Files
netease-modsdk-wiki/docs/mconline/60-我的世界创造营教程/玩法组件进阶教程/2-逻辑编辑器基础/5-逻辑编辑器的基础概念(4).md
boybook 760c2dd9ad 2.6
2025-12-01 20:59:16 +08:00

100 lines
4.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
front:
hard: 进阶
time: 20分钟
---
# 逻辑编辑器的基础概念4
在学习使用了官方提供的各种零件接口和SDK接口之后现在我们就可以尝试自己自定义一个接口啦。
<iframe src="https://cc.163.com/act/m/daily/iframeplayer/?id=6328664ee6c041f2578ca804" width="800" height="600" allow="fullscreen"/>
## 什么是自定义接口
在大型玩法开发中,我们会发现有时候很多地方都需要调用相同的功能,执行除了参数以外,几乎一样的逻辑节点。那么自定义接口就可以很好地解决这个问题,我们可以自定义一个接口,并且定义接口内部执行的逻辑节点。并且自由地调用它。这样可以极大地简化我们的逻辑代码。
## 定义自定义接口
在逻辑编辑器中,我们在左侧可以看到自定义接口一栏。在这里就可以创建一个自定义接口。
![](./images/56.png)
点击自定义接口右侧的加号,就可以创建一个自定义接口。然后修改其名字,我们这里改成`f_test`,需要注意,自定义接口必须以`f_`开头。
并且在顶部可以看到`Graph > f_test`,代表我们正在编辑的接口。
点击Graph即可返回到原来的编辑界面。双击左侧的自定义接口中的`f_test`,即可返回这个自定义接口的编辑。
![](./images/57.png)
我们可以在这里编写我们需要的逻辑从In的输入处开始执行直到输出处的Out就退出自定义函数。
自定义函数必须要从In到Out有一条完整的执行连线否则无法正常工作。
例如我们在这里循环从1打印到100然后链接输出。
![](./images/58.png)
这样就完成了自定义接口的编辑。我们回到Graph界面。
可以从左侧自定义接口中,选中`f_test`,并拖动到编辑界面中,就创建了一个节点调用我们的自定义接口。然后我们把它连接到服务端初始化之后来执行,查看日志窗口的输出效果。
![](./images/59.png)
![](./images/60.png)
可以看到像预期一样从1打印到了100。
## 自定义接口的参数
自定义接口如果只是能像刚刚所做的那样,能把一部分节点,封装到一个接口中,进行调用,就会显得很死板,因为其中的值都被固定。
遇到这种情况,我们就可以给它创建一个参数,在外部调用这个接口的时候,将参数带入接口,就可以让这个接口的实用性大大提高。
![](./images/61.png)
在左侧自定义接口选中了要编辑的自定义接口后,右侧属性面板就会出现相应的配置。可以看到有一个`inputParams`栏,还有一个`outputParams`栏。
我们可以在这里新增输入和输出参数,让它在运行前传入一些值,在运行结束后,再传出一些值。
假如还是刚才的循环的自定义接口我们希望传入参数指定它从1循环到多少我们就可以新增一个`inputParams`,点击加号新增。
如果我们还需要这个接口将某个运算结果传递回来,也可以新增一个`outputParams`,作为返回值。
![](./images/62.png)
我们这里先新增一个输入参数,定义它的名字为`循环到`,类型为`int`,然后再次回到自定义接口编辑处。就可以看到输入的节点多了一个循环到的端口,我们可以将它进行对应的参数传递,来达到预期的效果。
![](./images/63.png)
这样我们就可以在自定义接口外部定义需要循环多少次。现在就可以输入需要循环到的数字。
![](./images/64.png)
## Python模块
除了逻辑编辑器已经提供的接口外我们还可以直接调用Python的内置模块来实现更强大的功能。
![](./images/65.png)
细心的同学可能早就发现了在我们的编辑器中还有一个内置Python接口的分类在这里可以调用一些Python提供的接口例如对列表和字典的工具函数。
具体使用方法可以查阅Python的函数文档。
## 课后作业
`实体受到伤害`事件中,利用自定义接口 定义`实体标识符``手持物品名称``物品列表`三个参数,并重新实现攻击实体会随机掉落物品列表内的物品`的逻辑。
### 操作步骤
首先我们需要新建一个自定义接口,这里叫做`f_dropRandomItem`并给它定义3个输入参数物品列表的类型应该为list但是这里并没有列出list所以选择Any代表任意。
![](./images/66.png)
接下来我们可以把部分之前已经编写过的逻辑节点,复制到自定义接口中。然后对其连线进行调整。最后的效果如图:
![](./images/67.png)
完成配置后再回到Graph中直接将随机生成掉落物的逻辑节点替换成调用自定义接口就可以了。
![](./images/69.png)