1.3.0

Version 1.3.0 (2025-12-02)

🚀 Massive Performance Update! - Fixed critical performance issues + SQLite database system for unlimited chunks!

⚡ Performance Optimizations

Chunk Processing Optimized (99% less re-processing)

✅ Chunk Processing Cache: Chunks are now processed only once, not repeatedly every tick
✅ Smart Sample Check: 4-point sampling skips already correct chunks (~95% faster)
✅ Removed Double Processing: tick() method no longer processes player bubbles twice
📊 Effect: From 24,576 API calls per chunk → 4-100 calls (-99%)

Event Listeners Throttled (-90% Events)

✅ PlayerMove Cooldown: 3-second cooldown per player instead of every chunk change
✅ ChunkLoad Caching: Already processed chunks are skipped
📊 Effect: ~90% fewer event triggers for moving players

Entity Optimizations

✅ SnowmanManager: Uses getEntitiesByClass() instead of w.getEntities() (~10x faster)
✅ DecorationManager Cleanup: Iterates only over items instead of all entities
✅ GiftManager Tracking: New location tracking instead of chunk iteration (~100x faster)
✅ Wichtel/Elf Lifetime: Automatic removal after 240 seconds (configurable)
📊 Effect: Cleanup reduced from seconds to milliseconds

Scheduler Optimizations

✅ SnowstormManager Auto-Mode: Changed from runTaskTimer (every tick) to runTaskLater
📊 Effect: From 20 TPS overhead to 0 TPS (only runs every 45-150 seconds)

Chunk Reload Removed

✅ refreshChunkSafe(): Removed expensive chunk unload/reload
📊 Effect: ~50% less CPU load during biome changes

🗄️ SQLite Database System (BREAKING: replaces YAML)

Completely New Snapshot System

✅ SQLite instead of YAML: Biome snapshots stored in biome-snapshot.db
✅ GZIP Compression: Biome data is compressed
✅ Unlimited Chunks: No more 2,000-chunk limit!
✅ Minimal Storage: 10,000 chunks = ~5-10 MB (instead of 156 MB with YAML)
✅ Millisecond Performance: Load/save in <10ms per chunk
✅ No Memory Overhead: Data not held in RAM
✅ WAL Mode: Write-Ahead Logging for better concurrent performance
📊 Effect: -94% storage space, unlimited scaling

YAML to SQLite Migration

✅ Automatic Migration: /xmas biome migrate migrates old YAML snapshots
✅ Backup Creation: Old YAML saved as .backup-<timestamp>
✅ Backwards Compatible: Old configs continue to work
📊 Effect: Seamless upgrade from v1.2.x to v1.3.0

Biome Restore Completely Reworked

🔴 Critical Bug Fixed: Database was closed BEFORE restore, restore found no data
✅ New Timing Logic: DB stays open during /xmas off until restore finishes
✅ Detailed Logging: Progress every 50 chunks, error tracking
✅ Intelligent Block Removal: Only removes snow/ice in non-winter biomes
✅ Chunk Loading: Chunks loaded on-demand for restore
✅ Auto-Cleanup: DB cleared and closed after successful restore
📊 Effect: Restore now works reliably!

Debug Mode Added

✅ /xmas debug Command: Enables verbose debug logs
✅ Snapshot Tracking: See which chunks are being snapshotted
✅ Restore Details: Shows biome data and block removal statistics
✅ DB Status: Shows database open/close and chunk counts
✅ Performance Info: Time measurements and chunk processing
📊 Effect: Easier debugging and troubleshooting

📊 Compatibility

Server Software

✅ Spigot 1.21+: Fully compatible
✅ Paper 1.21+: Fully compatible (recommended for best performance)
✅ Purpur 1.21+: Fully compatible
⚠️ Folia: Partially compatible (possible threading issues)

Dependencies

✅ SQLite JDBC 3.45.0.0: Automatically included in JAR (Maven Shade)
✅ No Other Dependencies: Plug & Play

🎯 New Commands

/xmas debug - Enable/disable debug mode
/xmas biome migrate - Migrate YAML snapshots to SQLite
/xmas biome status - Now shows DB statistics (chunks, size)

📊 Performance Improvements (Measurements)

Metric	Before (v1.2.5)	After (v1.3.0)	Improvement
CPU Load at 1000 Chunks	~80%	~10-15%	-85%
RAM Usage (Snapshot)	156 MB (YAML)	5-10 MB (SQLite)	-94%
Non-Heap Usage	432/456 MB (95%)	~200/456 MB (44%)	-54%
Chunk Limit	2,000 (YAML)	Unlimited (SQLite)	∞
Chunk Processing Calls	24,576/chunk	4-100/chunk	-99%
PlayerMove Events	Every chunk change	Every 3 seconds	-90%
Entity Cleanup Time	5-10 seconds	<100ms	-98%
TPS During Long Runtime	10-15 TPS	19-20 TPS	Stable!
Startup Time (with Snapshot)	30-60 seconds (YAML)	<1 second (SQLite)	-98%
Snapshot Load/Save	Seconds	Milliseconds	1000x faster

🐛 Fixed Bugs

🔴 Critical: Biome Restore Didn't Work: DB was closed BEFORE restore started
🔴 Critical: YAML System Didn't Scale: 10,000+ chunks = 156+ MB, server crashes
🔴 Critical: Chunk Limit Too Low: 2,000 chunks reached quickly on large servers
🔴 Chunk Re-Processing Loop: Chunks were processed repeatedly instead of once
🔴 Double Player-Bubble Processing: tick() and playerBubbleTask did the same work
🔴 PlayerMove Event Spam: Hundreds of events per second when moving fast
🔴 SnowstormManager Auto-Mode: Ran every tick (20x/second) instead of only on toggle
🔴 Inefficient Entity Iteration: w.getEntities() instead of getEntitiesByClass()
🔴 Wichtel/Elves Never Despawn: setRemoveWhenFarAway(false) without lifetime enforcement
🔴 YAML Startup Time: Loading large snapshot files took 30-60 seconds

⚙️ Technical Details

Chunk Processing Cache:

New processedChunks Set with max 5,000 entries
Chunks are only processed if not in cache
Cache size is automatically limited (oldest 20% removed)

SQLite Database Schema:

CREATE TABLE chunks (
    world TEXT NOT NULL,
    x INTEGER NOT NULL,
    z INTEGER NOT NULL,
    biomes BLOB NOT NULL,      -- GZIP-compressed biome data (256 bytes → ~50-100 bytes)
    timestamp INTEGER NOT NULL,
    PRIMARY KEY (world, x, z)
);
CREATE INDEX idx_timestamp ON chunks(timestamp);

GZIP Compression:

Original: 256 biomes as enum ordinals (1 byte per biome)
Compressed: ~50-100 bytes (compression rate 50-60%)
Effect: 10,000 chunks = ~5-10 MB instead of 156 MB (YAML)

SQLite Optimizations:

WAL mode (Write-Ahead Logging): Better concurrent performance
PRAGMA synchronous = NORMAL: Faster writes
PRAGMA cache_size = 10000: 10 MB cache
PRAGMA temp_store = MEMORY: Temp data in RAM

PlayerMove Event Throttling:

HashMap with LastUpdate timestamps per player
3-second cooldown between updates
Prevents spam during fast chunk changes

Biome Restore Timing Fix:

stopFeatures(false): DB stays open for restore
restoreALLAsync(): Iterates through DB, restores chunks
At the end: DB is cleared and closed
Progress logging every 50 chunks

🎓 Migration Guide (v1.2.x → v1.3.0)

Upgrade Steps:

Stop Server
```
stop
```
Replace Plugin JAR
- Delete old ChristmasSeason-1.2.x.jar
- Copy new ChristmasSeason-1.3.0.jar to plugins/

Start Server

# Plugin automatically creates biome-snapshot.db

Optional: Migrate Old YAML Snapshots
```
/xmas biome migrate
```
- Migrates biome-snapshot.yml → biome-snapshot.db
- Creates backup: biome-snapshot.yml.backup-<timestamp>
- Deletes old YAML file after successful migration
Done!
- SQLite system runs automatically
- Unlimited chunks possible
- Better performance

Config Changes (optional):

biome:
  # Old config options can be removed:
  # restoreOnEvict: true      ← DEPRECATED, no longer needed!

  # enableSnapshot remains the same:
  enableSnapshot: true        # true = SQLite DB, false = no restore

⚠️ Breaking Changes

Minimal Breaking Changes:

✅ YAML Format: Old biome-snapshot.yml is no longer automatically loaded
- Solution: Use /xmas biome migrate
✅ Config Option: restoreOnEvict is ignored (no longer needed)
- No adjustment needed - simply ignored
✅ All Other Configs: 100% compatible!

Christmas Season

Links

Tags

Creators

Details

Compatibility

Changes