高级 Minecraft 配方管理插件
广泛的配方支持 · 触发系统 · 脚本引擎 · GUI 界面 · 物品插件集成
为什么选择 Craftorithm
- 通过其他插件提供的物品 ID 匹配物品 —— 重命名、添加附魔甚至更改物品类型都不会影响合成
- 通过注入原版合成系统来实现功能 —— 性能远超依赖事件监听器的插件,并完全支持所有原版特性
- 禁用原版或其他插件的配方
- 结果处理器、触发器、自定义箱子菜单以及其他强大的自定义功能
功能特性
快速开始
要求
- Java: 21 或更高版本
- 服务器: Paper / Spigot 1.20+(支持 Folia)
安装
- 下载插件
- 将 JAR 文件放入
plugins/ 目录
- 重启服务器
创建你的第一个配方
/cra create vanilla_shaped
在 GUI 中放置原料和结果物品,然后点击确认。配方将自动保存至
plugins/Craftorithm/recipes/。
强大的配置
结果处理器
结果处理器允许你对合成结果应用额外的修改,例如:
result_processors:
enchantments:
type: copy_from_source
lore:
type: add
data:
value:
- "&7传奇武器"
- "&a在地狱中锻造"
attributes:
type: merge_source
支持对附魔、属性、描述文本、物品标志等多种组件类型使用 copy_from_source(从源复制)/ add(添加)/ merge_source(合并源)/ remove(移除)策略。
合成余料
remainders 控制每次合成后每个输入槽位留下什么。每条规则使用 action 来选择耐久度消耗、物品替换或保留原物:
remainders:
- ingredient: minecraft:flint_and_steel
action: damage
damage: 1
- ingredient: my_items:magic_water_bucket
action: replace
item: minecraft:iron_ingot 2
- ingredient: my_items:reusable_catalyst
action: keep
damage: 保留已消耗的物品并应用配置的耐久度伤害;耐久度耗尽时物品会消失。
replace: 返回配置的 item;数量遵循物品 ID(例如 minecraft:iron_ingot 2),默认为 1。
keep: 返回一个未改变的已消耗物品副本。
- 原料使用与配方原料相同的 ID,包括原版 ID、自定义 ID、
tag: 以及 item_pack:。
- 没有匹配规则的槽位保留其原版余料。当多条规则匹配时,优先级最高的第一条生效。
世界隔离
enable_worlds 将配方限制在特定世界中。如果省略此项,则该配方在所有世界中可用:
# 单个世界
enable_worlds: world
# 多个世界
enable_worlds:
- world
- world_nether
- 世界名称为 Bukkit 世界名称,而非 Namespaced ID。
- 加载过程中,未知的世界会被报告为错误并被跳过。
- 没有
enable_worlds 的配方不受限制。
- 目前适用于铁砧、酿造台和切石机配方。
文档
完整文档
bStats
Advanced Minecraft Recipe Management Plugin
Extensive Recipe Support · Trigger System · Script Engine · GUI Interface · Item Plugin Integrations
Why Craftorithm
- Matches items by other plugin-provided item ID — renaming, adding enchantments, or even changing item types won't
affect crafting
- Implements functionality by injecting into the vanilla crafting system — performance far surpasses plugins that rely
on event listeners, with full support for all vanilla features
- Disable recipes from vanilla or other plugins
- Result processors, triggers, custom chest menus, and other powerful customization features
Features
Quick Start
Requirements
- Java: 21 or higher
- Server: Paper / Spigot 1.20+ (Folia supported)
Installation
- Downloa plugin
- Place the JAR file in the
plugins/ directory
- Restart the server
Create Your First Recipe
/cra create vanilla_shaped
Place ingredients and result items in the GUI, then click confirm. Recipes are automatically saved to
plugins/Craftorithm/recipes/.
Powerful Configuration
Result Processors
Result processors allow you to apply additional modifications to crafting results, for example:
result_processors:
enchantments:
type: copy_from_source
lore:
type: add
data:
value:
- "&7Legendary Weapon"
- "&aForged in the Nether"
attributes:
type: merge_source
Supports copy_from_source / add / merge_source / remove strategies for various component types including
enchantments, attributes, lore, item flags, and more.
Crafting Remainders
remainders controls what each crafting input slot leaves behind after a craft. Each rule uses action to select
durability damage, item replacement, or keeping the original item:
remainders:
- ingredient: minecraft:flint_and_steel
action: damage
damage: 1
- ingredient: my_items:magic_water_bucket
action: replace
item: minecraft:iron_ingot 2
- ingredient: my_items:reusable_catalyst
action: keep
damage: keeps the consumed item and applies the configured durability damage; it breaks when durability runs out.
replace: returns the configured item; the amount follows the item ID (for example minecraft:iron_ingot 2) and defaults to 1.
keep: returns one unchanged copy of the consumed item.
- Ingredients use the same IDs as recipe ingredients, including vanilla IDs, custom IDs,
tag:, and item_pack:.
- Slots without a matching rule keep their vanilla remainder. When multiple rules match, the first one wins.
World Isolation
enable_worlds restricts a recipe to specific worlds. When omitted, the recipe is available in every world:
# Single world
enable_worlds: world
# Multiple worlds
enable_worlds:
- world
- world_nether
- World names are Bukkit world names, not namespaced IDs.
- Unknown worlds are reported as errors during loading and skipped.
- Recipes without
enable_worlds are not restricted.
- Currently applies to anvil, brewing, and stonecutting recipes.
Documentation
Full Documentation
bStats
评论 0
登录后参与评分
还没有评论,来抢沙发吧