========================================================================
 Jedi Knight Mod

 P69.GOB  --  THE FLOATING MOD MENU

 An in-game menu made of things, not walls: a wide glass panel that
 floats in front of you and eases after you as you move, with a cursor
 where your gaze meets it. Look at a button and press the Mod Menu key
 to choose it. It is a kit other mods build in; this GOB is its demo,
 and works in every level, single player and multiplayer.

 [cogfactory / p69-mod-menu]

 BUILD 1  --  2026-10-03
 sha256 b49d137d76078fa2cb6933cb5da1933b

 This mod is not made or distributed by LucasArts
 Entertainment Co.
========================================================================

THIS PACKAGE
------------------------------------------------------------------------
  P69.GOB          the mod
  readme.txt       this file
  screenshot.jpg   what it looks like

INSTALLATION
------------------------------------------------------------------------
  RETAIL JEDI KNIGHT: copy P69.GOB into the Resource folder of your Jedi
  Knight install, beside Res1hi.gob and Res2.gob. Keep its name: Jedi
  Knight mounts every GOB in Resource in name order and the first one
  holding a file wins, and the mod replaces three of LucasArts' files
  (below) that Res1hi.gob and Res2.gob also carry -- P69.GOB sorts
  before both. To remove the mod, delete P69.GOB.

  OPENJKDF2 / THE LIBRETRO CORE: put P69.GOB in the mods folder of your
  Jedi Knight folder.

  IT REPLACES three whole files, each a COMPLETE copy of LucasArts' with
  the mod's lines added: jkl\static.jkl (the world every level shares),
  misc\items.dat (the inventory table: one new row, the Mod Menu key)
  and ui\jkstrings.uni (the game's text: one new line, the key's name in
  the Controls list). So it cannot be installed together with another
  mod that ships any of those three (P68.GOB, rbots,
  XtremeFuckin'Warfare): the first GOB in name order wins and the other
  mod's copy is ignored.

BIND THE KEY (once)
------------------------------------------------------------------------
  Setup -> Controls -> Keyboard: the list now ends with "Mod Menu".
  Select it and press the key you want (this readme assumes H). Jedi
  Knight remembers it in your player profile.

  A mod gets at most three such keys: the engine has twenty and
  LucasArts' force powers and items use seventeen.

  OPENJKDF2 / RETROARCH, when the game is started straight into a level
  (the libretro core's default): that start reads your profile BEFORE
  the mod's key exists, so the binding is dropped and must be made again
  each session -- or start through the game's main menu (core option
  Boot mode = Game main menu). Retail reads the profile at the main menu
  and keeps it.

HOW TO USE IT
------------------------------------------------------------------------
  Press the Mod Menu key: the MOD MENU opens in front of you. Look at a
  button (a white wedge marks where your gaze meets the panel, and the
  button lights up blue) and press the key again to choose it. Look off
  the panel and press the key to close it. The menu never closes on its
  own.

  It follows you: it keeps its heading while you look around it, and
  swings round in front of you when you turn well away. In a tight
  corridor, against a wall or on a slope it moves closer, slides aside
  and shrinks so it never sits inside a wall -- it looks the same size,
  only nearer.

  Third person (F1): the panel floats above your head instead of at eye
  level; look up at it.

  The demo's menus:

  MOD MENU    NIGHT LIGHT: OFF/ON   your own light, brighter
              VIEW: FIRST/THIRD     switches the camera
              OPTIONS >             the submenu
              CLOSE
  OPTIONS     FLASH                 a blue screen flash
              MENU SIZE             LARGE / NORMAL / SMALL
              < BACK
  LOW HEALTH  pops up ON ITS OWN when your health falls below 40:
              HEAL +25 / DISMISS

  MULTIPLAYER: every player has a menu of their own that nobody else
  sees; nothing it does is sent over the network.

SAVING
------------------------------------------------------------------------
  Saving and loading with the menu open is safe: the menu's pieces are
  never written into a save, and the menu rebuilds itself on the same
  page after a load.

RETAIL TEST
------------------------------------------------------------------------
  Run in real Jedi Knight by the project's owner (2026-10-03): it
  worked. The project's own tests ran in its engine fork (openjkdf2).
  What a retail check covers:

  1. the game starts and a level loads with P69.GOB installed
  2. Setup -> Controls -> Keyboard lists "Mod Menu", and the key opens it
  3. the panel reads well, in first and third person, in dark and bright rooms
  4. the cursor sits where you look; the gazed button lights; the key chooses it
  5. a tight corridor / a wall: the panel never pokes into the wall
  6. your inventory, force powers, field light and bacta all still work
  7. save and load with the menu open
  8. multiplayer: your menu is yours alone
  9. health below 40: the LOW HEALTH menu pops up

CREDITS
------------------------------------------------------------------------
  Built in cogfactory for SM Sith Lord. Font: Bahnschrift. The hotkey
  route follows rbots and SM Sith Lord's XtremeFuckin'Warfare (the
  static world).
