v1.1.1 - Data Persistence and Stability!

Welcome to the stability and performance release for FTB Chunks for BlueMap!

This update focuses on eliminating long-standing issues, ensuring your claim data is always persistent, and giving server administrators powerful new tools to manage map synchronization. Say goodbye to the need to edit a claim just to make it appear!

✨ Highlights of this Release

• 💾 Persistent Claim Data: Claims are now saved to a file, meaning they appear instantly and correctly when the server restarts. No more waiting for players to edit their claims!
• 🛠️ Admin Commands: Powerful new commands for administrators to manually reload, save, or re-synchronize all claim data instantly.
• 👯 Dual Marker Sets: Introduction of both 3D (Extruded) and 2D (Flat) markers, allowing users to choose their preferred visualization style right from the BlueMap layer menu.
• 🧠 Smarter Synchronization: Real-time detection of team deletions and color changes ensures the map is always an accurate reflection of the server's state.

➕ Added Features & Functionality

💾 Persistent Data Storage

A new file-based storage system dramatically improves startup reliability and prevents data loss.

• New file-based storage system for chunk claim data.
• Claims are now saved to <world_folder>/ftbchunksbluemap/claim_data.json.
• Data persists across server restarts — claims display immediately on startup.
• Auto-save every 5 minutes to prevent data loss.

💻 New Admin Commands

Powerful new commands for server administrators (all require OP level 2):

• /ftbchunksbluemap reload - Performs a full memory flush and reloads all data from scratch.
• /ftbchunksbluemap data save - Immediately saves current claim data to file.
• /ftbchunksbluemap data init - Forces complete re-initialization (clear, reload, sync).
• /ftbchunksbluemap data status - Shows current data status (chunks, teams, dimensions, last save time).

🗺️ Dual Marker Sets (2D & 3D)

Map viewers can now choose their preferred marker style in the BlueMap layer menu:

• 3D Claims (FTB Chunks Claims (3D)): Extruded markers showing full height from Y=-64 to Y=320, visible by default.
• 2D Claims (FTB Chunks Claims (2D)): Flat markers at consistent Y=65 level, hidden by default.
  • 2D markers are rendered to be consistently visible in 3D view.
  • Toggle visibility in BlueMap's layer menu.

💡 Smarter Team Change Detection

• Automatically detects when teams are deleted and removes their markers.
• Detects team color changes and rebuilds markers with updated colors.
• Tracks team metadata (name, color) changes in real-time.

✏️ Changes & Improvements

🚀 Improved Initialization

• Markers are now only cached after successful creation, preventing issues with phantom markers.
• Added a 3-second startup delay to ensure FTB Chunks data is fully loaded before the map synchronization begins.

🧹 Code Quality Improvements

• Refactored core components for better maintainability and reliability.
• Added comprehensive Javadoc documentation throughout.
• Improved error handling and logging.

✅ Fixed Issues

❌ Memory Leak Prevention

A primary focus of this release was eliminating memory leaks and stale references between server restarts:

• Fixed: All static caches are now properly cleared on server shutdown.
• Fixed: BlueMap API callbacks are correctly unregistered on shutdown, preventing stale references.
• No more stale references held between server restarts.

🗺️ Marker Display Issues

• Fixed: Markers not appearing until a claim was manually edited.
• Fixed: Marker creation now returns a success/failure status for proper state management.

🤓 Technical Details

New Files

• cc.olivr.ftbchunksbluemap.data.ChunkClaimData - Data model for JSON serialization.
• cc.olivr.ftbchunksbluemap.data.ChunkDataManager - Persistence and synchronization manager.
• cc.olivr.ftbchunksbluemap.command.ModCommands - Admin command handler.

Data File Structure

{
  "version": 1,
  "lastSaved": 1733500000000,
  "dimensions": {
    "minecraft:overworld": {
      "teams": {
        "<team-uuid>": {
          "teamName": "TeamName",
          "teamColor": 16777215,
          "chunks": ["0,0", "1,0", "1,1"],
          "hasForceLoaded": false
        }
      }
    }
  }
}

⬆️ Migration Notes

• Existing setups will work without changes.
• On first startup with this version, all existing claims will be scanned and saved to the new data file automatically.