luascript

LuaScript

Soporte de lenguaje Lua 5.4 para Godot Engine 4.x

WIP (muy actualizado para que pueda esperar cambios constantes; no hay compromiso con la congelación de funciones en este momento)

Progreso actual:

• El nuevo analizador que utiliza Antlr4 está en funcionamiento. Ahora viene la construcción del AST y del analizador estático.

¡¡Advertencia!! Tenga en cuenta que la etiqueta git 3.x existe solo por razones históricas y, aunque se compila, no está terminada. Así que no abra problemas ni envíe relaciones públicas para esta etiqueta. Agradezco la comprensión.

Características

• Implementación completa de la API de juego de Godot (función completa a la par con GDScript)
• Zona de pruebas API configurable
• Programación Orientada a Objetos basada en tablas y metatablas de Lua
• Soporte para herencia de archivos y clases base de Lua
• Soporte para herencia desde archivos y clases base nativos
• Soporte para propiedades
  • Captadores, definidores y valores predeterminados
  • Editar valores de propiedades en el editor de propiedades
• Soporte para señales
  • Conexión, emisión y recepción de señal desde código.
  • Conexión de señal desde el editor (actualmente no es compatible con Godot)
• Codificación en lenguaje Lua en el editor integrado de Godot
  • Linting de código fuente y análisis estático sobre la marcha
  • Resaltado de sintaxis del código fuente sobre la marcha
  • Embellecedor del código fuente
    • Formatee todo el archivo activo
    • Formatear el texto seleccionado
    • Formatear automáticamente al guardar
  • Refactorización del código fuente (actualmente no soportado por Godot)
  • Tema de color del editor de código (Icemoon)
• Codificación en lenguaje Lua en un editor externo (posiblemente con las mismas capacidades que el editor integrado)
• Soporte para múltiples tiempos de ejecución de Lua (PUC Rio Lua 5.4 y LuaJIT)
• Herramientas de depuración (posiblemente con todas las capacidades de depuración de Godot)
• Creación de herramientas para ampliar las funcionalidades integradas del editor.
• Soporte para ensamblaje avanzado de paquetes
  • Eliminación de códigos muertos mediante sacudidas de árboles
  • Código feo y minificador
  • Compilación en código de bytes binario
  • Compresión o cifrado
• Exportación para todas las plataformas compatibles con Godot

Cómo construir

Mi entorno de desarrollo se basa principalmente en Linux y Mac, por lo que no sé si funcionará en Windows. Sin embargo, no debería ser un problema, ya que solo estoy usando el código C++ 17 estándar y la API Godot C++ disponible. Si tiene algún problema al compilar en Windows, infórmelo y estaré encantado de trabajar para solucionarlo.

Entonces, primero que nada, debe tener Godot integrado exitosamente en su sistema, lo cual está más allá del alcance de este sencillo procedimiento.

Ahora, asumiendo que puedes clonar desde GitHub, simplemente clona LuaScript en la carpeta 'módulos' del código fuente de Godot y luego compila Godot nuevamente agregando a la línea de comando las siguientes opciones

module_luascript_enabled=sí

Si todo ha ido bien, ¡tendrás un Godot funcionando con soporte de Lua!

Continúe observando el desarrollo mientras agrego más funciones de manera lenta pero constante.

¡Divertirse!

Problemas y soporte

¿Tienes un error? ¡Cree un problema aquí en GitHub!

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

Versionado

Para mayor transparencia y conocimiento de nuestro ciclo de lanzamiento, los lanzamientos se numerarán con el formato de versión semántica: <major>.<minor>.<patch> y se construirán con las siguientes pautas:

• Romper la compatibilidad con versiones anteriores choca con el principal
• Las nuevas incorporaciones sin romper la compatibilidad con versiones anteriores superan al menor
• Las correcciones de errores y cambios varios superan el parche

Colaboradores

• Paulo Perbone (@perbone)

Licencia

Copyright 2017-2024 Paulo Perbone

Licenciado bajo la Licencia Apache, Versión 2.0 (la "Licencia"); no puede utilizar este archivo excepto de conformidad con la Licencia. Puede obtener una copia de la Licencia en

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

A menos que lo exija la ley aplicable o se acuerde por escrito, el software distribuido bajo la Licencia se distribuye "TAL CUAL", SIN GARANTÍAS NI CONDICIONES DE NINGÚN TIPO, ya sean expresas o implícitas. Consulte la Licencia para conocer el idioma específico que rige los permisos y limitaciones según la Licencia.