
? LandClaimPlugin
高级领地保护插件
一款功能强大、特性丰富的基于区块的领地保护插件,适用于 Paper 服务器。创建领地档案、保护你的建筑、通过精细的角色权限管理成员、建立联盟、设置传送点,并自定义领地的方方面面。
⚠️ 开发构建版本
开发构建版本由最新的提交自动生成,可能包含未完成的功能、破坏性更改或实验性代码。不建议在生产环境中使用这些构建版本。
如果你选择运行开发版:
- 请预期会出现 Bug、崩溃或不完整的功能。
- 配置文件和数据格式可能会在未经通知的情况下发生变化。
- 不保证向后兼容性。
仅用于测试、抢先体验或提供反馈。
? 下载最新的开发构建版本: GitHub Releases
✨ 功能特性
核心领地系统
- 领地档案 (Claim Profiles) — 使用领地档案管理你的土地。根据服务器配置,玩家可拥有单个档案,或使用多档案系统来管理多个独立的基地,并通过交互式 GUI 快速切换。
- 基于区块的领地 (Chunk-Based Claims) — 16×16 方块的保护区域,简单直观。
- 自动认领 (Auto-Claim) — 行走时自动认领所在的区块。
- 相连领地 (Connected Claims) — 可选要求领地必须相邻(支持对角线连接)。
- 手持领土地图 (小地图) — 在主手/副手或物品展示框中显示实时的 128×128 像素雷达地图,展示区块边界、领地颜色以及玩家实时朝向。
- 交互式选择器 (Interactive Selectors) — 通过玩家的头像以编程方式在线选择玩家,用于信任、成员和盟友的管理。
- 脱困指令 (Unstuck Command) — 安全的
/claim unstuck 功能,可将被困玩家传送到最近的未被占领的安全荒野方块处。
权限系统
- 4 级优先级链 —
所有者 > 角色 > 受信任者 > 访客 — 第一个匹配的层级决定权限
- 自定义角色 (Custom Roles) — 创建和配置自定义角色(例如 Member、CoOwner),具有基于标志位的细粒度权限
- 受信任玩家 (Trusted Players) — 授予特定玩家特定的权限覆盖
- 访客设置 (Visitor Settings) — 配置非成员在你的领地中可以做什么
- 25+ 权限标志位 — 门、陷阱门、容器、工作站、动物、载具、红石等更多功能
社交系统
- 成员系统 (Member System) — 邀请玩家加入你的领地,分配角色并管理访问权限
- 联盟系统 (Ally System) — 在领地之间建立相互联盟,并配置跨领地权限
- 信任系统 (Trust System) — 授予个别玩家针对该玩家的权限覆盖
- 封禁系统 (Ban System) — 完全禁止玩家进入或与你的领地交互。被封禁的玩家在到达领地边界时会被物理推开,并且(如果在封禁时在线)会被传送至外部。此状态在服务器重启后依然保留。
- 传送点系统 (Warp System) — 在你的领地内设置带有自定义图标和每个玩家限制命名的传送点
- 公共传送点 (Public Warps) — 将你的任意传送点发布到全服务器的公共列表中。其他玩家可以浏览并通过
/claim publicwarps 进行传送。
保护机制
- 方块保护 (Block Protection) — 防止未授权的破坏和放置
- 实体保护 (Entity Protection) — 保护动物、盔甲架和物品展示框
- 爆炸保护 (Explosion Protection) — 阻止 TNT、苦力怕和其他爆炸伤害
- 交互保护 (Interaction Protection) — 控制门、容器和工作站的访问
- 物品保护 (Item Protection) — 防止未授权的拾取和丢弃
- 活塞保护 (Piston Protection) — 阻止活塞跨越领地边界推/拉方块
- PvP 保护 (PvP Protection) — 禁用领地内的 PvP
- 战斗标记 PvP 绕过 (Combat Tag PvP Bypass) — 被积极战斗标记的玩家暂时失去对攻击的领地保护,防止在战斗中滥用安全区
- 闲置领地自动衰减 (Inactive Claim Auto-Decay) — 自动清理超过配置时长未活跃的玩家的领地,同时为 VIP 和管理员提供豁免选项
- 载具保护 (Vehicle Protection) — 防止未授权使用和破坏载具
- 指令屏蔽 (Command Blocking) — 在其他玩家的领地内屏蔽特定指令
- 荒野保护 (Wilderness Protection) — 启用
wildernessProtection.enabled 标志位反转默认设置:玩家只能在领地内建造/破坏,永远不能在未占领的区块中建造。专为公会/城镇风格服务器设计。
自定义选项
- 所有者别名 (Owner Alias) — 设置自定义显示名称,以替换 UI 元素、地图钩子和标题中的 Minecraft 用户名
- 领地颜色 (Claim Colors) — 为你的领地选择自定义十六进制颜色,用于地图和边框显示
- 可视化模式 (Visualization Modes) — 在显示实体或基于粒子的边界渲染之间切换
- 进出标题 (Entry/Exit Titles) — 当玩家进入或离开你的领地时显示的自定义 MiniMessage 格式标题
- 重命名领地 (Rename Claims) — 随时更改你领地的显示名称
- 完整消息自定义 (Full Message Customization) — 所有插件消息均可通过 Okaeri Configs 进行配置
? 支持的集成
LandClaimPlugin 无缝集成多种流行的服务器插件,提供开箱即用的互联体验。
?️ Web Map Plugins
在服务器的网络地图上直观展示领地!领地将绘制为与所选颜色匹配的多边形,并包含所有者和面积信息。
- BlueMap
- Dynmap
- Squaremap
- Pl3xMap
⚔️ Combat Tagger Plugins
防止在活跃战斗状态下进行战斗利用和命令滥用。自动检测战斗标记状态:
- DeluxeCombat
- CombatLogX
- PvPManager
- EternalCombat
- Claim Protection Bypass: 处于活跃战斗标记状态的玩家无法逃入领地以躲避 PvP 战斗 —— 领地的 PvP 保护对该玩家暂时失效,直到其标记过期(
combatTag.combatTagBypass: true)。
- Command Blocking: 防止被标记的玩家在战斗期间传送或放弃领地。
?️ WorldGuard
尊重 WorldGuard 区域,当玩家尝试圈地时进行检查。
- Volumetric Intersection Check: 100% 准确的 3D 边界检查,防止玩家在你的出生点或受保护区域上圈地。
- Gap Enforcement: 可配置的领地与 WorldGuard 区域之间的最小距离要求。
- Custom Flag Support: 对区域应用自定义
allow-land-claims WorldGuard 状态标志(例如 Wilderness/Warzone),明确允许玩家在区域内圈地,从而覆盖间隙和交叉保护设置!
? Bedrock / Geyser Support
安装 Geyser 2.x 后,基岩版玩家将获得定制的 UI。无硬性 Geyser 依赖 —— 插件使用反射来检测表单 API,如果未安装 Geyser 则回退到仅 Java 版的聊天提示。
- CustomForm text input 用于基于铁砧的提示(重命名、着色、角色名称)
- ModalForm confirmation 用于破坏性操作(放弃、取消所有圈地、封禁)
- 可视化效果会自动切换为粒子模式以适应基岩版客户端
Technical
- Cloud Command Framework — 异步命令执行,配备专用线程池
- Modular Architecture — 分离的命令组、监听器和管理器
- Eager Class Preloading — 消除 GUI 类首次执行时的延迟峰值
? Addons
插件的公共 API (LandClaimAPI) 和事件总线 (ClaimCreateEvent, ClaimDeleteEvent, PlayerEnterClaimEvent, PlayerLeaveClaimEvent) 允许你在同级 Maven 项目中构建独立的附加组件。软依赖 LandClaimPlugin,以确保仅在父插件存在时才加载附加组件。
Official Addons
Building Your Own
API 暴露了以下功能:
getClaimAt(...), getClaimsByOwner(UUID), getClaimByName(String), getClaimById(UUID)
getAllClaimProfiles() — 每个已加载的领地,用于全局迭代(税收、排行榜等)
transferClaim(Player actor, UUID profileId, UUID newOwnerId) and unclaimAll(Player actor, UUID profileId) — 编程方式的所有权/领地管理(actor 是新所有者或拥有 landclaim.admin 权限)
addBonusBlocks(UUID, int) and getBonusBlocks(UUID) — 用于付费领地块插件
isInCombat(Player) — 战斗标记器挂钩接口
- 完整的领地配置文件模型 —
getOwnedChunks(), getRoles(), getTrustedPlayerFlags() 等
对于希望在领地生命周期中采取行动附加组件,请监听 org.ayosynk.landClaimPlugin.api.event.* 事件。
? Installation
- 下载最新版本并将
LandClaimPlugin.jar 放入你的 plugins/ 文件夹。
- 重启服务器。
- 根据需要配置
plugins/LandClaimPlugin/config.yml。
Requirements: Paper 26.2+ | Java 25+
? Commands
所有命令均以 /claim(别名:/c)为基础。
General Commands
| Command |
Description |
/claim |
圈下你当前所在的区块 |
/claim radius <1-5> |
圈下以当前区块为中心的方形区域区块(例如 1 = 3×3,2 = 5×5) |
/claim profiles |
打开活动配置文件选择器(如果启用了多配置文件功能) |
/claim create <name> |
使用给定名称创建一个新的领地配置文件 |
/claim auto |
切换自动圈地模式(行走时自动圈地) |
/claim map |
获取当前持有的领土地图物品(别名:/claim minimap) |
/claim menu |
打开主要的领地管理 GUI |
/claim info |
查看你所在位置领地的信息 |
/claim visible |
切换领地边界可视化 |
/claim toggle <mode> |
切换可视化模式(display_entities, particles, off) |
/claim visualization <mode> |
/claim toggle 的别名 |
/claim notify |
切换进入和离开领地的聊天通知(别名:/claim chatnotify) |
/claim rename <name> |
重命名你的活动领地配置文件(3-32 个字母数字字符) |
/claim color <color> |
使用命名颜色或十六进制代码更改领地颜色(例如 red, #FF5500) |
/claim unstuck |
如果被困住,安全传送到最近的荒野方块 |
/claim abandon |
删除整个活动领地配置文件及其所有区块 |
/claim pvp <on/off> [time] |
在全局范围内切换领地内的 PvP,可选时间持续时间(秒) |
/unclaim |
取消圈下你当前所在的区块 |
/unclaim auto |
切换自动取消圈地模式(行走时取消你拥有的区块) |
/unclaim radius <1-5> |
取消方形半径内所有你拥有的区块(例如 1 = 3×3,2 = 5×5) |
/unclaim all |
取消属于你活动配置文件的所有区块(会提示确认) |
/unclaim all confirm |
确认取消所有区块 |
Menu Shortcuts
无需通过主菜单导航,直接跳转到特定的 GUI 面板。
| 命令 |
描述 |
/claim menu settings |
打开领地设置(颜色、PvP、可见性等) |
/claim menu members |
打开成员管理 |
/claim menu roles |
打开角色管理 |
/claim menu trusted |
打开受信任玩家管理 |
/claim menu visitors |
打开访客设置 |
/claim menu allies |
打开盟友管理 |
/claim menu map |
获取手持的领土地图 |
/claim menu warps |
打开传送点管理 |
管理命令
成员
| 命令 |
描述 |
/claim member invite <player> |
邀请一名玩家加入你的领地 |
/claim member kick <player> |
将一名成员从你的领地中移除 |
/claim member list |
列出所有成员及其角色 |
/claim accept <name> |
接受待处理的成员邀请 |
/claim deny <name> |
拒绝待处理的成员邀请 |
信任
| 命令 |
描述 |
/claim trust invite <player> |
向一名玩家发送信任邀请 |
/claim trust accept |
接受待处理的信任邀请 |
/claim trust deny |
拒绝待处理的信任邀请 |
/claim trust remove <player> |
移除受信任的玩家 |
/claim trust list |
列出所有受信任的玩家及其权限标志 |
盟友
| 命令 |
描述 |
/claim ally invite <name> |
向其他领地发送结盟请求 |
/claim ally accept <name> |
接受结盟请求 |
/claim ally deny <name> |
拒绝结盟请求 |
/claim ally remove <name> |
解除现有的联盟关系 |
传送点与管理员
| 命令 |
描述 |
| `/claim setwarp <name> [public |
private]` |
/claim delwarp <name> |
删除一个传送点 |
/claim warp <name> [warpName] |
传送至你的传送点,或公共传送点(/claim warp <name> 或 /claim warp <owner>:<name>) |
/claim publicwarps |
打开服务器范围的公共传送点浏览器 GUI |
/claim warps |
打开当前领地的传送点管理 GUI |
/claim admin check |
查看详细的领地信息(所有者 UUID、配置文件名称) |
/claim admin unclaim |
强制取消你当前所在区块的领地归属 |
/claim admin edit <player> |
打开任意玩家的领地管理 GUI(支持 @p, @s, @r) |
/claim admin add chunk <player> <amount> |
为玩家的领地上限增加额外的可领取区块 (控制台 & 玩家)。支持选择器(@p, @s, @r, @a)、反向参数顺序(<amount> <player>)以及自我授予(<amount>)。 |
/claim admin setalias <claim> <alias> |
设置或重置所有者的自定义别名 (控制台 & 玩家) |
/claim admin trust list <owner> |
列出该所有者信任的玩家 (控制台 & 玩家,支持选择器) |
/claim admin trust who <player> |
列出该玩家受到信任的领地 (控制台 & 玩家,支持选择器) |
/claim admin decay run |
触发手动扫描以处理不活跃领地的衰减 (控制台 & 玩家) |
/claim admin decay exempt <player> [true|false] |
切换或设置玩家是否豁免领地衰减 (控制台 & 玩家,支持选择器) |
/claim admin decay list |
列出所有手动豁免领地衰减的玩家 (控制台 & 玩家) |
/claim admin reload |
重新加载配置和消息 (控制台 & 玩家) |
/claim reload |
重新加载配置和消息的快捷方式 (控制台 & 玩家) |
? 权限
| 权限 |
描述 |
默认值 |
landclaim.* |
所有 LandClaim 权限 |
false |
landclaim.claim |
基本领地领取能力 |
✅ true |
landclaim.minimap |
访问手持领土地图 |
✅ true |
landclaim.auto |
使用自动领取模式 |
✅ true |
landclaim.admin |
管理员命令 & 绕过所有保护 |
op |
landclaim.decay.exempt |
使玩家免于自动领地衰减 |
op |
landclaim.update.notify |
在加入时接收更新通知 |
op |
landclaim.limit.<n> |
覆盖区块领取上限(例如 landclaim.limit.50) |
false |
landclaim.list |
列出领地 |
✅ true |
landclaim.warps.limit.<n> |
覆盖传送点上限(例如 landclaim.warps.limit.10) |
false |
landclaim.createrole.<n> |
覆盖自定义角色的最大数量 |
false |
? 商店与 NPC 集成 (DeluxeMenus & Citizens 2)
LandClaimPlugin 与 DeluxeMenus 和 Citizens 2 无缝集成,允许玩家使用物品(如金块)或经济货币购买额外的领地区块。
1. DeluxeMenus GUI 商店
在你的 DeluxeMenus 配置中(例如 plugins/DeluxeMenus/gui_menus/claimshop.yml):
menu_title: '&8购买领地区块'
open_command: claimshop
size: 27
items:
buy_chunk:
material: GOLD_BLOCK
slot: 13
display_name: '&e&l购买 1 个额外区块'
lore:
- '&7费用: &630x 金块'
- '&7你的区块: &a%landclaim_chunks% &7/ &b%landclaim_limit%'
- ''
- '&a&l点击 &f以购买 1 个领地区块!'
left_click_commands:
- '[console] clear %player_name% gold_block 30'
- '[console] claim admin add chunk %player_name% 1'
- '[message] &a成功交易 30 个金块换取 1 个额外领地区块!'
- '[sound] ENTITY_PLAYER_LEVELUP 1 1'
- '[refresh]'
left_click_requirement:
requirements:
has_gold_blocks:
type: has item
material: GOLD_BLOCK
amount: 30
deny_commands:
- '[message] &c你需要背包中有 30 个金块才能购买此项!'
- '[sound] BLOCK_ANVIL_LAND 1 1'
2. Citizens 2 NPC 设置
-
选项 A:将 NPC 链接到 DeluxeMenus(推荐)
/npc create "Territory Surveyor" --type player
/npc select
/npc command add -p "claimshop"
(右键点击该 NPC 将为玩家打开 /claimshop GUI!)
-
选项 B:直接控制台命令
/npc select
/npc command add -c "claim admin add chunk <p> 1"
(Citizens 占位符 <p> 和 Minecraft 实体选择器 @p 均受支持!)
如需完整的设置指南和 Vault 经济系统示例,请参阅我们的 集成文档。
? 披露与透明度声明
为符合平台准则及 Modrinth 披露政策:
? AI 辅助声明
本项目在维护者的直接设计、审查和测试下,使用 AI 辅助(大型语言模型)进行代码起草、重构、优化和文档编写。所有游戏逻辑、安全机制和数据库事务均由人工架构并经过审计。
? 外部网络调用与遥测数据
LandClaimPlugin 会与以下外部端点进行通信:
- Modrinth API (
https://api.modrinth.com):在启动时查询公共 Modrinth v2 API 以检查新版本。仅发送标准的 User-Agent 标头(LandClaimPlugin/{version})。不共享任何玩家或服务器识别数据。退出方式:在 config.yml 中设置 updateChecker.enabled: false。
- bStats 分析 (
https://bstats.org):通过 bStats 收集匿名使用指标(Java 版本、服务器软件、在线玩家数量)。不收集任何个人可识别信息。退出方式:在 plugins/bStats/config.yml 中设置 enabled: false。
- Redis 与远程 MySQL(可选):仅连接到用户配置的端点,用于跨服务器发布/订阅同步或集中式数据库存储。
? 快速链接

? LandClaimPlugin
Advanced Territory Protection for Minecraft
A powerful, feature-rich chunk-based land protection plugin for Paper servers. Create claim profiles, protect your builds, manage members with granular roles, form alliances, set warps, and customize every aspect of your territory.
⚠️ DEVELOPMENT BUILDS
Development builds are automatically generated from the latest commits and may include unfinished features, breaking changes, or experimental code. These builds are not recommended for production use.
If you choose to run a dev build:
- Expect bugs, crashes, or incomplete functionality.
- Configs and data formats may change without notice.
- No guarantee of backward compatibility.
Use them only for testing, early access, or contributing feedback.
? Download latest dev builds: GitHub Releases
✨ Features
Core Claiming
- Claim Profiles — Manage your land using claim profiles. Depending on server configuration, players can own a single profile or utilize the Multi-Profile System to manage multiple independent bases and quickly switch between them via an interactive GUI.
- Chunk-Based Claims — 16×16 block protection zones, simple and intuitive.
- Auto-Claim — Automatically claim chunks as you walk.
- Connected Claims — Optionally require claims to be adjacent (with diagonal support).
- Held Territory Map (Minimap) — Live 128×128 pixel radar map in hand/off-hand or Item Frames showing chunk boundaries, claim colors, and real-time player orientation.
- Interactive Selectors — Programmatically select online players via their heads for Trust, Member, and Ally management.
- Unstuck Command — A safe
/claim unstuck feature that teleports trapped players to the nearest safe wilderness block.
Permission System
- 4-Tier Priority Chain —
Owner > Role > Trusted > Visitor — the first matching tier decides
- Custom Roles — Create and configure custom roles (e.g., Member, CoOwner) with granular flag-based permissions
- Trusted Players — Grant individual players specific permission overrides
- Visitor Settings — Configure what non-members can do in your claims
- 25+ Permission Flags — Doors, trapdoors, containers, workstations, animals, vehicles, redstone, and more
Social Systems
- Member System — Invite players to join your claim, assign them roles, and manage access
- Ally System — Form mutual alliances between claims with configurable inter-claim permissions
- Trust System — Grant individual players per-player permission overrides
- Ban System — Hard-deny a player from entering or interacting with your claim. Banned players are physically pushed back at chunk boundaries and (if online at the moment of the ban) teleported outside. Survives server restarts.
- Warp System — Set named warps within your claims with custom icons and per-player limits
- Public Warps — Publish any of your warps to the server-wide public list. Other players can browse and teleport via
/claim publicwarps.
Protection
- Block Protection — Prevent unauthorized breaking and placing
- Entity Protection — Protect animals, armor stands, and item frames
- Explosion Protection — Block TNT, creeper, and other explosion damage
- Interaction Protection — Control door, container, and workstation access
- Item Protection — Prevent unauthorized pickup and drop
- Piston Protection — Block pistons from pushing/pulling across claim borders
- PvP Protection — Disable PvP inside claims
- Combat Tag PvP Bypass — Actively combat-tagged players temporarily lose claim protection against attacks, preventing safe-zone abuse during fights
- Inactive Claim Auto-Decay — Automatically clean up claims from players inactive for a configurable period, with exemption options for VIPs and staff
- Vehicle Protection — Prevent unauthorized vehicle use and destruction
- Command Blocking — Block specific commands inside other players' claims
- Wilderness Protection — Opt-in
wildernessProtection.enabled flag flips the default: players can only build/break inside claims, never in unclaimed chunks. Designed for clan/town-style servers.
Customization
- Owner Alias — Set a custom display name to replace your Minecraft username in UI elements, map hooks, and titles
- Claim Colors — Pick a custom hex color for your claim used on maps and borders
- Visualization Modes — Toggle between Display Entity or Particle-based boundary rendering
- Entry/Exit Titles — Custom MiniMessage-formatted titles shown when players enter or leave your claim
- Rename Claims — Change your claim's display name at any time
- Full Message Customization — All plugin messages are configurable via Okaeri Configs
? Supported Integrations
LandClaimPlugin seamlessly hooks into various popular server plugins to provide an interconnected experience out-of-the-box.
?️ Web Map Plugins
Visualize claims directly on your server's web map! Claims are drawn as colored polygons matching the claim's chosen color, complete with owner and size information.
- BlueMap
- Dynmap
- Squaremap
- Pl3xMap
⚔️ Combat Tagger Plugins
Prevent combat exploitation and command abuse while in active combat. Automatically detects combat tagging:
- DeluxeCombat
- CombatLogX
- PvPManager
- EternalCombat
- Claim Protection Bypass: Actively combat-tagged players cannot flee into claims to hide from PvP fights — claim PvP protection temporarily drops for them until their tag expires (
combatTag.combatTagBypass: true).
- Command Blocking: Prevents tagged players from teleporting or abandoning claims during combat.
?️ WorldGuard
Respect WorldGuard regions when players attempt to claim land.
- Volumetric Intersection Check: 100% accurate 3D boundary checking to prevent players from claiming over your spawn or protected areas.
- Gap Enforcement: Configurable required distance between claims and WorldGuard regions.
- Custom Flag Support: Apply the custom
allow-land-claims WorldGuard state flag to regions (e.g., Wilderness/Warzone) to explicitly allow players to claim land inside them, overriding the gap and intersection protections!
? Bedrock / Geyser Support
Bedrock players get a tailored UI when Geyser 2.x is installed. No hard Geyser dependency — the plugin uses reflection to detect the form API and falls back to the Java-only chat prompts if Geyser is missing.
- CustomForm text input for anvil-based prompts (rename, color, role name)
- ModalForm confirmation for destructive actions (abandon, unclaim all, ban)
- Visualization automatically switches to particle mode for Bedrock clients
Technical
- Cloud Command Framework — Async command execution with dedicated thread pools
- Modular Architecture — Separate command groups, listeners, and managers
- Eager Class Preloading — Eliminates first-execution lag spikes for GUI classes
? Addons
The plugin's public API (LandClaimAPI) and event bus (ClaimCreateEvent,
ClaimDeleteEvent, PlayerEnterClaimEvent, PlayerLeaveClaimEvent) let
you build standalone addons in a sibling Maven project. Soft-depend on
LandClaimPlugin so the addon only loads when the parent is present.
Official Addons
| Addon |
Description |
Repository |
| LandClaimPlugin-Economy |
Charge for claiming, warps, and member invites; per-chunk daily tax with auto-unclaim; server-wide claim marketplace + time-limited auctions with a GUI browser. Vault-based. |
synkfr/LandClaimPlugin-Eco-Addon |
Building Your Own
The API exposes:
getClaimAt(...), getClaimsByOwner(UUID), getClaimByName(String), getClaimById(UUID)
getAllClaimProfiles() — every loaded claim, for global iteration (tax, leaderboards, etc.)
transferClaim(Player actor, UUID profileId, UUID newOwnerId) and unclaimAll(Player actor, UUID profileId) — programmatic ownership / claim management (the actor is either the new owner or has landclaim.admin)
addBonusBlocks(UUID, int) and getBonusBlocks(UUID) — for paid-claim-block plugins
isInCombat(Player) — hook for combat-taggers
- The full claim profile model —
getOwnedChunks(), getRoles(), getTrustedPlayerFlags(), etc.
For addons that want to act on claim lifecycle, listen for
org.ayosynk.landClaimPlugin.api.event.* events.
? Installation
- Download the latest release and drop
LandClaimPlugin.jar into your plugins/ folder.
- Restart your server.
- Configure
plugins/LandClaimPlugin/config.yml to your liking.
Requirements: Paper 26.2+ | Java 25+
? Commands
All commands use /claim (alias: /c) as the base.
General Commands
| Command |
Description |
/claim |
Claim the chunk you're standing in |
/claim radius <1-5> |
Claim a square area of chunks centered on your current chunk (e.g. 1 = 3×3, 2 = 5×5) |
/claim profiles |
Open the active profile selector (if Multi-Profile is enabled) |
/claim create <name> |
Create a new claim profile with the given name |
/claim auto |
Toggle auto-claim mode (claim chunks as you walk) |
/claim map |
Receive the live held Territory Map item (alias: /claim minimap) |
/claim menu |
Open the main claim management GUI |
/claim info |
View info about the claim at your location |
/claim visible |
Toggle claim boundary visualization |
/claim toggle <mode> |
Switch visualization mode (display_entities, particles, off) |
/claim visualization <mode> |
Alias for /claim toggle |
/claim notify |
Toggle claim enter and leave chat notifications (alias: /claim chatnotify) |
/claim rename <name> |
Rename your active claim profile (3-32 alphanumeric characters) |
/claim color <color> |
Change claim color using a named color or hex code (e.g., red, #FF5500) |
/claim unstuck |
Safely teleport to the nearest wilderness block if trapped |
/claim abandon |
Delete your entire active claim profile and all its chunks |
/claim pvp <on/off> [time] |
Toggle PvP globally in the claim, with an optional time duration in seconds |
/unclaim |
Unclaim the chunk you're standing in |
/unclaim auto |
Toggle auto-unclaim mode (unclaim your owned chunks as you walk) |
/unclaim radius <1-5> |
Unclaim all your owned chunks in a square radius (e.g. 1 = 3×3, 2 = 5×5) |
/unclaim all |
Unclaim all chunks belonging to your active profile (prompts for confirmation) |
/unclaim all confirm |
Confirm unclaiming all chunks |
Menu Shortcuts
Jump directly to specific GUI panels without navigating through the main menu.
| Command |
Description |
/claim menu settings |
Open claim settings (color, PvP, visibility, etc.) |
/claim menu members |
Open member management |
/claim menu roles |
Open role management |
/claim menu trusted |
Open trusted player management |
/claim menu visitors |
Open visitor settings |
/claim menu allies |
Open ally management |
/claim menu map |
Receive the held Territory Map |
/claim menu warps |
Open warp management |
Management Commands
Members
| Command |
Description |
/claim member invite <player> |
Invite a player to join your claim |
/claim member kick <player> |
Remove a member from your claim |
/claim member list |
List all members and their roles |
/claim accept <name> |
Accept a pending member invitation |
/claim deny <name> |
Deny a pending member invitation |
Trust
| Command |
Description |
/claim trust invite <player> |
Send a trust invitation to a player |
/claim trust accept |
Accept a pending trust invitation |
/claim trust deny |
Deny a pending trust invitation |
/claim trust remove <player> |
Remove a trusted player |
/claim trust list |
List all trusted players and their flags |
Allies
| Command |
Description |
/claim ally invite <name> |
Send an alliance request to another claim |
/claim ally accept <name> |
Accept an alliance request |
/claim ally deny <name> |
Deny an alliance request |
/claim ally remove <name> |
Remove an existing alliance |
Warps & Admin
| Command |
Description |
| `/claim setwarp <name> [public |
private]` |
/claim delwarp <name> |
Delete a warp |
/claim warp <name> [warpName] |
Teleport to your warp, or a public warp (/claim warp <name> or /claim warp <owner>:<name>) |
/claim publicwarps |
Open the server-wide public warps browser GUI |
/claim warps |
Open the active claim's warp management GUI |
/claim admin check |
View detailed claim info (owner UUID, profile name) |
/claim admin unclaim |
Force-unclaim the chunk you're standing in |
/claim admin edit <player> |
Open any player's claim management GUI (supports @p, @s, @r) |
/claim admin add chunk <player> <amount> |
Add bonus claim chunks to a player's limit (Console & Player). Supports selectors (@p, @s, @r, @a), reverse ordering (<amount> <player>), and self-granting (<amount>). |
/claim admin setalias <claim> <alias> |
Set or reset an owner's custom alias (Console & Player) |
/claim admin trust list <owner> |
List players trusted by this owner (Console & Player, supports selectors) |
/claim admin trust who <player> |
List claims where this player is trusted (Console & Player, supports selectors) |
/claim admin decay run |
Trigger a manual scan to decay inactive claims (Console & Player) |
/claim admin decay exempt <player> [true|false] |
Toggle or set a player's exemption from claim decay (Console & Player, supports selectors) |
/claim admin decay list |
List all players manually exempt from claim decay (Console & Player) |
/claim admin reload |
Reload configuration and messages (Console & Player) |
/claim reload |
Shortcut to reload configuration and messages (Console & Player) |
? Permissions
| Permission |
Description |
Default |
landclaim.* |
All LandClaim permissions |
false |
landclaim.claim |
Basic claiming ability |
✅ true |
landclaim.minimap |
Access to the held Territory Map |
✅ true |
landclaim.auto |
Use auto-claim mode |
✅ true |
landclaim.admin |
Admin commands & bypass all protection |
op |
landclaim.decay.exempt |
Exempts player from automatic claim decay |
op |
landclaim.update.notify |
Receive update notifications on join |
op |
landclaim.limit.<n> |
Override the chunk claim limit (e.g., landclaim.limit.50) |
false |
landclaim.list |
List claims |
✅ true |
landclaim.warps.limit.<n> |
Override the warps limit (e.g., landclaim.warps.limit.10) |
false |
landclaim.createrole.<n> |
Override the max number of custom roles |
false |
? Shop & NPC Integration (DeluxeMenus & Citizens 2)
LandClaimPlugin integrates seamlessly with DeluxeMenus and Citizens 2 to allow players to purchase extra claim chunks with items (e.g. Gold Blocks) or economy currency.
1. DeluxeMenus GUI Shop
In your DeluxeMenus configuration (e.g. plugins/DeluxeMenus/gui_menus/claimshop.yml):
menu_title: '&8Buy Land Claim Chunks'
open_command: claimshop
size: 27
items:
buy_chunk:
material: GOLD_BLOCK
slot: 13
display_name: '&e&lBuy 1 Extra Chunk'
lore:
- '&7Cost: &630x Gold Block'
- '&7Your Chunks: &a%landclaim_chunks% &7/ &b%landclaim_limit%'
- ''
- '&a&lCLICK &fto purchase 1 claim chunk!'
left_click_commands:
- '[console] clear %player_name% gold_block 30'
- '[console] claim admin add chunk %player_name% 1'
- '[message] &aSuccessfully traded 30 Gold Blocks for 1 extra claim chunk!'
- '[sound] ENTITY_PLAYER_LEVELUP 1 1'
- '[refresh]'
left_click_requirement:
requirements:
has_gold_blocks:
type: has item
material: GOLD_BLOCK
amount: 30
deny_commands:
- '[message] &cYou need 30 Gold Blocks in your inventory to buy this!'
- '[sound] BLOCK_ANVIL_LAND 1 1'
2. Citizens 2 NPC Setup
-
Option A: Link NPC to DeluxeMenus (Recommended)
/npc create "Territory Surveyor" --type player
/npc select
/npc command add -p "claimshop"
(Right-clicking the NPC opens the /claimshop GUI for the player!)
-
Option B: Direct Console Command
/npc select
/npc command add -c "claim admin add chunk <p> 1"
(Both Citizens placeholder <p> and Minecraft entity selector @p are supported!)
For complete setup guides and Vault economy examples, see our Integrations Documentation.
? Disclosures & Transparency
In compliance with platform guidelines and Modrinth disclosure policies:
? AI Assistance Disclosure
This project uses AI assistance (LLMs) for code drafting, refactoring, optimization, and documentation under the direct design, review, and testing of the maintainers. All game logic, security gates, and database transactions are human-architected and audited.
? External Network Calls & Telemetry
LandClaimPlugin communicates with the following external endpoints:
- Modrinth API (
https://api.modrinth.com): Queries the public Modrinth v2 API on startup to check for new versions. Sends only the standard User-Agent header (LandClaimPlugin/{version}). No player or server-identifying data is shared. Opt-out: set updateChecker.enabled: false in config.yml.
- bStats Analytics (
https://bstats.org): Collects anonymous usage metrics (Java version, server software, online player count) via bStats. No personally identifiable information is collected. Opt-out: set enabled: false in plugins/bStats/config.yml.
- Redis & Remote MySQL (Optional): Connects only to user-configured endpoints for cross-server pub/sub synchronization or centralized database storage.
? Quick Links
评论 0
登录后参与评分
还没有评论,来抢沙发吧