A standalone “how to play” guide. It covers everything you can do as a player. For exact numbers it links to the canonical references rather than repeating them, so they can never drift:
- Every keybinding (and how to rebind):
keybindings.md— itself generated from the in-game help. The in-game Help dialog (F10) shows the same table live.- Stat → effect formulas (HP, mana, stamina, damage, dodge, crit, …):
stats.md.- The world, its regions and story:
STORY.mdandPLACES.md.🇫🇷 Version française :
player-guide.fr.md.
The game is a server-authoritative top-down
isometric RPG/MMO. The server decides everything (your position, HP,
loot, quest state); the client just draws the world and sends your
intent. That means there is no offline mode — you always play against a
running nilorea-server.
Launch nilorea-client (or
nilorea-client-admin if you have an admin build).
Main menu → Settings lets you set the server host/port, display options, and audio volumes before connecting. About shows the game version, the network protocol version and the licence summary — quote both numbers in a bug report, and check the protocol number first if a server refuses your connection (it must match the server’s). Start connects.
On connect the client downloads and hash-checks what it needs. This is automatic. The install itself is small (~8 MB — the menus, font and translations); on first login it pulls a few MB of game data, and artwork, sounds and music arrive as you first encounter them. A brand-new area may show plain shapes for a moment on a slow link while its art catches up. Everything is cached, so it is fetched once and not again.
One consequence worth knowing: content updates reach you
without reinstalling. New items, quests or artwork show up on
your next login. If artwork ever looks wrong or out of date,
nilorea-client --clear-cache throws the downloaded copy
away and fetches it again — nothing you own or have done is stored
there, only downloaded files. You do not wait for that first few
MB. The login screen comes up as soon as the connection is made
and the download continues behind it, with a
Downloading assets... n/m line along the bottom edge — and
on a first login it keeps running behind the prologue you read next. It
has normally finished before you have typed your password; if it has
not, the game finishes it before the character-creation step and shows
the usual progress screen for the remainder.
Entering the world waits until the world is ready. After you log in (or travel to another map) the loading screen stays up until the area around you is fully in place — terrain, buildings, other players and their gear. It is deliberately a short pause instead of dropping you into a world that is still assembling itself. If something is slow to arrive the game gives up waiting after ~15 s and shows you the world regardless, so you are never stuck on a loading screen.
Login screen: enter an account name + password, or create a new account. Passwords are salted + SHA-256 hashed on the server; weak passwords are rejected.
First login only — pick your character
body (the types discovered under assets/players/,
e.g. man / woman) and complete the stat
roll to choose your starting attribute spread, then
confirm.
You spawn into the world. New characters are walked through a short tutorial (see §10) by Apprentice Sven near the plaza spawn.
One account can hold several characters; your friends list, block list, and the account-wide “tutorial done” flag are shared across all of them.
Lost your password? A player changes their own with
/password(§9). If you’re fully locked out, only an operator can reset it (see the Admin Guide).
Almost every panel is a toggle bound to one key, and every UI key is rebindable from the Shortcut Manager (F2). Defaults:
| Key | Panel | What it’s for |
|---|---|---|
| I | Inventory / Character | Items, equipment, stats, level, XP, carry capacity (the character sheet is merged in here) |
| P | Stat Distribution | Spend earned stat points (§5) |
| K | Spellbook | Browse spells, assign them to the hotbar |
| L | Skillbook | Browse active/passive skills, assign to hotbar |
| C | Crafting | Recipes + crafting (§7) |
| J | Quest Log | Active quests, objectives, rewards |
| O | Friends List | Online friends, add/remove, invite, whisper, block |
| M | Minimap | Local fog-of-war view of nearby tiles & entities |
| Shift+M | World Map | Full region map; zoom/pan; landmarks (§4) |
| H | Quest Compass | A dial pointing at your active quest target |
| Shift+B | Hotbar | The 1–9 quick-use bar |
| U | Player HUD | HP / MP / Stamina / XP bars |
| N | Status Effects | Buff/debuff duration strip |
| Y | Day / Night wheel | Shows server time of day |
| Enter | Chat | Open chat input; Shift+Enter toggles the chat panel |
| F10 | Help | In-game keybinding reference |
| F2 | Shortcut Manager | Rebind any UI/gameplay key |
| Escape | — | Close the topmost panel / cancel |
Full table, including camera controls and debug overlays: keybindings.md.
0 resets) and pan
(left-drag when zoomed in). Your zoom is remembered between
sessions.map-<id>). Owning it
upgrades the World Map for that area to a detailed terrain view; without
it you only see explored chunks as fog. Map items are
bound (you can’t drop or trade them).Combat is target-based. The server resolves every hit; the client only sends “I want to attack/cast at this target”.
auto_attack action to a hotbar slot to keep attacking the
current target. It stops when the target dies or leaves range, when you
move with the keyboard, when a panel opens, or on Escape.Hitting staggers — and so does getting hit. Every connecting hit — melee, arrow, spell or area skill — briefly stops the enemy where it stands. It does not stop it fighting back: the stagger holds its feet, not its weapon, so it will swing at you again as soon as its own attack cooldown is up. Only a real stun skill prevents an enemy from acting.
Taking a hit staggers you the same way, but much more briefly, and it cannot be chained: however many enemies are on you, you only flinch once every so often rather than once per hit. Being surrounded is meant to be dangerous, not to take the controls away from you. Your own attacks are never blocked by it — you swing back on your own cooldown, exactly like the enemy does. (Operators tune both sides separately; see the admin guide.)
Closing in to attack. When you attack a target that is out of reach, the server walks you in and stops you just off the target’s body — not at the far edge of your weapon’s reach. Longer weapons no longer leave you standing further back for no reason, and larger creatures push you out further than small ones. Your weapon’s reach is unchanged: it still decides whether a swing connects, it just no longer decides where you stop walking. A bow is the deliberate exception — an archer stops as soon as the target is in range rather than closing in.
How enemies close in. An aggressive enemy paths to your position and stops at its own engagement range — which is shorter than most weapon ranges, so a spear or a bow lets you open the fight before it can reach you. It re-aims on a short interval as you move, and a connecting hit of any kind (melee, arrow, spell, area skill) stops it where it stands. Being hit never prevents an enemy from swinging back — only a real stun does that.
Stamina gates physical actions (swings, shots, some skills) and regenerates out of combat. Status effects (buffs, debuffs, stun, damage-over-time) show in the strip toggled with N.
Death & respawn: you respawn after a short delay
at your last checkpoint. The exact respawn/regen timings and all
hit/dodge/crit/damage-reduction math are server-tuned — see stats.md and the server config (config_audit.md).
The game is classless — there are no fixed classes locking you out of weapons or spells. You “build anything” by choosing your stat spread and your gear/spells/skills.
stats.md (the source of truth — this
guide does not repeat the formulas).requirements block). Spells and skills
are gated at buy/learn time. The shops and equip
actions enforce these — there is no class gate, only level + stats.The crafting system’s full design (materials tiers, consumables,
weapon enhancement oils, permanent -honed transmutes) is
documented in crafting.md.
/block <name>
to suppress their chat and trade requests;
/unblock <name> removes it; /blocklist
shows your current list./invite <name> (works for
off-screen players and online friends too). The target gets a popup to
accept./leave./kick <name> — remove a member./transfer <name> — hand over leadership./loot free|rr|ng — set the loot mode:
free-for-all, round-robin, or
need/greed.Press Enter to open chat. Channels: Local (nearby), Zone (your map), Global (everyone), and Whisper (one person). Pick a channel or use a command:
| Command | Effect |
|---|---|
/say <msg> |
Local channel |
/yell <msg> |
Zone channel |
/global <msg> |
Global channel |
/tell <name> <msg> (also /t,
/w, /whisper) |
Whisper one player |
/block <name> /
/unblock <name> / /blocklist |
Manage your block list |
/password <current> <new> |
Change your own account password |
/invite <name> |
Invite to party |
/leave (or /pleave) |
Leave your party |
/kick <name> |
Kick a party member (leader) |
/transfer <name> |
Transfer party leadership (leader) |
/loot free\|rr\|ng |
Set party loot mode (leader) |
While chat input is open, gameplay keys are suspended — only typing, Enter (send) and Escape (cancel) work.
security.md and config_audit.md.config/client.json; they’re never sent to the
server.tooltip_delay_sec in
config/client.json, next to
tooltip_max_width_px, which is how wide a tooltip runs
before it wraps./password <current> <new> (see §9).This guide deliberately does not duplicate the full key table — it would drift. The authoritative, always-current list (with rebinding via F2) is:
keybindings.md.This guide is in the game too. The Guide button at the top right of the Help dialog (F10) opens it in its own window — in French when the game is set to French. Links to the key table and the story open in the same window (Back returns to the page you came from); links to the technical references are shown as plain text there. Escape closes the guide first, then the Help dialog.
Found something in the game this guide doesn’t mention? That’s a
documentation bug — per the project’s “reference every meaningful change
in the guide, EN + FR” rule (root CLAUDE.md). Please flag
it.