[1.7.10][UD][CustomNEIPlugins——自定义NEI插件] 整合包作者的好帮手!（兼容CS2）

本帖最后由 jjnjjn 于 2016-12-2 23:03 编辑

在制作大中型整合包的时候，自己魔改的物品获取方式、或者自己添加的机器的处理配方往往有时不能直接呈现给玩家。

但如果装了这个mod，整合包作者便可以将对于物品的说明和一些机器的配方，以自定义NEI插件的形式呈现给玩家。

比如说，我们可以制作这样的NEI插件，让玩家在使用NEI查询苹果时，显示苹果的相关说明文字（示例内容摘自百度百科）：

再比如说，我们可以制作针对CustomStuff2模组自定义机器的插件（当然别的mod的机器也是可以的，不过一般来说Mod作者自己会制作相应的NEI插件），让玩家在使用NEI查询特定物品的时候可以查到该机器的处理配方；同时也可以让玩家在打开机器的Gui后，可以点击Gui里的特定位置来查看该机器所有的处理配方。

（下两幅图是我使用此mod为achang的Re:Start整合包中使用CustomStuff2模组制作的热能采掘机制作的NEI插件。由于只是示范，我没有把该机器所有的配方在NEI插件中制作出来，只制作了两个配方加以示范）。

（下两幅图是我为原版工作台添加的额外NEI插件，当点击工作台Gui箭头下方的部分区域时，Gui会自动跳转到我自定义的NEI插件中。如果使用NEI查询下届之星或者钻石或者泥土的配方，也会出现这个NEI插件。如果想要将这个配方真实地添加进游戏，可以再使用Minetweaker等模组）

自定义插件的详细方法

该mod是通过编写json文件来自定义NEI插件的，不过不用担心，编写一个自定义插件的json文件并不复杂。

第一次启动该mod时，它会在mod的配置文件夹(.minecraft/configs)中生成自己的配置文件夹“CustomNEIPlugins”，该文件夹内部如下图所示。

ModSettings.cfg是此mod的主配置文件，目前只用来修改像前面的苹果那样的插件(即下面提到的PluginStackInfo)的布局。

另外两个文件夹分别对应此mod目前支持的两种自定义插件的类型：PluginStackInfo（即像前面的苹果插件那样的插件），与PluginMachineRecipe（即像前面的热能采掘机与工作台那样的插件）

进入各个子文件夹去后，一共会看到3个json文件，分别对应上面的三个示例插件。它们都是示例模板。玩家可以复制并修改它们来方便地制作自己的NEI插件。（注意，这三个插件默认都是关闭的，想要在游戏中查看它们的作用得手动开启(方法见下文)）

下面我来介绍一下编写这两种插件的json文件的格式。注意：编写json时如果有的项不想要可以设置为空

Tips：

1. 对于json文件中所有非本地化名称，可以在语言文件中本地化它们时使用“§”符号，来达到改变颜色的效果。具体参见Wiki

2. 该Mod添加了两个命令"/cnp reload"与"/cnp status"，来让玩家可以在游戏中重新加载所有的配置文件(主配置文件+各个插件的json文件)，与查看当前各个插件的加载情况（会显示各个插件的加载状态，即已加载/已禁用/发生错误）

一、PluginStackInfo

首先介绍的是PluginStackInfo文件夹中的ExamplePluginStackInfo.json，这就是刚才的苹果对应的NEI插件。

编写这类插件时，首先json文件中的“plugin_type”项一定要写“plugin_stack_info”

“plugin_enabled”表示是否启用该插件，所有模板中的值都是“false”，一定要把它改为“true”才能正常使用

“plugin_recipe_per_page”表示NEI插件中一页显示几个配方，这个值建议写1-2，超过2个的话，NEI将无法正常显示

“plugin_unlocalized_title_name”表示NEI插件的标题的未本地化名称，这个值可以自行填写，但最好包含需要支持的mod的modid，不然容易和其他mod冲突。填好之后，可以在任何mod的语言文件中添加此名称的本地化条目（如果其他mod不允许修改语言文件的话，可以在此mod的语言文件中添加，我不介意）。之后便可以在游戏中正常显示本地化的名字了。

“plugin_content”表示插件具体的内容，在这条里：“item”项中需写上物品的名称，比如“minecraft:apple”或者“minecraft:coal:1”；“basic_unlocalized_display_string”表示所显示文本的非本地化名称的基础部分，而“document_amount”表示该物品一共有多少条说明，设置好这两个值后，还需要和之前一样，在一个mod的语言文件中设置好对应的本地化条目，即写上形如“xxxxx1=xxx”,“xxxxx2=xxxx”的本地化条目，其中xxxxx表示非本地化名称的基础部分，后面的数字表示它是第几条说明。默认情况下，每一页显示1条说明。本地化文本中不需要添加换行符，此mod会自动换行。“is_crafting_recipe”表示该插件是否会在查询相应物品来源（比如对着物品按R键）的时候被加载，而“is_usage_recipe”表示该插件是否会在查询相应物品用途（比如对着物品按U键）的时候被加载

二、PluginMachineRecipe

再来说说更复杂，但功能也更多的PluginMachineRecipe。该mod会自带ExamplePluginMachineRecipe1.json（即前面那个工作台的插件）与ExamplePluginMachineRecipe2.json（即前面热能采掘机的插件）两个模板插件。这儿只对ExamplePluginMachineRecipe1.json作说明，并且与前面插件相同的条目我就不再赘述了。

编写这类插件时，首先json文件中的“plugin_type”一定要写“plugin_machine_recipe”

略去几个前面提到过的条目后，“plugin_background_texture”中需填写NEI插件背景图片所在的资源路径，默认的是NEI自带的那种灰色背景，如果某个机器的Gui不是这种灰色的，那需要修改这个值。

“plugin_gui_texture”是机器Gui材质文件的资源路径

“plugin_gui_class”表示Gui机器所在.class文件的路径（即java中的包名+类名，最后不需要加上.class的后缀名），比如原版工作台就填“net.minecraft.client.gui.inventory.GuiCrafting”，其他mod的机器可以通过用解压缩软件打开mod的jar文件寻找。对于用CustomStuff2制作的带有Gui的“机器”，这儿需填写“custom_stuff2.modid.gui_name”，其中modid表示用CS2制作的mod的modid，gui_name表示CS2中gui的名称。

“plugin_recipe_identifier”表示该机器配方的标识符，用于让NEI识别并过滤配方。这个的值可以随意写，但一定不能和其他插件的值重复，不然点击Gui中的特定位置时，可能会跳转到别的NEI插件，而不是你自定义的这个NEI插件。

“plugin_transfer_rect”表示Gui中跳转查看该NEI插件所有配方的矩形的位置。其中有多个参数，分别表示x,y坐标和矩形的长宽。

“plugin_progress_bar”表示插件中进度条的显示，这个json没有进度条，所以是空。具体格式参见ExamplePluginMachineRecipe2.json，其中参数依次表示Gui中的x,y坐标、材质文件中的x,y坐标、进度条宽度、高度、进度条显示完全所需的tick数，和进度条显示的方向（默认的0代表自左向右显示，1表示向下，2表示向左，3表示向上；设置为4-7表示进度条方向为0-3，但是此时显示的是由满进度减少为零进度）。

“plugin_gui_offset”：由于NEI插件显示的页面材质只是将Gui材质的部分截取出来(比如截取的高度只有65)，所以可能会出现Gui材质在NEI插件中错位的情况。修改这个值可以调节材质的位移进行补偿。（默认值为5和11）

“plugin_recipes”表示该机器全部的处理配方。“inputs”表示一条配方的输入，可以写多个物品，其下属参数分别表示物品名称、堆叠个数、是否匹配矿物辞典和在NEI插件中的x，y坐标。“outputs”表示一条配方的输出，同样可以写多个物品，参数意义和输入基本一样，不过“oredict_search”项与输入物品中的“oredict”项略有不同：由于同样的输入只能有唯一的输出，因此输出物品的矿物辞典匹配只代表在查询其配方(即对它按R键)的时候，是否同一矿典的物品都会匹配到这条配方，而不代表在输出产物的位置处循环显示同一矿典的多个物品(这点与输入物品的矿典匹配不同)。“strings”表示在该配方显示的时候同时写出的文字，这个json为空，具体格式可见ExamplePluginMachineRecipe2.json，同样可以写多个值，不过需注意，此时"string"项中填写的也是非本地化文本，并且支持格式化输入，（具体格式可参考ExamplePluginMachineRecipe2.json和此模组的语言文件），格式化输入时，"string"项由非本地化名称与任意长度的参数以”_,”两个字符相连接。

更新日志

下载地址：http://pan.baidu.com/s/1qYxYlaO

此外，该mod以MIT许可证在GitHub上开源：https://github.com/GWYOG/CustomNEIPlugins

[groupid=1181]Unknown Domain[/groupid]

回复: