WCustomCraft — 适用于 Paper 1.21+ 的扩展合成系统
直接在服务器中使用交互式游戏内 GUI 创建自定义 3x3、4x4、5x5 和 6x6 合成配方!不再需要混乱的 YAML 或 base64 物品字符串。
为什么选择 WCustomCraft?
标准 Minecraft 将合成限制在简单的 3x3 网格中。无论您运营的是 RPG 服务器、Skyblock(空岛)服务器 还是 自定义生存 SMP 服务器,您的终局物品都值得拥有 传奇般的合成公式。
WCustomCraft 通过在 Paper 1.21+ 中直接引入功能齐全的 4x4、5x5 和 6x6 合成台,打破了原版限制,并结合了超友好的 游戏内配方创建器 GUI,让您只需单击即可创建并保存配方。
主要功能
? 1. 四种合成网格尺寸
3x3(9 个槽位):标准合成网格。在此创建的配方可以选择性地通过原版合成台进行合成(register-vanilla-3x3: true)。
4x4(16 个槽位):宽敞的双箱 GUI 内的高级 4x4 合成网格。
5x5(25 个槽位):宽敞的双箱 GUI 内的大师级 5x5 合成网格。
6x6(36 个槽位):利用双箱 GUI 内完整 36 槽区域的传奇 6x6 合成网格。
- 尺寸选择菜单:如果玩家运行不带参数的
/craft,交互式菜单允许他们选择要打开的网格尺寸!
2. 交互式游戏内配方创建器 (/ccraft create)
告别复杂的 YAML 配置错误、损坏的 NBT 字符串和外部网页生成器:
- 运行
/ccraft create <recipe_id> <3|4|5|6>。
- 将精确的原料物品放置在合成网格槽位中。完全支持自定义显示名称、描述文本、附魔、
CustomModelData 和 NBT(PersistentDataContainer)标签!
- 将所需的成品放入输出槽位。
- 点击右下角的交互式按钮切换 无形状 vs 有形状 合成以及 精确 NBT 匹配。
- 点击 保存并注册配方 — 您的配方立即在服务器中生效,并干净地保存到
recipes.yml 中!
3. 便携式合成台 (/ccraft bench)
想给玩家提供一个便携式的终局合成工具吗?
- 运行
/ccraft bench <player> <size> 给他们一个自定义的 便携式合成台 物品(3x3、4x4、5x5 或 6x6)。
- 在世界中任何地方右键点击该物品,都会立即打开相应的自定义合成网格!
- 使用 Bukkit
PersistentDataContainer 标签进行保护,防止玩家通过重命名普通物品来作弊。
4. 沉浸式世界方块触发器
想在生存世界中直接放置自定义合成台,而无需输入命令吗?
在 config.yml 中,您可以绑定标准的 Minecraft 方块,以便当玩家右键点击它们时,打开您扩展的合成菜单:
block-triggers:
enabled: true
require-sneak: false # 可选:Shift + 右键点击
blocks:
FLETCHING_TABLE: "FOUR_BY_FOUR"
SMITHING_TABLE: "FIVE_BY_FIVE"
ENCHANTING_TABLE: "SIX_BY_SIX"
5. 智能合成引擎与保护
- 居中 / 偏移图案匹配:当合成的有形状配方小于打开的网格时(例如在
5x5 合成台中合成 3x3 配方),算法会动态计算边界框。玩家可以在中心或角落放置配方,它将完美合成!
- Shift 合成支持:根据原料和库存空间自动计算最大可合成次数,并将物品直接存入玩家的库存。
- 物品返还保护:如果玩家在合成网格中仍有原料的情况下关闭合成 GUI(按
ESC 或 E),所有物品都会安全地返回到他们的库存或掉落在地上,确保没有任何物品丢失。
- 交互式配方书 (
/ccraft list):玩家可以浏览分页菜单中的所有已注册自定义配方,并点击任何物品以预览其确切的合成网格布局!
命令与权限
| 命令 |
别名 |
描述 |
权限 |
默认值 |
/craft [size] |
/bench, /megacraft, /ecraft |
打开尺寸选择菜单或特定网格尺寸(3、4、5、6)。 |
ccraft.use
ccraft.craft.3
ccraft.craft.4
ccraft.craft.5
ccraft.craft.6 |
true
true
true
true
true |
/ccraft list |
/recipes, /ccp |
打开配方浏览器 / 配方书 GUI。 |
ccraft.use |
true |
/ccraft create <id> <size> |
|
为指定尺寸(3、4、5 或 6)打开交互式配方创建器 GUI。 |
ccraft.admin |
op |
/ccraft bench <player> <size> |
/ccraft givebench |
向玩家提供便携式合成物品(3、4、5 或 6)。 |
ccraft.admin |
op |
/ccraft delete <id> |
|
从内存和 recipes.yml 中删除指定的自定义配方。 |
ccraft.admin |
op |
/ccraft reload |
|
重新加载 config.yml 和 recipes.yml,无需重启服务器。 |
ccraft.admin |
op |
/ccraft give <player> <id> [amt] |
|
直接将配方 <id> 的结果物品给予玩家。 |
ccraft.admin |
op |
安装与兼容性
- 下载
CustomCraftPlus-1.0.0.jar 并将其放入服务器的 plugins/ 文件夹中。
- 确保您的服务器运行在 Java 21 上的 Paper 1.21 或更高版本(或 Purpur/Folia 等分支)。
- 重启或重载服务器。配置文件将在
plugins/CustomCraftPlus/ 中自动生成。
常见问题 (FAQ)
问:这需要任何客户端模组吗?
答:不需要! CustomCraftPlus 完全在服务器端运行,使用标准的 Minecraft 箱子 GUI、物品数据和音效。使用原版客户端加入 1.21+ 服务器的玩家可以立即使用所有功能。
Q:我可以使用来自其他插件(如 MythicMobs、ItemsAdder、Oraxen 或 MMOItems)的自定义物品作为材料或结果吗?
A:可以! 当使用 /ccraft create GUI 时,CustomCraftPlus 会克隆完整的 ItemStack 元数据,包括 NBT 标签、CustomModelData、显示名称和描述。放入创建槽中的任何物品都将原样作为配方所需材料及输出结果。
Q:我可以禁用原版 3x3 工作台集成吗?
A:可以!只需在 config.yml 中设置 register-vanilla-3x3: false,然后运行 /ccraft reload 即可。
? 支持与贡献
如果你喜欢 WCustomCraft,请留下评价并在 Discord 上反馈任何问题
WCustomCraft — Expanded Crafting for Paper 1.21+
Create custom 3x3, 4x4, 5x5, and 6x6 crafting recipes right inside your server using interactive in-game GUIs! No more messy YAML or base64 item strings.
Why WCustomCraft?
Standard Minecraft restricts crafting to a simple 3x3 grid. Whether you are running an RPG server, a Skyblock server, or a Custom Survival SMP, your end-game items deserve legendary crafting formulas.
CustomCraftPlus breaks past the vanilla limits by introducing fully functional 4x4, 5x5, and 6x6 crafting tables directly into Paper 1.21+, combined with an ultra-friendly In-Game Recipe Creator GUI that lets you create and save recipes with a single click.
Key Features
? 1. Four Crafting Grid Sizes
3x3 (9 slots): Standard crafting grid. Recipes created here can optionally also be crafted inside vanilla crafting tables (register-vanilla-3x3: true).
4x4 (16 slots): Advanced 4x4 crafting grid inside a spacious double-chest GUI.
5x5 (25 slots): Master 5x5 crafting grid inside a spacious double-chest GUI.
6x6 (36 slots): Legendary 6x6 crafting grid utilizing the full 36-slot area inside a double-chest GUI.
- Size Selector Menu: If a player runs
/craft without arguments, an interactive menu allows them to choose which grid size to open!
2. Interactive In-Game Recipe Creator (/ccraft create)
Say goodbye to complicated YAML configuration errors, broken NBT strings, and external web generators:
- Run
/ccraft create <recipe_id> <3|4|5|6>.
- Place your exact ingredient items inside the crafting grid slots. Fully supports custom display names, lore, enchantments,
CustomModelData, and NBT (PersistentDataContainer) tags!
- Place your desired result item into the output slot.
- Click the interactive buttons at the bottom right to toggle Shapeless vs. Shaped crafting and Exact NBT Matching.
- Click Save & Register Recipe — your recipe is immediately active across the server and saved cleanly to
recipes.yml!
3. Portable Crafting Benches (/ccraft bench)
Want to give your players a portable end-game crafting tool?
- Run
/ccraft bench <player> <size> to give them a custom Portable Crafting Bench item (3x3, 4x4, 5x5, or 6x6).
- When right-clicked anywhere in the world, the item opens the corresponding custom crafting grid instantly!
- Secured with Bukkit
PersistentDataContainer tags so players cannot rename ordinary items to cheat.
4. Immersive World Block Triggers
Want custom crafting tables placed right inside your survival world without typing commands?
In config.yml, you can bind standard Minecraft blocks so when players right-click them, they open your expanded crafting menus:
block-triggers:
enabled: true
require-sneak: false # Shift + Right Click optional
blocks:
FLETCHING_TABLE: "FOUR_BY_FOUR"
SMITHING_TABLE: "FIVE_BY_FIVE"
ENCHANTING_TABLE: "SIX_BY_SIX"
5. Smart Crafting Engine & Protection
- Centered / Offset Pattern Matching: When crafting a shaped recipe smaller than the open grid (such as a
3x3 recipe inside a 5x5 table), the algorithm dynamically calculates bounding boxes. Players can place the recipe in the center or corner and it will craft flawlessly!
- Shift-Crafting Support: Automatically calculates the maximum crafts available based on ingredients and inventory space, depositing items directly to the player's inventory.
- Item Return Protection: If a player closes the crafting GUI (
ESC or E) with ingredients still inside the grid, all items are safely returned to their inventory or dropped on the ground so nothing is ever lost.
- Interactive Recipe Book (
/ccraft list): Players can browse paginated menus of all registered custom recipes and click any item to preview its exact crafting grid layout!
Commands & Permissions
| Command |
Aliases |
Description |
Permission |
Default |
/craft [size] |
/bench, /megacraft, /ecraft |
Opens the size selector menu or a specific grid size (3, 4, 5, 6). |
ccraft.use
ccraft.craft.3
ccraft.craft.4
ccraft.craft.5
ccraft.craft.6 |
true
true
true
true
true |
/ccraft list |
/recipes, /ccp |
Opens the Recipe Browser / Recipe Book GUI. |
ccraft.use |
true |
/ccraft create <id> <size> |
|
Opens the interactive Recipe Creator GUI for size (3, 4, 5, or 6). |
ccraft.admin |
op |
/ccraft bench <player> <size> |
/ccraft givebench |
Gives a portable crafting item (3, 4, 5, or 6) to a player. |
ccraft.admin |
op |
/ccraft delete <id> |
|
Deletes the specified custom recipe from memory and recipes.yml. |
ccraft.admin |
op |
/ccraft reload |
|
Reloads config.yml and recipes.yml without restarting the server. |
ccraft.admin |
op |
/ccraft give <player> <id> [amt] |
|
Gives the result item of recipe <id> directly to a player. |
ccraft.admin |
op |
Installation & Compatibility
- Download
CustomCraftPlus-1.0.0.jar and place it inside your server's plugins/ folder.
- Ensure your server is running Paper 1.21 or newer (or forks like Purpur/Folia) on Java 21.
- Restart or reload your server. Configuration files will automatically generate in
plugins/CustomCraftPlus/.
Frequently Asked Questions (FAQ)
Q: Does this require any client-side mods?
A: No! CustomCraftPlus runs 100% server-side using standard Minecraft chest GUIs, item data, and sound effects. Players joining with vanilla clients on 1.21+ can use all features immediately.
Q: Can I use custom items from other plugins (like MythicMobs, ItemsAdder, Oraxen, or MMOItems) as ingredients or results?
A: Yes! When you use the /ccraft create GUI, CustomCraftPlus clones exact ItemStack metadata including NBT tags, CustomModelData, display names, and lore. Anything you drop into the creator slot is exactly what the recipe requires and outputs.
Q: Can I disable vanilla 3x3 table integration?
A: Yes! Simply set register-vanilla-3x3: false inside config.yml and run /ccraft reload.
? Support & Contributing
If you enjoy WCustomCraft, please leave a review and report any thing on dc
评论 0
登录后参与评分
还没有评论,来抢沙发吧