luascript

LuaScript

Prise en charge du langage Lua 5.4 pour Godot Engine 4.x

WIP (fortement mis à jour afin que vous puissiez vous attendre à des changements constants - aucun engagement avec le gel des fonctionnalités pour le moment)

Progrès actuel :

• Le nouvel analyseur utilisant Antlr4 est opérationnel. Vient maintenant la construction de l’AST et de l’analyseur statique.

Avertissement!! Veuillez noter que la balise git 3.x n'existe que pour des raisons historiques et que, bien qu'elle soit compilée, elle est inachevée. Veuillez donc ne pas ouvrir de problèmes ni envoyer de relations publiques pour cette balise. Appréciez la compréhension.

Caractéristiques

• Implémentation complète de l'API de gameplay de Godot (fonctionnalité complète à égalité avec GDScript)
• Bac à sable API configurable
• Programmation orientée objet basée sur les tables et métatables de Lua
• Prise en charge de l'héritage de la classe de base et du fichier Lua
• Prise en charge de l'héritage de la classe de base et du fichier natifs
• Prise en charge des propriétés
  • Getters, setters et valeurs par défaut
  • Modification des valeurs des propriétés dans l'éditeur de propriétés
• Prise en charge des signaux
  • Signal connecter, émettre et recevoir du code
  • Connexion du signal depuis l'éditeur (actuellement pas bien supporté par Godot)
• Codage en langage Lua dans l'éditeur intégré de Godot
  • Linting de code source et analyse statique à la volée
  • Mise en évidence de la syntaxe du code source à la volée
  • Embellisseur de code source
    • Formater l'intégralité du fichier actif
    • Formater le texte sélectionné
    • Formater automatiquement lors de l'enregistrement
  • Refactorisation du code source (actuellement non pris en charge par Godot)
  • Thème de couleur de l'éditeur de code (Icemoon)
• Codage en langage Lua dans un éditeur externe (éventuellement avec les mêmes capacités que l'éditeur intégré)
• Prise en charge de plusieurs environnements d'exécution Lua (PUC Rio Lua 5.4 et LuaJIT)
• Outils de débogage (éventuellement avec toutes les capacités de débogage de Godot)
• Création d'outils pour étendre les fonctionnalités de l'éditeur intégré
• Prise en charge de l'assemblage avancé de packages
  • Élimination du code mort grâce au tremblement d'arbre
  • Code uglifier et minifier
  • Compilation en bytecode binaire
  • Compression ou cryptage
• Exporter pour toutes les plateformes prises en charge par Godot

Comment construire

Mon environnement de développement est basé principalement sur Linux et Mac donc je ne sais pas s'il fonctionnera sous Windows. Cela ne devrait pas être un problème car j'utilise uniquement le code C++17 standard et l'API Godot C++ disponible. Si vous rencontrez un problème lors de la construction sous Windows, veuillez signaler un problème et je serai heureux de travailler à sa résolution.

Donc, tout d’abord, vous devez avoir Godot intégré avec succès dans votre système, ce qui dépasse la portée de ce simple guide pratique.

Maintenant, en supposant que vous puissiez git clone depuis GitHub, clonez simplement LuaScript dans le dossier « modules » du code source de Godot, puis reconstruisez Godot en ajoutant à la ligne de commande les options suivantes

module_luascript_enabled=oui

Si tout s'est bien passé, vous aurez un Godot en marche avec le support de Lua !

Continuez à surveiller le développement car j'ajoute lentement mais régulièrement plus de fonctionnalités.

Amusez-vous!

Problèmes et assistance

Vous avez un bug ? Veuillez créer un problème ici sur GitHub !

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

Gestion des versions

Pour plus de transparence et de compréhension de notre cycle de publication, les versions sont numérotées selon le format de version sémantique : <major>.<minor>.<patch> et construites selon les directives suivantes :

• Briser la rétrocompatibilité annule le problème majeur
• De nouveaux ajouts sans rompre la compatibilité ascendante modifient le mineur
• Les corrections de bugs et les modifications diverses modifient le correctif

Contributeurs

• Paulo Perbone (@perbone)

Licence

Copyright 2017-2024 Paulo Perbone

Sous licence Apache, version 2.0 (la « Licence » ); vous ne pouvez pas utiliser ce fichier sauf en conformité avec la licence. Vous pouvez obtenir une copie de la licence à

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

Sauf disposition contraire de la loi applicable ou accord écrit, le logiciel distribué sous la licence est distribué « TEL QUEL », SANS GARANTIE OU CONDITION D'AUCUNE SORTE, expresse ou implicite. Consultez la licence pour connaître la langue spécifique régissant les autorisations et les limitations en vertu de la licence.