Devlopment - twoone-3/BDSpyrunner GitHub Wiki

开发插件

要求

  • 熟练掌握了Python3的相关知识,如果未掌握可前往菜鸟教程学习。

环境

  • 下载Visual Studio Code并安装PythonPyLance扩展
  • 将仓库中的mc.pyi放入plugins文件夹
  • 使用Visual Studio Code打开plugins文件夹,即可自动补全代码

开始

如果你已经了满足上面的要求就可以开始写插件了

1. 创建新文件

plugins目录下创建myplugin.py,键入以下内容:

import mc
help(mc)

如果不想在后续的代码编写中写'mc.',则可以使用'from mc import *' 保存之后启动BDS,你将看到mc模块的详细信息

2. 监听游戏内事件

使用setListener函数可以将一个函数与某个事件绑定起来,如下:

from mc import *
def onUseItem(e):
    print(e)
setListener('onUseItem', onUseItem)

保存并启动BDS,进入服务器,
当你使用物品时,一些相关的数据就会打印的控制台上。

3. 获取实体数据

有了监听器回传的这些数据,我们该怎么处理呢?
来看下面这个例子

from mc import *
def onUseItem(e):
    p = e['Player']
    pos = p.pos
    print(p.name + '在' + str(pos) + '使用了物品')
    p.sendText(p.name + '在' + str(pos) + '使用了物品')
setListener('onUseItem', onUseItem)

将文件保存为UTF-8格式以支持中文
启动BDS,进入游戏测试,你将在控制台看到输出

结束

好了现在你已经完全掌握了插件开发的基础内容
去尽情发挥创造力吧!
有任何问题可以在QQ群里反馈