-
Notifications
You must be signed in to change notification settings - Fork 0
AFK Areas
AFK areas define the locations in which players enter the dedicated AFK_AREA state.
Each area can have its own region, teleport destination, priority and reward configuration.
Supported region types:
- Native cuboid
- WorldGuard
Every area has a stable technical ID, for example:
spawn-afk
IDs may contain lowercase letters, numbers, - and _. The first character must be a lowercase letter or number.
New areas initially use their technical ID as their display name.
Rename the display name without changing the ID:
/afkarea rename spawn-afk Spawn AFK Area
Set both corners:
/afkarea pos1
/afkarea pos2
Both positions must be in the same world.
Create the area:
/afkarea create spawn-afk cuboid
The corner order does not matter.
/afkarea create spawn-afk worldguard spawn_region
The WorldGuard region must exist in the world where the command is executed.
Stand at the desired arrival location and run:
/afkarea setteleport spawn-afk
AFK Area stores world, coordinates, yaw and pitch.
The teleport destination may be outside the region and may be in another world.
Test it with:
/afkarea tp spawn-afk
Configured in config.yml:
afk:
auto-teleport:
target-area: spawn-afkThe same target is used by /afkarea.
/afkarea pos1
/afkarea pos2
/afkarea redefine spawn-afk
This changes only the cuboid region.
/afkarea setregion spawn-afk another_region
Set priority:
/afkarea setpriority spawn-afk 10
Higher numbers are checked first.
If equal-priority areas overlap, the technical area ID is used as a deterministic tie-breaker.
/afkarea list
/afkarea info spawn-afk
info shows name, enabled state, priority, region and teleport destination.
/afkarea delete spawn-afk
If the deleted ID is still configured as the automatic target, automatic teleporting and /afkarea will no longer have a valid destination.
New areas are enabled by default.
Disabled areas are excluded from runtime region detection and automatic teleporting.
The enabled state is persisted, but there is currently no dedicated administration command for changing it.
Successful area changes rebuild active regions and resynchronize online players. A restart is not required.
AFK Area Wiki
Setup
Administration
Integrations & Storage
Help