luascript

Lua脚本

Godot Engine 4.x 的 Lua 5.4 语言支持

WIP（大量更新，因此您可以期待不断的变化 - 目前不承诺冻结功能）

目前进展：

• 使用 Antlr4 的新解析器已启动并运行。现在是 AST 和静态分析器的构建。

警告！！请注意，git 标签 3.x 仅出于历史原因而存在，尽管它已编译，但尚未完成。因此，请不要为此标签打开问题或发送 PR。感谢理解。

特征

• 完整的 Godot 游戏 API 实现（功能与 GDScript 相当）
• 可配置的API沙箱
• 基于Lua的表和元表的面向对象编程
• 支持从Lua基类和文件继承
• 支持从本机基类和文件继承
• 对属性的支持
  • Getter、Setter 和默认值
  • 在属性编辑器中编辑属性值
• 支持信号
  • 从代码连接、发射和接收信号
  • 来自编辑器的信号连接（目前 Godot 还没有很好支持）
• Godot 内置编辑器中的 Lua 语言编码
  • 动态源代码检查和静态分析
  • 动态源代码语法高亮显示
  • 源代码美化器
    • 格式化整个活动文件
    • 设置所选文本的格式
    • 保存时自动格式化
  • 源代码重构（Godot目前不支持）
  • 代码编辑器颜色主题（Icemoon）
• 外部编辑器中的 Lua 语言编码（可能具有与内置编辑器相同的功能）
• 支持多个 Lua 运行时（PUC Rio Lua 5.4 和 LuaJIT）
• 调试工具（可能具有Godot的所有调试功能）
• 创建工具以扩展内置编辑器功能
• 支持高级封装组装
  • 通过 tree-shaking 消除死代码
  • 代码压缩器和压缩器
  • 编译成二进制字节码
  • 压缩或加密
• 导出到所有 Godot 支持的平台

如何建造

我的开发环境主要基于Linux和Mac，所以我不知道它是否可以在Windows上运行。不过这应该不是问题，因为我只使用标准 C++17 代码和可用的 Godot C++ API。如果您在 Windows 上构建时遇到任何问题，请报告问题，我将很乐意致力于解决它。

所以首先你必须在你的系统中成功构建 Godot，这超出了这个简单的方法的范围。

现在，假设您可以从 GitHub 进行 git clone，只需将 LuaScript 克隆到 Godot 的源代码“modules”文件夹中，然后再次构建 Godot，在命令行中添加以下选项

module_luascript_enabled=是

如果一切顺利，您将拥有一个运行 Lua 支持的 Godot！

请继续关注开发情况，因为我正在缓慢而稳定地添加更多功能。

玩得开心！

问题与支持

有错误吗？请在 GitHub 上创建问题！

https://github.com/perbone/luascript/issues

版本控制

为了提高发布周期的透明度和洞察力，版本采用语义版本控制格式进行编号： <major>.<minor>.<patch>并按照以下准则构建：

• 破坏向后兼容性会导致主要问题
• 在不破坏向后兼容性的情况下添加新内容会带来轻微的影响
• 错误修复和其他更改会影响补丁

贡献者

• 保罗·佩尔博恩 (@perbone)

执照

版权所有 2017-2024 保罗·佩博恩

根据 Apache 许可证 2.0 版（“许可证”）获得许可；除非遵守许可证，否则您不得使用此文件。您可以在以下位置获取许可证副本：

http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则根据许可证分发的软件均按“原样”分发，不带任何明示或暗示的保证或条件。请参阅许可证，了解许可证下管理权限和限制的特定语言