Player Guide

Nilorea — Player Guide

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:

🇫🇷 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.


1. Getting started

  1. Launch nilorea-client (or nilorea-client-admin if you have an admin build).

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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).


2. The screen — HUD & panels

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.


3. Moving & the world

Maps & navigation aids

Travel


4. Combat

Combat is target-based. The server resolves every hit; the client only sends “I want to attack/cast at this target”.

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).


5. Character progression

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.


6. Items, inventory & economy


7. Crafting

The crafting system’s full design (materials tiers, consumables, weapon enhancement oils, permanent -honed transmutes) is documented in crafting.md.


8. Social & multiplayer

Friends & block list (O)

Party / groups

Trade


9. Chat & commands

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.


10. Quests, NPCs & the tutorial


11. PvP


12. Account & settings


13. Quick keybinding reference

This guide deliberately does not duplicate the full key table — it would drift. The authoritative, always-current list (with rebinding via F2) is:

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.