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.
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.
Basic cursor movements
h✓ 2, 3, 17j✓ 2, 3, 9, 39, 40, 45, 56, 57, 58, 64, 65, 69, 70, 72k✓ 1, 3l✓ 1, 3, 53, 54
1. Lantern Harbor · 6. Mirror Library · 3. Bridges of Lines · 13. Weavers’ Workshop · 14. Grammar Foundry · 15. Word Sanctuary · 19. Cabinet of Echoes · 20. Chamber of Nine · 22. Clockwork Orchard · 23. Weavers’ Trials · 24. Summit of Beginnings · 18. Cartographers’ Camp
Words, WORDs, and their boundaries
w✓ 4, 6, 15, 17, 23, 37, 40, 41, 42, 43, 44, 67, 69W✓ 25e✓ 6, 40E✓ 26b✓ 5B✓ 26
2. Word Grove · 5. Ember Forge · 6. Mirror Library · 8. Morning Tower · 13. Weavers’ Workshop · 14. Grammar Foundry · 15. Word Sanctuary · 23. Weavers’ Trials · 9. Wind Cliffs
Line and file beginnings and endings
0✓ 7, 9, 26, 48^✓ 7$✓ 8gg✓ 9, 40, 52, 56G✓ 8
3. Bridges of Lines · 9. Wind Cliffs · 16. Delimiter Vault · 14. Grammar Foundry · 18. Cartographers’ Camp · 19. Cabinet of Echoes
Counts, multiplication, and columns
count✓ 9, 27, 37, 66, 67, 69|✓ 27
1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 2d3w
3. Bridges of Lines · 9. Wind Cliffs · 13. Weavers’ Workshop · 22. Clockwork Orchard · 23. Weavers’ Trials
Finding characters in both directions
f✓ 10, 11, 46, 47, 49, 50, 51F✓ 28t✓ 28T✓ 28;✓ 11,✓ 28
4. Echo Observatory · 16. Delimiter Vault · 17. Whisper Chapel · 10. Hunters’ Pass
Searching text and the word under the cursor
/✓ 12, 23, 71?✓ 30, 71*✓ 29#✓ 29n✓ 12, 30, 71N✓ 12, 30
4. Echo Observatory · 8. Morning Tower · 24. Summit of Beginnings · 10. Hunters’ Pass
Matching brackets and block boundaries
%✓ 31[{✓ 31]}✓ 31[(✓ 31])✓ 31
11. Stone Circles
Scrolling and viewport positions
zt✓ 34zz✓ 34, 35zb✓ 34H✓ 35M✓ 35L✓ 35
z
12. Horizon Tower
Deletion and operators
x✓ 13, 55, 66, 68X✓ 37d✓ 15, 18, 22, 23, 24, 41, 42, 43, 44, 45, 48, 51, 57, 58, 59, 67, 69, 70dd✓ 15, 18, 22, 24, 41, 57, 58, 59, 70dw✓ 15, 23, 42, 67, 69D✓ 37
5. Ember Forge · 19. Cabinet of Echoes · 22. Clockwork Orchard · 23. Weavers’ Trials · 13. Weavers’ Workshop · 6. Mirror Library · 8. Morning Tower · 14. Grammar Foundry · 15. Word Sanctuary · 16. Delimiter Vault · 17. Whisper Chapel · 20. Chamber of Nine · 24. Summit of Beginnings
Replacement and letter case
r✓ 14~✓ 37
5. Ember Forge · 13. Weavers’ Workshop
Copying, cutting, and putting text
y✓ 16, 17, 22, 24, 41, 45, 46, 47, 49, 50, 55, 56, 57, 58, 60, 69, 72yy✓ 16, 22, 24, 55, 56, 57, 58, 60, 69, 72Y✓ 41p✓ 16, 17, 18, 22, 24, 41, 56, 58, 59, 72P✓ 41, 55, 57, 59, 69
6. Mirror Library · 8. Morning Tower · 14. Grammar Foundry · 15. Word Sanctuary · 16. Delimiter Vault · 17. Whisper Chapel · 19. Cabinet of Echoes · 20. Chamber of Nine · 23. Weavers’ Trials · 24. Summit of Beginnings
Unnamed, small deletion, and black hole registers
"✓ 55, 56, 57, 58, 59, 60, 69, 72""✓ 55"-✓ 55"_✓ 57
19. Cabinet of Echoes · 20. Chamber of Nine · 23. Weavers’ Trials · 24. Summit of Beginnings
The yank register and nine deletions of history
"0✓ 58, 69, 72"1✓ 59"2✓ 59"3✓ 59"4✓ 59"5✓ 59"6✓ 59"7✓ 59"8✓ 59"9✓ 59
20. Chamber of Nine · 23. Weavers’ Trials · 24. Summit of Beginnings
Named registers and appending
"a✓ 56, 57, 60"A✓ 56
"a · "b · "c · "d · "e · "f · "g · "h · "i · "j · "k · "l · "m · "n · "o · "p · "q · "r · "s · "t · "u · "v · "w · "x · "y · "z · "A · "B · "C · "D · "E · "F · "G · "H · "I · "J · "K · "L · "M · "N · "O · "P · "Q · "R · "S · "T · "U · "V · "W · "X · "Y · "Z
19. Cabinet of Echoes · 20. Chamber of Nine
Inspecting register contents
:reg✓ 60
20. Chamber of Nine
Inserting and changing text
i✓ 19I✓ 38, 65a✓ 20A✓ 20, 23, 61, 64c✓ 40, 48, 51, 61, 70, 72cc✓ 40, 61, 72C✓ 40s✓ 39S✓ 39o✓ 21, 24O✓ 38Esc✓ 19, 20, 21, 23, 24, 38, 39, 40, 48, 51, 61, 64, 65, 70, 72
7. Dawn Scriptorium · 13. Weavers’ Workshop · 22. Clockwork Orchard · 8. Morning Tower · 21. Scribes’ Harbor · 14. Grammar Foundry · 16. Delimiter Vault · 17. Whisper Chapel · 24. Summit of Beginnings
Sentence and paragraph navigation
{✓ 32}✓ 32(✓ 33)✓ 33
11. Stone Circles
Repeating the last change
.✓ 42, 59, 68
14. Grammar Foundry · 20. Chamber of Nine · 23. Weavers’ Trials
Word, sentence, and paragraph objects
iw✓ 43aw✓ 43iW✓ 44aW✓ 44is✓ 45as✓ 45ip✓ 45ap✓ 45
15. Word Sanctuary
Inside and around brackets: every alias
i[✓ 46a[✓ 46, 48, 70i]✓ 46a]✓ 46i(✓ 46, 48a(✓ 46i)✓ 46a)✓ 46ib✓ 46ab✓ 46i{✓ 47a{✓ 47i}✓ 47a}✓ 47iB✓ 47aB✓ 47i<✓ 47a<✓ 47i>✓ 47a>✓ 47
16. Delimiter Vault · 24. Summit of Beginnings
Double quotes, single quotes, backticks, and tags
i"✓ 49a"✓ 49, 51i'✓ 49a'✓ 49i`✓ 50a`✓ 50it✓ 50, 51, 70at✓ 50
17. Whisper Chapel · 24. Summit of Beginnings
Absolute and relative line numbers
nu✓ 36nonu✓ 36nu!✓ 36rnu✓ 36nornu✓ 36rnu!✓ 36
12. Horizon Tower
Marks, exact jumps, and line jumps
m✓ 52, 53, 54, 71'✓ 52`✓ 52, 71:marks✓ 53:delm✓ 53:delmarks✓ 54:delmarks!✓ 54:delm!✓ 54
18. Cartographers’ Camp · 24. Summit of Beginnings
Undo and redo
u✓ 14, 59, 69Ctrl-r✓ 14:undo✓ 68:redo✓ 68
5. Ember Forge · 20. Chamber of Nine · 23. Weavers’ Trials
Virtual buffers and files
:b✓ 62, 63:ls✓ 62:w✓ 21, 22, 23, 24, 61, 63, 70, 72:e✓ 61, 62, 63, 72
21. Scribes’ Harbor · 7. Dawn Scriptorium · 8. Morning Tower · 24. Summit of Beginnings
First non-blank on adjacent lines
+✓ 27-✓ 27
9. Wind Cliffs
Recording, replaying, and repeating macros
q✓ 64, 65, 66, 69, 72@✓ 64, 65, 66, 69, 72@@✓ 65, 72
22. Clockwork Orchard · 23. Weavers’ Trials · 24. Summit of Beginnings