Game configuration
Navigation: Configuration (drop-down menu)
Everything about the game world is stored in the database as configuration data, and all of it can be edited here. The drop-down groups the most-used parts of the configuration into their own pages; below that you always have the full configuration tree as a fallback.
Most configuration data is loaded when a game server starts. After a change, use Reload configuration and restart all game servers on the Servers page, or restart the server process.
System
Route edit-config/…SystemConfiguration/
The system settings are not part of the game configuration — they apply to the server process itself.
| Setting | Meaning |
|---|---|
| IP resolver | How the server determines the address it reports to the game client: Auto, Public, Local, Loopback or Custom. See Connect a game client. |
| IP resolver parameter | The fixed IP or host name, when the resolver is Custom |
| Auto start | Start the listeners of all servers when the process starts. Only applies to the all-in-one startup — distributed processes always start their listeners. |
| Auto update schema | Update the database schema automatically at startup. Only applies to the all-in-one startup; in a distributed deployment the update is started manually on the Setup page. |
| Read console input | Whether the all-in-one process reacts to commands typed in its console |
| Time zone id | The time zone used to interpret the time-of-day entries of periodic event schedules (invasions, Blood Castle, Devil Square, …). IANA ids such as Europe/Warsaw are recommended; when empty or unresolvable, UTC is used. |
These settings can also be given as start parameters or environment variables, which take precedence over what is configured here.
Game clients
Route edit-config-grid/…GameClientDefinition/
The client versions your server knows: version bytes, description, and the protocol/serializer which is used for them. A connect server and the endpoints of a game server each reference one of these definitions, which is how one server can serve several client versions on different ports.
General
Route edit-config/…GameConfiguration/{id}/hide-collections
The settings of the game configuration itself, without its (huge) collections. This is where the values live which most server operators want to change:
- Rates — experience rate, master experience rate
- Levels — maximum level, maximum master level, minimum monster level for master experience
- Money and items — maximum inventory/vault money, whether monsters drop money, item drop duration, maximum item option level on drop, excellent item drop level delta
- Characters — maximum characters per account, character name regex, maximum password length, maximum party size
- Formulas — the experience formula and master experience formula
- Misc — info range, recovery interval, letter settings, durability consumption
Monsters
Route edit-config-grid/…MonsterDefinition/
All monsters and NPCs with their attributes (health, defense, damage, movement speed, attack range), the attribute set used for battle, their drops, their intelligence (AI) and their merchant/quest role.
Merchant stores
Route merchants
A more comfortable editor for NPC merchants: pick a merchant and edit the items it offers with the graphical item storage editor instead of the generic form.
Character classes
Route edit-config-grid/…CharacterClass/
Stat attributes and their growth per level, level requirements, the evolution path from one class to the next, the home map, and the stat point gain per level.
Skills
Route edit-config-grid/…Skill/
Damage, mana and ability cost, range, target restrictions, the classes which can learn a skill, the master skill definitions and their dependencies.
Items
Route edit-config-grid/…ItemDefinition/
Item definitions with their requirements, level tables, possible options, sockets and the classes which may equip them. Items use a dedicated editor with a graphical representation instead of the plain generic form.
Drop item groups
Route edit-config-grid/…DropItemGroup/
Which items drop with which chance. Groups can be assigned globally, to a map or to a monster, which is how the drop tables are composed.
The chance of a group is a value between 0 and 1. Beware that groups are evaluated in order and the money group is usually the fallback — increasing one group's chance implicitly lowers what is left for the others.
Game maps
Route edit-config-grid/…GameMapDefinition/
Maps with their number, name, terrain, safe zone, level requirements, monster spawn areas, enter and exit gates, and the battle zone of event maps.
The spawn areas and gates are much easier to edit graphically — an edit page of a map links to the map editor.
Mini games
Route edit-config-grid/…MiniGameDefinition/
Blood Castle, Devil Square, Chaos Castle, Illusion Temple and the other events: entry requirements, ticket items, the spawn waves, rewards and the schedule at which they start. The time-of-day entries are interpreted in the time zone configured under System.
Warp list
Route edit-config-grid/…WarpInfo/
The entries of the in-game warp list: index, name, target gate, level requirement and cost.
Jewel mixes
Route edit-config-grid/…JewelMix/
The jewel stacking (mix/unmix) definitions.
Plugins, chat commands, map editor
The lower part of the drop-down leads to Plugins, Chat commands and the Map editor.
Full configuration
Route edit-config/…GameConfiguration/
The complete game configuration as one editable tree, including all collections which the General page hides. Everything that has no dedicated page can be reached from here — item options, item sets, quests, attributes, magic effects, crafting definitions, and so on.
The generic edit pages
Most configuration pages are generated automatically from the data model by reflection. There are two of them:
The grid (edit-config-grid/{type})
A sortable, searchable and paged list of all objects of one type, with these actions per row:
- Edit — open the object in the form
- Duplicate — create a copy, which is the fastest way to add a variant of an existing monster or item
- Delete — remove the object
…and an Add new button at the bottom.
The form (edit-config/{type}/{id})
A form with one input per property of the object, grouped by category. Referenced objects are shown as drop-downs, collections as editable sub-lists which lead deeper into the tree. The breadcrumb at the top is how you find your way back.
Some types have a specialized editor instead of (or in addition to) the generic form — items, item storages and maps.
The generic pages are a technical view of the data. They do not know the game rules, so it is possible to create inconsistent or invalid configurations with them. Some fields also can't be edited or created yet, because not every type has a corresponding component.
Change one thing at a time and test it, and take a database backup before larger edits.
Configuration search
The search box in the navigation area searches the whole configuration by name and jumps directly to the edit page of a result. It is usually much faster than walking the tree — if you know an item, monster or skill by name, search for it.