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

除非適用法律要求或書面同意，否則根據許可證分發的軟體均以「原樣」分發，不帶任何明示或暗示的保證或條件。請參閱許可證，以了解許可證下管理權限和限制的特定語言