❄️ Snowball Event — Villager Shoot

Players throw snowballs at villagers for quick festive rewards—perfect for hubs. Ties into the shards economy and other events.

🎮 What happens in-game?

• On hit → per-player cooldown check → roll a reward by chance.
• Reward executes console commands, sends messages, optional sound/firework.
• Pairs well with Shards, Advent, and Santa.

⚙️ Configuration (YAML)

# Configuration for snowball hitting mechanics
villager-shoot:
  rewards:
    default:
      cooldown: 30 # Cooldown per player (seconds)

      # Reward 1: Small shard prize
      small_prize:
        chance: 80
        commands:
          - "shards give %player% 5"
        messages:
          - "&aHit! The villager is stunned and drops 5 shards."
        event:
          firework: false
          sound: "BLOCK_SNOW_PLACE"

      # Reward 2: Large shard prize
      large_prize:
        chance: 20
        commands:
          - "shards give %player% 25"
        messages:
          - "&aCritical Hit! The villager drops 25 shards!"
        event:
          firework: true
          sound: "ENTITY_ARROW_HIT_PLAYER"

Keys explained

• cooldown — per-player seconds to prevent spam.
• chance — weight for random pick across entries.
• commands — console side; %player% supported.
• messages — color codes allowed.
• event.firework / event.sound — feedback FX.

🧭 Enabling

1. Register listener for ProjectileHitEvent.
2. Check snowball → villager, shooter is player.
3. Apply cooldown, roll reward from config, run commands/FX.
4. (Optional) Restrict to named villagers (e.g., “Elf”).

🎯 Balancing tips

• Common 3–10 shards; rare 20–50.
• Cooldown 30–60s works well.
• Always use sounds; fireworks for rare wins.
• Rotate rewards weekly.

🧪 Variations

medium_prize:
  chance: 15
  commands:
    - "shards give %player% 12"
  messages:
    - "&aSolid hit! &f+12 shards"
  event:
    firework: false
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"

cosmetic_hat:
  chance: 5
  commands:
    - "give %player% leather_helmet 1"
  messages:
    - "&dFestive bonus! &fYou found a Santa hat!"
  event:
    firework: true
    sound: "ENTITY_PLAYER_LEVELUP"

🧰 Troubleshooting

• Nothing happens — verify listener registration and config path.
• Spammy — raise cooldown, lower chances/values.
• No sound/firework — confirm sound ID and WG flags.

✅ Why players love it

• Zero friction mini-event.
• Constant feedback (messages/FX).
• On-theme and synergistic with the whole event loop.