? ItemCraft – 完整使用指南 (v1.4.1)
1️⃣ 安装
- 下载 .jar 文件
- 将其放入以下目录:
plugins/
- 启动你的服务器
- (可选)安装 FancyHolograms 以支持全息图
要求:
- Paper / Spigot 1.21+
- Java 21
2️⃣ 创建新配方
步骤 1 – 打开编辑器 GUI
命令:
/ic
所需权限:
itemcraft.editor
步骤 2 – 设置材料
GUI 界面类似于原版合成表:
[ 3x3 合成网格 ] → [ 结果栏 ]
- 将物品拖入 3x3 网格中
- 你可以使用自定义数量(例如,在一个槽位中使用 32 个金锭)
- 将输出物品放置在结果栏中
步骤 3 – 设置合成次数限制
使用“最大合成次数”按钮:
- 左键点击 → +1
- Shift + 左键 → +10
- 右键点击 → -1
- Shift + 右键 → -10
重要提示:
0 = 无限合成
步骤 4 – 选择限制模式
使用“限制模式”按钮。
共有 2 种模式:
GLOBAL(全局)
- 整个服务器总共可以合成该配方 X 次
- 存储在:globaldata.yml
PER_PLAYER(按玩家)
- 每个玩家可以单独合成该配方 X 次
- 存储在:playerdata.yml
你可以在保存前自由切换模式。
步骤 5 – 保存配方
点击“Save”(保存)。
系统会提示你在聊天中输入一个配方 ID。
示例:
legend_sword
文件将创建在以下位置:
plugins/ItemCraft/recipes/legend_sword.yml
3️⃣ 手动打开配方
命令:
/ic open <id>
示例:
/ic open legend_sword
所需权限:
itemcraft.open
4️⃣ 将配方绑定到方块
绑定
看向一个方块并运行:
/ic gan <id>
示例:
/ic gan legend_sword
该方块将成为一个自定义合成方块。
所需权限:
itemcraft.bind
解绑
看向该方块并运行:
/ic removegan
所需权限:
itemcraft.unbind
5️⃣ 通过方块进行合成
一旦方块被绑定:
- 右键点击该方块
- 自定义合成 GUI 将打开
- 系统将执行以下操作:
- 检查材料
- 检查合成次数限制
- 扣除所需物品
- 给予输出物品
6️⃣ FancyHolograms 支持
如果已安装 FancyHolograms:
- 绑定方块时会自动创建一个全息图
- /ic reload 刷新全息图
- 可以在 config.yml 中启用/禁用
安全回退机制:
如果未安装 FancyHolograms,插件将在没有全息图的情况下正常运行。
7️⃣ 重载插件
命令:
/ic reload
这将重载以下内容:
所需权限:
itemcraft.reload
8️⃣ 文件结构
plugins/ItemCraft/
├── config.yml
├── lang/
├── recipes/
├── bindings.yml
├── playerdata.yml
└── globaldata.yml
每个配方都存储在其独立的 YAML 文件中。
9️⃣ 权限列表
itemcraft.editor
itemcraft.open
itemcraft.bind
itemcraft.unbind
itemcraft.reload
itemcraft.help
? 安全性与保护
GUI 受到全面保护:
- 无 Shift+点击漏洞
- 无拖拽漏洞
- 无快捷栏交换漏洞
- 防止窃取装饰性物品
- 数据保存安全
- 自动处理重载逻辑
? 设置示例
配方:
- 1 钻石块
- 32 金锭
- 结果:下界合金锭
- 最大合成次数:50
- 模式:GLOBAL(全局)
保存后:
/ic gan legend_block
现在整个服务器总共只能合成它 50 次。
如果你需要:
- 简短摘要版本
- SEO 优化描述
- 专业的 GitHub README
- 格式化的 Modrinth Wiki 页面
- Discord 公告帖子
请告诉我你想要哪一个。
? ItemCraft – Complete Usage Guide (v1.4.1)
1️⃣ Installation
- Download the .jar file
- Place it inside:
plugins/
- Start your server
- (Optional) Install FancyHolograms for hologram support
Requirements:
- Paper / Spigot 1.21+
- Java 21
2️⃣ Creating a New Recipe
Step 1 – Open the Editor GUI
Command:
/ic
Required permission:
itemcraft.editor
Step 2 – Set Ingredients
The GUI looks like a vanilla crafting table:
[ 3x3 Crafting Grid ] → [ Result Slot ]
- Drag items into the 3x3 grid
- You can use custom amounts (e.g., 32 gold in one slot)
- Place the output item in the Result slot
Step 3 – Set Craft Limit
Use the "Max crafts" button:
- Left Click → +1
- Shift + Left → +10
- Right Click → -1
- Shift + Right → -10
Important:
0 = Unlimited crafting
Step 4 – Choose Limit Mode
Use the "Limit Mode" button.
There are 2 modes:
GLOBAL
- Entire server can craft the recipe X times total
- Stored in: globaldata.yml
PER_PLAYER
- Each player can craft the recipe X times individually
- Stored in: playerdata.yml
You can switch modes freely before saving.
Step 5 – Save the Recipe
Click "Save".
You will be prompted to enter a recipe ID in chat.
Example:
legend_sword
The file will be created in:
plugins/ItemCraft/recipes/legend_sword.yml
3️⃣ Opening a Recipe Manually
Command:
/ic open <id>
Example:
/ic open legend_sword
Required permission:
itemcraft.open
4️⃣ Binding a Recipe to a Block
Bind
Look at a block and run:
/ic gan <id>
Example:
/ic gan legend_sword
That block becomes a custom crafting block.
Required permission:
itemcraft.bind
Unbind
Look at the block and run:
/ic removegan
Required permission:
itemcraft.unbind
5️⃣ Crafting via Block
Once a block is bound:
- Right-click the block
- The custom crafting GUI opens
- The system will:
- Check materials
- Check craft limit
- Remove required items
- Give output
6️⃣ FancyHolograms Support
If FancyHolograms is installed:
- A hologram is automatically created when binding a block
- /ic reload refreshes holograms
- Can be enabled/disabled in config.yml
Safe fallback:
If FancyHolograms is not installed, plugin works normally without holograms.
7️⃣ Reloading the Plugin
Command:
/ic reload
This reloads:
- config
- language files
- recipes
- bindings
- holograms
Permission required:
itemcraft.reload
8️⃣ File Structure
plugins/ItemCraft/
├── config.yml
├── lang/
├── recipes/
├── bindings.yml
├── playerdata.yml
└── globaldata.yml
Each recipe is stored in its own YAML file.
9️⃣ Permissions
itemcraft.editor
itemcraft.open
itemcraft.bind
itemcraft.unbind
itemcraft.reload
itemcraft.help
? Security & Protection
The GUI is fully protected:
- No shift-click exploit
- No drag exploit
- No hotbar swap exploit
- No stealing decorative items
- Safe data saving
- Automatic reload handling
? Example Setup
Recipe:
- 1 Diamond Block
- 32 Gold
- Result: Netherite Ingot
- Max crafts: 50
- Mode: GLOBAL
After saving:
/ic gan legend_block
Now the entire server can craft it only 50 times total.
If you need:
- A short summary version
- SEO optimized description
- A professional GitHub README
- A formatted Modrinth wiki page
- A Discord announcement post
Just tell me which one you want.
评论 0
登录后参与评分
还没有评论,来抢沙发吧