PvP & Arena

Everything that makes this a kit-driven PvP core rather than a general server plugin — arena/spawn setup, combat, kits, the token shop, and the minigames layered on top.

Region & Arena Regen /region, /awild region

The plugin splits the world into two WorldGuard regions: spawn (a safe zone — no PvP, no block breaking/placing, a blocked-items list) and arena (the PvP zone, periodically regenerated).

region:
  world: ""            # written automatically by /region
  spawn-name: ""
  arena-name: ""

spawn:
  blocked-items: [TNT, FLINT_AND_STEEL, LAVA_BUCKET, WATER_BUCKET]

max-build-height: 150   # -1 disables the cap — stops sky-base/tower stalling in the arena

regen:
  enabled: true
  interval: "20m"        # how often the arena auto-restores to its last snapshot
  lift-above-y: 120.0    # players caught inside are lifted clear a moment before restore
  blocks-per-tick: 20000 # restore budget per tick, keeps huge arenas from freezing the server

TNT placed inside the arena auto-ignites immediately (no flint & steel needed) — configurable fuse via tnt-fuse-ticks (default 80 = 4 seconds, matching vanilla lit TNT).

Combat & Kill Rewards

Landing a hit on another player starts a combat tag on both of you. Getting tagged blocks every command except a configurable allowlist — logging out or teleporting away doesn't save you from a fight already in progress.

combat:
  combat-seconds: 15          # tag duration; another hit refreshes it back to this value
  kill-reward-ruby: 5.0       # rubies credited for every PvP kill — 0 disables it
  kill-broadcast: true        # announce every PvP kill server-wide
  allowed-commands: [msg, r, tell, whisper, m]

alphawildsystem.combat.bypass lets a player use any command while tagged — staff-only by default.

Kill Reward Milestones /killrewards

A one-time claimable menu of lifetime PvP kill milestones (tracked via the vanilla player_kills statistic — the same number the scoreboard shows). Each tier is claimable exactly once per player.

# kill-rewards.yml
tiers:
  - {kills: 5,    reward: 15}
  - {kills: 10,   reward: 30}
  - {kills: 25,   reward: 75}
  - {kills: 50,   reward: 150}
  - {kills: 100,  reward: 300}
  # ... up to kills: 4000, reward: 12000

Kits /give kit

Every death (and /give <player> kit) rolls a fresh random kit — one random item per category, plus a random amount of blocks/explosives, from kits.yml. Enchant strength scales the opposite way from material tier, so the best material doesn't also roll the best enchants:

enchant-tiers:
  netherite: {protection: 1, sharpness: 1}   # weakest enchants — stats already win
  diamond:   {protection: 2, sharpness: 2}
  iron:      {protection: 3, sharpness: 3}
  gold:      {protection: 3, sharpness: 3}
  chainmail: {protection: 4, sharpness: 4}   # strongest enchants — stats already lose

blast-protection-chance: 20   # % chance a NON-netherite armor piece also rolls Blast Protection

Custom Items

Ten special items usable only inside the arena. One is rolled into every kit; admins can hand out a specific one with /give <id> <player>. Set enabled: false on any item in custom-items.yml to pull it from the kit roll and stop /give from handing it out.

Each item has its own cooldown-seconds plus item-specific tuning (throw-speed, force, radius, range, damage, duration-seconds, etc.) in custom-items.yml.

Token Shop /shop

A 7-category ruby token shop, fully config-driven from shop.yml — icon/material/price/amount for every item are read fresh each time the menu opens, no restart needed after /awild reload. Includes inventory-overflow protection, drag-drop protection, and price deduction before the item is handed over.

Chat Color /chatcolor, /cc

Opens a menu of 14 preset two-stop gradients (red, blue, light, yellow, orange, pink, brown, purple, green, lime, cyan, end, halloween, warden) — picking one applies that gradient to the player's own chat messages going forward. Add, remove, or recolor options freely in chatcolors.yml.

# chatcolors.yml
colors:
  cyan: {material: CYAN_CONCRETE, name: "$AFCFᴄʏᴀɴ", start: "#36AFCF", end: "#77C8D9"}
  warden: {material: SCULK_CATALYST, name: "�E5B64ᴡᴀʀᴅᴇɴ", start: "#0E5B64", end: "#2AE7F5"}
  # ... 12 more presets

Clear Lag

Every interval-minutes, all dropped items on the ground are swept server-wide — with a warning 15 seconds ahead of time so nobody loses something they just dropped mid-fight. /clearlag only toggles a player's own warning message; the sweep itself always runs for everyone regardless.

clearlag:
  enabled: true
  interval-minutes: 5

Totem Practice /totempractice

A whack-a-mole reflex minigame — click the totem before it moves. Useful for players practicing totem-popping timing outside of a real fight.