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。
ToolCore
The items a player holds that do something a vanilla item cannot — defined entirely in
YAML, and built to cooperate with the plugins you already run.
A catalogue, not a hardcoded list. Every item lives in items.yml: its kind, its
tuning, its name and its lore. Add an entry, reload, and the item exists. The shipped
3×3 and 5×5 pickaxes are the same code with a different radius — write radius: 3 and
you have a 7×7 without touching Java.
Identity that survives everything. An item is recognised by a hidden persistent-data
id, never by its display name. Rename it in an anvil, park it in a shulker box for a
month, restart the server — it is still what it was. And renaming a plain pickaxe to
look like one grants nothing.
Tree feller. A bounded, iterative flood fill that travels through logs and leaves,
so it finds the branch on the far side of a canopy, but breaks only the logs. Hard-capped
at max-blocks, and it refuses to look into unloaded chunks.
Area pickaxes. A flat slab in the plane you are looking at: mine a wall and you tunnel
a corridor, mine the floor and you strip a layer.
Selector wand. Two corners per player, persistent across restarts, with a block
count. Right-click, sneak-right-click or left-click — all three conventions work. It
never breaks, places or opens anything.
Mob stacking, optional. A deliberately small stacking core — count, lock, name,
split, merge — plus a stack nametag, a mob cage and a mobstack separator. It does not
scale experience or loot, which is exactly what lets it sit next to other plugins. Already
run a stacker? Switch the whole module off and keep everything else.
The reason to buy this one
Protection that actually works, with any plugin.
Most area tools hook one specific protection plugin's API. That works until you run a
different one, or two, or one they never tested against.
ToolCore fires a real, cancellable BlockBreakEvent for every extra block before
breaking it. Your claim plugin, your logging plugin and your anti-xray plugin all see an
area swing as what it is: a series of ordinary player block breaks. Each keeps exactly
the control it already had.
- A cancellation skips exactly that block — the sweep continues, so a 5×5 at a claim
border breaks the outside and leaves the inside untouched.
- If the block the player actually mined is denied, no sweep starts at all.
setDropItems(false) is honoured too.
- CoreProtect logs every block. Rollback works.
- No API version to keep up with, and nothing to break on a Minecraft update.
There is a five-minute verification in the bundled docs so you can prove it on your own
server before you go live.
Also worth knowing
- No dependencies. Nothing in
depend:, nothing in softdepend:. No database, no
GUI library, no permission plugin required.
- No recipes, deliberately. Items are handed out with
/customitem give, which any
crate, shop, quest or rank plugin can run as console. ToolCore hands out items; it does
not decide how players earn them.
- Permission-driven, never rank-driven. One node per item, defaulting to on, each
overridable in the catalogue. No rank name anywhere in the plugin.
- Bilingual out of the box. English and Dutch ship configured. Every message, item
name and lore line takes one value or one per language, and a player's language drives
both chat and the text on the item they are handed.
- Bounded by design.
max-blocks is a hard cap, the flood fill is iterative and
never recursive, the stacking scan is interval-based with a per-scan merge budget, and
caged mobs live in the item's data rather than as entities that could leak.
- Two modules, each switchable, with one clear log line when a dependency is off —
never a half-started module.
Commands
| Command |
What it does |
/customitem give <player> <id> [amount] |
Hand out a catalogue item |
/customitem get <id> [amount] |
Give one to yourself |
/customitem list · info <id> |
What exists, and how it is tuned |
/customitem pos |
Your wand selection and its block count |
/stackablemobs [page] |
Which mob types can stack |
/toolcore <status|reload> |
Status and a live reload of everything |
Full command and permission reference in the bundled docs/.
Requirements
- Paper 1.21 or newer
- Java 21 or newer
- No dependencies
Spigot and Folia are not supported.
评论 0
登录后参与评分
还没有评论,来抢沙发吧