← Documentation
Staff Handbook

Settlers of Yore

How to moderate the world, manage players, translate chat, and build content — for Translators, Authors, Moderators, and Admins.

Access Levels

The role hierarchy

Every account carries one of four core roles. Each tier inherits everything below it — a Moderator can do everything an Author can, and an Admin can do everything anyone can.

Roles are assigned by an Admin through the admin console. Contact an Admin if a role change is needed.

Translator is a fifth role, off to the side Translator sits above Player but does not sit between Author and Moderator in the inheritance chain — a Translator does not automatically get Author's editing tools or Moderator's console access. It exists purely to give translation staff their own admin-panel entry point. See Translator Access below.
Command permissions can move Most chat commands' minimum role below is a default, not a hard limit — an Admin can raise, lower, or disable almost any command from the Feature Flags page without a deploy. If a command behaves differently than documented here, check Feature Flags before assuming this page is wrong.
Chat Commands

In-game commands

Typed directly into chat. Commands marked Player are available to everyone; the rest require the listed role by default (see the callout above).

CommandRoleDescription
/helpPlayerLists available commands. Client-side only.
/timePlayerReports the current in-game day/night time.
/islandPlayerRe-opens the Island Access window — a backup for players standing on their own island but not on the portal tile.
/tp <player>ModeratorTeleport yourself to a named online player. Queries the whole fleet if they're not on your node, and waits up to 3s for a reply.
/visit <player>ModeratorTeleport yourself directly onto a player's island — bypasses the portal and visitor list entirely. Works even if the owner is offline.
/ban <username>ModeratorSuspends the account and kicks them fleet-wide. Cannot target yourself, the built-in admin account, or an equal/higher role.
/timeout <username> [minutes]ModeratorTimes the account out for the given minutes (default 60) and kicks them fleet-wide. Same target restrictions as /ban.
/goto <area_id> [portal_id]AdminTeleport yourself to a portal in an area, through the normal portal-transfer path (safe across nodes).
/move <player> <area_id> [portal_id]AdminForce-warp a named player — online or not, on any node — to a portal.
/item <item_id> [qty]AdminAdds an item to your own inventory.
/give <player> <item_id> [qty]AdminAdds an item to a named player's inventory. Works even if they're offline.
/gold <player> <delta>AdminAdjusts a player's gold by a positive or negative amount (never below 0).
/giveessence <player> <amount>AdminGrants island essence (the terrain-editing currency) to a player.
/resetislandAdminResets your own island back to its starter layout. There is no command to reset someone else's island — use the admin panel (see Islands below).
/godAdminToggles god mode for yourself — see the callout below.
What /god actually does God mode is combat-only: monsters neither aggro onto you nor retaliate if you're already their target. It does not grant noclip, unlimited resources, or bypass tool requirements. It's tracked per-player and replicated fleet-wide, so it works correctly even if you're proxied onto another node. It clears automatically on logout.

/give, /gold, /giveessence, /visit, and /move all resolve their target purely by name lookup in the database, so they work against offline or other-node players. /tp is the exception — the target has to actually be online.

Chat moderation (automatic, not a command)

Two independent, always-on passes run over every chat message, both toggleable from Feature Flags:

Profanity filter
Masks common profanity with asterisks before a message is broadcast. Automatic — not a per-player setting.
Translation
Detects non-English chat and appends a translation in brackets, e.g. Bonjour! (Hello!). Fails silently if the translation call errors — the original message still sends.
Admin Console
Minimum access: Moderator Some sections require Admin

Managing the world

The admin console is a separate web application at /admin. Log in with the same credentials as the game.

What you can see

Moderator Online Players

A live list of every player currently connected, showing their username, area, and connection status. Useful for monitoring activity and spotting unusual patterns.

Moderator Users

A searchable list of all registered accounts with their status, role, and email confirmation state. From here you can suspend accounts, send password resets, and (as Admin) change roles.

Moderator Areas

A summary of every area in the game — player counts, area IDs, and current load.

Admin Dashboard

Time-series graphs for CPU usage, memory, player count, and NPC count. Switch between last hour, last 12 hours, last 24 hours, or last 7 days. Peak-of-all-time and peak-since-server-start values appear as fixed readings above the graphs. On production, a status card also reports whether the shared remote LED display is connected, which fleet node is currently driving it, and when it last updated or errored — the way to confirm the physical dashboard is alive without SSHing into the box.

Admin Server Registry

Live status of every server node in the fleet — IDs, WebSocket addresses, owned areas, and load metrics.

Admin Network Simulation

Inject artificial packet delay and loss to test how the game handles poor connections without touching a real client.

Admin Feature Flags

Full control over every feature flag in the game — including the cmd_* flags that set each chat command's effective minimum role (see Chat Commands above), the chat moderation flags, and other rollout switches like subscriptions. Each flag can be overridden per-role or per-user on top of its global default, and changes apply immediately with no deploy.

Admin Editor Access

Grant or revoke per-area content-editing permissions for Author-and-above users. See the Area Editor section below for details.

Admin Translator Access

Grant a Translator (or Author/Moderator) permission to translate specific languages. Unlike Editor Access, this is scoped by language rather than by area — Admins can translate every language without a grant.

Admin Islands

Grant essence to a character, reset a single player's island back to its starter layout, or (with a typed confirmation phrase) reset every island fleet-wide. A player online and standing on an island you reset is kicked back through the portal flow rather than hot-swapped in place.

Managing user accounts

In the Users list, click any row to expand its actions:

Suspend
Permanently ban the account. The player cannot log in until unsuspended.
Timeout
Temporary suspension until a chosen date and time.
Unsuspend
Lift an active suspension or timeout immediately.
Send reset
Email the user a password-reset link. Also confirms their email if they never did.
Change role
Admin only. Promote or demote between Player, Translator, Author, Moderator, and Admin.
Delete
Admin only. Permanently removes the account and all associated data.
Protected accounts cannot be modified by anyone — this covers the built-in admin account and your own account. You cannot suspend or demote yourself.

Granting editor access

Go to Editor Access in the left nav. A table lists every current permission grant. To give someone access to an area:

  1. Make sure their role is at least Author — use the Users panel to promote them first if needed.
  2. In the Grant Access form, enter the user's ID and the area ID (for example, start).
  3. Click Grant. The user can now open that area in the editor immediately.

To remove access, click Revoke next to the relevant row in the table. An Author or Moderator without at least one grant won't see the content editor in their nav at all — only Admins get it automatically.

Granting translator access

Go to Translator Access in the left nav. Grants are per-language rather than per-area: pick the user and the language they're permitted to translate for. A Translator without any grant sees the translator tooling but has nothing to act on until granted at least one language.

Content Editors
Minimum access: Admin

Items, NPCs, quests, achievements & game config

Alongside the Map Editor (Author-accessible, covered in the next chapter), the editor at /editor has several Admin-only pages for authoring game content. Each opens a list of entries organized into a drag-and-drop-reorderable folder tree, with a detail dialog for the selected entry.

Item Editor

Tabs: Common, Harvesting, Attack, Defense, Modifiers, Requirements, Consumable. Icons are chosen from the item spritesheet with a click-to-select popup picker, and the preview pane renders through the same sprite code the live client uses, so it matches in-world appearance exactly.

NPC Editor

Tabs: Appearance, Light Source, Animal, Equipped Items, Combat Stats, Loot, Dialogue — Combat Stats and Loot only appear for NPCs that need them. Use the Animal tab plus a Harvesting entry to make a passing animal harvestable (see the player handbook's Harvesting section); leaving Combat Stats empty makes an NPC permanently non-attackable.

Quest Editor

A quest has a giver NPC, an offer/accept/decline dialogue hook, and an ordered list of stages. Each stage is its own collapsible card with a requirement (item turn-in, kill count, interact, or report), a turn-in NPC, and its own embedded 3-page mini dialogue (In Progress / Turn In / After Turn In). A stage's turn-in NPC can differ from the quest giver, so multi-stage "delivery" quests are supported.

Achievement Editor

Define an id, name, description, optional icon (picked from the same visual tile picker used elsewhere), a single requirement (harvest / kill / craft count, optionally scoped to a specific item or NPC), and an optional reward of gold and/or items. Achievement names and descriptions are never shown mid-progress — players only find out when they unlock one.

Game Config

One tabbed page covering server-tunable values that hot-reload the moment you save: Resource Loot Tables, Fishing, Skills, Crafting Recipes, Message of the Day, HP Regen, and Day/Night Cycle. Loot and Fishing tables now use an independent percentage chance per entry rather than relative weights — each entry rolls on its own, so more than one thing (or nothing at all) can drop from a single swing.

View as — the editor's left nav has an Admin-only role simulator that lets you preview the panel as a Moderator, Author, Translator, or Player would see it, useful for checking a permission change without logging into a second account.
Area Editor
Minimum access: Author Must have been granted at least one area

Building the world

The area editor is a full map and tile-properties editor that runs in your browser at /editor. Log into the game first — the editor reads your session automatically. If you're not logged in you'll be sent back to the game.

Changes go live in seconds. When you save, the server picks up the new file within 300 ms and hot-reloads — players already in the area see the update without reconnecting.

The interface

Map Editor
Paint, erase, fill, and shift-select tiles across multiple layers. Switch areas from the dropdown at the top.
Tile Properties
Set collision directions and shadow behaviour for individual tile types in the current tileset. Changes affect every placed instance of that tile.

Working with layers

Areas have six fixed layers, drawn in order from bottom to top:

ground
Terrain base - grass, stone, water.
ground decoration
Flowers, cracks, puddles - things that sit on the ground.
objects
Walls, trees, furniture - the main solid world.
object decoration
Decorations overlaid on objects.
tops
The upper parts of tall objects (rooftops, treetops). Renders above players.
tops decoration
Details on tops - trim, foliage, etc.

Toggle layer visibility with the eye icons in the layers panel. Painting always targets the currently selected layer.

Tools

Paint (P)
Click or drag to place the selected tile.
Eraser (E)
Click or drag to remove tiles from the active layer.
Fill (F)
Flood-fill a contiguous region with the selected tile.
Pick (O)
Click a placed tile to select it in the picker (eyedropper).
Shift (H)
Drag to move a rectangular selection of tiles on the active layer.
Ctrl+Z
Undo (up to 50 levels).
Flip H/V
Mirror the selected tile horizontally or vertically before placing.

The right-hand picker panel has separate Tiles and Stamps tabs; switching tabs swaps only that tab's own default tool, so an active Eraser, Fill, or Marker tool isn't reset just by switching. Your tool selection and other prefs now save immediately, so a reload mid-edit won't lose them.

Markers

Markers are non-tile placements handled in their own panel. The two structural ones are required for a working area:

Start
Where players spawn when they enter this area from a different one.
Link
Connects this area to a neighbouring one at the edge where it's placed.
Sound
An ambient sound source with a radius. A Plays During dropdown restricts it to Day only, Night only, or Day & Night (default) — useful for things like crickets that should only play after dark.

Tile properties & collision

Switch to the Tile Properties panel, then click a tile in the picker to select it. The editor shows a diagram of the tile with 16 clickable segments — the blocking directions.

N_L / N_R
S_L / S_R
E_T / E_B
W_T / W_B
NE / NW
MH / MV

Each edge is split into two halves so a wall can block only part of a tile — useful for diagonal walls and door frames. Click a segment to toggle it. The collision map you see on tiles in the map editor updates immediately and saves with the tileset.

The shadow toggle controls whether the tile casts a visual shadow. Shadow fill darkens the tile itself; shadow V-flip mirrors the shadow projection vertically, useful for tiles that face the opposite direction.

Saving

The editor auto-saves 1.5 seconds after your last change. You can also save immediately with Ctrl+S. A version timestamp is recorded each save — if you edit an area locally with the tools dev server, the deploy process compares timestamps and keeps whichever version is newer, so production edits are never accidentally overwritten.

Creating a new area

  1. Open the area dropdown at the top of the map editor and choose New area.
  2. Set the area ID (lowercase letters and underscores, e.g. forest_north), name, width, and height in tiles. Choose a tileset.
  3. Paint tiles on the ground layer to give the area its base terrain.
  4. Place a Start marker (in the markers tool) to set where players spawn when they enter from a different area.
  5. Place Link markers at the edges to connect this area to neighbouring ones.
Islands

Supporting player islands

Every player can own a personal island, entered through an animated portal tile placed in the world (currently in the starting town). Islands aren't authored in the editor — players terrain-edit them live, in-world, spending a currency called essence per edit.

Visiting
A player must be granted visitor access by the island's owner before they can visit — Admins can visit (and edit) any island without a grant.
Contributing
A separate grant from visiting — a visitor cannot edit terrain unless also made a contributor.
Essence
Spent on every terrain edit (placing/removing land, raising/lowering elevation, adding slopes). Subscribers earn it passively, and a player who gifts someone a month of premium receives 500 essence per gift (the "Gift giver" amount on the admin Subscriptions page's Essence Rewards row); /giveessence or the admin panel can top a player up.

If a player reports being stuck in water or unable to reach their island, the most common fixes are: confirm they're using the portal (or /island if they're already on the island but off the portal tile), or as a last resort use /resetisland — the caller's own island only — or the admin panel's per-player island reset, which works on anyone's island and kicks them out cleanly if they're currently on it.

Account & Access

Account management

Changing your password

Log into the game, open your profile (click your character name), and use the Change password form. You'll need to enter your current password to confirm.

Forgotten password

  1. On the login screen, click Forgot password.
  2. Enter your registered email address and submit.
  3. You'll receive an email with a reset link valid for one hour. Click it, choose a new password, and log in.