ВЕРСИИ (35)

## [3.4.0] - 2026-10-06 ### Added - **Configurable Claim Block Purchase Caps:** - Added `maxBonusClaimBlocks` in `config.yml` (hard cap on bonus/bought chunks a player can hold; `0` = unlimited). - Added `maxTotalClaimLimit` in `config.yml` (hard cap on total claim allowance including base limit and bonus blocks; `0` = unlimited). - **Admin Chunk Allowance Management Commands:** - Added `/claim admin set chunk <player> <amount>`: Directly set a player's bonus chunk allowance. Supports `0` or positive values, Minecraft selectors (`@p`, `@s`, `@r`, `@a`), reverse argument ordering, and self-granting. - Added `/claim admin remove chunk <player> <amount>`: Deduct bonus chunks from a player's allowance, clamped to 0 so players cannot have negative bonus chunks. - Added `/claim admin reset chunk [player]`: Reset bonus chunk allowance back to 0 (defaults to self for in-game players). - **Developer API (`LandClaimAPI`):** - Added `setBonusBlocks(UUID playerId, int amount)` to `LandClaimAPI` interface and plugin delegate, allowing addons to directly set bonus allowances. ### Fixed - **Economy Purchase Limits Enforcement:** - Fixed `/claim buy claim`, `/claim buy role`, `/claim buy member`, and `/claim buy warp` executing even when `limitPurchases.enabled` was set to `false` in `LandClaimPlugin-Economy`. - Added bounds checking in `/claim buy claim` enforcing `maxBonusClaimBlocks` and `maxTotalClaimLimit` before charging player funds.

## [3.3.0] - 2026-10-01 ### Added - **Combat Tag PvP Claim Protection Bypass:** - Actively combat-tagged players temporarily lose claim PvP protection while their combat tag is active (`combatTag.combatTagBypass: true`), preventing them from initiating a fight in the wilderness and running into a claim to hide. - Integrated with **DeluxeCombat**, **CombatLogX**, **PvPManager**, and **EternalCombat**. - Added robust combat hooks with reflection and Bukkit/Paper API fallbacks. - **Inactive Claim Auto-Decay & Exemption System:** - Added configurable automatic cleanup of inactive claims (`decay.enabled`, `decay.inactiveDays`, `decay.checkIntervalHours`, `decay.onlyCheckOwner`). - Claims belonging to players who have been offline longer than `inactiveDays` (default: 14 days) are automatically unclaimed and their profiles cleaned up. - Staff and VIP exemption support via permission `landclaim.decay.exempt` and per-player exemption commands. - Added `/claim admin decay run` (trigger manual decay sweep). - Added `/claim admin decay exempt <player> [true|false]` (toggle or set player exemption). - Added `/claim admin decay list` (view all manually exempt players). - Added `INACTIVITY_DECAY` reason to `ClaimDeleteEvent`. - Added `decay_exempt` database column and automatic migration in `SQLPlayerDao`. ### Fixed - **Minecraft Entity Selector Resolution (`@s`, `@p`, `@a`, `@r`):** - Resolved `IllegalStateException` on Paper servers by scheduling entity selector resolution (`Bukkit.selectEntities`) on the primary server thread. - Extracted execution location and executor entity from Brigadier's `CommandSourceStack`, correctly resolving `@s` and `@p` when commands are executed via `/execute at @p ...` or `/execute as @p ...`.

## [3.2.2] - 2026-09-25 ### Added - **Minecraft Entity Selector Support (`@p`, `@s`, `@r`, `@a`):** - Added native entity selector support for `/claim admin add chunk`, `/claim admin edit <player>`, `/claim admin trust list <player>`, and `/claim admin trust who <player>`. - Added selector resolution directly on the main thread (Folia and Paper safe) using `Bukkit.selectEntities()`. - Added selector suggestions (`@p`, `@s`, `@r`, `@a`) in tab completion. - **Flexible Argument Parsing for `/claim admin add chunk`:** - Automatically handles both `<player> <amount>` and `<amount> <player>` orders seamlessly. - Supports single-argument self-grant `/claim admin add chunk <amount>` when executed by in-game players. - Defaults bonus chunk amount to `1` if omitted (`/claim admin add chunk <player>`). - **Comprehensive DeluxeMenus & Citizens 2 Documentation:** - Added complete setup guide with copy-paste configurations and in-game commands for DeluxeMenus chunk shops and Citizens 2 NPC shopkeepers in both docs and README.

## [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

Fixed A bug where other players can place water/lava inside claims

A land claiming plugin