ToolCore

插件

· 作者 vineurodev

> 一个自定义物品的 YAML 目录:包括伐木斧、半径驱动的区域镐、选择器 > 法杖,以及可选的生物堆叠核心。每个额外方块都会触发真实且可取消的 > BlockBreakEvent,因此任何保护插件都能保留其否决权。

0 本站下载 0 关注 更新于 3 个月前

最新 1.0.0 · 26.2 · Paper / Purpur

一键开服(送7天)

ToolCore

玩家手持的、能实现原版物品无法做到的功能的工具 —— 完全通过 YAML 定义,并旨在与你已运行的插件协同工作。

一个目录,而非硬编码列表。 每个物品都存在于 items.yml 中:其类型、参数配置、名称和描述。添加一条条目,重新加载,该物品即生效。内置的 3×3 和 5×5 镐使用的是同一套代码,仅 radius(半径)不同 —— 写入 radius: 3,你便拥有了一把 7×7 镐,无需触碰 Java 代码。

经得起一切考验的身份标识。 物品通过隐藏的持久化数据 ID 进行识别,而非显示名称。在铁砧上重命名它、将其放入潜影盒存放一个月、重启服务器 —— 它依然是原来的那个物品。而将一把普通镐重命名为看起来像某件特殊物品,并不会赋予任何额外功能。

伐木斧。 一种有界、迭代式的泛洪填充算法,可穿透原木 和 树叶,从而找到树冠另一侧的树枝,但仅破坏原木。受 max-blocks(最大方块数)硬性限制,且不会探测未加载的区块。

区域镐。 在你所注视方向的平面上形成一个扁平 slab:挖掘墙壁时开凿出隧道,挖掘地面时剥离一层。

选择法杖。 每位玩家两个角点,重启后依然保留,并统计方块数量。支持右键、潜行右键或左击 —— 三种操作习惯均可用。它绝不会破坏、放置或打开任何方块。

生物堆叠(可选)。 一个刻意精简的堆叠核心 —— 计数、锁定、命名、拆分、合并 —— 加上堆叠名牌、生物笼和生物堆叠分隔器。它不缩放经验值或战利品,这正是它能与其他插件共存的原因。已经运行了其他堆叠插件?只需关闭整个模块,其余功能保持不变。


购买此插件的理由

真正有效的保护机制,兼容任意插件。

大多数区域工具仅挂钩特定保护插件的 API。这在你只使用那一个插件时有效,但一旦你换用另一个、多个,或使用了它们从未测试过的插件,就会出问题。

ToolCore 在破坏每个额外方块前,会触发一个 真实的、可取消的 BlockBreakEvent。你的领地插件、日志插件和反 X 光插件看到的区域挥砍,就是它本来的样子:一系列普通的玩家方块破坏事件。每个插件都能保持其原有的控制权。

  • 取消某个方块的事件会 精确跳过该方块 —— 扫描继续,因此当 5×5 范围触及领地边界时,会破坏外部方块而让内部完好无损。
  • 如果玩家实际挖掘的那个方块被拒绝,则 根本不会启动扫描。
  • setDropItems(false) 也会被尊重。
  • CoreProtect 记录每一个方块。回滚操作正常运作。
  • 无需跟进 API 版本更新,也不会因 Minecraft 版本更新而崩溃。

捆绑文档中包含五分钟验证指南,让你在实际部署前在自己的服务器上证明其有效性。


也值得了解

  • 无依赖项。 depend: 和 softdepend: 中均无任何内容。无需数据库、GUI 库或权限插件。
  • 故意不提供配方。 物品通过 /customitem give 发放,任何宝箱、商店、任务或排名插件均可作为控制台指令执行。ToolCore 负责发放物品;它并不决定玩家如何获得它们。
  • 基于权限,而非基于等级。 每个物品对应一个权限节点,默认开启,可在目录中单独覆盖。插件内不出现任何等级名称。
  • 开箱即用的双语支持。 英语和荷兰语已配置好。每条消息、物品名称和描述行都支持单值或多语言值,玩家的语言设置同时控制聊天文本和他们获得的物品上的文字。
  • 设计上的有界性。 max-blocks 是硬性上限,泛洪填充采用迭代方式而非递归,堆叠扫描基于时间间隔并设有每次扫描的合并预算,被囚禁的生物存储在物品数据中而非作为可能泄漏的实体存在。
  • 两个模块,各自可切换,当依赖项关闭时仅输出一条清晰的日志行 —— 绝不会出现部分启动的模块。

命令

命令 功能
/customitem give <player> <id> [amount] 发放目录中的物品
/customitem get <id> [amount] 给自己发放一个
/customitem list · info <id> 查看有哪些物品及其配置
/customitem pos 查看你的法杖选区及方块数量
/stackablemobs [page] 查看哪些生物类型可以堆叠
/toolcore <status|reload> 查看状态并实时重载所有配置

完整的命令和权限参考见捆绑的 docs/ 文件夹。


要求

  • Paper 1.21 或更高版本
  • Java 21 或更高版本
  • 无依赖项

不支持 Spigot 和 Folia。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源