安装
- 下载插件 jar 文件
- 将 jar 文件放入服务器的
plugins/ 文件夹中。
- 启动(或重启)服务器。CozyTools 将在
plugins/CozyTools/ 下生成默认的 config.yml 和 abilities.yml 文件。
- 根据需要编辑配置文件,然后在游戏内或控制台运行
/ctools reload。
能力
| 能力 |
功能说明 |
| Vein Miner |
一击破坏相连的同类矿石/方块(类似小型采矿模式),最多可破坏配置上限数量的方块。 |
| Excavator |
一击破坏一片软质方块(如泥土、沙子、砾石等),非常适合地形改造。 |
| Tree Feller |
仅敲击树干即可砍倒整棵树(可选清理树叶)。 |
| Auto Smelt |
自动熔炼工具挖掘到的所有物品,使用原版熔炉配方——无需放置熔炉。 |
| Rocket Boots |
双击跳跃向前冲刺,可选择限制为仅在水中时可用。 |
每种能力仅在白名单列出的方块类型上触发(见 abilities.yml),其他方块则正常破坏。耐久消耗、粒子效果以及按世界限制的设置均可针对每种能力单独配置。
获取工具
有两种方式向玩家发放工具:
附魔菜单
在控制台中运行以下命令,为玩家打开一个图形界面,让他们自行选择能力、粒子效果和附魔:
/enchantmenu <tool> <player> <time> [ability]
<tool> - config.yml 中 tools: 下定义的工具键值(例如 pickaxe、shovel、axe)
<player> - 目标玩家的用户名(必须在线)
<time> - 工具的持续时间:30m、24h、7d、1mo 或 permanent
[ability] - 可选;预先锁定工具至特定能力,防止玩家自行选择
示例:
/enchantmenu pickaxe cozydev 7d
此命令仅限控制台使用——玩家在聊天栏输入无效。
模板
通过你在 config.yml 中定义的模板,立即向玩家发放一个即用型工具:
/ctools give <template> <player> [time]
示例:
/ctools give drill cozydev 3d
如果省略 [time],则使用模板自身配置的过期时间。
命令
| 命令 |
描述 |
/ctools <tool> <player> [time] [ability] |
直接为指定工具键值打开附魔菜单图形界面。 |
/ctools give <template> <player> [time] |
向玩家发放预配置的模板工具/靴子。 |
/ctools reload |
重新加载 config.yml 和 abilities.yml,无需重启服务器。 |
/enchantmenu <tool> <player> <time> [ability] |
附魔菜单命令的控制台专用版本。 |
所有命令均支持对工具键值、模板、在线玩家以及时长示例的自动补全。
权限
| 权限节点 |
默认值 |
描述 |
cozytools.command.ctools |
op |
访问 /ctools 命令 |
cozytools.command.enchantmenu |
op |
访问 /enchantmenu 命令 |
cozytools.ability.vein_miner |
true |
可触发 Vein Miner 能力 |
cozytools.ability.excavator |
true |
可触发 Excavator 能力 |
cozytools.ability.tree_feller |
true |
可触发 Tree Feller 能力 |
cozytools.ability.auto_smelt |
true |
可触发 Auto Smelt 能力 |
cozytools.ability.rocket_boots |
true |
可使用 Rocket Boots |
配置
两个配置文件位于 plugins/CozyTools/ 目录下:
config.yml - 工具定义(材质、名称、有效能力、附魔)、/ctools give 的模板、火箭靴设置、GUI 文本、消息、粒子效果以及工具过期系统。
abilities.yml - 各能力的设置:方块白名单、每次激活的最大方块数、耐久消耗、默认粒子效果以及按世界启用的开关。
这两个文件都包含大量注释——直接打开并调整数值,然后运行 /ctools reload 即可应用更改,无需重启服务器。
工具过期
工具可以是临时的也可以是永久的。在发放工具时设置持续时间(30m、24h、7d、1mo 或 permanent),过期的工具会根据 config.yml 中的 expiry: 设置自动清理并从背包/容器移除。
Installation
- Download the plugin jar
- Drop the jar into your server's
plugins/ folder.
- Start (or restart) the server. CozyTools will generate its default
config.yml and abilities.yml files under plugins/CozyTools/.
- Edit the configs to taste, then run
/ctools reload in-game or from console.
Abilities
| Ability |
What it does |
| Vein Miner |
Breaks connected blocks of the same ore/type in one hit (like a mini vein-miner), up to a configurable block cap. |
| Excavator |
Breaks a cluster of soft blocks (dirt, sand, gravel, etc.) in one hit - great for terraforming. |
| Tree Feller |
Chops an entire tree (logs, with optional leaf cleanup) from a single hit on the trunk. |
| Auto Smelt |
Automatically smelts anything the tool mines, using vanilla furnace recipes - no furnace needed. |
| Rocket Boots |
Double-jump to launch yourself forward, optionally restricted to when you're in water. |
Each ability only triggers on the block types listed in its whitelist (see abilities.yml) - anything else breaks normally. Durability cost, particle effects, and per-world restrictions are all configurable per ability.
Recieve Tools
There are two ways to hand tools to players:
Enchant Menu
Run this from the console to open a GUI for a player, letting them pick an ability, a particle effect, and enchants themselves:
/enchantmenu <tool> <player> <time> [ability]
<tool> - a tool key defined under tools: in config.yml (e.g. pickaxe, shovel, axe)
<player> - the target player's username (must be online)
<time> - how long the tool lasts: 30m, 24h, 7d, 1mo, or permanent
[ability] - optional; pre-locks the tool to a specific ability so the player can't choose
Example:
/enchantmenu pickaxe cozydev 7d
This command is console-only - it won't work when typed by a player in chat.
Templates
Give a player a ready-to-use tool instantly, using a template you've defined in config.yml:
/ctools give <template> <player> [time]
Example:
/ctools give drill cozydev 3d
If [time] is omitted, the template's own configured expiry is used.
Commands
| Command |
Description |
/ctools <tool> <player> [time] [ability] |
Opens the enchant menu GUI for a tool key directly. |
/ctools give <template> <player> [time] |
Gives a pre-configured template tool/boots to a player. |
/ctools reload |
Reloads config.yml and abilities.yml without restarting the server. |
/enchantmenu <tool> <player> <time> [ability] |
Console-only version of the enchant menu command. |
All commands have tab-completion for tool keys, templates, online players, and duration examples.
Permissions
| Permission |
Default |
Description |
cozytools.command.ctools |
op |
Access to /ctools |
cozytools.command.enchantmenu |
op |
Access to /enchantmenu |
cozytools.ability.vein_miner |
true |
Can trigger Vein Miner |
cozytools.ability.excavator |
true |
Can trigger Excavator |
cozytools.ability.tree_feller |
true |
Can trigger Tree Feller |
cozytools.ability.auto_smelt |
true |
Can trigger Auto Smelt |
cozytools.ability.rocket_boots |
true |
Can use Rocket Boots |
Configuration
Two config files live in plugins/CozyTools/:
config.yml - tool definitions (material, name, valid abilities, enchants), templates for /ctools give, rocket boots settings, GUI text, messages, particle effects, and the tool expiry system.
abilities.yml - per-ability settings: block whitelists, max blocks per activation, durability cost, default particles, and per-world toggles.
Both files are heavily commented - open them up and adjust values directly, then run /ctools reload to apply changes without a restart.
Tool Expiry
Tools can be temporary or permanent. Set the duration when giving a tool (30m, 24h, 7d, 1mo, or permanent), and expired tools are automatically swept and removed from inventories/containers based on the expiry: settings in config.yml.
评论 0
登录后参与评分
还没有评论,来抢沙发吧