rglua

Crates.iorglua
lib.rsrglua
version3.0.0-beta2
sourcesrc
created_at2021-11-26 06:23:13.729812
updated_at2022-04-01 00:05:27.117889
descriptionToolkit for garrysmod development with the source sdk and luajit api
homepage
repositoryhttps://github.com/Vurv78/rglua
max_upload_size
id487927
size122,519
Vurv (Vurv78)

documentation

README

🌑 rglua cratesio Build Status License github/Vurv78

This is a crate that allows interop with the (g)luajit c api as well as the source sdk through libloading and vtable bindings. You can then use these for binary modules or manually injected code, like with Autorun-rs

More information on binary modules can be found on the garrysmod wiki: Creating Binary Modules and examples can be found here.

Usage

If you are targeting 32 bit make sure to install the toolchain and build to it:

rustup target add i686-pc-windows-msvc
cargo build --target=i686-pc-windows-msvc

Comparison

There are actually a decent amount of libraries out there for gmod development. Here's a comparison and why you could use this one.

Library rglua rust-glua-sys gmod-rs gmrs
Full Lua C Api Bindings ✔️
On Crates.io ✔️ ✔️
Proc Macros ✔️ ✔️ ✔️
Interfacing w/ Source SDK ✔️
Returning Result<> from functions ✔️ ✔️
Can be used on stable ✔️ ✔️ ✔️
Real world examples ✔️ 〰️ ✔️
Linux / OSX Support ✔️ ✔️ ✔️
Github Stars 😢 👍 👑 🤷‍♂️

You can help with that last one 😉

Acknowledgements

garrysmod_common

This is heavily based off of garrysmod_common, in how we export the lua_shared functions and trying to replicate everything from the Lua C Api.

Commit count: 86

cargo fmt