gmserverplugin

This is a utility library for making Server Plugins that access the Lua state in Garry's Mod.

Currently, accessing the Lua state from a server plugin before it has been created yet requires hooking various internal functions to "steal" the Lua state pointer once it's been initialized. The problem with this is that if two server plugins do this, they'll end up changing the assembly of the function and the signature to find that function will no longer work.

There's a simple solution, but we can safely assume that the request will never be fulfilled. If it is, this repo will be archived for obvious reasons.

In the mean time, I have created this statically linked hacklioteque that will handle all the bullshit for you. You can use this library in any language you want, as long as it supports FFI with C.

Important Notes

1. This library is NOT thread-safe. Do not call any of these functions outside of the main thread.
2. Be careful with managing your state between map changes. You should test this thoroughly. Callbacks will still fire between map changes. You cannot unregister callbacks.

Signatures

If the signatures in this library are outdated, please let me know or submit a PR - the signatures can be found here.

Usage

If you're not using Rust, you can download a precompiled static library from the releases page.

Events

There are three events you can hook into.

Rust

Cargo.toml

[lib]
crate-type = ["cdylib"]

[dependencies]
gmserverplugin = "*"
# OR
gmod = { version = "*", features = ["server-plugin"] } # The gmod crate will re-export gmserverplugin for you with the `server-plugin` feature. https://github.com/WilliamVenner/gmod-rs

lib.rs

extern "C" fn newstate(lua_state: *mut std::ffi::c_void, iluainterface: *mut std::ffi::c_void) {
    println!("newstate");
}

extern "C" fn before_init(lua_state: *mut std::ffi::c_void, iluainterface: *mut std::ffi::c_void) {
    println!("before_init");
}

extern "C" fn after_init(lua_state: *mut std::ffi::c_void, iluainterface: *mut std::ffi::c_void) {
    println!("after_init");
}

#[no_mangle]
unsafe extern "C" fn CreateInterface() -> *mut std::ffi::c_void {
    gmserverplugin::init(); // This will hook the relevant functions, if not already

    gmserverplugin::newstate(newstate); // Register a callback that will be called when the `newstate` event fires.
    gmserverplugin::before_init(before_init); // Register a callback that will be called when the `before_init` event fires.
    gmserverplugin::after_init(after_init); // Register a callback that will be called when the `after_init` event fires.

    // create an IServerPluginCallbacks instance and return a pointer to it
    // you'll probably want to use cxx for this!
}

C++

extern "C" {
    extern "C" typedef void (*Callback)(void* lua_State, void* ILuaInterface);

    void init();
    void newstate(Callback);
    void after_init(Callback);
    void before_init(Callback);
}