💚 The Grinch — World Boss

A seasonal boss with weighted abilities, taunts, contributor-based rewards, and an optional loot chest drop.

Configuration

grinch:
  enabled: true

  display_name: "&2&lThe Grinch"
  # Must be a valid Mojang username with a public skin
  skin: "L1lius"

  stats:
    health: 800
    speed: 0.32

  cosmetics:
    glowing: true
    thunder: true

  # AI pacing
  ai:
    tick_rate: 20                 # internal loop tick rate
    taunt_every_seconds: 25
    ability_every_seconds: 12

  messages:
    spawn_lines:
      - "&2The Grinch:&7 Ho ho—no. &cNo Christmas this year!"
      - "&2The Grinch:&7 I’ll turn your joy into &2silence&7."
    taunts:
      - "&2The Grinch:&7 Your cheer makes me sick!"
      - "&2The Grinch:&7 I’ll stuff your stockings with sorrow!"
    death_lines:
      - "&aThe Grinch retreats into the blizzard… for now."

  # Weighted abilities (higher = more often)
  abilities:
    roar_knockback:
      weight: 20
    snowstorm_slow:
      weight: 30
    shadow_dash:
      weight: 25
    summon_minions:
      weight: 25

  # Rewarding after death
  rewarding:
    top_contributors: 5            # reward top N damage dealers

  # Weighted reward buckets; each winner gets one bucket
  rewards:
    shards_big:
      chance: 40
      commands:
        - "shards give %player% 150"
      messages:
        - "&a+150 shards from the Grinch’s stolen stash!"
    diamonds:
      chance: 30
      commands:
        - "give %player% diamond 6"
      messages:
        - "&bSix frosty diamonds glitter in your hand."
    mythic_key:
      chance: 20
      commands:
        - "crate key give %player% Mythic 1"
      messages:
        - "&dYou received a &lMythic Key&d!"
    rare_title:
      chance: 10
      commands:
        - "lp user %player% parent addtemp grinchslayer 7d"
      messages:
        - "&6Title unlocked: &eGrinch Slayer &7(7d)"

  # Chest dropped at the death location (filled with Santa presents + optional extras)
  loot_chest:
    enabled: true
    min_gifts: 3
    max_gifts: 6
    announce: "&aA loot chest appeared at &f%x%,%y%,%z%&a!"
    extra_items:
      coal:
        material: "COAL"
        amount: 8
      gold_nuggets:
        material: "GOLD_NUGGET"
        amount: 16

How it works

• Stats & cosmetics: control health/speed and visuals (glow/thunder).
• AI pacing: a simple loop that handles taunts and ability casts on timers.
• Abilities: picked by weight (higher weight → more frequent). Implemented server-side (KB roar, AOE slow, dash, spawn minions).
• Messages: broadcast on spawn/taunt/death for drama.
• Rewards:
  • Top rewarding.top_contributors damage dealers each roll one reward bucket (by chance).
  • Commands run as console; %player% placeholder supported.
• Loot chest: drops at death position; filled with Santa gifts and optional extras.

Commands & Permissions

Balancing tips

• Health 600–1000 suits 10–30 players; tune speed for arena size.
• Keep ability weights varied; don’t spam one control effect.
• Use shard-heavy rewards early in season; shift to cosmetics/titles later.
• Announce chest coordinates for exciting “final rush”.

Troubleshooting

• Skin not applied — ensure the Mojang username exists and has a public skin.
• No loot chest — check loot_chest.enabled and WG region flags for chest placement.
• No rewards — confirm rewarding.top_contributors ≥ 1 and rewards.*.chance entries sum to something sensible.