config.yml

Global settings. After editing, run /afkzoneadmin reload. A missing top-level section is a loud error, not a silent default.

Settings:
  Check-Interval: 20
  Save-Interval: 300

Wand:
  Outline:
    Enabled: true
    Interval: 10
    Spacing: 0.5
    Max-Points: 600
    Range: 64.0
    Selection-Particle: "HAPPY_VILLAGER"
    Zone-Particle: "END_ROD"
  Item:
    Material: BLAZE_ROD
    Name: "&d&lAFK Wand"
    Lore:
      - "&8AFK Zone"
      - ""
      - "&dUsage:"
      - "&5- &7Left-Click: &fPosition 1"
      - "&5- &7Right-Click: &fPosition 2"
      - ""
      - "&eThen run /afkzoneadmin create <zone>"
    Glow: true

Shards:
  Enabled: true
  Name-Singular: "Shard"
  Name-Plural: "Shards"
  Format: "#,##0"
  Abbreviate-Numbers: false
  Boosters:
    Enabled: true
    Permission-Boosters: true
    Permission-Prefix: "optimalafkzone.booster."

Shop:
  Enabled: true
  Default-Shop: "shards"
  Confirm-Purchase: true

Temporary-Icons:
  Not-Enough-Shards:
    Material: BARRIER
    Name: "&c&lError!"
    Lore:
      - "&7You don't have enough shards for this!"
  Limit-Reached:
    Material: BARRIER
    Name: "&c&lError!"
    Lore:
      - "&7You have reached limit for this purchase!"

Inventories-Sounds:
  "SHOP-OPEN": "BLOCK_CHEST_OPEN;1;1.2"
  "CONFIRM-OPEN": "UI_BUTTON_CLICK;1;1.4"
  "PURCHASE": "ENTITY_PLAYER_LEVELUP;1;1.6"
  "CLICK": "UI_BUTTON_CLICK;0.6;1.5"
  "PAGE-CHANGED": "ITEM_BOOK_PAGE_TURN;1;1"
  "NO-PAGE-FOUND": "BLOCK_NOTE_BLOCK_PLING;1;0.7"
  "FAILURE": "ENTITY_VILLAGER_NO;1;1"
  "ZONE-REWARD": "ENTITY_EXPERIENCE_ORB_PICKUP;1;1.2"
  "SHARDS-EARNED": "BLOCK_AMETHYST_BLOCK_CHIME;0.7;1.4"
  "BOOSTER-ACTIVATED": "ENTITY_PLAYER_LEVELUP;1;1.2"
  "WAND-SELECT": "BLOCK_NOTE_BLOCK_PLING;0.7;1.8"

Settings

Key	Default	Description
Check-Interval	20	Ticks between each player’s zone tick. Also the display refresh rate - keep at 20 or the action bar fades between updates. Progress is tracked in ticks, so timing stays exact.
Save-Interval	300	Seconds between player-data flushes to the database.

Wand

Wand.Outline controls the selection/zone particle outline; Wand.Item is the wand item.

Key	Default	Description
Outline.Enabled	true	Show the particle outline while selecting.
Outline.Interval	10	Ticks between outline refreshes.
Outline.Spacing	0.5	Distance between particles (smaller = denser).
Outline.Max-Points	600	Cap on particles per outline.
Outline.Range	64.0	Max render distance in blocks.
Outline.Selection-Particle	HAPPY_VILLAGER	Particle for the wand selection.
Outline.Zone-Particle	END_ROD	Particle for /afkzoneadmin outline.
Item.*	-	Standard item (Material, Name, Lore, Glow).

Shards

Key	Default	Description
Enabled	true	Master switch. When false, zones ignore Reward-Mode and always run their own Rewards.
Name-Singular	Shard	{currency} when amount is 1.
Name-Plural	Shards	{currency} otherwise.
Format	#,##0	Java DecimalFormat pattern.
Abbreviate-Numbers	false	Abbreviate large numbers (1.2k, 3.4M).
Boosters.Enabled	true	Master switch for boosters.
Boosters.Permission-Boosters	true	Enable permanent permission multipliers.
Boosters.Permission-Prefix	optimalafkzone.booster.	Prefix for permission boosters.

Shop

Key	Default	Description
Enabled	true	Master switch for the shop.
Default-Shop	shards	Which shops/ file /afkzone shop opens.
Confirm-Purchase	true	Show the confirm menu before buying.

Temporary-Icons

Two icons that flash in the clicked slot for ~2s as purchase feedback: Not-Enough-Shards and Limit-Reached. Each is a standard item. Deleting either sub-section is null-safe - the failure sound still plays.

Inventories-Sounds

Named sounds in "NAME;volume;pitch" form, used by the GUIs and reward events (XSound names, stable across versions). Keys: SHOP-OPEN, CONFIRM-OPEN, PURCHASE, CLICK, PAGE-CHANGED, NO-PAGE-FOUND, FAILURE, ZONE-REWARD, SHARDS-EARNED, BOOSTER-ACTIVATED, WAND-SELECT.