Christmas Season

Christmas Season is a feature-rich Christmas event plugin for Paper, Purpur and Folia (Minecraft 1.21.3+ and 26.x). It transforms your world into a winter wonderland – snow biomes that follow your players, snowstorms, gift chests, elves, decoration drops and snowball-throwing snowmen – all controlled through a single /xmas command and fully reverted with /xmas off.

⚠️ Requirements

• Minecraft: 1.21.3 – 1.21.11 or 26.x (1.21.1/1.21.2 are NOT supported)
• Server: Paper, Purpur or Folia (plain Spigot is not supported – the plugin uses Paper's Adventure API)
• Java: 21+ (26.x servers require Java 25+)

One JAR covers all supported versions – live-tested on Paper 26.2, Paper 1.21.11 and Folia 1.21.11.

---

Features

• ❄ Dynamic snow biomes

  • Snow biomes follow your players in a configurable bubble (biome.playerBubble)
  • Full 3D biome changes (1.18+ multi-Y-level), Nether/End/cave biomes are never touched
  • Original biomes are stored in a compressed SQLite snapshot database – /xmas off restores everything, chunk by chunk, with per-chunk completion tracking and automatic retries
  • Performance-friendly: tick budgets (perTickBudget), chunk queues, no TPS spikes

• 🌨️ Snowstorms

  • Weather control with auto mode (configurable on/off cycles), manual mode or none
  • /xmas storm <on|off|toggle|status|pulse>

• 🎁 Gifts

  • Gift chests spawn near players with three loot tables: common, extra, rare
  • Configurable lifetime, spawn chance and optional broadcast on spawn
  • Protected against hoppers and explosions – and the cleanup can never delete player-placed chests (PDC-marker check)
  • Manual spawn via /xmasgift

• 🎄 Decoration drops

  • Periodic glowing decoration items around players (decoration.drops, fully configurable)
  • Spawn interval, chance, lifetime and glow are configurable

• 🧝 Wichtel & Elves

  • Mischievous Wichtel that steal dropped items and teleport around (wichtel.*)
  • Friendly Elves (Allays) that wander around (elves.*)
  • Max count per world, spawn intervals and lifetime are configurable

• ☃️ Snowmen

  • Aggressive snow golems that throw (harmless) snowballs at players
  • Configurable max count, spawn interval, attack range and attack chance
  • Never spawn in or near water (they would melt)

• 🛡️ Region protection (soft dependency)

  • No spawns inside WorldGuard regions or GriefPrevention claims
  • Works without those plugins installed; configurable via regionIntegration.*

• 💾 Backup system

  • Automatic SAFE backup on /xmas on, timestamp backup on /xmas off and an emergency backup if the server stops while the event is running
  • Startup safety checks: database integrity check and crash detection
  • Compare and repair restores with /xmas biome compare and /xmas biome fix-diff

• 🔧 Quality of life

  • Full tab completion for all commands (including biome names)
  • Update checker (/xmas update check + admin notifications)
  • Two languages included: German and English (language: de|en)
  • Config validation with clear warnings on startup
  • bStats metrics
  • Folia-ready: regionalized schedulers, thread-safe throughout

---

Commands

/xmas on                                  Start the event (creates a SAFE backup first)
/xmas off                                 Stop the event and restore all biomes
/xmas status                              Show event, storm and region-protection status
/xmas reload                              Reload the configuration (all modules)
/xmas biome set <biome> [radius]          Manually set biomes around you
/xmas biome status                        Snapshot database statistics
/xmas biome clearsnap                     Delete the snapshot database (guarded)
/xmas biome compare <backup>              Compare current biomes with a backup
/xmas biome fix-diff <backup> confirm     Restore differing chunks from a backup
/xmas storm <on|off|toggle|status|pulse>  Control the snowstorm
/xmas backup <list|restore|create|clear>  Manage biome database backups
/xmas update check                        Check Modrinth/GitHub for updates
/xmasgift                                 Spawn a gift chest at your position

Permission: xmas.admin (default: OP)

---

Links

• 📦 Source & full changelog: https://github.com/BoondockSulfur/ChristmasSeason
• 🐛 Issues & feature requests welcome!