luascript

LuaScript

Suporte à linguagem Lua 5.4 para Godot Engine 4.x

WIP (fortemente atualizado para que você possa esperar mudanças constantes - sem compromisso com congelamento de recursos neste momento)

Progresso atual:

• O novo analisador usando Antlr4 está instalado e funcionando. Agora vem a construção do AST e do analisador estático.

Aviso!! Observe que a tag git 3.x existe apenas por razões históricas e, embora seja compilada, está inacabada. Portanto, por favor, não abra problemas nem envie PR para esta tag. Agradeço a compreensão.

Características

• Implementação completa da API de jogo do Godot (recurso completo no mesmo nível do GDScript)
• Sandbox de API configurável
• Programação Orientada a Objetos baseada em tabelas e metatabelas de Lua
• Suporte para herança de classe base e arquivo Lua
• Suporte para herança de classe e arquivo base nativo
• Suporte para propriedades
  • Getters, setters e valores padrão
  • Editando valores de propriedades no editor de propriedades
• Suporte para sinais
  • Sinal conectar, emitir e receber do código
  • Conexão de sinal do editor (atualmente não é bem suportado por Godot)
• Codificação da linguagem Lua no editor integrado do Godot
  • Linting de código-fonte em tempo real e análise estática
  • Destaque de sintaxe do código-fonte em tempo real
  • Embelezador de código-fonte
    • Formate todo o arquivo ativo
    • Formate o texto selecionado
    • Formate automaticamente ao salvar
  • Refatoração de código-fonte (atualmente não suportada por Godot)
  • Tema de cores do editor de código (Icemoon)
• Codificação da linguagem Lua em editor externo (possivelmente com os mesmos recursos do editor integrado)
• Suporte para múltiplos tempos de execução Lua (PUC Rio Lua 5.4 e LuaJIT)
• Ferramentas de depuração (possivelmente com todos os recursos de depuração do Godot)
• Criação de ferramenta para estender as funcionalidades integradas do editor
• Suporte para montagem avançada de pacotes
  • Eliminação de código morto por meio de agitação de árvores
  • Feio e minificador de código
  • Compilação em bytecode binário
  • Compactação ou criptografia
• Exporte para todas as plataformas suportadas pelo Godot

Como construir

Meu ambiente de desenvolvimento é baseado principalmente em Linux e Mac, então não sei se funcionará no Windows. Não deve ser um problema, pois estou usando apenas o código C++ 17 padrão e a API Godot C++ disponível. Se você tiver algum problema ao criar no Windows, informe o problema e teremos prazer em trabalhar para resolvê-lo.

Então, antes de tudo, você precisa ter o Godot construído com sucesso em seu sistema, o que está além do escopo deste simples tutorial.

Agora, supondo que você possa git clone do GitHub, basta clonar o LuaScript na pasta 'modules' do código-fonte do Godot e então construir o Godot novamente adicionando à linha de comando as seguintes opções

module_luascript_enabled=sim

Se tudo tiver corrido bem, você terá um Godot rodando com suporte Lua!

Continue acompanhando o desenvolvimento enquanto estou adicionando mais recursos de forma lenta, mas constante.

Divirta-se!

Problemas e suporte

Tem um bug? Crie um problema aqui no GitHub!

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

Versionamento

Para transparência e insights sobre nosso ciclo de lançamento, os lançamentos são numerados com o formato de controle de versão semântico: <major>.<minor>.<patch> e construídos com as seguintes diretrizes:

• Quebrar a compatibilidade com versões anteriores prejudica o principal
• Novas adições sem quebrar a compatibilidade com versões anteriores superam o menor
• Correções de bugs e alterações diversas prejudicam o patch

Colaboradores

• Paulo Perbone (@perbone)

Licença

Copyright 2017-2024 Paulo Perbone

Licenciado sob a Licença Apache, Versão 2.0 (a "Licença"); você não pode usar este arquivo exceto em conformidade com a Licença. Você pode obter uma cópia da Licença em

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

A menos que exigido pela lei aplicável ou acordado por escrito, o software distribuído sob a Licença é distribuído "COMO ESTÁ", SEM GARANTIAS OU CONDIÇÕES DE QUALQUER TIPO, expressas ou implícitas. Consulte a Licença para o idioma específico que rege as permissões e limitações sob a Licença