iCraft
—— 自定义矩阵合成系统 ——
使用统计
. 视频
. 前言
最初是为MoreExpansion（3D更多扩展）插件而打造的合成系统
后来萌生了自定义矩阵的合成系统
. 功能
- 自定义矩阵：也就是自定义布局Gui装饰，不同合成面板有不同的矩阵
- 丰富的API
- 支持NBT物品，支持MOD物品，支持Lore
- 可开关代替原版合成台（右击工作台时）
- 通过游戏内可视化添加、编辑
- 自定义语言文本
- 无前置插件，即下即装即用
- 兼容性的友好性：支持许多服务端和许多版本
. 兼容性
通过了Paper/Spigot-1.12-1.15，Mohist-1.12.2，CatServer-1.12.2的测试
通过了踢出正在合成的玩家，关服，均无吞物品情况
不支持1.8.8及以下
尚未测试1.9-1.11
- Minecraft-1.12-1.15（没测过1.11及以下，应该支持）
- Paper/Spigot
- Mohist
- CatServer
- 支持NBT物品，支持MOD物品
. 下载
新版：
. 提醒
合成面板的意思是Gui合成界面，通过Panel.yml配置可以添加更多不同的合成面板，可以自定义矩阵
. 命令权限
- /iCraft help
- 描述：查看命令帮助
- 权限：icraft.help
- /iCraft openPanel <合成面板ID> [玩家]
- 描述：打开合成系统
- 权限：icraft.open
- /iCraft viewRecipe <合成面板ID> <配方ID> [玩家]
- 描述：查看配方公式
- 权限：icraft.admin
- /iCraft addRecipe <合成面板ID> <配方ID>
- 描述：添加合成配方
- 权限：icraft.admin
- /iCraft delRecipe <合成面板ID> <配方ID>
- 描述：删除合成配方
- 权限：icraft.admin
- /iCraft editRecipe <合成面板ID> <配方ID>
- 描述：编辑合成配方
- 权限：icraft.admin
. 配置
config.yml
- # 语言 Language
- # 可选 Optional: lang_en lang_cn lang_ru
- language: "lang_en"
- # 设置
- # setting
- setting:
- # 如果是new，右键工作台时打开自定义矩阵合成系统
- # if new, open custom crafting system
- # when right click crafting-table
- # 如果是sel，右键工作台时打开原版合成系统-自定义矩阵合成系统选择界面
- # if sel, open vanilla Gui-custom crafting system select Gui
- # when right click crafting-table
- # 如果是old，右键工作台时打开原版合成系统
- # if old, open vanilla crafting-table
- # when right click crafting-table
- default: sel
- # 如果打开新型合成系统
- # 打开的GUI的合成面板ID
- # if open custom crafting system
- # open the gui id custom crafting system
- gui: gui
- # 关于合成系统菜单
- # about custom crafting system
- inventory:
- # 合成系统标题
- # inventory title
- #title: '&lcrafting system'
- title: '&l合成系统'
- # 点击合成按钮的名称
- # click on the name of the composition button
- #button: '&7&l[&acomposition&7&l]'
- button: '&7&l[&a点击合成&7&l]'
- # 关闭按钮的名称
- # click on the name of the close button
- #close: '&7&l[&cclose&7&l]'
- close: '&7&l[&c关闭&7&l]'
- # 关于选择界面 About selection Gui
- selectGui:
- #title: "&lPlease select Crafting System"
- title: "&l请选择合成系统"
- #vanillaGuiButton: "&7&l[&aVanilla Crafting Gui&7&l]"
- vanillaGuiButton: "&7&l[&a原版合成系统&7&l]"
- #newGuiButton: "&7&l[&aNew Crafting Gui&7&l]"
- newGuiButton: "&7&l[&a新型合成系统&7&l]"
. 自定义矩阵
Panel.yml
- # 合成面板ID
- gui:
- # 合成系统矩阵
- # 放置所需合成物品的槽位
- # 0是第一格，1是第二格，以此推类
- matrix:
- - 10
- - 11
- - 12
- - 13
- - 19
- - 20
- - 21
- - 22
- - 28
- - 29
- - 30
- - 31
- - 37
- - 38
- - 39
- - 40
- # 合成按钮的槽位
- buttonSlots:
- - 16
- # 合成结果的槽位
- resultSlots:
- - 25
- # 关闭按钮的槽位
- closeSlots:
- - 43
- # 合成面板ID
- xxx:
- # ..同上
. API
对开发者更加友好（hook后，别忘记添加Recipe.yml和Panel.yml，如果加入时）
- if (Bukkit.getPluginManager().isPluginEnabled("iCraft")) {
- saveResource("Recipe.yml", false); //如果需要注册配方则加入
- saveResource("Panel.yml", false); //如果需要面板配方则加入
- IManager.hook(this);
- }
也可以通过API添加配方
- List<ItemStack> itemMatrix = new ArrayList<>(); // 所需合成物品，空的请设置为Material.AIR
- List<ItemStack> results = Collections.singletonList(itemStack); // 合成结果
- Recipe recipe = new Recipe(配方ID, 合成面板ID", itemMatrix, results); // 实例化配方
- IManager.registerRecipe(recipe); // 注册配方
可通过反编译查阅api包
