LandClaimPlugin

[3.2.1] - 2026-09-15

Fixed

- Admin Command Console Execution & Argument Order: - Fixed /claim admin add chunk <player> <amount> failing to execute from server console (such as DeluxeMenus, donation stores, and server console scripts). - Aligned /claim admin add chunk argument syntax to the documented order <player> <amount> instead of the previous reversed order. - Enabled console execution for /claim admin reload and the root shortcut /claim reload. - Replaced strict PlayerSource restriction on the /claim root builder with Source, allowing non-player senders for applicable administrative subcommands while preserving player-only restrictions on gameplay and GUI commands. - Resolved potential ClassCastException by properly handling CommandSender instead of forcing Player casting in admin handler callbacks.

[3.2.0] - 2026-09-04

Added

- Claim Boundary Chat Notifications: - Added configurable chat notifications upon entering and leaving claim territory (claimChatNotifications.enabled). - Added personal player toggle command /claim notify (alias /claim chatnotify) to opt in/out of chat notifications. - Added landclaim.notify permission node for command access. - Formatted messages configurable in messages.yml with territory name placeholders (%claim%). - Server-Wide Visitor Settings Locking: - Added server-wide lock setting visitorSettings.locked in config.yml. - Added configurable server default flags via visitorSettings.defaultFlags (e.g. allowing exploration while restricting block breaking/placing). - Enforced server default flags during permission resolution when locked, completely bypassing individual profile overrides. - Blocked access to VisitorSettingsGUI when locked to prevent player confusion.

[3.2.0] - 2026-09-04

Added

- Claim Boundary Chat Notifications: - Added configurable chat notifications upon entering and leaving claim territory (claimChatNotifications.enabled). - Added personal player toggle command /claim notify (alias /claim chatnotify) to opt in/out of chat notifications. - Added landclaim.notify permission node for command access. - Formatted messages configurable in messages.yml with territory name placeholders (%claim%). - Server-Wide Visitor Settings Locking: - Added server-wide lock setting visitorSettings.locked in config.yml. - Added configurable server default flags via visitorSettings.defaultFlags (e.g. allowing exploration while restricting block breaking/placing). - Enforced server default flags during permission resolution when locked, completely bypassing individual profile overrides. - Blocked access to VisitorSettingsGUI when locked to prevent player confusion.

[3.1.0] - 2026-09-03

Added

- Public Warp Collision Disambiguation Menu: - Added interactive WarpDisambiguationGUI dialog when multiple players have a public warp sharing the same name. - Enabled /claim warp <name> for all players to discover and teleport to public warps. - Added direct owner targeting syntax: /claim warp <owner>:<name> and /claim warp <owner> <name>. - Public API Events & Overloads: - Added WarpPrivacyChangeEvent (Cancellable) fired whenever a warp is toggled between public and private. - Added ClaimTransferEvent fired when claim ownership is transferred. - Added WarpCreateEvent and WarpDeleteEvent fired on warp creation and deletion. - Added ClaimMemberAddEvent and ClaimTrustAddEvent (Cancellable) fired when member and trust invites are accepted. - Added LandClaimAPI.transferClaim(UUID, UUID) and LandClaimAPI.unclaimAll(UUID) overloads.

Fixed

- Fixed bug where public warps could not be reverted to private via /claim setwarp <name> private. - Fixed multi-profile UUID key desync between ClaimCommand, WarpControlPanelGUI, and ClaimManager.loadProfiles(). - Fixed /claim setwarp location check incorrectly rejecting secondary profiles owned by the player. - Fixed NullPointerException on PublicWarpsGUI Back button when the player owns no claim profiles. - Patched combat escape exploit in PublicWarpsGUI by enforcing CombatManager.isInCombat() checks before teleportation.

[3.0.0] - 2026-08-30

Added

- Radius Claiming & Unclaiming: - Added /claim radius <1-5> and /unclaim radius <1-5> for bulk area territory expansion and contraction. - Automatically respects permission gates, claim limits, world blacklists, WorldGuard boundaries, and adjacency rules. - Instant Particle Feedback & Quota Progress: - Dynamic temporary boundary visualization flash upon claiming or unclaiming chunks. - Pling/Bass audio feedback for interactive confirmation. - Chat quota indicator displaying <chunks>/<limit> claimed. - Auto-Unclaim Command: - Registered /unclaim auto allowing players to unclaim chunks as they move. - In-Game Held Territory Map (Minimap): - Live 128×128 pixel radar map rendering directly onto a vanilla FILLED_MAP item using Bukkit's MapView & MapRenderer canvas. - Accurate player-centered projection tracking smooth sub-chunk movement across 16×16 blocks. - Renders chunk polygons, boundary grid lines, custom profile claim colors (#RRGGBB), allies (#9b59b6), members/trusted (#3498db), foreign claims (#e74c3c), and wilderness (#282c34). - Real-time rotating player cursor (MapCursor.Type.PLAYER) and dynamic territory name banner. - Interactive right-click zoom toggle between Overview mode (16×16 chunks) and Close Detail mode (8×8 chunks) with audio feedback. - Full Bedrock / Geyser support (rendered seamlessly in hand, off-hand, and wall Item Frames). - New commands: /claim minimap, /claim map, /claim menu map. - New permission: landclaim.minimap (default: true). - Configurable via minimap section in config.yml. - Modrinth Update Checker: - Automated asynchronous update checker querying the Modrinth v2 API on startup (PAlDTriF). - Interactive MiniMessage join notification with clickable links for server operators/admins with landclaim.update.notify permission. - Configurable via updateChecker section in config.yml. - Action Bar Display Toggle: - Added actionbarEnabled option (default: true) to enable/disable claim status and wilderness action bar messages. - Java 25 & Paper 26.2+ Compatibility: - Upgraded bytecode target to Java 25 (release 25, class file version 69.0) aligned with Paper API 26.2.build.120-stable. - Upgraded maven-shade-plugin to 3.6.0 with ASM 9.8 for Java 25 bytecode relocation.

Changed & Improved

- Unclaim Command Consolidation: - Unified all unclaiming commands exclusively under /unclaim (/unclaim, /unclaim radius <1-5>, /unclaim auto, /unclaim all [confirm]). - Removed duplicate unclaim subcommands from /claim. - SQL Error Handling & Transaction Integrity: - Fixed CompletableFuture exception propagation in SQLProfileDao and SQLWarpDao to prevent cache desyncs on rolled-back transactions. - Removed redundant queries in SQLProfileDao.getProfile. - Added safe Material.getMaterial(...) fallback in SQLWarpDao to prevent server startup crashes on missing/renamed materials. - Role Cleanup on Ownership Transfer: - Automatically cleans up member and trusted roles for the new owner upon claim transfer.

Removed

- Legacy V1 Code Purge: - Removed dead legacy Claim.java and ChunkSelection.java models. - Removed unused ClaimDao, SQLClaimDao, RoleDao, and SQLRoleDao. - Removed legacy claimCache from CacheManager and INVALIDATE_CLAIM from RedisManager. - Removed outdated inventory-based GUI map (ClaimMapGUI, ClaimMapInfoGUI) in favor of the high-resolution held Territory Map.

1. GeyserMC Support 2. Wilderness protection 3. Claim bans 4. /claim reload for config 5. Public warp 6. SqaureMap porper support 7. small bug fixes

Folia Support (not fully tested) if you face any issues feel free tell me in discord or github

Version 2.3.0 focuses on permission enforcement, improved GUI invitation flows, dynamic claim handling, custom claim color support, banned claim name filtering, smarter tab completion, and major config/documentation cleanup.

This update adds 13 new CLI commands for claims management, a new /claim toggle visualization mode command with tab completion, and multiple fixes for multi-profile claim handling and config loading. Documentation has also been refreshed with a new informations and updated API/dev docs.

New admin profiles, commands, bypass & GUI support Public plugin API + PlaceholderAPI integration Security, reliability, and performance improvements Config/docs cleanup and new admin flags

1. Added MultiProfile mode check the docs for the details 2. unstuck command to escape from a claim if trapped 3. block commnads like sethome, etc 4. Deployed a Docs page check it out

fix: uncapped claim limit permission check

1. Reworked Trust System (Check Out README for more detail). 2. You can now ally with players using their username instead of claim name, including offline players via GUI text input, and invites/accept/deny/remove all auto-resolve to the correct claim profile. 3. Added owner alias (Check out README for more detail). 4. Added add max-memberships configuration option. 5. Added CLAIM_LAND premission to RoleEdit pression menu. 6. Added PvP command for turning on/off globally with a timer arg. 7. Made Renaming and other stuff uses AnvilGUI instead of Chat Input for better understanding. 8. Fix where it was showing 2 member role and other minor bugs. 9. Improve WorldGaurd Hook (Check Out README for more detail). 10. Added Few more admin commnads (Check Out README for more detail).

1. Added Support for newer verison 2. Added new admin commands 3. lots of Bug fixes check out the the github for more detailed update info.

Improve claim protection reliability by increasing EventPriority to HIGHEST in all protection listeners. Fixes conflicts with permissive WorldGuard configurations.

fix: prevent visitors from rotating items in item frames (v2.0.3)

fix: prevent land claims from disappearing due to cache eviction and aggressive auto-unclaim - Disabled 30-minute inactivity expiration for profile and player caches in CacheManager. - Fixed auto-unclaim logic in EventListener to only trigger when requireConnectedClaims is enabled.

1. Improved interaction protection system 2. Better detection for doors, trapdoors, containers, and redstone 3. Improved compatibility with newer Minecraft blocks 4. General stability improvements

V2 UPDATE

Plugin Refactor Read description v1 will automatically migrate to v2 only the claims

New Features

- Map Integration: Added support for BlueMap (Flat ShapeMarkers) and Dynmap (Area markers) to display claims on web maps automatically. Contiguous claims are now aggressively merged into a single, clean border polygon instead of showing internal chunks! - Language Support: added support for Cyrillic

Version 1.8

New Features

- Map Integration: Added support for BlueMap (3D ExtrudeMarkers) and Dynmap (Area markers) to display claims on web maps automatically. - Multiple Homes: Added /claim sethome <name>, /claim home <name>, /claim homes, and /claim delhome for players to set multiple homes strictly within their own claims. - Claim List: Added /claim list command showing coordinates of all your owned chunks, grouped by world. - LuckPerms Support: Fully integrated LuckPerms nodes (landclaim.list, landclaim.sethome, etc.) including dynamic home limits per rank (landclaim.homes.limit.<n>).

Protections & Anti-Griefing

- Respawn Anchors: Blocked exploding respawn anchors inside or near claimed lands. - Piston Griefing: Prevented players from pushing or pulling blocks across claim borders they do not own using pistons or slime blocks. - Minecart Griefing: Prevented Hopper Minecarts from being pushed from the wilderness into a claimed chunk. - Hex Colors: Full support for Bungee hex color formats (&#RRGGBB) in config, action bars, and chat messages.

Bug Fixes

- Double Prefix Format: Removed duplicate [LandClaim] prefixes from the /claim help menu. - Fixed actionbar messages not updating: Actionbar messages were reading from wrong config file; now properly reads from messages.yml - Added missing actionbar-owner key: Added missing message key for viewing other players' claims - Wilderness actionbar persistence: Wilderness message now stays visible instead of flickering when moving between unclaimed chunks

Bug Fixes

- Fixed actionbar messages not updating: Actionbar messages were reading from wrong config file; now properly reads from messages.yml - Added missing actionbar-owner key: Added missing message key for viewing other players' claims - Wilderness actionbar persistence: Wilderness message now stays visible instead of flickering when moving between unclaimed chunks

Optimizations

- Batch Particle Spawning: Visualization particles are now collected and spawned in batches, reducing object creation overhead - Visualization Cache Limit: Added max size limit (100 entries) to mergedEdgesCache to prevent unbounded memory growth - Configurable Action Bar Interval: Action bar update interval is now configurable via actionbar-update-interval (default: 20 ticks) - Reduced Vector Object Creation: Particle edge calculation now uses primitive math instead of Vector objects - ChunkPosition Flyweight Cache: Added object pooling for ChunkPosition instances to reduce GC pressure in hot paths - Async Debounced Saves: New SaveManager handles file I/O asynchronously with debouncing - data is marked dirty and saved in batches every 60 seconds - Optimized Wilderness Detection: Actionbar only recalculates when claim status changes, not on every chunk transition

Styling

- Minimal Message Style: All messages updated to minimal/formal style - New Color Scheme: Messages now use &7 (gray) and &#31A2DD (blue accent) colors - Removed Emojis: All emoji characters removed from messages for cleaner look - Updated Prefix: Plugin prefix updated to match new color scheme

Technical Changes

- Added getActionBarMessage() method to ConfigManager for actionbar-specific messages - Added getActionBarUpdateInterval() method to ConfigManager - Added actionbar-update-interval config option - Added SaveManager class for async debounced file operations - Added ChunkPosition.of() static factory method with flyweight caching - Added lastClaimStatusMap to EventListener for optimized wilderness tracking - Removed unused Vector import from VisualizationManager - Removed unused EntityDamageEvent import from EventListener

Version 1.7

Bug Fixes

- Fixed null pointer exception: Added null safety checks in GUIListener title parsing - Fixed offline player lookup performance: Replaced slow iteration with Bukkit's cached lookup

New Features

- Player Data Persistence: Auto-claim/unclaim states and visualization modes now persist across server restarts - WorldGuard Integration: Full WorldGuard API integration - claims now properly respect WorldGuard region gaps - New playerdata.yml: Stores player-specific settings (auto-claim, visualization modes)

Optimizations

- Cached player lookups: GUIListener and TrustManager now use efficient cached lookups instead of iterating all offline players

Technical Changes

- Config version bumped to 6 - Plugin version bumped to 1.7 - Improved README.md with clean, minimal documentation - Added WorldGuard dependency (optional, soft-depend) - Added loadPlayerData() and saveAllPlayerData() methods to CommandHandler and VisualizationManager

Version 1.6

Bug Fixes

- Fixed memory leak: Player data maps now cleaned up on player quit (EventListener, CommandHandler, VisualizationManager) - Fixed chat exploit vulnerability: Removed vulnerable onPlayerChat handler that could be exploited - Fixed typos in messages.yml: "Memeber" → "Member", "Premissions" → "Permissions" - Fixed hardcoded messages: CommandHandler now uses config for all messages - Fixed soft-depend syntax: Changed soft-depend: WorldGuard\ to soft-depend: [WorldGuard]` in plugin.yml - Added CONTAINER permission: Separate permission check for chests, furnaces, barrels, etc.

Optimizations

- Thread Safety: Replaced HashMap with ConcurrentHashMap in ClaimManager, TrustManager, and VisualizationManager - Memory Management: Added comprehensive player data cleanup on quit via PlayerJoinListener - Separated Block Types: Container blocks and interactable blocks now have separate permission checks

New Features

- Command Aliases: Added /c as alias for /claim and /uc as alias for /unclaim - Improved Tab Completion: Now suggests online players for trust/untrust/member commands - CONTAINER Permission: New permission type for accessing chests, furnaces, hoppers, etc.

GUI Improvements

- TrustListGUI Overhaul: - 54-slot inventory with glass pane borders - Online/offline status indicator (green/red) for trusted players - Info item showing total trusted count - Better organized layout with player heads in center area - TrustMenuGUI Overhaul: - 27-slot inventory with glass pane borders - Player head with online status at top - Permission-specific icons (Bricks for BUILD, Lever for INTERACT, Chest for CONTAINER, Ender Pearl for TELEPORT) - Permission descriptions in lore - Clear enabled/disabled status indicators - VisitorMenuGUI Overhaul: - 27-slot inventory with glass pane borders - Info item explaining visitor permissions - Warning for dangerous permissions (BUILD) - Same permission icons and descriptions as TrustMenuGUI

Technical Changes

- Config version bumped to 5 - Plugin version bumped to 1.6 - Added cleanupPlayer() methods to EventListener, CommandHandler, and VisualizationManager - Extended PlayerJoinListener to handle PlayerQuitEvent

added new messages.yml added a config for condole log to stop to prevent console spam and minor bug fixes

Gui fixes and bugs fixes

Update Notes

* Added Villagers Protection and Tamed pets protection * Added per player permission management * New commands added — use /claim help to view the full list.

Configuration Notice

If you're upgrading from version 1.3.1 or newer*, your config files will update automatically. If you're using version 1.3.1 or older, you must delete* your old config.yml to prevent issues.

Do NOT delete claims.yml or trust.yml unless you want to lose your existing claim and trust data.

fixed few bugs and issues

Update Notes

* Numerous bugs and issues have been fixed. * New commands added — use /claim help to view the full list.

Configuration Notice

If you're upgrading from version 1.3 or newer*, your config files will update automatically. If you're using version 1.3 or older, you must delete* your old config.yml to prevent issues.

Do NOT delete claims.yml or trust.yml unless you want to lose your existing claim and trust data.

Key Changes:

- Added auto-saving for trust.yml and claims.yml - Added configurable prefix for messages - Implemented /claim admin unclaim command - Fixed PvP prevention for bow shots - Added new messages for admin unclaim feature

changes

- added /claim visble [always|off] - added tab completer

A land claiming plugin