From 3f505a03e8ff83dd0b8155090bafc90ad2b06a3c Mon Sep 17 00:00:00 2001 From: Mathieu Schroeter Date: Tue, 12 Dec 2017 22:42:25 +0100 Subject: [PATCH] Update the USER readme --- README-user.md | 27 +++++++++++++++++++++------ 1 file changed, 21 insertions(+), 6 deletions(-) diff --git a/README-user.md b/README-user.md index 282e335..890f57f 100644 --- a/README-user.md +++ b/README-user.md @@ -1,5 +1,5 @@ -# Planet Blupi (v1.9.x) +# Planet Blupi This version contains over 30 missions and a built in editor, which enables you to construct your own missions. @@ -20,16 +20,28 @@ What ever your screen resolution is, the game "Planet Blupi" always runs in the game by default in windowed mode. Proceed as follows: 1. Quit the game _Planet Blupi_. -2. Open the file `/data/config.json` with a text editor. +2. Open the file `share/planetblupi/data/config.json` with a text editor. 3. Replace `fullscreen: true` by `fullscreen: false`. 4. Save and restart the game. In this mode the screen is no more scrolled if the mouse touches the window border. Use the Keyboard arrows instead. +> It's possible to start the game with `--fullscreen off` instead of editing +> the `config.json` file. + +If the problem persists, maybe you should try to start the game with the software +renderer. Edit the `config.json` file and add `"renderer": "software"` or start +the game with `--renderer software`. + +On Windows, an other possibility exists. You can try to change the driver used +by the software renderer. By default it uses `"direct3d"`, you can change by +`"opengl"` with `"driver": "opengl"` with the `config.json` file or +`--driver opengl` by command line argument. + ## Mouse -Left button: +Left button: This button is always used in three steps: 1. Select a Blupi. @@ -41,7 +53,7 @@ step 1) is not necessary. You may select several Blupis by maintaining the Shift button pressed. -Right button: +Right button: The right button is a shortcut. It orders the selected Blupi to do the most useful operation on the selected spot. @@ -67,7 +79,10 @@ The music is provided in OGG and MIDI formats. The OGG variant is prefered because the render is the same for all platforms. For purist fanboys, it's possible to enforce the MIDI variant by starting the game with the `--restore-midi` command line argument. Note that in this case, it's possible -to lose some instruments, it depends of you system. +to lose some instruments, it depends of your system. + +> You can edit the `share/planetblupi/data/config.json` file and add an entry +> `"restoremidi": true` too. If you want, you can overload all musics with yours by providing OGG or MIDI music files in your user directory. @@ -76,7 +91,7 @@ On Windows, type `%LOCALAPPDATA%\Epsitec SA\Planet Blupi` in the file browser, on macOS, look at `~/Library/Application Support/Epsitec SA/Planet Blupi`, and on Linux, look at `~/.local/share/Epsitec SA/Planet Blupi`. -You can create a `music` sub-directory with your music. For example: +You can create a `music` sub-directory with your music. For example: `%LOCALAPPDATA%\Epsitec SA\Planet Blupi\music\music000.ogg`. Only 10 musics are supported: `music000` to `music009`.