Skip to content
/ Ivan Public

OOT Randomizer item tracker, hint tracker, and timer.

License

Notifications You must be signed in to change notification settings

L-P/Ivan

Repository files navigation

Ivan

What's the opposite of a nagging fairy that always gets in your way and never tells you anything useful? Ivan.

Ivan is a tailor-made, keyboard-driven Ocarina of Time: Randomizer item tracker, hint tracker, timer, and input viewer.
Because using a mouse is slow, and you gotta go fast.

Keyboard input

screenshot of ivan

Ivan must be focused for keyboard input to work.

  • Esc quits the tracker, only works when the timer is stopped (not paused) to avoid accidentally closing the tracker.
    When the timer is not paused, Esc will cancel the current input mode.
  • Del to reset the timer and the tracker, only works when the timer is paused.
  • - to undo the last action.
  • + to redo the last undone action.

The state of the tracker is persisted to file in case you close it by mistake of if someone played Song of Storms nearby. Del will reset the tracker right after launching if needed.

Item tracker

Basic usage:

  1. Press a number on your numpad to select an item zone
  2. Press another number to select and upgrade/enable an item

Item zones visually map to your numpad, ie. bottom-left is 1, top-right is 9. same for items inside their own 3×3 grid.
eg. if you wanted to enable Light Arrows, you would press 8 (top-middle) then 2 (bottom-middle). That's it.

Songs are a special case as they are not selectable using their visible position on the tracker, instead they are accessible in logical order (eg. to get Requiem you would press 3 as teleportation songs are in the bottom-right zone, then 4 because Requiem is the fourth song in the pause menu).

Other keys:

  • 0 to display the region highlight or cancel your selection.
  • Esc to cancel your selection.
  • . to downgrade the next selected item instead of upgrading it.
  • - to undo the last action.
  • + to redo the last undone action.

Mouse

  1. Left click to upgrade an item.
  2. Right click to downgrade an item.
  3. Scroll up/down to:
  • upgrade or downgrade an item.
  • cycle up/down the list of dungeons on stones and medallions.

Timer

  • Space once to start the timer, then to pause/resume it.
  • Del when it is paused to stop it (and reset all tracker data).

Hint tracker

  1. Press the key corresponding to your hint type (WotH, Barren, Sometimes, Always).
  2. Type your text.
  3. Press Enter.
  • w to enter a WotH Hint (green background, fuzzy location search).
  • g to enter a Goal Hint (green background, freeform text).
  • b to enter a Barren Hint (red background, fuzzy location search).
  • s to enter a Sometimes Hint (blue background, freeform text).
  • a to enter a Always Hint (yellow background).
  • Esc to cancel your input.
  • Enter to submit your input.

As Always Hints have a fixed slot, they get special treatment. The text you input is parsed as the slot name until the first space, then your text. eg. If you get Nocturne of Shadows on Ocarina of Time you might press a to start the prompt then oot = nocturne then Enter.

Dungeon input

Dungeon input allows you to quickly set which dungeons holds what medallions when reading the altar at the Temple of Time.

  1. Press d to enter dungeon input mode.
  2. Dungeon mode always starts with the Light Medallion and goes in the same order as the altar.
  3. Press the KP of the medallion that originally holds the dungeon. eg. if Fire Temple holds the Light Medallion, press the key for Fire Medallion, ie. 5.
  4. Dungeon mode will advance automatically to the next medallion and you can go back to 3.
  5. When the last medallion is entered the three stones are filled randomly and dungeon mode is exited automatically.

You can also use + and - to cycle through medallions to correct a mistake and 0 to exit.

Input Viewer

The input viewer displays your input around the timer. Button and axes IDs depend on your configuration and can be set in the InputViewer key of config.json.
If you want to disable the input viewer you can set Enabled to false.

Customization

The images in the assets folder can be changed if you wish to customize your background or your icons.
The config.json file contains all positions and definitions of the available items and locations, it also contains keybinds.