Keybindings Reference
Source of truth: the static const arrays in
client/help_ui.c (nilorea-client) and
editor/help_data.h (nilorea-assets-editor). This file must
match them. See the Help System Maintenance rule in root
CLAUDE.md.
Game Client — Gameplay
Movement
| WASD / Arrow keys |
Move (8 directions) |
| Space |
Jump |
| Left-click tile |
Walk to tile (pathfinding) |
| Space / Home |
Re-center camera on player |
Combat
| F |
Melee attack, or open dialog if target is a friendly NPC (hold =
auto-repeat) |
| R |
Toggle weapon (melee/ranged) or ranged attack |
| Ctrl+F / Ctrl+R |
Force-attack friendly NPC/player |
| Tab |
Cycle target (nearest enemy first) |
| Shift+Tab |
Cycle target backwards |
| Right-click enemy |
Select target + walk-to-attack |
| 1-9 |
Activate hotbar slot 1-9 (spell select, equip arrow/weapon, use
potion/scroll) |
| 1-9 (auto_attack) |
Toggle auto-attack mode (assign to hotbar) |
| Ctrl+1-9 |
Force-cast spell on friendly |
| V |
Use HP potion |
| Shift+V |
Use Mana potion |
| Escape |
Deselect target / cancel auto-attack |
Interaction
| Left-click NPC |
Walk to NPC and talk |
| Left-click door/chest/portal |
Walk to object and interact |
| Left-click ground item |
Walk to item and pick up |
| Left-click other player |
Walk to that player’s tile (does NOT engage combat) |
| Shift+Left-click other player |
Attack that player (force-attack on a non-PvP target produces a
single MSG_COMBAT_DENIED toast — server clears the auto-attack loop on
deny) |
| E |
Interact with nearest NPC / door / chest |
| Right-click entity |
Show name/level tooltip (player rows render the server-pushed
account name from PROTOCOL 64) |
| Shift+right-click |
Open the action context menu for the entity / map object / ground
item under the cursor (selects it too). Player → Invite to Party /
Add-or-Remove Friend / Trade / Whisper / Examine / Attack; party member
→ Whisper / Trade / Promote / Kick (leader only); NPC → Talk; enemy →
Attack; object → Interact; ground item → Pick Up. Plain right-click
keeps the tooltip. (TD-67) |
| T |
Send trade request to selected target (player only) |
| G |
Invite selected player to a party (dispatches
/invite <name> via chat; server-side validation chain
identical to the slash-command path) |
| Shift+G |
Leave the current party (MSG_PARTY_LEAVE, no-op when
not in a party) |
UI Panels
Every entry in this table is a rebindable SC_TOGGLE_*
action — open F2 (Shortcut Manager) to remap any of them. Defaults shown
below.
| I |
Toggle Inventory |
SC_TOGGLE_INVENTORY |
| P |
Toggle Stat Distribution |
SC_TOGGLE_STAT_DISTRIB |
| K |
Toggle Spellbook |
SC_TOGGLE_SPELLBOOK |
| L |
Toggle Skillbook |
SC_TOGGLE_SKILLBOOK |
| C |
Toggle Crafting |
SC_TOGGLE_CRAFTING |
| J |
Toggle Quest Log |
SC_TOGGLE_QUEST_LOG |
| O |
Toggle Friends List |
SC_TOGGLE_FRIENDS |
| M |
Toggle Minimap |
SC_TOGGLE_MINIMAP |
| Shift+M |
Open World Map — a dedicated page; closes only on Escape or the
top-right close button (×) |
SC_TOGGLE_WORLD_MAP |
| +/= , - , 0, mouse wheel (world map open) |
World Map zoom in / out / reset. The mouse wheel zooms anchored on
the cursor; 0 / the reset button restore zoom 1 and
recenter on the player. Zoom persisted in
config/client.json::world_map_zoom. On-screen
+ / o / - buttons mirror the keys; the minimap has the same
buttons on its left edge (minimap_zoom). |
world_map.c internal |
| Left-drag (world map open) |
Pan the world map by dragging (grab-and-drag; only moves when zoomed
in past the fit view). Pan is session-only (not persisted); reopening or
resetting recenters on the player. |
world_map.c internal |
| H |
Toggle Quest Compass |
SC_TOGGLE_COMPASS |
| Shift+B |
Toggle Hotbar |
SC_TOGGLE_HOTBAR |
| U |
Toggle HP / MP / Stamina / XP HUD |
SC_TOGGLE_PLAYER_HUD |
| N |
Toggle Status Effects strip (buff/debuff durations) |
SC_TOGGLE_STATUS_STRIP |
| Y |
Toggle Day / Night wheel |
SC_TOGGLE_DAY_NIGHT |
| Enter |
Open / send chat |
SC_OPEN_CHAT |
| Shift+Enter |
Toggle Chat panel |
SC_TOGGLE_CHAT_PANEL |
| Escape |
Close topmost panel / exit confirmation |
SC_CLOSE_TOPMOST |
| Ctrl+M |
Toggle Moderation panel (moderators only) |
SC_TOGGLE_MOD_PANEL |
| F2 |
Toggle Shortcut Manager (rebind keys) |
SC_TOGGLE_SHORTCUTS |
| F10 |
Toggle Help dialog |
SC_TOGGLE_HELP |
The Character Sheet is merged into the Inventory panel — no separate
key (the earlier C alias is gone; rebind
SC_TOGGLE_INVENTORY to C via F2 if you want it
back).
Camera
| Mouse wheel |
Zoom in / out |
| Middle-click drag |
Pan camera freely |
| Page Up / Numpad + |
Zoom in (large step) |
| Page Down / Numpad - |
Zoom out (large step) |
| +/- |
Zoom in / out |
Chat
| Enter |
Activate chat input |
| Escape (in chat) |
Cancel input |
| /say, /yell, /global |
Channel commands |
| /tell <name> <msg> |
Whisper to player (also /t, /w, /whisper) |
| /block <name> |
Suppress chat + trade requests from player |
| /unblock <name> |
Stop blocking the player |
| /blocklist |
Show your current block list |
| /password <current> <new> |
Change your own account password |
| Mouse wheel (chat area) |
Scroll chat log |
| 1-9 (NPC dialog) |
Select dialog choice |
Tutorial (Phase 71)
First-login characters are walked through the main_00
quest by Apprentice Sven near the plaza spawn. The top-centre ribbon
shows the current beat; completing main_00 latches an
account-wide tutorial_completed flag so every future alt
skips the intro automatically. main_01 is gated on
main_00 being turned in — the Elder Marn “The First Shard”
response is hidden until then.
| Start |
Talk to Apprentice Sven near the plaza spawn |
| Move |
Walk east to the practice yard (WASD or click) |
| Combat |
Kill the Practice Dummy (Tab to target, A to hit) |
| Inventory |
Open your pack with I |
| Equip |
Drag or right-click the Training Dagger onto the weapon slot |
| Elder Marn |
Cross the plaza and speak with Elder Marn to accept
main_01 |
| Skip |
The ribbon’s Skip button bypasses main_00 (no
rewards) |
Debug
| B |
Toggle smooth height rendering |
| F1 |
Toggle tile picking debug overlay |
| F8 |
Toggle entity sprite debug |
| F9 |
Flush and reload all sprite caches |
Game Client
Admin — Editor Mode (ADMIN_BUILD only)
General
| F5 |
Toggle editor on / off |
| F10 |
Toggle help dialog |
| Hover a control |
Its tooltip explains what the tool does (delay: Interface → Tooltip
delay) |
| Escape |
Exit editor / cancel mode |
Layer Editing
| Left-click |
Paint tile / apply current tool |
| Right-click |
Erase tile / remove object |
| Shift+drag |
Rectangle selection (batch paint) |
| Mouse wheel |
Adjust value slider / scroll segments |
Height Mode
| H |
Ground height paint mode |
| S |
Segment edit mode |
| E |
Eyedropper (read height from tile) |
| Apply Slopes btn |
Click-to-select: smooth chunk slopes |
Segment Mode
| Left-click |
Apply segment values to tile |
| Mouse wheel |
Shift all segments up/down (rigid body) |
| Seg 1 checkbox |
Enable/disable second segment |
Chunk Operations
| Shift+Delete |
Open chunk operations dialog |
| Clear Chunk |
Reset all tiles to default |
| Toggle Safe Zone |
Click chunk to toggle safe flag |
| Toggle Dark Place |
Click chunk to toggle dark flag |
| Right-click / Esc |
Cancel click-to-select mode |
Objects / Map Objects /
Particles
| Left-click (Objects) |
Place static/wall object |
| Right-click (Objects) |
Remove static/wall object |
| Left-click (MapObj) |
Place door/portal/stairs |
| Right-click (MapObj) |
Remove map object |
| Left-click (Particles) |
Place particle emitter |
| Right-click (Particles) |
Remove particle emitter |
Overlays
| F2 |
Toggle height tint overlay |
| F3 |
Toggle height number labels |
| F4 |
Toggle segment outline overlay |
| F7 |
Toggle particle emitter markers |
| F11 |
Toggle safe zone overlay |
Undo / Redo
| Ctrl+Z |
Undo last edit stroke |
| Ctrl+Y |
Redo |
Game Editor
All modules share these controls:
| Toolbar buttons |
Switch editor mode (12 modes) |
| F1 |
Toggle Help dialog (per-module pages) |
| F2 |
Toggle Preferences (hover-tooltip delay; 0 ms = tooltips off) |
| Left/Right arrows (help open) |
Switch help page |
| Escape |
Close preferences / help / exit confirmation dialog |
Every interactive control in every mode carries a hover tooltip. Rest
the pointer on it and the tooltip appears after the delay set in
Preferences [F2] — persisted as tooltip_delay_sec in
config/editor.json.
Sprite Editor
| Type combobox |
Select sprite type (clothes/enemies/etc.) |
| Sprite listbox |
Browse and select sprites from assets/ |
| Left/Right arrows |
Step frame backward/forward (autoplay off) |
| Left-click preview |
Set hotspot at cursor position |
| Drag on preview |
Update hotspot in real-time |
| AnimSet buttons |
Switch walk/stop/attack/death mode |
| Direction selector |
Choose N/NE/E/SE/S/SW/W/NW |
| Save button |
Write .txt descriptor file |
Entity Editor
| Type combobox |
Select entity type (enemy/NPC/item/spell) |
| Sprite combobox |
Select sprite — loads animated preview |
| Equipment combos |
NPC weapon/clothes — layered on preview |
| New / Open / Save / Save As |
File operations |
Quest Editor
| Stage list |
Select quest stage to edit |
| Add/Remove Stage |
Manage multi-stage quest structure |
| Apply to Stage |
Save edits to selected stage |
| Type combobox |
Set stage type (kill/collect/talk/travel) |
| New / Open / Save |
File operations |
Dialog Editor
| Node list |
Select dialog node to edit |
| Add/Remove Node |
Manage dialog tree structure |
| Response list |
Select response in current node |
| Add/Remove Response |
Manage branching responses |
| New / Open / Save |
File operations |
Particle Editor
| Preset radiolist |
Select emitter preset to edit |
| Restart button |
Recreate preview with current settings |
| Pause button |
Freeze particle simulation |
| New / Save / Save As |
File operations |
Static Object Editor
| Preset radiolist |
Select object/wall preset to edit |
| Left-click on grid |
Toggle footprint tile (on/off) |
| is_wall checkbox |
Wall mode: single-tile, no footprint edit |
| Load Image button |
Browse for sprite PNG file |
| New / Save |
File operations |
Tile Editor
| Tile radiolist |
Select tile to edit |
| Add / Remove |
Add or remove tile from tileset |
| Move Up/Down |
Reorder tile IDs (remaps chunks) |
| Animated checkbox |
Enable animation fields for tile |
| Save button |
Write map.json + animated_tiles.json |
Map Object Editor
| Preset radiolist |
Select template to edit |
| Type combobox |
Door / Portal / Stairs Up / Stairs Down |
| Load Image button |
Browse for sprite PNG file |
| New / Save |
File operations |
Asset Browser
| Category combobox |
Filter by asset type (21 categories) |
| File listbox |
Browse files in selected category |
| Open in Editor |
Load selected file in its editor mode |
| Rescan assets/ |
Refresh file listing from disk |
Notes
- When chat input is active (after pressing Enter),
all gameplay keys are blocked. Only typing, Enter (send), and Escape
(cancel) work.
- When admin editor is active, all gameplay/combat
keys are suppressed. Only editor controls and camera remain active.
- When shortcut manager (F2) is open, all gameplay
keys are blocked. Escape closes the panel (or cancels a rebind in
progress).
- When help dialog (F10/F1) is shown, all keys are
blocked except the help toggle key and Escape to dismiss.
- Auto-attack (holding F or R) stops when: key
released, target dies, player moves with keyboard, or any UI panel
opens.
- Force-attack (Ctrl+F/R/1-9) allows targeting
friendly NPCs (HP floor at 1, NPC retaliates) and other players (safe
zones still block PVP).
- Boot-phase modals (Connection Error retry dialog,
Login screen, Exit confirm) are pre-shortcut-manager — their Enter /
Escape bindings are attached to specific widgets via
n_gui_button_set_keycode[_focused]. These are not
rebindable (shortcut manager isn’t loaded yet at that point). Login
Enter is focused on the name / password / confirm textareas so it
submits while you’re typing; retry-dialog Enter / Escape are global
because the dialog has no text inputs.