AP-More

⚠ 使用前须知！

这不是一个由box3lab神岛实验室官方发布的项目

本项目未完全测试，存在不可预测的风险，不建议用于生产！！

如果使用本项目进行游戏开发，带来的后果作者不承担责任，本项目应该被视为整活项目

本插件支持Python或者JavaScript与ArenaPro集成开发。

忠告：还是乖乖学TypeScript吧，别的东西都不是ArenaPro官方支持的。

以下部分是Python部分的教学

将Python集成到神岛ArenaPro的项目里！（arenapro+daopy=啥？不知道，反正daopy的1m体积够神岛编辑器喝一壶的）

使用

创建Ap-More项目(Python)

在ArenaPro上使用Python需要一定修改，所以这样的项目要通过本插件创建。

打开一个空的文件夹

按下Ctrl-Shift-P 打开命令面板，输入并找到：

Ap-more: 创建 AP-more 项目

选择Skulpt.js来运行Python

请等待一切执行完成，查看终端提示。

编写Ap-more(Python)代码

找到client/src/daopy-client/index.py 和 server/src/daopy-server/index.py，它们分别是client端和server端的入口文件

# 假设这是server端
from dao3 import * # 引入当前端的所有全局对象（api）
@world.onPlayerJoin
def onPlayerJoin(ev):
    world.say(f"{ev.entity.player.name} 加入了这个游戏！")

关于api

提示：

MicroPython WASM支持目前存在无法解决的bug，不想理会的话请使用Skulpt.js支持： from dao3 import * 不可用，原因未知。需要精确导入，例如from dao3 import world,voxels

Python的API与js的几乎没有区别，所以直接阅读box3api文档即可。编写代码时有自动补全的。但是编写时要注意以下几点：

需要引入API：from dao3 import * 会引入当前端所有的API
再也没有异步了：所有的async函数或者返回Promise的函数会被同步执行，直接阻塞返回结果（这个是Skulpt.js的Suspension特性），例如dialog不需要await了。如果你需要写一段不断执行的脚本，那么推荐你用@world.onTick事件
事件使用：以下是推荐的事件使用方式：

# server端
from dao3 import *

# 1.装饰器形式,函数名随意
@world.onPlayerJoin
def onPlayerJoin(ev:GameEntityEvent):
    # ev 是事件对象，冒号后面的可加可不加，加了自动补全会更方便，至于加什么嘛，看box3api文档
    world.say(f"{ev.entity.player.name} 加入了这个游戏！")

# 2.普通函数形式
def onPlayerJoin(ev:GameEntityEvent):
    world.say(f"{ev.entity.player.name} 加入了这个游戏！")
world.onPlayerJoin(onPlayerJoin) # 注册事件

预构建、构建和上传

预构建：这个在命令面板里输入预构建可以找到，会把daopy文件编译成_daopy_bundle.ts
构建+上传：这个是原ArenaPro的功能了，本插件直接调用它来完成预构件以后的操作。
预构建+构建+上传，这个可以在命令面板找到，直接执行所有操作上传到地图。（一键三连了属于是，这个是最常用的）

注意事项

创建AP-dpy不要使用原版的ArenaPro插件，这样创建的是纯TypeScript项目。
使用本插件时请使用命令面板中的预构建+构建+上传来部署

AP-More

tobylai

AP-More

以下部分是Python部分的教学

使用

创建Ap-More项目(Python)

编写Ap-more(Python)代码

关于api

预构建、构建和上传

注意事项

相关链接

以下是ArenaPro官方的链接：

以下是非官方（本插件）的链接：

其他链接：

鸣谢