BLOUMA (demo) - remake for macOS
Built from kit 2026-11-08 (repo 4c15875c+changes).

Blouma is a game by -JS- (https://blouma.eu), made with Game Editor. This is a
remake that runs his public demo with the same rules and picture (320x200,
sharp square pixels), made with his permission. Nothing else needs to be installed.


START

Double-click Blouma.app. The window opens maximized; the picture uses the
largest whole multiple of 320x200 that fits.

The app is not signed by an Apple developer account, so the first start of
a downloaded copy is blocked ("cannot be verified" / "Apple could not
verify"). Allow it once:
  - macOS 15 and newer: double-click Blouma.app, close the message, then
    System Settings > Privacy & Security > scroll down > "Open Anyway".
  - macOS 14 and older: right-click Blouma.app > Open > Open.
  - Or in the Terminal (any version), in the folder with the app:
      xattr -dr com.apple.quarantine Blouma.app
Move Blouma.app out of the Downloads folder first (e.g. to Applications),
otherwise macOS may start it from a temporary read-only copy.


KEYS

  Arrow keys        walk / sail / swim (Up/Down: step back/front, swim up/down)
  Ctrl              touch / use; Ctrl + arrow = run, swim fast
  Space             special action      Option (Alt)   look at (info)
  Tab               spit / big bubble   H     hide (when Blouma can)
  1-6               inventory slot, 7 switches things/skills;
                    then Delete (the backspace key) = left click, Return = right click
  F1                menu: L load, O new game, Q quit
  F2                menu: T setup, S save, I info
  F11               show health
  Mouse             works too (inventory, menus; click the title BLOUMA top left
                    = F1, right click = F2)
  Esc               quits at once, like the original (no question)
  Option+Return     fullscreen on/off at any time (Alt+Enter on other systems)

On a MacBook the F-keys may need the "fn" key (fn+F1, fn+F2), unless
System Settings > Keyboard > "Use F1, F2, etc. keys as standard function keys"
is switched on. The game's own help is behind F1 / F2 and in the tutorial.


SAVES

Settings, "GO ON?" and SAVE GAME are kept in

  ~/Library/Application Support/blouma-remake/saves

(Finder: Go > Go to Folder..., paste the line.) Delete that folder to start like
a new installation.


OPTIONS AND MESSAGES

Start the program from the Terminal to see its messages and to use options:

  Blouma.app/Contents/MacOS/Blouma --scale 3      a window of exactly 3x 320x200
  Blouma.app/Contents/MacOS/Blouma --fullscreen   fullscreen at start
  Blouma.app/Contents/MacOS/Blouma --mute         no sound
  Blouma.app/Contents/MacOS/Blouma --fresh        nothing is read or saved
  Blouma.app/Contents/MacOS/Blouma --help         all options

(In the kit folder, "bash run-with-messages.sh" does this and keeps run-log.txt.)
Please send any bug report to whoever gave you this game, with the messages if you
have them and a few words about what you did.

Licences of the included software: Blouma.app/Contents/Resources/LICENSES/.
