Keybindings

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

Input Action
WASD / Arrow keys Move (8 directions)
Space Jump
Left-click tile Walk to tile (pathfinding)
Space / Home Re-center camera on player

Combat

Input Action
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

Input Action
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.

Input Action Shortcut action
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

Input Action
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

Input Action
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.

Step What happens
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

Input Action
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

Input Action
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

Input Action
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

Input Action
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

Input Action
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

Input Action
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

Input Action
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

Input Action
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

Input Action
Ctrl+Z Undo last edit stroke
Ctrl+Y Redo

Game Editor

All modules share these controls:

Input Action
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

Input Action
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

Input Action
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

Input Action
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

Input Action
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

Input Action
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

Input Action
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

Input Action
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

Input Action
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

Input Action
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