简介
Lua 为蛋仔游戏开发提供了更高的灵活性和更好的性能。
本教程假设读者已具备 Lua 和蛋码的基础知识。蛋仔支持的 Lua 版本为 5.4。
开发环境设置
必要工具
安装步骤
- 启动 PC 版蛋仔编辑器,打开目标地图。
- 在插件菜单中点击"蛋仔开发助手"(Eggitor)。
- 选择生成工程，会自动插件安装至 VSCode。
- 如果自动安装未能成功，可在"编辑器安装目录\Documents\res\luac"下找到eggitor.vsix文件进行手动安装。
工程设置
- 在 VSCode 中,你会在侧边栏看到蛋仔图标。
- 在蛋仔开发助手界面点击"生成工程",选择合适目录。
- 点击"连接",将编辑器连接至 VSCode。
更多插件介绍请参考"蛋仔开发助手"一章。
编写第一个 Lua 脚本
- 在工程目录下新建
main.lua文件。 - 添加简单的打印语句:
lua
print("Hello, Eggy!")- 在蛋仔编辑器中运行,查看触发器调试窗口的输出。
使用 API 发送游戏内提示
当然，在触发器日志框里弹提示玩家是看不到的，如何发个飘字提示给玩家呢？这就需要使用蛋仔的API接口了：
lua
GlobalAPI.show_tips("Eggy!!", 3.0) -- 持续 3.0 秒
API 使用指南
导出 API
使用 VSCode 蛋仔开发助手插件的"导出 API"功能生成 EggyAPI.lua 文件,包含所有可用 API、类型和常量。
API 分类
- 全局 API: LuaAPI, GameAPI, GlobalAPI (直接调用)
- 单位 API: 使用 "单位.方法" 形式调用 (注意使用点号 . 而非冒号 😃
| API 类型 | 描述 | 调用方式 |
|---|---|---|
| LuaAPI | Lua 专用 API | 直接调用 |
| GameAPI | 游戏逻辑相关 | 直接调用 |
| GlobalAPI | 游戏效果表现相关 | 直接调用 |
| 单位 API | 不同类型单位的专用 API | 单位.方法 |
注意事项
- 优先使用已文档化的 API。
- 避免使用未文档化的测试状态 API,因其可能在未来被移除或替换。
结语
恭喜你已经掌握了蛋仔 Lua 的基础知识。现在,你可以开始开发自己的地图了！祝你开发愉快！