phantasia

Phantasia - 2D SDL3 RPG prototype.
git clone git://git.beep.wimdupont.com/phantasia.git
Log | Files | Refs | README | LICENSE

phantasia.6 (2318B)


      1 .Dd July 30, 2026
      2 .Dt PHANTASIA 6
      3 .Os
      4 .Sh NAME
      5 .Nm phantasia
      6 .Nd 2D SDL3 RPG prototype
      7 .Sh SYNOPSIS
      8 .Nm
      9 .Op Fl -record Ar file Op Fl -seed Ar n
     10 .Op Fl -replay Ar file
     11 .Sh DESCRIPTION
     12 .Nm
     13 is a small top-down RPG prototype with connected map areas, item pickup, shops,
     14 visible in-world encounters, independently roaming and pursuing monsters, and
     15 turn-based battles.
     16 At startup, Continue restores the autosave and New Game starts fresh. The game
     17 saves player progression and mutable area state on area transitions and clean
     18 exit.
     19 Combat creates a pre-battle checkpoint; quitting mid-battle does not save a
     20 partial encounter, while victory saves its finalized result.
     21 .Sh KEYBINDINGS
     22 .Bl -tag -width "Arrow keys / WASD / HJKL"
     23 .It Arrow keys / WASD / HJKL
     24 Move the player.
     25 .It Space / E
     26 Interact, pick up nearby loot, or speak to a facing shopkeeper.
     27 .It C
     28 Open or close the character sheet.
     29 .It I
     30 Open or close the inventory.
     31 .It O
     32 Open or close the magick book.
     33 .It F3
     34 Toggle debug collision bounds, movement targets, frame timings, and event
     35 overflow counts.
     36 .It Arrow keys / HJKL
     37 Move through inventory items, item and spell actions, battle commands, learned
     38 spells, and combat targets.
     39 .It Enter
     40 Open or confirm the selected inventory action, shop choice, battle command, or
     41 spell action or target.
     42 .It Escape
     43 Return one level from an inventory, magick book, or battle submenu, or close an
     44 open character sheet. In the overworld or at the root of combat, open the main
     45 options menu. Its Sound submenu independently enables music and sound effects;
     46 Exit Game quits the game.
     47 .It Backspace
     48 Return one menu level or close the current menu without opening the main options
     49 menu. At the overworld or combat root, do nothing.
     50 .It Window close button
     51 Quit the game.
     52 .El
     53 .Sh OPTIONS
     54 .Bl -tag -width Ds
     55 .It Fl -record Ar file
     56 Record input from a fresh game without loading or writing the normal save.
     57 Quit normally to complete the recording.
     58 .It Fl -seed Ar n
     59 Set the recording's random seed (default 0x5048414e).
     60 .It Fl -replay Ar file
     61 Replay input headlessly without saving and report the final tick count and state.
     62 Use the same build, content, and simulation configuration as the recording.
     63 Malformed or incomplete recordings return a nonzero exit status.
     64 Cross-platform floating-point determinism is not guaranteed.
     65 .El