DyClaim

插件

· 作者 Claww

轻量级区块所有权,支持信任、服务器管理、网页地图及五种语言;一个 JAR 即可适配所有服务器,包括 Folia。

0 本站下载 0 关注 更新于 5 天前

最新 1.3.1 · 26.3 · Bukkit / Folia

一键开服(送7天)

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 在网页地图上显示领地。已安装集成会自动检测;核心领地功能无需它们即可工作。


对性能保护的理性审视

四个插件中处理 1,000 次方块破坏检查所需的时间

在 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 版本兼容性和基岩版客户端可视化未被完成的服务器测试矩阵覆盖;部署前请验证所选的集成。

设置与升级

  1. 停止服务器并将 JAR 放入 plugins/ 目录。
  2. 启动服务器以生成 plugins/DyClaim/ 目录。
  3. 根据需要编辑 config.yml 和消息文件。
  4. 由有权限的玩家运行 /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。允许使用和修改,包括在商业服务器上。再分发必须是免费的,保留署名并提供相同条款下的相应源代码。付费分发需要单独的书面许可。针对早期分发的第三方许可证和授予的权利不受影响。欢迎贡献、错误报告和功能请求。

源代码和问题跟踪

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源