二次开发 开源 娱乐 CraftItem —— 锻造物品重制版 更有(zhe)趣(mo)、更耐玩的物品锻造 [1.8-1.21] 2.0.3

锻造物品 CraftItem

用更多花样的锻造方法折磨取悦你的玩家吧！

一张图看完锻造配方的全部设置 (图为 v1.1.3 的全部设置)
最近空闲时间不多，v2.0.0 的图找个时间再做，只是多了些功能，差不多的。




为什么选择这个重制版

1. 功能众多：原插件本来就非常占用玩家的时间，而且吊玩家胃口，我们添加了更加困难的 Custom-Fishing 小游戏锻造，以及只需要花时间就可以完成锻造的时长锻造，比原插件的功能更丰富
2. 稳定运行：此插件在本帖作者的服务器上已运行近两年，添加新锻造模式的版本也已运行近一年未出现问题。这个插件也是作者服务器的特色插件之一，出现漏洞时，更新有保障。
3. 修复漏洞：原插件的代码是惨不忍睹，从 2.0.0 起使用 PluginBase 框架真正重构了大量代码，提高开发效率。在这个重制版，我们还修复了原插件的材料拿在副手不消耗等严重漏洞。
4. 开发者友好：不仅保持开源，重制版还添加了一些方便开发者使用的事件，比如 MaterialDisappearEvent，你可以通过取消这个事件，在玩家遭遇大失败时，阻止某些贵重物品损坏。当然，新版本在配置文件增加了阻止损坏的选项，通常来说能满足绝大多数需求。
5. 插件间联动：支持与经济插件、变量插件进行最基本的联动。同时，还支持与 MMOItems 等插件联动，识别材料时，仅识别特定插件物品的 ID，而非识别完整物品！（目前仅支持 MMOItems，这里是兼容代码，欢迎贡献其它插件支持）
6. 还有更多，我忘了！

高自定义界面

详见配置文件 Gui.yml (Github)
可自由编辑图标位置、添加 CustomModelData 实现自定义图标贴图、点击执行命令、命令中使用PAPI变量等等

命令/权限
子命令对应的权限为 craftitem.command.<子命令>，如 craftitem.command.open。一般不需要给玩家任何权限。
你可以搭配菜单插件，使用控制台命令 ci open <配方ID> [玩家] 的方式为玩家打开锻造界面。

以下命令中，<> 为必选参数，[] 为可选参数，参数不需要输入尖括号和方括号。

• /ci category <分类> [玩家] 给 自己/别人 打开分类界面
• /ci open <配方ID> [玩家] 给 自己/别人 打开锻造界面
• /ci get <配方ID> [玩家] 给 自己/别人 锻造成功后的奖励
• /ci create <配方ID> 创建锻造配方
• /ci delete <配方ID> 删除锻造配方
• /ci edit <配方ID> 编辑锻造配方
• /ci reload 重载配置文件

如果开启了 Setting.RequirePermission 选项（默认开启），则打开锻造界面还需要 craftitem.open.配方ID 权限

模式说明

本插件有三个锻造模式，理解各个模式的工作逻辑，有助于你灵活运用本插件。


1. 普通锻造模式

与困难锻造冲突，困难锻造为“关闭”时可用。

在该模式下，玩家需要在背包内放好锻造所需的所有材料，然后点击锻造按钮，扣费成功后开始锻造。每次开始锻造都会扣费，不会扣材料。但是锻造结束后有一个情况会扣除玩家的材料，详见下文。

首先，插件会随机生成一个程度值，程度可以为 小, 中, 大，分别使用锻造配方设置中对应的三个倍率。

播放“敲敲打打”“锻造中”标题，等一段时间，
然后根据锻造设置中的成功率判定锻造是否成功。

如果成功了，按照程度值，有 小成功, 成功, 大成功，锻造进度将增加相应倍率。
如果失败了，按照程度值，有 小失败, 失败, 大失败，锻造进度将减少相应倍率。

当程度为大失败时，玩家将会随机丢失一个材料，这是原插件最折磨人、最刺激的地方。

在这种锻造模式下，锻造不可能一次就出来成品，需要锻造多次直到锻造进度达到 100% 才可获得该配方的最终成品。

获得最终成品时，扣除玩家背包中的所有材料。

小技巧
将倍数调成“100 100 100”，将成功率调成100，锻造一次就能成功并获得最终成品。
（经典锻造逻辑，反正普通锻造能实现，就不单独做一个模式了。）

点击展开...

2. 时长锻造模式 *重制版新增

与普通锻造模式和困难锻造模式共存，锻造时长设置为一个时间时可用。

在该模式下，玩家需要在背包内放好锻造所需的所有材料，然后点击锻造按钮，扣费成功后开始锻造。这次，插件将会在玩家开始锻造时，扣除玩家背包中的所有材料，并记录锻造开始的时间。

玩家此时可以在菜单中看到当前锻造进度，等待当前时间到达锻造配方设置中的锻造时长后，进度将达到 100%，玩家可在锻造界面中领取该配方的最终成品。



3. 困难锻造模式 *重制版新增

与普通锻造冲突，困难锻造为“开启”时可用

与普通锻造几乎一致，只在一个地方有所不同。

在困难锻造中，在普通锻造的基础上，执行到 然后根据锻造设置中的成功率判定锻造是否成功。 之前，先在此中断，取消显示“敲敲打打”标题，取而代之的，是开启一个 Custom-Fishing 小游戏。

如果小游戏成功了，在之前中断的位置继续，判定锻造是否成功。
如果小游戏失败了，终止锻造，直接判定为失败。

困难锻造模式一样会随机生成程度值，影响锻造进度增减的倍率。

比较好玩的是，即使小游戏成功了，也有可能锻造失败，就像本帖图片展示的最后一幅图一样；
如果小游戏不成功，必锻造失败。
这是我将其称为“困难锻造”的原因。

这就相当于在普通锻造开始时加了一个比较难的“人机测验”，如果你在配置文件中的“随机游戏设置”里面设置一些难度非常逆天的小游戏，人都不一定过得去。

小技巧
与普通锻造类似，倍数和成功率均调成100，则需要玩家完成一次小游戏即可获得锻造成品。

点击展开...

希望你和你的玩家玩得愉快 :)






开源许可证

原插件部分保持 MIT 许可证，MrXiaoM 修改部分使用 GPL-3.0 许可证，许可证正文详见 LICENSE。