Reference: ZoneDef.txt

Purpose

Contains zone information for all default zones. These include official overworld and dungeon zones, as well as some development areas.

Note: Player groves start at Zone ID 5000 and are not included in this list. Accounts without the special debug permission may not use the build tool in any IDs below 5000. This helps to prevent some exploits during gameplay.

ZoneDef folder

This same block format is used for grove entries present in the ZoneDef subfolder. Unlike the master file (ZoneDef.txt) which contains all the official gameplay zones, the grove entries are kept isolated from each other for easier editing.

File Format

Resembles INI format with structured blocks.
Comment character: semicolon (;)
Each line is split into a key=value pair on the first "=" symbol.

Block Format

Property Type Description
[ENTRY] N/A Begins a new entry.
ID Integer The ID of the zone. This is used as a key into the table. Must be unique.
ACCOUNTID Integer For groves, this is the Account ID who owns the zone. The owner is free to perform all grove editing functions. There may only be one owner.
DESC String Description. Has no effect on the client or server. It merely serves as a sort of comment field which is preserved in data autosaves.
NAME String The name of the zone. This is used in the client for players to identify the location.
TERRAINCONFIG String Required by the client. This indicates the terrain template to use.
ENVIRONMENTTYPE String The default environment type loaded by the client.
MAPNAME String The map resource loaded by the client for browsing the world map.
REGIONS String Not used. A secondary client map resource that attempts to define locations by a color map.
ShardName String This is the name that appears in parenthesis in the space above the client minimap. The server does not actually have shards.
GroveName String When players create accounts, this is the grove name that has been chosen. It must be unique.
WarpName String This is the exact grove name used for warp commands.
PageSize Integer Scenery tiles will be this many units across. Do not change the page size when there are any existing scenery tiles, or it may cause problems where the correct tiles will not be loaded. This is distinct from terrain tiles, which are always 1920 units wide. Official zones often use smaller tile sizes, presumably to reduce the amount of scenery in a particular tile and improve data fetch times.
MaxAggroRange Integer If present, this value can be used to enforce an upper limit to the global creature aggro range, specific to that instance. This is expressed in map units. 10 units = 1 meter.
MaxLeashRange Integer If present, this value can be used to enforce an upper limit to the global creature leash range, specific to that instance. The leash range is the maximum tether distance that a creature may stray or attack around its spawn point. This is expressed in map units. 10 units = 1 meter. The default is 500.
DefLoc Int,Int,Int Three integers, separated by commas. These represent the default X,Y,Z coordinates that players will appear when they are warped into a zone.
Persist Bool Not recommended for use. If set to 1, instances will not be unloaded even if there are no players in them. Default value is false.
Instance Bool If set to 1, this zone is instanced. Players not in a party will spawn into separate instances. This is also used internally by the server to determine if the zone should behave as a dungeon.
Grove Bool If set to 1, this zone is considered a grove, and has some modified rules for warping. Groves are typically public-access zones that can be freely warped to if the player is at a sanctuary, or in a grove. Positional warping is also freely enabled within zones. User generated groves start at zone ID 5000. Due to client safeguards, standard players are not able to access the build tool if their zone ID is below that.
Arena Bool If set to 1, this zone will appear in the PvP arena list. Arenas also have slightly altered warp rules, as players are freely able to enter them from sanctuary locations.
Audit Bool If set to 1, scenery edits in this zone will be audited (saved to a log file). By default this applies to all zones under ID 5000, since they are not expected to be groves.

For audits to work, make sure SceneryAuditAllow is enabled in ServerConfig.txt.

DropRateProfile String The drop rate profile to use for this instance. If not specified, instance will be used for all zones where Instance=1, and standard for otherwise. If this value is custom set, it will override the default. In this case, make sure there is a matching profile name in DropRateProfile.txt.
EnvironmentCycle Bool If set to 1, players in this zone will see daylight cycling. There is a single server-wide daylight cycle that affects all zones with this flag. See the EnvironmentCycle field in ServerConfig.txt to change the actual daylight modes and cycle times.
PlayerFilterType Integer Specifies a filter mode to allow or deny players from warping. The following modes are provided: (0=None, 1=Whitelist, 2=Blacklist)
PlayerFilterID Integer List A list of integers, separated by commas. Each integer specifies the CreatureDef ID of a player that will be allowed or blocked based on the PlayerFilterType setting. For a whitelist, only players on the list will be allowed to enter. For a blacklist, only the players on the list will be blocked. This field adds IDs into a list. Use may optionally use this field on multiple lines to add more entries.
BuildPermission String A list of 5 integers, separated by a comma, and applied as a single configuration string. This allows zones to contain edit permissions for other players, separate from account permissions. The properties within this string can be described in the following way:
CDef,X1,Y1,X2,Y2

Where CDef is the CreatureDef ID of a player character. The others are coordinates of the top left and bottom right corners of a bounding box. These coordinates are expressed as scenery tile coordinates (see PageSize), not terrain tiles, and not world map units. Since this field only adds a single permission, you may use this field on multiple lines for more entries.