Pika-Software / gm_moonloader

Integrate moonscript into your Garry's Mod!

gm_moonloader

Integrate moonscript into your Garry's Mod!

This binary module seamlessly integrates moonscript into Garry's Mod, by adding include of plain .moon files and support for auto-reload.

Just add require "moonloader" line into your autorun!

How to install

1. Go to latest release
2. Download binary for your OS and Garry's Mod branch. For example gmsv_moonloader_linux32.dll
3. Put downloaded binary into <Your Garry's Mod Folder>/garrysmod/lua/bin/ (if it doesn't exists then create folder)
4. Enjoy! 🎉

How to use

1. Add require before any AddCSLuaFile or include

require "moonloader"

2. Include your .moon file with include

-- you can use example/init.moon, but for the sake of compability
-- I suggest to use .lua instead of .moon
include "example/init.lua" -- Will automatically generate .lua from .moon in garrysmod/cache/moonloader/lua

3. (optional) before using finding lua files with file.Find or reading them I suggest to use moonloader.PreCacheDir("yourdirectory") to compile .lua files from all .moon files

Notes

• Compiled .moon files are stored in garrysmod/cache/moonloader/lua folder. This folder is cleaned up after each startup.

Example

-- autorun/example_autorun.lua
if SERVER then
    require "moonloader"
end

AddCSLuaFile "example/init.lua"
include "example/init.lua"

-- example/init.moon
print "Hello from Moonscript! ##{i}" for i = 1, 5 

API

---- Functions ----
-- Compiles given moonscript code into lua code
-- and returns lua_code with compiled line and char offset from moonCode
-- If fails, returns nil and error reason
-- Same as moonscript.to_lua (https://moonscript.org/reference/api.html)
lua_code: string/nil, line_tabel: table/string
= moonloader.ToLua(moonCode: string)

-- Recursively compiles and caches all .moon files in given lua directory
-- Use this to add compiled .lua files into Source filesystem
-- Returns nothing
moonloader.PreCacheDir(path: string)

-- Tries to compile given file in lua directory
-- and return true if successful, otherwise false
success: bool = moonloader.PreCacheFile(path: string)

---- Hooks ----
-- Executes when .moon file was compiled
-- Path is relative to lua directory
GM:MoonFileCompiled(path: string)

Compilation

1. Clone this repo with submodules

$ git clone https://github.com/Pika-Software/gm_moonloader --recursive

2. Clone my garrysmod_common repo with branch master-cmake or x86-64-cmake

$ git clone https://github.com/dankmolot/garrysmod_common --branch=master-cmake --recursive

3. Configure cmake project

$ cd gm_moonloader
$ mkdir -p build && cd build
$ cmake .. -DGARRYSMOD_COMMON_PATH="../../garrysmod_common" -DBUILD_SHARED_LIBS=OFF
# Optionally also use -DAUTOINSTALL=<path to garrysmod/lua/bin>

4. Build it!

$ cmake --build . -j -t gm_moonloader --config Release

5. (Optional) Configure project to build 32bit library

# On Windows
$ cmake -A Win32 .. # and other options...
# On Linux
$ cmake .. -DCMAKE_C_FLAGS="-m32" -DCMAKE_CXX_FLAGS="-m32" # and other options...

6. (Optional) Configure client-side library

$ cmake .. -DCLIENT_DLL=ON

Contributing

Feel free to create issues or pull requests! ❤️

Licenese

MIT License