promotional bannermobile promotional banner

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.
Back to Files

christmas-season-1.2.4.jar

File namechristmas-season-1.2.4.jar
Uploaded
Nov 28, 2025
Downloads
40
Size
54.8 KB
File ID
7272204
Type
R
Release
Supported game 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

What's new

### 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

This mod has no additional files