Learn MOONSCRIPT with Real Code Examples
Updated Nov 21, 2025
Installation Setup
Install Lua runtime (5.1+ recommended)
Install MoonScript via LuaRocks (`luarocks install moonscript`)
Verify installation with `moonc --version`
Use MoonScript compiler (`moonc`) to compile .moon files to Lua
Optional IDE plugins for syntax highlighting
Environment Setup
Install Lua runtime
Install MoonScript via LuaRocks
Set PATH for `moonc` CLI
Optional IDE/editor MoonScript plugin
Test compilation and execution
Config Files
moonc.lua configuration
.moon files as source
Compiled Lua output in build/
Project-specific Lua modules
Documentation and notes
Cli Commands
moonc file.moon - compile to Lua
moonc --watch src/ - auto-compile changes
lua file.lua - run compiled Lua
luarocks install moonscript - install MoonScript
moonc --version - check compiler version
Internationalization
UTF-8 support
Works with global Lua modules
Compatible with multi-language strings
No locale restrictions
Community examples worldwide
Accessibility
Cross-platform via Lua runtime
Open-source and MIT licensed
Lightweight compiler
Readable syntax for beginners
Works in text editors and IDEs
Ui Styling
Terminal output via `print`
Text-based logging
Integration with game engine rendering
No native GUI in MoonScript
Visual output handled by Lua host
State Management
Tables for mutable state
Class instances for object state
Local and global variables
Function closures
Interop with Lua state when needed
Data Management
Table creation and manipulation
List and table comprehensions
Class properties and methods
Interfacing with Lua modules
Serialization via Lua tables