Christmas Season

Lightweight Christmas event plugin for Paper and Spigot 1.21 with biome snow, global snowstorms, decoration drops, gifts, elves and snowmen, controlled via the /xmas command, requires Java 21.
Download

File Details
Download

christmas-season-1.2.4.jar

ByBoondockSulfur
  • R
  • Nov 28, 2025
  • 54.76 KB
  • 32
  • 1.21.10+10

File Name

christmas-season-1.2.4.jar

Supported Versions

  • 1.21.10
  • 1.21.9
  • 1.21.8
  • 1.21.7
  • 1.21.6
  • 1.21.5
  • 1.21.4
  • 1.21.3
  • 1.21.2
  • 1.21.1
  • 1.21
### Version 1.2.4 (2025-11-28)

Language system update with full multi-language support and important stability improvements.

#### 🌍 New Features

**Complete Multi-Language System**
- 🎯 **LanguageManager**: New system for managing translations
- 🇩🇪 **German (de)**: Full German localization (default)
- 🇬🇧 **English (en)**: Full English translation
- 📝 **All texts translated**: Commands, messages, entity names, broadcasts, error messages, console logs
- 🎭 **Translated entity names**: Wichtel, Elves, Snowmen, Gifts, Decorations - all names are now multilingual
- 🔧 **Config option**: `language: en` (or `de`) in config.yml
- 🔄 **Live reload**: Language switching with `/xmas reload` without server restart
- 📦 **Language files**: `messages_de.yml` and `messages_en.yml` in plugin folder
- 💾 **Performance cache**: Loaded translations are cached
- 🎨 **Placeholder support**: Dynamic values in messages (e.g., chunk count, biome names, coordinates)

**Documentation**
- 📖 **README_EN.md**: Complete English documentation added
- 🔗 **Language links**: Both READMEs link to each other
- ✨ **Enhanced changelog structure**: Detailed descriptions of all changes

#### 🔧 Technical Improvements

**Language System**
- **Modular design**: LanguageManager as standalone utility class
- **Fallback system**: Missing translations are logged and displayed
- **YAML-based**: Easy customization and extension through YAML format
- **Color code support**: Automatic conversion from `&` to `§`
- **Config cleanup**: Removed `decoration.name` from config.yml (now handled by language system)

**Stability & Performance**
- 🛑 **`/xmas biome restore` disabled**: Command has been disabled as it synchronously loads reference world chunks, causing server freezes (30+ seconds)
- ✅ **Alternative usage**: Use `/xmas off` for safe, asynchronous biome reset
- 🔒 **YAML Boolean fix**: Keys like `on`, `off` are now quoted (`"on":`, `"off":`) to prevent YAML boolean interpretation

#### 🐛 Fixed Bugs

- 🔴 **Translation keys not found**: YAML was interpreting `on`/`off` as booleans (`true`/`false`) - fixed by quoting
- 🔴 **Server freeze on biome restore**: `/xmas biome restore` blocked main thread - command disabled with warning
- ⚪ **Hardcoded entity names**: All managers now use LanguageManager instead of hardcoded strings