LUMEN · Instructions · PDF
LUMEN · The light keeper’s handbook
24 realms, 72 quests. A practical guide to Vim movements and its language of editing.
Your objective
The journey teaches deliberate text editing, from a single movement to text objects, registers, and macros. Each realm introduces a small family of commands. Quests require the specified tools, not just an accidental match with the target text. Completing the game means practising its curriculum, not mastering every feature of the full Vim editor. Revisit completed quests and look for your own clear, repeatable solutions.
Download handbook
PL / EN / ES / 中文 / 한국어 / 日本語 — PDF ↗Keys for the journey
Choose a language, name your character, and accept the terms. Click the board to give it keyboard focus. In Normal mode, letters perform commands; in Insert mode, they become text. Esc returns to Normal mode. On touch devices, use the keys beneath the board and the text entry fields. Before moving, read the objective, compare the buffer with the target, and check the required commands. Hints become more specific in stages. Restart affects the current quest; the map lets you return to unlocked realms. The Help button opens explanations and the manual at any time. Esc in Insert mode returns to Normal; in Normal mode, when no command is pending, it opens pause. A pause button is also available. The final three quests can be played as optional timed trials. Their suggested times are an extra challenge, not a condition for completing the curriculum. Practise correctness before speed.
Command syntax
Case matters: w and W, p and P, i and I are different commands. 3w means press 3 and then w; Ctrl-r means hold Control and press r. Symbols including +, -, |, $, %, semicolon, and comma are actual command keys. A command such as ciw combines operator c with text object iw. Enter the names and target text shown on the tablets exactly, even when the instructions use another language. Press Enter after : commands and after searches beginning with / or ?. Type sequences in order without the arrows that separate steps. <Esc>, <Enter>, <C-r>, and <Space> mean Escape, Enter, Control+r, and the space key; do not type the angle brackets.
Command
A colon opens the command line. :w saves a virtual document, :e opens another, :ls lists buffers, and :b switches buffers. :marks lists marks; :delmarks and its abbreviation :delm remove them, while :delmarks! clears local marks. :reg shows register contents. :set nu and :set nonu enable and disable absolute line numbers; :set nu! toggles them. :set rnu, :set nornu, and :set rnu! do the same for relative numbers. Enter confirms a command; Esc cancels it.
Registers · Recording a macro · Virtual files
A register is Vim’s clipboard. Ordinary copying and deleting use the unnamed register; a double-quote prefix selects another. Lowercase a–z identify named registers, while writing to A–Z appends to the corresponding lowercase register. Register 0 preserves the last yank, registers 1–9 retain a history of larger deletions, and register - stores a small deletion. Register _ is the black hole: delete into it without replacing other clipboard contents. :reg helps you inspect what was actually stored.
A macro records a sequence of actions, including cursor movements. To record in register a, press qa, perform the actions, and stop recording with q. @a replays register a; @@ repeats the last replayed macro. A count before replay sets the number of repetitions. Test a single run before replaying many times. A useful macro ends in a predictable position, ready to process the next piece of text.
A buffer is an open document; a filename identifies its virtual saved copy. :w [name] saves text, :e name opens a document, :ls lists buffers, and :b name or number switches buffers. Save intentional changes before leaving a document. Everything happens inside the game and its local save. Exporting your journey creates a backup, not a real source file in your computer’s filesystem. Do not type passwords or other confidential information into exercises.
LUMEN is an educational simulator of a selected Vim curriculum. The board represents a text buffer and its visible part is a viewport. Scrolling commands change the viewport, not the text. Files are virtual: the game does not read your computer’s directories or execute operating-system commands. Commands follow the editing operations being taught, but the game does not replace full Vim with all its options, plugins, and syntax exceptions. In-game help and this handbook describe the supported scope.
Progress stays on your device
Your name, terms acceptance, and progress are stored in this browser’s localStorage. This is not an account or a cloud backup. Private browsing, clearing site data, or storage restrictions can remove it. Download a save backup if you want to preserve it or move to another device. Optional diagnostics are off by default and have a separate switch in settings. They are not required to play. Diagnostics contain limited technical error data, not your name, exercise contents, or full save. The terms explain the data handling in more detail.
Curriculum ↗