Documentation

Zone Permissions

Zone owners have full control over who can enter, build, and manage within their zone. The permission system uses roles — predefined or custom — to grant specific abilities to players.

Roles

Every zone comes with built-in roles:

Role	What They Can Do
Owner	Everything. Full control over the zone.
Admin	Manage roles, members, settings, and sub-zones. Can't transfer or delete the zone.
Moderator	Kick/ban players, manage chat, review reports.
Builder	Place and remove blocks, upload assets, run scripts.
Tenant	Build within their assigned sub-zone only.
Visitor	Enter the zone, interact with objects, chat. Default role for everyone.

Custom Roles

Zone owners can create custom roles with granular permissions. For example, a "Shop Staff" role might allow building within a sub-zone and moderating chat, but not managing other players.

Custom roles have:

A name and color (for display in chat and name tags)
A specific set of permissions
A priority level (higher priority roles override lower ones)

Permissions

Permissions are additive — if a player has multiple roles, they get the combined permissions of all their roles.

Available Permissions

Permission	Description
`zone.build`	Place and remove blocks anywhere in the zone
`zone.manage`	Edit zone name, description, visibility, and configuration
`zone.roles`	Create, edit, and delete roles
`zone.members`	Assign and remove member roles
`zone.ban`	Ban and kick players from the zone
`zone.subzones`	Create, edit, and delete sub-zones
`zone.portals`	Create, edit, and delete portals
`zone.scripts`	Execute and manage scripts in the zone
`zone.assets`	Upload and manage assets in the zone
`chat.moderate`	Delete messages, mute players in zone chat
`subzone.build`	Place and remove blocks within assigned sub-zone
`subzone.assets`	Upload assets within assigned sub-zone
`subzone.scripts`	Execute scripts within assigned sub-zone

All permissions are enforced server-side. Block operations are validated in real-time by the dedicated server — it checks the player's permissions from their PlayerState before allowing any block placement or removal.

Block Limits

Each zone tier has a maximum block count, enforced server-side:

Zone Tier	Max Blocks
Plot	10,000
District	100,000
Region	500,000
Realm	2,000,000

Bans

Owners, admins, and moderators can ban players from a zone:

Type	Duration	Effect
Kick	Instant	Removed but can re-enter
Temp Ban	1h – 30 days	Cannot enter until ban expires
Permanent	Indefinite	Cannot enter; zone hidden from their search

Banned players can appeal through the game overlay. The zone owner decides whether to lift the ban.

Zone Settings

These zone-wide settings act as master toggles that affect all players:

Setting	Values	Description
PvP	on / off	Whether players can damage each other
Flight	on / off	Whether players can fly
Building	on / off	Master toggle — overrides all build permissions
Scripts	on / off	Master toggle — overrides all script execution
Gravity	0.0 – 2.0	Gravity multiplier (1.0 = normal)
Weather	none / rain / snow / fog	Environmental effects
Time of Day	fixed / dynamic	Lock the sky or let it cycle
Max Players	varies by tier	Per-instance player cap (see below)
Entry Fee	0+ credits	Charge visitors to enter (public zones)

Player Capacity

Each zone tier has a maximum concurrent player count:

Zone Tier	Max Players
Plot	20
District	50
Region	200
Realm	500

When a zone is full, new players will receive a "zone is full" message and will need to wait for a spot to open.

Managing Members

From the zone management overlay or web dashboard:

Invite — send an invite to a specific player or generate a shareable invite link
Assign Roles — give a player one or more roles
Remove Roles — revoke a player's role
View Members — see all players with roles in your zone
Review Bans — manage active bans and appeals