我的世界MMCE升级系统使用教程

本教程适用人群:会安装模组、配置环境且可熟练使用ZenScript的人群。

适用版本:MMCE-1.11.1-r39。


MMCE在r39版本中加入了升级系统,目前尚未完工但基础功能已具备。

创建升级

首先,我们需要导入类:

import mods.modularmachinery.MachineUpgradeBuilder;

接下来,创建一个升级:

MachineUpgradeBuilder.newBuilder(String name, String localizedName, int level, int maxStack);
//level暂无作用;name必须唯一。

然后,您可以对创建出的MachineUpgradeBuilder对象做出许多操作:

MachineUpgradeBuilder addDescriptions(String... descriptions); //为升级添加固定工具提示,会在添加了升级的物品上显示;可为多行。

MachineUpgradeBuilder setBusGUIDescriptionHandler(IFunction<SimpleMachineUpgrade, String[]> handler); //为升级添加升级总线提示的事件监测

MachineUpgradeBuilder addCompatibleMachines(String... machineNames);
MachineUpgradeBuilder addIncompatibleMachines(String... machineNames);
//上述两个,分别为添加白名单、添加黑名单机械,未使用时默认对所有机器生效;这两个方法互相冲突。

MachineUpgradeBuilder addRecipeCheckHandler(UpgradeEventHandlerCT handler);
MachineUpgradeBuilder addRecipeStartHandler(UpgradeEventHandlerCT handler);
MachineUpgradeBuilder addRecipePreTickHandler(UpgradeEventHandlerCT handler);
MachineUpgradeBuilder addRecipePostTickHandler(UpgradeEventHandlerCT handler);
//……
//这些事件可以在源代码仓库中的
// src/main/java/hellfirepvp/modularmachinery/common/integration/crafttweaker/upgrade/MachineUpgradeBuilder.java 
// 找到。
//具体用法,参考下方示例与 src/main/java/hellfirepvp/modularmachinery/common/integration/crafttweaker/event/MMEvents.java 。
//事实上,有关升级的大部分需求都可以在此实现。

示例:

import mods.modularmachinery.MachineUpgradeBuilder as Builder;
Builder.newBuilder("upgradename","升级名",1,64).setBusGUIDescriptionHandler(
    function(SimpleMachineUpgrade){
        return ["text",] as string[];
    }).addRecipeCheckHandler(function(MachineUpgrade){
        //相关代码    
})

事件相关类

你可能注意到了一些问题,就比如SimpleMachineUpgrade和MachineUpgrade是什么东西。

SimpleMachineUpgrade可在setBusGUIDescriptionHandler事件中得到,可以由此获取存储在升级总线里的自定义IData——customData。注意,该成员同时是ZenGetter和ZenSetter;亦可以获取升级数,通过[ZenGetter] stackSize

MachineUpgrade会在所有的配方事件中得到,请用以下方式强转:

import mods.modularmachinery.MachineUpgradeHelper;

SimpleDynamicMachineUpgrade castToSimpleDynamicMachineUpgrade(MachineUpgrade upgrade);

当然还有个类叫做SimpleDynamicMachineUpgrade,但是由于上面创建的是简单升级,因此不能用这个类;但当你用DynamicMachineUpgradeBuilder创建了动态升级之后,得到的MachineUpgrade都是SimpleDynamicMachineUpgrade,请用类似方式转换。SimpleDynamicMachineUpgrade相较SimpleMachineUpgrade多了一个存储在物品上的自定义IData,即itemData,用法与customData相同。

绑定物品

import mods.modularmachinery.MachineUpgradeHelper;
addFixedUpgrade(IItemStack itemStack, String upgradeName);

没什么好说的,upgradeName就是上面注册升级时唯一的Name,使用该方法后物品将可以作为升级装入升级总线并发挥其作用。

Copyright © 2018-2023 PHP源码网 版权所有
PHP源码网 » 我的世界MMCE升级系统使用教程

提供最优质的资源集合

立即查看 了解详情