Changelog for Claim My Land 1.20.1

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

> ⚠️ IMPORTANT — Breaking Change & Backup Warning > > v2.x is not save-compatible with v1.x. Parcel data saved by any v1 release will not load in v2. If you are upgrading an existing world, your claimed parcels will be lost. > > Back up your world before installing v2. Copy your entire world folder to a safe location before upgrading. Once you have loaded the world in v2, downgrading back to v1 is not supported.

[2.1.0] - 2026-03-08

> 💡 Recommended: Since this mod is heavily command-based, we recommend using Chat Plus for a better command history and larger chat window.

🎉 Highlights

• JourneyMap integration — claimed parcels now appear as coloured polygon overlays on the map
• Parcel HUD — a small overlay in the bottom-left corner shows which parcel and estate you are standing in
• Formatted command responses — all command and tool feedback is now consistently styled with colour, icons, and structured detail lines
• Unique estate names — default estate names are now always unique per player and never produce duplicates after demolishing and re-claiming

➕ Added

JourneyMap Integration (optional)

• Parcel boundaries rendered as coloured polygon overlays on the JourneyMap fullscreen map and web map
• Colour scheme matches estate type: Nation (blue), Citizen (light purple), Zone (yellow), Player (green)
• Your own parcels render in vivid colours; other players' parcels render in muted/desaturated versions of the same hue so the type is still identifiable
• Parcel and owner labels displayed on fullscreen and web maps; hidden on the minimap to reduce clutter
• Overlays update live when parcels are claimed or demolished — no map reload required
• Integration is fully optional: the mod loads and functions normally without JourneyMap installed

Parcel HUD Overlay

• Small semi-transparent panel in the bottom-left corner of the screen, sitting just above the hotbar
• Displays estate name, parcel name, owner, and parcel type while standing inside a claimed parcel
• Hidden automatically in wilderness, in spectator/F1 mode, and when the GUI is hidden (F1)
• Parcel type label is colour-coded to match the JourneyMap overlay and command output convention

Client-Side Parcel Caching & Networking

• Server now syncs parcel data to clients via a lightweight packet layer
• Client-side cache eliminates the block-break redraw glitch (blocks no longer visually break and reappear when protection cancels the event)
• Full parcel registry synced to clients on login and dimension change
• Per-parcel updates broadcast to nearby players when parcels are claimed or demolished

Unique Estate & Parcel Default Names

• Default estate names are now unique per player: PlayerName-estate-1, PlayerName-estate-2, etc.
• Default parcel names are scoped to their estate: PlayerName-parcel-1, PlayerName-parcel-2, etc.
• Counter is monotonically increasing — demolishing an estate and re-claiming never produces a duplicate name
• Counter persists across server restarts via NBT

⚙️ Changed

Formatted Command & Tool Responses

• All command responses now use a consistent visual style: colour-coded header, separator line, bold title, and grey detail body
• Success responses use ✔ green, failures use ✘ red, warnings use ⚠ yellow, info uses ℹ aqua
• Whitelist add/remove responses show the entry name and the estate it was applied to
• Multi-reason failure responses (e.g. join, relinquish) now display as a formatted bullet list rather than plain indented text
• Tool and item messages (ZoningTool, CitizenTool, Deeds) use the same formatting system as commands

Performance Improvements

• Added chunk-index pre-filter (ParcelChunkIndex) in front of the 3D interval tree — block events in unclaimed chunks now exit in O(1) without touching the BST
• findByParcelId() is now O(1) via a direct UUID → Parcel map (was O(n) linear scan)
• findAllByEstateId() and findAllByNationEstateId() are now O(1) via an EstateID → Parcels multimap (was O(n))

Dimension Validation

• All nine inline OVERWORLD dimension checks in the event handler extracted to a single isInProtectedDimension() helper
• Centralised in one place — ready for multi-dimension support in v2.2

🐛 Fixed

• Fixed DemolishEstateSubCommand having an extra incorrect .suggests() in its command chain
• Fixed default estate naming producing duplicate names after demolishing and re-claiming parcels
• Fixed hasAccess() and hasInteractAccess() duplicating identical parcel-resolution logic — now share a single resolveParcelAt() helper
• Fixed syncAllParcelsToPlayer() using the logging-in player's own name as the owner name for every parcel in the world

🗑️ Removed

• Removed NATIONS_BY_ID multimap from ParcelRegistry (deprecated since 2.0)
• Removed abandonParcel() and updateOwner() from ParcelRegistry (deprecated since 2.0)
• Removed findByNationId() from ParcelRegistry (deprecated since 2.0)
• Removed all deprecated constant fields from CommandHelper
• Removed getNations() / getNationById() from ParcelRegistry — moved to EstateRegistry as on-demand stream filters

🔧 Technical / Developer Notes

• New networking layer: CMLNetwork, CacheSyncPacket, SyncParcelPacket, SyncAllParcelsPacket, RemoveParcelPacket
• New client-side classes: ClientParcel (record), ClientParcelCache, ClientParcelRegistry, ParcelRegionCache
• New JourneyMap classes: JourneyMapIntegration, JourneyMapOverlayHandler, ParcelPolygonOverlayFactory
• New command helpers: CommandResponseFormatter, PlayerMessageHelper, ParcelDisplayFormatter, WhitelistFormatter
• New estate/parcel naming helpers: EstateHelper, ParcelHelper
• EstateTypeRegistry gains a CopyFactory for estate copying that does not carry over whitelists
• AbstractEstate.copyFrom() added for controlled field copying
• PlayerRegistry gains a per-player estate name counter with NBT persistence
• Parcel interface gains nameAndRegister() as the single commit point for naming, registration, and save
• ParcelRegistry.register() and unregisterParcel() gain ServerLevel overloads that broadcast network packets without breaking existing call sites

[2.0.0] - 2026-03-02

> 💡 Recommended: Since this mod is heavily command-based, we recommend using Chat Plus for a better command history and larger chat window.

🎉 Major Changes

Estate System Introduction

Parcels now represent physical land/space, while Estates represent ownership & access control.

• Relationship: One Estate → Many Parcels (one-to-many)
• Key Concept: Each Estate can contain multiple Parcels, and every Parcel belongs to exactly one Estate
• Benefits:
  • Group multiple Parcels under shared ownership and access rules
  • Parcels within the same Estate don't need to be adjacent
  • Apply whitelist changes to all Parcels in an Estate at once

⚙️ Changed

• Command Structure Reorganization:

  • Moved all whitelist sub-commands from /parcel to /estate commands
  • Restructured /cml whitelist command syntax for clarity
  • Renamed abandon command → relinquish

• Relinquish Rules:

  • Only Citizen Estates and Parcels can be relinquished
  • Designed for nation owners to set up pre-claimed parcels that players can claim

• Massively Improved Display & Formatting: 🆕

  • Enhanced visual formatting with:

    • Tree-structured hierarchical displays using box-drawing characters
    • Color-coded output for different whitelist types
    • One entry per line for better readability

  • Better command output:

    • estate list - Shows estates organized by type (Nation/Citizen/Regular)
    • parcel list - Displays parcels with estate relationships
    • estate whitelist - Shows all whitelist types in organized sections
    • Whitelist displays now show item counts and categories
    • Nation hierarchy view shows the full chain: Nation → Citizens → Parcels

• Code Quality:

  • Massive refactoring to support Estate system
  • Improved code organization and maintainability
  • Generic methods reduce code duplication across whitelist types

➕ Added

• Entity Spawn Whitelist: Control which entities can spawn in your parcels

• Entity Spawn Tag Whitelist:

  • Pre-populated with default allowable spawns (cows, chickens, eggs, buckets, etc.)
  • Fixes bug where neutral entities couldn't spawn in owned parcels

• Tag-Based Whitelists: 🆕

  • Block Tags: Allow entire categories of blocks (e.g., #minecraft:planks)
  • Item Tags: Allow entire categories of items (e.g., #minecraft:swords)
  • Entity Tags: Control entity categories (e.g., #minecraft:skeletons)
  • Much easier than adding items individually

• Estate Commands: Full suite of commands for managing Estates

  • Create, rename, delete estates
  • Transfer ownership between players
  • View detailed estate information
  • Manage all whitelist types at the estate level

• Whitelist Display Commands: 🆕

  • View any whitelist type: players, blocks, items, entities, or their tags
  • See all whitelists for an estate in one organized view
  • Categorized display makes finding entries easy
  • Summary view shows counts across all whitelist types

• Rolling JSON Backup System: Implemented automatic periodic saving of parcel data with configurable retention

  • Parcel data is now automatically saved to timestamped JSON files at regular intervals
  • Configurable save frequency (default: every 10 minutes)
  • Automatic cleanup of old save files, keeping only the N most recent backups (default: 20 files)
  • Added ability to manually trigger saves on-demand
  • Added recovery system to load from most recent backup on server startup
  • Save files are stored in world/data/claimmyland/ directory with timestamp naming format: parcels_YYYY-MM-DD_HH-MM-SS.json
  • Provides protection against data loss from server crashes or corruption > Note: Backup settings (interval, retention countm flie path, etc) are currently hardcoded. Configuration options will be added in a future versions.

Technical Details

• Introduced RollingJsonSaver utility class for generic rolling file management
• Backup system operates on server tick events with configurable intervals
• Uses Gson for JSON serialization/deserialization
• Automatic file cleanup prevents disk space issues from backup accumulation