Changelog - Illegal Quarry

[0.1.173] - 2026-01-25

MAJOR: Pure ECS Persistence System 🚀

BREAKING CHANGE: Migrated from CSV-based persistence to 100% game-internal ECS persistence.

New Files

• QuarryDataManager.java - In-memory cache + disk I/O system for quarry persistence

  • Methods: saveQuarry(), loadQuarry(), removeQuarry(), persistToDisk(), loadFromDisk()
  • File: mods/tiffy-IllegalQuarry/quarries.dat (replaces quarry.csv)
  • Format: Pipe-delimited NBT strings (one per line)

• QuarryInitializer.java - ECS system for restoring persisted quarries on startup

  • Waits 20 ticks for world to fully load
  • Deserializes and creates ECS entities from cache
  • Quarries resume mining immediately with preserved state

Modified Files

• QuarryComponent.java - ✅ Added serialization

  • toNBTString() - Serialize to pipe-delimited format
  • fromNBTString() - Deserialize from pipe-delimited format
  • Format: id:Q-xxx|owner:name|pos:x,y,z|speed:3|tier:2|tick:45|fuel:1200|filters:Ore_Mithril;Ore_Gold

• QuarryPlugin.java - ✅ Removed QuarryManager, added ECS lifecycle

  • Calls QuarryDataManager.loadFromDisk() in setup()
  • Registers QuarryInitializer for automatic restoration
  • Calls QuarryDataManager.persistToDisk() in shutdown()
  • Added debug logging in start()

• QuarryListener.java - ✅ Complete refactor

  • Removed all QuarryManager dependencies
  • Added countQuarriesByPlayer() for player limits
  • Added getQuarriesNear() for adjacent quarry detection
  • All events now use QuarryDataManager

• QuarryMiningSystem.java - ✅ Added persistence

  • Fuel state saved every 100 ticks
  • Immediate save after fuel refill
  • Max fuel loss on crash: ~5 seconds

• IllegalQuarryCommand.java - ✅ Updated persistence calls

  • /iq and /iq clear now query QuarryDataManager
  • Shows fuel + filter count in info display

• IllegalQuarryListCommand.java - ✅ Updated persistence calls

  • /iqlist iterates QuarryDataManager.getAllQuarries()
  • Updated storage location message

Deleted Files

• QuarryManager.java ❌ REMOVED - Replaced by lighter QuarryDataManager

Persistence Features

• ✅ Fuel Persistence: Fuel balance survives restart (100-tick save interval + immediate on refill)
• ✅ Filter Persistence: Active filters restored after restart
• ✅ Speed Persistence: Speed level maintained across restarts
• ✅ Tick Counter Persistence: Mining progress preserved
• ✅ Zero CSV Files: No quarry.csv - 100% game-internal storage
• ✅ Atomic Writes: Entire cache written atomically on shutdown
• ✅ Instant Resume: Quarries resume mining immediately on startup with previous state
• ✅ Crash Resilience: Max 500 tick fuel loss (~25 seconds) on force kill

Migration Notes

• ⚠️ Breaking Change: Existing quarry.csv data is NOT imported
• Recommendation: Fresh start - players must re-place quarries
• Rationale: Fuel/filter data not in CSV; clean slate preferred for pre-release
• Benefit: No data loss after v0.1.173 (all state now persisted)

Technical Details

• Storage: mods/tiffy-IllegalQuarry/quarries.dat
• Format: Pipe-delimited key:value pairs (human-readable)
• Thread Safety: ConcurrentHashMap-based caching (proven pattern from IllegalPipe)
• Lifecycle: Load setup() → Restore startup() → Save runtime changes → Persist shutdown()
• Performance: One-time load + periodic saves (not per-tick overhead)

Build Status

• ✅ Build #173: SUCCESSFUL
• ✅ Compile errors: 0
• ✅ Warnings: 5 (BlockState deprecation - external API)
• ✅ JAR size: 349KB