DyClaim — 区块认领,化繁为简
保护你的建筑。共享你的土地。管理你的认领区域。
DyClaim 是一款基于命令的区块认领插件,适用于生存、SMP 和经济类服务器。无需图形界面(GUI),即可保护土地、指定可使用者并管理认领设置。
DyClaim 将临时信任、共同所有权、玩家交易、自动认领和可配置的保护功能与熟悉的基于命令的工作流相结合。版本 1.3.1 为 DyMarket 等庄园和经济插件添加了开发者写入 API,并使保护检查更加轻量。版本 1.3.0 增加了认领飞行、按认领控制火焰蔓延、封闭认领以及隐藏认领通知的选择,并优化了保护检查的性能。版本 1.2.0 使 DyClaim 成为适用于所有服务器的单一 JAR 文件(包括 Folia),并增加了服务器认领、对整个权限组的信任以及发光的认领边界。现有的命令、设置和认领数据均得以保留。
1.3.1 新增内容
- 开发者写入 API:
DyClaimAPI 新增了 getClaimById、transferClaim、setTrust、removeTrust 和 getTrustRights,使得 DyMarket 等庄园和经济插件可以出售、租赁和出租认领区域。更改会触发常规的转让和信任事件。请参阅 开发者 API。
- 更轻量的保护检查: 认领通过方块坐标查找,在查询任何权限之前先处理所有者和受信任玩家,并且拒绝消息每种语言只构建一次而非每次事件都构建。在 Paper、Purpur 和 Folia 上,拒绝信息以预渲染组件的形式发送给玩家。不改变消息文本和保护结果。
1.3.0 新增内容
- 认领飞行:
/claim fly [on|off] 允许你在自己的认领区域以及你可以建造的认领区域内飞行。离开时飞行停止,返回时恢复;几秒钟内的坠落伤害将被豁免。需要权限 dyclaim.fly(默认 OP)。
- 火焰控制:
/claim fire 允许火焰在认领区域内蔓延并烧毁方块。认领区域默认防火(protection.fire-spread)。
- 封闭认领:
/claim entry 阻止访客进入;所有者、共同所有者以及受信任的玩家或组仍可进入。认领区域默认开放(protection.visitor-entry)。
- 认领通知:
/claim notices [on|off] 为你隐藏或显示进出通知。命名认领会显示其名称,且通知可以以标题形式显示(notification.use-title)。
- 性能优化: 认领查找使用区块索引,保护规则和热设置在每次配置加载时仅计算一次,玩家加入和退出不再在主线程上写入文件。
所有新的保护设置均遵循 default / forced-value / player-toggle 结构,其默认值确保现有服务器保持不变。请参阅 更新日志。
1.2.1 新增内容
访客容器访问。 /claim containers 允许访客在你的认领区域内打开箱子、 barrels、潜影盒、熔炉、漏斗、发射器和炼药锅。访客仍然不能破坏或放置方块。服务器管理员可以通过 protection.visitor-containers 控制此功能(默认关闭),类似于访客门和活板门。
1.2.0 新增内容
适用于所有服务器的单一 JAR。 DyClaim-1.3.1.jar 可在 Bukkit、Spigot、Paper、Purpur 和 Folia 上运行。DyClaim 在启动时检测 Folia;使用独立 1.1.0 Folia 版本的服务器可以切换到该版本。
服务器认领。 /claim admin server 保护你所在的区块供服务器使用:无所有者、无价格、无数量限制。只有拥有 dyclaim.admin.serverclaims 权限的管理员才能管理它,执行 /claim admin server remove 可移除该认领。
群组信任。 /claim trust group:<name> 信任某个权限组中的所有成员;LuckPerms 会向其成员授予 group.<name> 权限。取消信任和信任列表的操作方式相同。
新边界效果。 /claim see 绘制发光线条,仅限你自己在 Minecraft 1.19.4 及更高版本的客户端上看到。设置 visualization.style: particles 可恢复粒子边界效果。
版本 1.1.0 增加了按权限划分的认领上限、认领消息、访客封禁、PlaceholderAPI 支持、Web 地图图层、从 GriefPrevention 和 ClaimChunk 导入数据、开发者 API 以及德语、西班牙语和俄语的消息支持。
选择你的服务器版本
| 服务器 |
JAR 文件 |
| Bukkit, Spigot, Paper, Purpur, Folia |
DyClaim-1.3.1.jar |
一个 JAR 文件服务于所有支持的服务器。替换前请停止服务器并备份完整的 DyClaim 数据文件夹;认领数据保持在 schema 2 格式。本次发布没有 Velocity/BungeeCord 配套组件。
Java 17 字节码;请使用你的服务器所需的运行时环境。可选集成也必须支持你选择的平台。平台详情 · 命令指南 · 集成与导入 · 下载与校验和
为什么选择 DyClaim?
零冗余。 没有复杂的 GUI,没有不必要的功能。只有简洁、快速的区块保护,即开即用。可选系统在你启用之前保持禁用状态。
按认领设置。 每个认领都有独立的 PvP、爆炸和怪物生成开关,以及用于控制村民伤害和访客对门、活板门和容器访问权限的设置。玩家可以在服务器规则范围内自定义其土地的运行方式。
自动语言支持。 DyClaim 会检测每位玩家的 Minecraft 语言,并以该语言显示命令和消息。英语、土耳其语、德语、西班牙语和俄语开箱即用,TAB 补全也会跟随当前活跃语言。
与你的服务器兼容。 可选的 WorldGuard、GriefPrevention、Towny、Lands、Residence 和 GriefDefender 钩子有助于防止领地重叠。Vault 连接经济功能,Floodgate 启用基岩版检测和区块边界,PlaceholderAPI 提供 DyClaim 占位符,BlueMap、Dynmap 和 squaremap 在网页地图上显示领地。已安装集成会自动检测;核心领地功能无需它们即可工作。
对性能保护的理性审视

在 Purpur 1.20.4 上,拥有 50 个领地面积,测试于 2026 年 11 月 12 日,DyClaim 1.3.1 在该合成工作负载的所有三列中观测到的中位数最低:所有者允许的方块破坏检查(0.364 对比 GriefPrevention 的 0.586)、访客被阻止的检查(2.642 对比 14.659)以及 50% / 50% 混合模式(1.505 对比 7.604),单位为每 1,000 次事件的毫秒数,包含默认拒绝反馈。Paper、Purpur 和 Folia 上访客侧的大部分优势来自于发送预渲染组件;Spigot 保留文本路径,因此未获得这部分优势。这些是事件处理持续时间,而非 CPU 或内存使用情况,且不能确立在所有工作负载中的绝对优势。
方法、结果和局限性
以你的方式圈地
使用 /claim 圈选你当前所在的区块。服务器管理员可以配置价格、冷却时间、总/世界限制、通过 dyclaim.limit.<number> 权限实现的等级限制以及不同所有者之间的间距。添加 Vault 和经济插件提供商以实现付费圈地和退款,或者在不依赖经济插件的情况下使用核心圈地功能。
为你的领地命名,选择安全重生点,并通过编号或名称传送。分页列表显示位置,而领地信息展示所有权、有效设置和销售状态。进入时的操作栏显示所有者和 PvP 状态,所有者可以通过 /claim message 添加简短的欢迎消息。Java 粒子边框帮助玩家查看区块边界;可选的 Floodgate 路径为基岩版玩家提供方块边界。
自动圈地可以在你行走时获取符合条件的区块。它尊重余额、限制、冷却时间和获取规则,并且免费自动圈地需要显式配置。
分享访问权限而不放弃所有权
使用永久信任或授予 30m、2h 或 7d 的临时访问权限。分别控制建造、容器、门、陷阱门、红石、实体和传送。一个被信任开门的玩家不会自动获得进入箱子的权限。
邀请一名共同所有者并获得其同意,或将所有权转让给在线玩家。共同拥有的领地计入限制。共同所有者可以管理信任和设置,但不能出售、删除或转让领地。转让会清除之前的信任、共同所有权、氏族访问和销售列表。
要将某人完全排除在外,请使用 /claim ban <player> [duration] 阻止他们步行或传送到领地内。所有者、共同所有者和管理员不能被禁止。
可选的 SimpleClans 适配器添加了实验性的氏族信任功能。
具有清晰控制的保护
- 方块放置、破坏、容器和支持的实体交互。
- 每个领地的 PvP、爆炸、怪物爆炸和敌对怪物生成设置。
- 默认阻止玩家对村民造成伤害,但不阻止交易。
- 访客对门、陷阱门和容器的独立访问权限。
- 访客和怪物践踏农田的独立策略。
- 跨所有者的活塞、流体和漏斗检查;双层箱的两个部分均受保护。
- 放置床和其他多方块结构时,对每个受影响的方块进行检查。
- 对支持的方块变换和告示牌编辑的访问检查。
- 玩家拥有的狼以及有害的溅射型或滞留型药水的 PvP 保护。
- 农场动物、车辆和拴绳操作的实体访问检查。
- 可配置的发射器输出及外部树木或施肥生长的边界保护。
- 全局/世界默认值、强制保护规则和锁定的玩家切换。
可选的怪物清理功能在已加载的领地区块中使用有界检查,具有可配置的规模和命名/驯服例外。它还可以移除领地内已有的符合条件怪物。外部红石检查覆盖附近的电源效应,而不是每一个可能的电路。
交易领地并管理你的服务器
启用玩家市场以列出、取消和购买领地。配置价格上限并从卖方收益中扣除税费;/claim sell 保留其服务器退款目的。购买确认会重新检查其上下文,交易日志记录不确定的经济结果以便对账。
管理员可以管理领地、价格、退款、世界黑名单和配置。其他工具包括会话绕过、获取禁止以及带有预览、确认、备份和批处理的非活跃清理。定时清理功能可单独使用。/claim admin server 保护出生点或其他没有所有者的服务器区域。从 GriefPrevention 或 ClaimChunk 迁移的服务器可以使用 /dyclaim admin import 导入现有领地,首先进行预览和备份。
可选的访客警告功能允许所有者/共同所有者警告其领地内的未经授权玩家。共享冷却时间防止交替所有者的制裁加速。默认规则使用 180 秒内的三次警告、60 秒的冷却时间和两天的制裁。
五种语言,自动切换
使用 lang: auto,玩家根据其保存的偏好或 Minecraft 语言接收消息。英语、土耳其语、德语、西班牙语和俄语客户端获得各自的語言;其他语言则回退到英语。
TAB 仅显示有效语言。 键入英文命令词始终有效,包括操作词和信任权限名称。
玩家可以使用 /claim lang auto|en|tr|de|es|ru 选择语言。管理员可以通过 /claim admin lang en|tr|de|es|ru 强制为所有人设定语言,这将优先于个人偏好。选择 auto 可恢复自动选择。
命令
| 命令 |
用途 |
/claim |
认领当前所在区块 |
/claim sell, /unclaim |
出售或移除你的领地 |
/claim trust <player> [duration] |
授予永久或临时访问权限 |
/claim trust <player> <right> <allow|deny> |
更改单个信任权限 |
/claim trust group:<name> [duration] |
信任权限组中的所有人 |
/claim untrust <player>, /claim trustlist |
管理信任关系 |
/claim coowner add <player>, /claim coowner remove |
管理一名共同所有者 |
/claim transfer <player> |
提议所有权转让 |
/claim market list <price>, /claim market cancel, /claim market buy |
交易领地 |
/claim auto [on|off] |
切换自动认领功能 |
/claim name <name>, /claim setspawn |
设置名称或安全出生点 |
/claim tp <number|name>, /claim list [page] |
浏览你的领地 |
/cltp <number|name> |
/claim tp 的简写形式 |
/claim info, /claim see |
查看领地信息或显示边界 |
/claim pvp, /claim explosion [mob], /claim mob |
更改未解锁的保护设置 |
/claim villager, /claim doors, /claim trapdoors, /claim containers |
更改村民/访客设置 |
/claim warn <player> |
警告未经授权的玩家 |
/claim message <text|clear> |
向访客显示消息 |
/claim ban <player> [duration], /claim unban <player>, /claim banlist |
禁止某玩家进入你的领地 |
/claim lang <auto|en|tr|de|es|ru> |
选择你的语言 |
/claim fly [on|off] |
在你自己的领地及可建造的领地中飞行 |
/claim fire |
允许或禁止火焰在此领地蔓延 |
/claim entry |
开放或关闭此领地供访客进入 |
/claim notices [on|off] |
显示或隐藏领地进出提示 |
/claim help [page] |
游戏内分页帮助 |
/confirm, /cancel |
接受或拒绝待处理的操作 |
/dyc 作为 /claim 的简写形式使用,例如 /dyc list。管理员可以使用 /dyca 作为 /claim admin 的简写;对于没有 dyclaim.admin 权限的玩家,该命令将被隐藏。请使用 /claim help 和 /claim admin 获取游戏内帮助。TAB 补全建议会根据权限和语言进行过滤。旧的 trustperm 和 mobexplosion 别名仍然有效;帮助和根 TAB 使用分组命令。信任权限包括 build(建造)、containers(容器)、doors(门)、trapdoors(活板门)、redstone(红石)、entities(实体)和 teleport(传送)。
控制台发送者可以使用 claim admin reload 以及支持的全局配置命令(enable、disable、price、pricediff、cooldown、prefix、economy、lang、blacklist),前提是满足现有的管理员权限检查。需要玩家、位置或玩家确认的命令仅限玩家使用。
权限
| 权限 |
默认值 |
用途 |
dyclaim.player |
所有人 |
玩家命令组 |
dyclaim.claim |
所有人 |
认领区块 |
dyclaim.sell |
所有人 |
出售或移除领地 |
dyclaim.see |
所有人 |
显示领地边界 |
dyclaim.info |
所有人 |
查看领地信息 |
dyclaim.list |
所有人 |
列出领地 |
dyclaim.trust |
所有人 |
管理信任和访问权限 |
dyclaim.teleport |
所有人 |
传送到领地 |
dyclaim.settings |
所有人 |
更改未锁定的领地设置 |
dyclaim.coowner |
所有人 |
管理共同所有权 |
dyclaim.transfer |
所有人 |
转让所有权 |
dyclaim.market |
所有人 |
使用玩家市场 |
dyclaim.auto |
所有人 |
使用自动认领 |
dyclaim.name |
所有人 |
命名领地 |
dyclaim.setspawn |
所有人 |
设置领地传送目的地 |
dyclaim.warn |
所有人 |
警告未经授权的访客 |
dyclaim.message |
所有人 |
设置领地消息 |
dyclaim.ban |
所有人 |
禁止访客进入领地 |
dyclaim.admin |
OP |
核心管理、玩家命令及绕过权限 |
dyclaim.admin.bypass |
OP |
保护绕过权限 |
dyclaim.admin.serverclaims |
OP |
创建、移除和管理服务器领地 |
dyclaim.admin.purge |
OP |
非活跃清理的额外权限 |
dyclaim.admin.purge.exempt |
OP |
非活跃清理豁免 |
dyclaim.warn.exempt |
OP |
警告处罚豁免 |
dyclaim.ban.exempt |
OP |
无法被禁止进入领地或被排除在封闭领地之外 |
dyclaim.fly |
OP |
领地内飞行 |
dyclaim.limit.<number>, dyclaim.limit.unlimited |
未设置 |
玩家或组的领地数量限制;取最高值 |
权限可通过你的权限管理器进行配置。如果某个可选功能在配置中被禁用,相应的权限也不会启用该功能。
兼容性与集成
1.1.0 验证: 328 项自动化测试和工件检查,以及在 Paper 1.20.1-26.3、Purpur 26.2、Spigot 26.2/26.3 和 Folia 26.2/26.3 上的实时测试。测试涵盖了等级限制、领地消息、访客禁令、占位符、BlueMap/Dynmap/squaremap、Vault 经济与市场、SimpleClans、从 GriefPrevention 和 ClaimChunk 导入信任关系、从 Beta、1.0.3 和 1.0.4 升级,以及拥有多达 50,000 个领地的服务器。详细记录见 验证说明。
Minecraft 版本列表:1.20–26.3。 支持 Bukkit、Spigot、Paper 和 Purpur。针对 Spigot API 1.20.4 编译为 Java 17 字节码;请使用你服务器所需的 Java 运行时环境。
历史 v1.0.2 验证: 148 项自动化测试,以及针对控制台重载、分组命令、旧版别名、本地化帮助/TAB 和自定义消息保留的特定 Purpur 1.20.4 / Java 21 场景测试。早期的 v1.0.2 检查涵盖了重启持久性、访客访问和末影珍珠弹射物阻挡保护。
早期版本在 Purpur 1.20.4 以及 Paper/Purpur/Spigot 26.2 上进行了测试;维护者还报告称在 26.3 上运行过早期版本。v1.0.2 的各个版本并未重复这些检查。中间补丁版本未单独测试。26.2 的检查通过 ViaVersion/ViaBackwards 使用协议客户端进行。详细测试矩阵。
可选集成:
| 插件 |
用途 |
| Vault + 经济提供程序 |
支付、退款和市场 |
| WorldGuard, GriefPrevention, Towny, Lands, Residence, GriefDefender |
重叠防止钩子 |
| Floodgate |
基岩版检测和区块边界可视化路径 |
| SimpleClans |
实验性氏族信任 |
| PlaceholderAPI |
%dyclaim_...% 占位符 |
| BlueMap, Dynmap, squaremap |
网页地图上的领地范围(仅在 Folia 上支持 BlueMap) |
核心领地功能不需要上述任何插件。Real-provider 版本兼容性和基岩版客户端可视化未被完成的服务器测试矩阵覆盖;部署前请验证所选的集成。
设置与升级
- 停止服务器并将 JAR 放入
plugins/ 目录。
- 启动服务器以生成
plugins/DyClaim/ 目录。
- 根据需要编辑
config.yml 和消息文件。
- 由有权限的玩家运行
/claim admin reload,或在服务器控制台中运行 claim admin reload。
市场、自动认领、警告、怪物清理、计划清理和氏族集成默认禁用。 请在配置中启用您想要的功能。领地消息、访客禁令、占位符和地图层默认启用,但可以分别关闭。
从 v1.0.0 或更高版本升级: 备份 JAR 文件和完整的 DyClaim 数据文件夹,然后在服务器停止时替换 JAR 文件。现有的领地数据保持兼容;缺失的配置选项会被添加而不会替换您的设置。
从 Beta 版本升级之前,请一起备份旧的 JAR 文件和完整的 DyClaim 数据文件夹。现有的领地会随着旧格式备份进行迁移。回退到 Beta 需要匹配旧格式的数据,而不仅仅是旧的 JAR 文件。
更新通知
DyClaim 会检查 Modrinth 以获取最新的兼容公共稳定版本,并通过直接版本链接通知管理员。它不会自动替换您的 JAR 文件。Beta 和原始 v1.0.0 用户必须手动更新一次: 其安装的检测器缺陷无法远程修复。v1.0.1 及更高版本的修正检测器可以宣布未来的兼容稳定版本。仅在 GitHub 上发布不会触发 Modrinth 通知。
源代码与许可证
DyClaim 使用自定义的 DyClaim Source-Available License 1.0。允许使用和修改,包括在商业服务器上。再分发必须是免费的,保留署名并提供相同条款下的相应源代码。付费分发需要单独的书面许可。针对早期分发的第三方许可证和授予的权利不受影响。欢迎贡献、错误报告和功能请求。
源代码和问题跟踪
DyClaim — Chunk Claiming Made Simple
Protect your builds. Share your land. Manage your claims.
DyClaim is a command-based chunk claiming plugin for survival, SMP and economy servers. Protect land, choose who can use it, and manage claim settings without a GUI.
DyClaim combines temporary trust, shared ownership, player trading, automatic claiming and configurable protection with the familiar command-based workflow. Version 1.3.1 adds a developer write API for estate and economy plugins such as DyMarket and makes protection checks lighter. Version 1.3.0 added claim flight, fire control per claim, closed claims and a choice to hide claim notices, and made protection checks lighter. Version 1.2.0 made DyClaim one JAR for every server, including Folia, and added server claims, trust for whole permission groups and glowing claim borders. Existing commands, settings and claim data are preserved.
New in 1.3.1
- Developer write API:
DyClaimAPI gains getClaimById, transferClaim, setTrust, removeTrust and getTrustRights, so estate and economy plugins such as DyMarket can sell, rent and lease claims. Changes fire the usual transfer and trust events. See the developer API.
- Lighter protection checks: claims are found from block coordinates, owners and trusted players are answered before any permission lookup, and denial messages are built once per language instead of on every event. On Paper, Purpur and Folia the denial goes to players as a ready component. No message text and no protection result changes.
Added in 1.3.0
- Claim flight:
/claim fly [on|off] flies inside your own claims and claims you can build in. Flight stops when you leave and comes back when you return; fall damage is forgiven for a few seconds. Needs dyclaim.fly (OP by default).
- Fire control:
/claim fire lets fire spread and burn blocks in a claim. Claims stay fireproof by default (protection.fire-spread).
- Closed claims:
/claim entry keeps visitors out; owners, coowners and trusted players or groups still walk in. Claims stay open by default (protection.visitor-entry).
- Claim notices:
/claim notices [on|off] hides or shows entry and exit notices for you. Named claims show their name, and notices can be shown as a title (notification.use-title).
- Lighter: claim lookups use a chunk index, protection rules and hot settings are worked out once per configuration load, and player joins and quits no longer write files on the server thread.
All new protection settings follow the default / forced-value / player-toggle structure, and their defaults keep existing servers unchanged. See the changelog.
Added in 1.2.1
Visitor containers. /claim containers lets visitors open chests, barrels, shulker boxes, furnaces, hoppers, dispensers, droppers and brewing stands in your claim. Visitors still cannot break or place blocks. Server owners control it with protection.visitor-containers (off by default), like visitor doors and trapdoors.
Added in 1.2.0
One JAR for every server. DyClaim-1.3.1.jar runs on Bukkit, Spigot, Paper, Purpur and Folia. DyClaim detects Folia at startup; servers on the separate 1.1.0 Folia build can switch to it.
Server claims. /claim admin server protects the chunk you stand in for the server: no owner, price or limit. Only holders of dyclaim.admin.serverclaims manage it, and /claim admin server remove lifts it.
Group trust. /claim trust group:<name> trusts everyone in a permission group; LuckPerms gives its members group.<name>. Untrust and the trust list work the same way.
New borders. /claim see draws glowing lines that only you can see, on Minecraft 1.19.4 and newer clients. visualization.style: particles brings back the particle border.
Version 1.1.0 added claim limits by permission, claim messages, visitor bans, PlaceholderAPI, web-map layers, importing from GriefPrevention and ClaimChunk, a developer API and German, Spanish and Russian messages.
Choose your server build
| Server |
JAR |
| Bukkit, Spigot, Paper, Purpur, Folia |
DyClaim-1.3.1.jar |
One JAR serves every supported server. Stop the server and back up the full DyClaim data folder before replacement; claim data stays on schema 2. There are no Velocity/BungeeCord companions in this release.
Java 17 bytecode; use the runtime required by your server. Optional integrations must also support your selected platform. Platform details · Command guide · Integrations and import · Downloads and checksums
Why DyClaim?
Zero bloat. No complex GUIs, no unnecessary features. Just clean, fast chunk protection that works. Optional systems stay disabled until you choose to enable them.
Per-claim settings. Each claim has its own PvP, explosion and mob spawning toggles, plus controls for villager damage and visitor access to doors, trapdoors and containers. Players choose how their land works within the server's rules.
Automatic language. DyClaim detects each player's Minecraft language and shows commands and messages in their language. English, Turkish, German, Spanish and Russian are supported out of the box, and TAB follows the active language.
Works with your server. Optional hooks for WorldGuard, GriefPrevention, Towny, Lands, Residence and GriefDefender help prevent overlapping claims. Vault connects economy features, Floodgate enables Bedrock detection and block borders, PlaceholderAPI gets DyClaim placeholders, and BlueMap, Dynmap and squaremap show claims on the web map. Installed integrations are detected automatically; core claiming works without them.
A measured look at protection

On Purpur 1.20.4 with 50 claim areas, measured on 12 November 2026, DyClaim 1.3.1 had the lowest observed median in all three columns of this synthetic workload: owner-allowed block-break checks (0.364 against 0.586 for GriefPrevention), visitor-blocked checks (2.642 against 14.659) and a 50% / 50% mix (1.505 against 7.604), in milliseconds per 1,000 events including default denial feedback. Most of the visitor-side gain on Paper, Purpur and Folia comes from sending the denial as a ready component; Spigot keeps the text path and does not get that part. These are event-processing durations, not CPU or RAM usage, and do not establish superiority across all workloads.
Method, results and limitations
Claim your land, your way
Claim your current chunk with /claim. Server owners can configure prices, cooldowns, total/world limits, limits per rank through dyclaim.limit.<number> permissions and spacing between different owners. Add Vault and an economy provider for paid claims and refunds, or use core claiming without economy dependencies.
Name your claims, choose safe spawn points and teleport by number or name. Paginated lists show locations, while claim information displays ownership, effective settings and sale status. Entry action bars show the owner and PvP state, and owners can add a short welcome message with /claim message. Java particle borders help players see chunk boundaries; an optional Floodgate path provides block borders for Bedrock players.
Automatic claiming can acquire eligible chunks as you walk. It respects balance, limits, cooldowns and acquisition rules, and requires explicit configuration for free automatic claims.
Share access without giving away ownership
Use permanent trust or grant temporary access for 30m, 2h or 7d. Control building, containers, doors, trapdoors, redstone, entities and teleportation separately. A player trusted to open doors does not automatically gain access to chests.
Invite one coowner with their acceptance, or offer ownership to an online player. Coowned claims count toward limits. Coowners can manage trust and settings but cannot sell, delete or transfer the claim. Transfers clear previous trust, coownership, clan access and sale listings.
To keep someone out completely, /claim ban <player> [duration] stops them from walking or teleporting into the claim. Owners, coowners and administrators cannot be banned.
An optional SimpleClans adapter adds experimental clan trust.
Protection with clear controls
- Block placement, breaking, containers and supported entity interactions.
- Per-claim PvP, explosion, mob explosion and hostile mob spawning settings.
- Player villager damage blocked by default, without blocking trading.
- Separate visitor access for doors, trapdoors and containers.
- Separate visitor and mob farmland trampling policies.
- Cross-owner piston, fluid and hopper checks; both halves of double chests are protected.
- Checks for every affected block when placing beds and other multi-block structures.
- Access checks for supported block transformations and sign editing.
- PvP protection for player-owned wolves and harmful splash or lingering potions.
- Entity access checks for farm animals, vehicles and leash operations.
- Configurable boundary protection for dispenser output and external tree or fertilization growth.
- Global/world defaults, forced protection rules and locked player toggles.
Optional mob cleanup uses bounded checks in loaded claim chunks, with configurable scope and named/tamed exceptions. It can also remove eligible mobs already inside a claim. External redstone checks cover nearby power effects rather than every possible circuit.
Trade claims and manage your server
Enable the player marketplace to list, cancel and buy claims. Configure price limits and tax deducted from seller proceeds; /claim sell keeps its server-refund purpose. Purchase confirmations recheck their context, and a transaction journal records uncertain economy outcomes for reconciliation.
Administrators can manage claims, prices, refunds, world blacklists and configuration. Additional tools include session bypass, acquisition bans and inactive cleanup with previews, confirmation, backups and batches. Scheduled cleanup is available separately. /claim admin server protects spawn or other server areas without an owner. Servers moving from GriefPrevention or ClaimChunk can import existing claims with /dyclaim admin import, with a preview and a backup first.
Optional visitor warnings let owners/coowners warn unauthorized players inside their claim. Shared cooldowns prevent alternating owners from accelerating sanctions. Default rules use three warnings within 180 seconds, a 60-second cooldown and a two-day sanction.
Five languages, automatically
With lang: auto, players receive messages based on their saved preference or Minecraft language. English, Turkish, German, Spanish and Russian clients get their own language; other languages fall back to English.
TAB shows only the effective language. English command words always work when typed, including operation words and trust permission names.
Players can choose /claim lang auto|en|tr|de|es|ru. Administrators can force a language for everyone with /claim admin lang en|tr|de|es|ru, taking priority over personal preferences. Choosing auto restores automatic selection.
Commands
| Command |
Purpose |
/claim |
Claim your current chunk |
/claim sell, /unclaim |
Sell back or remove your claim |
/claim trust <player> [duration] |
Grant permanent or temporary access |
/claim trust <player> <right> <allow|deny> |
Change individual trust rights |
/claim trust group:<name> [duration] |
Trust everyone in a permission group |
/claim untrust <player>, /claim trustlist |
Manage trust |
/claim coowner add <player>, /claim coowner remove |
Manage one coowner |
/claim transfer <player> |
Offer an ownership transfer |
/claim market list <price>, /claim market cancel, /claim market buy |
Trade claims |
/claim auto [on|off] |
Toggle automatic claiming |
/claim name <name>, /claim setspawn |
Set a name or safe spawn |
/claim tp <number|name>, /claim list [page] |
Navigate your claims |
/cltp <number|name> |
Short form of /claim tp |
/claim info, /claim see |
Inspect a claim or display borders |
/claim pvp, /claim explosion [mob], /claim mob |
Change unlocked protection settings |
/claim villager, /claim doors, /claim trapdoors, /claim containers |
Change villager/visitor settings |
/claim warn <player> |
Warn an unauthorized visitor |
/claim message <text|clear> |
Show a message to visitors |
/claim ban <player> [duration], /claim unban <player>, /claim banlist |
Keep a player out of your claim |
/claim lang <auto|en|tr|de|es|ru> |
Choose your language |
/claim fly [on|off] |
Fly inside your own claims and claims you can build in |
/claim fire |
Let fire spread in this claim, or not |
/claim entry |
Open or close this claim to visitors |
/claim notices [on|off] |
Show or hide claim entry and exit notices |
/claim help [page] |
Paged in-game help |
/confirm, /cancel |
Accept or reject a pending action |
/dyc works as a short form of /claim, for example /dyc list. Administrators can use /dyca as a short form of /claim admin; it is hidden from players without dyclaim.admin. Use /claim help and /claim admin for in-game help. TAB suggestions are filtered by permissions and language. The old trustperm and mobexplosion aliases still work; help and root TAB use the grouped commands. Trust rights are build, containers, doors, trapdoors, redstone, entities and teleport.
Console senders can use claim admin reload and the supported global configuration commands (enable, disable, price, pricediff, cooldown, prefix, economy, lang, blacklist), subject to the existing admin permission checks. Commands needing a player, location or player confirmation remain player-only.
Permissions
| Permission |
Default |
Purpose |
dyclaim.player |
Everyone |
Player command group |
dyclaim.claim |
Everyone |
Claim chunks |
dyclaim.sell |
Everyone |
Sell or remove claims |
dyclaim.see |
Everyone |
Display claim borders |
dyclaim.info |
Everyone |
View claim information |
dyclaim.list |
Everyone |
List claims |
dyclaim.trust |
Everyone |
Manage trust and access rights |
dyclaim.teleport |
Everyone |
Teleport to claims |
dyclaim.settings |
Everyone |
Change unlocked claim settings |
dyclaim.coowner |
Everyone |
Manage coownership |
dyclaim.transfer |
Everyone |
Transfer ownership |
dyclaim.market |
Everyone |
Use the player marketplace |
dyclaim.auto |
Everyone |
Use automatic claiming |
dyclaim.name |
Everyone |
Name claims |
dyclaim.setspawn |
Everyone |
Set claim teleport destinations |
dyclaim.warn |
Everyone |
Warn unauthorized visitors |
dyclaim.message |
Everyone |
Set a claim message |
dyclaim.ban |
Everyone |
Ban visitors from a claim |
dyclaim.admin |
OP |
Core administration, player commands and bypass permission |
dyclaim.admin.bypass |
OP |
Protection bypass permission |
dyclaim.admin.serverclaims |
OP |
Create, remove and manage server claims |
dyclaim.admin.purge |
OP |
Additional permission for inactive cleanup |
dyclaim.admin.purge.exempt |
OP |
Inactive cleanup exemption |
dyclaim.warn.exempt |
OP |
Warning-sanction exemption |
dyclaim.ban.exempt |
OP |
Cannot be banned from claims or kept out of closed claims |
dyclaim.fly |
OP |
Claim flight |
dyclaim.limit.<number>, dyclaim.limit.unlimited |
Not set |
Claim limit for a player or group; the highest wins |
Permissions can be configured through your permission manager. A permission does not enable an optional feature that is disabled in configuration.
Compatibility and integrations
1.1.0 verification: 328 automated tests and artifact checks, plus live tests on Paper 1.20.1-26.3, Purpur 26.2, Spigot 26.2/26.3 and Folia 26.2/26.3. They covered rank limits, claim messages, visitor bans, placeholders, BlueMap/Dynmap/squaremap, Vault economy and the market, SimpleClans, imports with trust from GriefPrevention and ClaimChunk, upgrades from Beta, 1.0.3 and 1.0.4, and servers with up to 50,000 claims. Limits are recorded in the verification notes.
Minecraft version listing: 1.20–26.3. Bukkit, Spigot, Paper and Purpur. Compiled for Java 17 bytecode against Spigot API 1.20.4; use the Java runtime required by your server.
Historical v1.0.2 verification: 148 automated tests, plus targeted Purpur 1.20.4 / Java 21 scenarios for console reload, grouped commands, legacy aliases, localized help/TAB and custom-message preservation. Earlier v1.0.2 checks covered restart persistence, visitor access and ghast projectile block protection.
Earlier releases were checked on Purpur 1.20.4 and Paper/Purpur/Spigot 26.2; the maintainer also reported running an earlier release on 26.3. Those checks were not repeated for every version with v1.0.2. Intermediate patch versions were not individually tested. The 26.2 checks used protocol clients through ViaVersion/ViaBackwards. Detailed test matrix.
Optional integrations:
| Plugin |
Purpose |
| Vault + economy provider |
Payments, refunds and marketplace |
| WorldGuard, GriefPrevention, Towny, Lands, Residence, GriefDefender |
Overlap prevention hooks |
| Floodgate |
Bedrock detection and block-border visualization path |
| SimpleClans |
Experimental clan trust |
| PlaceholderAPI |
%dyclaim_...% placeholders |
| BlueMap, Dynmap, squaremap |
Claim areas on the web map (only BlueMap on Folia) |
Core claiming requires none of these plugins. Real-provider version compatibility and Bedrock client visualization are not covered by the completed server test matrix; validate your selected integrations before deployment.
Setup and upgrades
- Stop your server and place the JAR in
plugins/.
- Start the server to generate
plugins/DyClaim/.
- Edit
config.yml and the message files as needed.
- Run
/claim admin reload as a permitted player, or claim admin reload in the server console.
Marketplace, auto claim, warnings, mob cleanup, scheduled purge and clan integration are disabled by default. Enable the features you want in configuration. Claim messages, visitor bans, placeholders and map layers are enabled by default and can each be turned off.
Upgrading from v1.0.0 or later: back up the JAR and complete DyClaim data folder, then replace the JAR while the server is stopped. Existing claim data remains compatible; missing configuration options are added without replacing your settings.
Before upgrading from Beta, back up the old JAR and the complete DyClaim data folder together. Existing claims migrate with an old-format backup. Reverting to Beta requires matching old-format data, not just the old JAR.
Update notifications
DyClaim checks Modrinth for the newest compatible public stable release and notifies administrators with a direct version link. It does not replace your JAR automatically. Beta and original v1.0.0 users must update manually once: their installed checker defect cannot be repaired remotely. The corrected checker in v1.0.1 and later can announce future compatible stable releases. Publishing only on GitHub does not trigger Modrinth notifications.
Source code and license
DyClaim uses the custom DyClaim Source-Available License 1.0. Use and modification are permitted, including on commercial servers. Redistribution must be free, retain attribution and provide the corresponding source under the same terms. Paid distribution requires separate written permission. Third-party licenses and rights granted for earlier distributions remain unaffected. Contributions, bug reports and feature requests are welcome.
Source code and issues
评论 0
登录后参与评分
还没有评论,来抢沙发吧