luascript

ЛуаСкрипт

Поддержка языка Lua 5.4 для Godot Engine 4.x

WIP (значительно обновлено, поэтому вы можете ожидать изменения констант - на данный момент никаких обязательств по заморозке функций нет)

Текущий прогресс:

• Новый парсер, использующий Antlr4, запущен и работает. Теперь идет построение АСТ и статического анализатора.

Предупреждение!! Обратите внимание, что тег git 3.x существует только по историческим причинам, и хотя он компилируется, он не доработан. Поэтому, пожалуйста, не открывайте вопросы и не отправляйте пиар по этому тегу. Цените понимание.

Функции

• Полная реализация API игрового процесса Godot (функция аналогична GDScript)
• Настраиваемая песочница API
• Объектно-ориентированное программирование на основе таблиц и метатаблиц Lua.
• Поддержка наследования от базового класса и файла Lua.
• Поддержка наследования от собственного базового класса и файла.
• Поддержка свойств
  • Геттеры, сеттеры и значения по умолчанию
  • Редактирование значений свойств в редакторе свойств
• Поддержка сигналов
  • Сигнал подключения, излучения и получения из кода
  • Подключение сигнала из редактора (в настоящее время Godot плохо поддерживается)
• Кодирование на языке Lua во встроенном редакторе Godot
  • Линтинг и статический анализ исходного кода на лету
  • Подсветка синтаксиса исходного кода на лету
  • Улучшитель исходного кода
    • Форматировать весь активный файл
    • Форматировать выделенный текст
    • Автоматическое форматирование при сохранении
  • Рефакторинг исходного кода (в настоящее время не поддерживается Godot)
  • Цветовая тема редактора кода (Icemoon)
• Кодирование на языке Lua во внешнем редакторе (возможно, с теми же возможностями, что и встроенный редактор)
• Поддержка нескольких сред выполнения Lua (PUC Rio Lua 5.4 и LuaJIT).
• Инструменты отладки (возможно, со всеми возможностями отладки Godot)
• Создание инструмента для расширения встроенных функций редактора.
• Поддержка расширенной сборки пакетов
  • Устранение мертвого кода посредством встряхивания дерева
  • Углификатор и минификатор кода
  • Компиляция в двоичный байт-код
  • Сжатие или шифрование
• Экспорт для всех платформ, поддерживаемых Godot.

Как построить

Моя среда разработки основана в основном на Linux и Mac, поэтому я не знаю, будет ли она работать на Windows. Это не должно быть проблемой, поскольку я использую только стандартный код C++17 и доступный API Godot C++. Если у вас возникли какие-либо проблемы при сборке в Windows, сообщите о проблеме, и я буду рад поработать над ее решением.

Итак, прежде всего вам необходимо успешно встроить Godot в вашу систему, что выходит за рамки этого простого руководства.

Теперь, предполагая, что вы можете git clone из GitHub, просто клонируйте LuaScript в папку «модули» исходного кода Godot, а затем снова соберите Godot, добавив в командную строку следующие параметры.

модуль_luascript_enabled = да

Если все прошло хорошо, у вас будет работающий Godot с поддержкой Lua!

Продолжайте следить за развитием событий, поскольку я медленно, но неуклонно добавляю новые функции.

Веселиться!

Проблемы и поддержка

Есть ошибка? Пожалуйста, создайте проблему здесь, на GitHub!

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

Управление версиями

Для прозрачности и понимания нашего цикла выпуска выпуски нумеруются в семантическом формате версий: <major>.<minor>.<patch> и создаются с учетом следующих рекомендаций:

• Нарушение обратной совместимости приводит к серьезным последствиям.
• Новые дополнения без нарушения обратной совместимости
• Исправления ошибок и различные изменения, внесенные в патч.

Авторы

• Пауло Пербоне (@perbone)

Лицензия

Copyright 2017-2024 Пауло Пербоне

Лицензия Apache версии 2.0 («Лицензия»); вы не можете использовать этот файл, кроме как в соответствии с Лицензией. Вы можете получить копию Лицензии по адресу:

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

Если это не требуется действующим законодательством или не согласовано в письменной форме, программное обеспечение, распространяемое по Лицензии, распространяется на условиях «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ ИЛИ УСЛОВИЙ, явных или подразумеваемых. См. Лицензию для конкретного языка, регулирующего разрешения и ограничения в рамках Лицензии.