zones.yml

Every zone is one file zones/<name>.yml (the file name is the zone id). New zones are copied from zones/_template.yml by /afkzoneadmin create. Edit the template to change what every new zone looks like. After editing a zone, run /afkzoneadmin reload.

Settings:
  Enabled: true
  Display-Name: "&d&lAFK Zone"
  Permission: ""
  Reward-Time: 60
  Random-Rewards: true
  Reward-Mode: "Both"
  Reset-Progress-On-Leave: true
  Priority: 0

Region:
  World: "world"
  Min: { X: 0, Y: 0, Z: 0 }
  Max: { X: 0, Y: 0, Z: 0 }

Protection:
  Prevent-Damage: true
  Prevent-Hunger: true
  Prevent-Mob-Targeting: true

Shards:
  Enabled: true
  Amount: 1
  Chance: 100.0

Action-Bar-Settings:
  Enabled: true
  Interval: 40
  Format: "&d&lAFK &8» &7Next reward in &d{next} &8» &7Shards: &d{shards}"

Boss-Bar-Settings:
  Enabled: true
  Title: "&d&lAFK ZONE &8» &7Next reward in &d{next}"
  Color: "PURPLE"
  Style: "PROGRESS"
  Progress: true

Enter-Actions:
  - "[message] &5[&d&lAFK Zone&5] &7You are now AFK in &d{zone}&7."
  - "[title] &d&lAFK ZONE;&7Enjoy your stay;10;40;10"
  - "[sound] BLOCK_AMETHYST_BLOCK_CHIME;1;1.2"

Leave-Actions:
  - "[message] &5[&d&lAFK Zone&5] &7You have left &d{zone}&7."

Rewards:
  reward1:
    Chance: 60
    Actions:
      - "eco give %player% 25"
  reward2:
    Chance: 25
    Actions:
      - "eco give %player% 50"
  reward3:
    Chance: 15
    Actions:
      - "eco give %player% 100"
      - "coins give %player% 50"

Settings

Key	Default	Description
Enabled	true	Whether the zone is active.
Display-Name	&d&lAFK Zone	Name shown in messages/displays ({zone}).
Permission	""	Node required to use the zone. Empty = public. Without it the player gets a silent denied session.
Reward-Time	60	Seconds between payouts.
Random-Rewards	true	true = roll one reward group by weighted Chance; false = run every group.
Reward-Mode	Both	What this zone pays: Shards, Commands, Both, or empty to inherit config.yml.
Reset-Progress-On-Leave	true	Reset progress toward the next payout when the player leaves.
Priority	0	Higher priority wins in overlapping zones.

Reward-Mode: Shards = only shards; Commands = only the zone’s Rewards; Both = both. If config.yml Shards.Enabled is false, this is ignored and zones always run their Rewards.

Region

The cuboid - usually written by /afkzoneadmin create. World, plus Min/Max X/Y/Z corners. Edit and reload to resize.

Protection

All default true: Prevent-Damage, Prevent-Hunger, Prevent-Mob-Targeting. Set to false to leave vanilla behaviour.

Shards

Key	Default	Description
Enabled	true	Whether this zone awards shards.
Amount	1	Base shards per payout (before boosters).
Chance	100.0	% chance the shard payout happens each interval.

Displays

Action-Bar-Settings (Enabled, Interval, Format) and Boss-Bar-Settings (Enabled, Title, Color, Style, Progress). Tokens, colors and styles are listed under Information → Displays. An [actionbar] action is pointless while the action-bar display is enabled - use [title]/[message]/[sound] for payout feedback.

Enter / Leave actions

Enter-Actions and Leave-Actions use the shared action syntax - see Information → Actions. Zone actions also get {zone}, {zone-id}, {reward-time} and {players}.

Rewards

Named groups, each with a Chance (relative weight) and Actions. With Random-Rewards: true, one group is chosen per payout by weight; with false, every group runs. Weights need not sum to 100. A line with no [tag] runs as a console command.