AP-More 3.0.2

新的介绍内容：

AP-More插件旨在将Python和JavaScript与神岛ArenaPro集成，提供一个非官方的开发工具。需要注意的是，本项目并非由box3lab神岛实验室官方发布，且未完全测试，存在不可预测的风险，不建议用于生产环境。使用本项目进行游戏开发所带来的后果，作者不承担责任，本项目应被视为整活项目。

使用AP-More插件进行开发：

• 支持语言： 本插件支持Python和JavaScript与ArenaPro的集成开发。
• 使用建议： 虽然插件支持多种语言，但官方推荐学习TypeScript，因为它是ArenaPro官方支持的语言。

Python集成教学：

要将Python集成到神岛ArenaPro项目中，您需要使用AP-More插件进行项目创建和代码编写。

• 创建AP-More项目（Python）：

  1. 打开一个空文件夹。
  2. 按下Ctrl-Shift-P打开命令面板，输入并选择"Ap-more: 创建 AP-more 项目"。
  3. 选择Skulpt.js作为Python运行环境，等待执行完成。

• 编写AP-More（Python）代码： 找到client/src/daopy-client/index.py和server/src/daopy-server/index.py，它们分别是客户端和服务器端的入口文件。示例代码如下：

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

• API使用：

  • 由于MicroPython WASM支持存在bug，建议使用Skulpt.js支持。需要精确导入API，例如from dao3 import world, voxels。
  • Python的API与JavaScript的几乎相同，可参考box3api文档。注意Skulpt.js的Suspension特性，所有异步函数将同步执行。

• 预构建、构建和上传：

  • 预构建：在命令面板中输入"预构建"，编译daopy文件为_daopy_bundle.ts。
  • 构建和上传：使用原ArenaPro功能进行。
  • 一键三连：在命令面板中选择"预构建 构建 上传"，完成所有操作并上传到地图。

注意事项：

• 创建AP-dpy项目时，请勿使用原版ArenaPro插件，否则会创建纯TypeScript项目。
• 使用本插件时，请使用命令面板中的"预构建 构建 上传"来部署。

相关链接：

• ArenaPro官方链接：

  1. Box3lab: ArenaPro插件 - 告别繁琐，拥抱高效！
  2. 神岛实验室 - ArenaPro的开发团队官网。

• 非官方（本插件）链接：

  1. daopy-runtime - 神岛中运行Python的运行时组件。
  2. daopy-npm - 发布在npm上的daopy运行时。
  3. tobylai的小站。

• 其他链接：

  1. Skulpt.js - 基于JavaScript的Python解释器。

鸣谢：

• 神奇代码岛
• 神岛实验室
• 岛研所(非官方)
• Skulpt.js
• MicroPython
• Icons8（图标来源）

请谨慎使用AP-More插件，了解其非官方性质和潜在风险。