{"id":14961474,"url":"https://github.com/perbone/luascript","last_synced_at":"2025-05-15T09:04:25.131Z","repository":{"id":44632971,"uuid":"101610955","full_name":"perbone/luascript","owner":"perbone","description":"Lua language support for Godot Engine","archived":false,"fork":false,"pushed_at":"2024-11-01T00:48:18.000Z","size":1718,"stargazers_count":687,"open_issues_count":10,"forks_count":49,"subscribers_count":32,"default_branch":"master","last_synced_at":"2025-04-07T04:07:00.189Z","etag":null,"topics":["apache2","cpp","game-development","game-engine","gamedev","godot","godot-engine","godotengine","lua","lua-script","lua-support","luascript","open-source"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/perbone.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"patreon":"perbone"}},"created_at":"2017-08-28T06:27:19.000Z","updated_at":"2025-04-06T02:20:54.000Z","dependencies_parsed_at":"2024-01-08T08:28:59.914Z","dependency_job_id":"62421aac-6b88-4ebd-a5cf-defd80b37df4","html_url":"https://github.com/perbone/luascript","commit_stats":{"total_commits":348,"total_committers":10,"mean_commits":34.8,"dds":0.5,"last_synced_commit":"13aa1271bef6b5025f461fb4a5cc38f32b3d4c04"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perbone%2Fluascript","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perbone%2Fluascript/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perbone%2Fluascript/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perbone%2Fluascript/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/perbone","download_url":"https://codeload.github.com/perbone/luascript/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248890828,"owners_count":21178513,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apache2","cpp","game-development","game-engine","gamedev","godot","godot-engine","godotengine","lua","lua-script","lua-support","luascript","open-source"],"created_at":"2024-09-24T13:25:18.777Z","updated_at":"2025-04-14T13:48:22.775Z","avatar_url":"https://github.com/perbone.png","language":"C++","readme":"# LuaScript [![License](https://img.shields.io/:license-apache-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\n## Lua 5.4 language support for Godot Engine 4.x\n\n\u003e #### WIP (heavily updated so you can expect constants changes - no commitment with feature freezing at this moment)\n\u003e\n\u003e Current progress:\n\u003e\n\u003e - The new parser using Antlr4 is up and running. Now comes the construction of the AST and the static analyzer.\n\u003e\n\u003e #### Warning!! Kindly note that the git tag 3.x exists only for historical reasons, and although it compiles it is unfinished. So please do not open issues nor send PR for this tag. Appreciate the understanding.\n\n## Features\n\n- Full Godot's gameplay API implementation (feature complete on par with GDScript)\n- Configurable API sandbox\n- Object Oriented Programming based on Lua's tables and metatables\n- Support for inheritance from Lua base class and file\n- Support for inheritance from native base class and file\n- Support for properties\n  - Getters, setters and default values\n  - Editing properties values in the property editor\n- Support for signals\n  - Signal connect, emit and receive from code\n  - Signal connect from the editor (currently not well supported by Godot)\n- Lua language coding in Godot's built in editor\n  - On the fly source code linting and static analysis\n  - On the fly source code syntax highlighting\n  - Source code beautifier\n    - Format the entire active file\n    - Format the selected text\n    - Format automatically when saving\n  - Source code refactoring (currently not supported by Godot)\n  - Code editor color theme (Icemoon)\n- Lua language coding in external editor (possibly with the same capabilities as the built in editor)\n- Support for multiple Lua runtimes (PUC Rio Lua 5.4 and LuaJIT)\n- Debugging tools (possibly with all Godot's debugging capabilities)\n- Tool creation to extend the built in editor functionalities\n- Support for advanced package assembling\n  - Dead code elimination throught tree-shaking\n  - Code uglifier and minifier\n  - Compilation into binary bytecode\n  - Compression or encryption\n- Export for all Godot's supported platforms\n\n## How to Build\n\nMy development environment is based primarily on Linux and Mac so I don't know if it will work on Windows. Shouldn't be a problem though as I'm only making use of standard C++17 code and the available Godot C++ API. If you experience any problem when building on Windows please report an issue and I'll be glad to work on solving it.\n\nSo first of all you have to have Godot successfully built in your system, which is beyond the scope of this simple how to.\n\nNow, assuming you can git clone from GitHub, just clone LuaScript into Godot's source code 'modules' folder and then, build Godot again adding to the command line the following options\n\nmodule_luascript_enabled=yes\n\nIf everything has gone well, you'll have a running Godot with Lua support!\n\nKeep watching the development as I'm slowly but steadly adding more features.\n\nHave fun!\n\n## Issues and Support\n\nHave a bug? Please create an issue here on GitHub!\n\nhttps://github.com/perbone/luascript/issues\n\n## Versioning\n\nFor transparency and insight into our release cycle, releases are be numbered with the [semantic versioning](http://semver.org/) format: `\u003cmajor\u003e.\u003cminor\u003e.\u003cpatch\u003e` and constructed with the following guidelines:\n\n- Breaking backwards compatibility bumps the major\n- New additions without breaking backwards compatibility bumps the minor\n- Bug fixes and misc changes bump the patch\n\n## Contributors\n\n- Paulo Perbone ([@perbone](https://twitter.com/perbone))\n\n## License\n\nCopyright 2017-2024 Paulo Perbone\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License\n","funding_links":["https://patreon.com/perbone"],"categories":["C++"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperbone%2Fluascript","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fperbone%2Fluascript","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperbone%2Fluascript/lists"}