gmserverplugin

这是一个实用库，用于制作访问 Garry's Mod 中的 Lua 状态的服务器插件。

目前，在服务器插件创建之前从其中访问 Lua 状态需要挂钩各种内部函数以“窃取”Lua 状态指针，一旦初始化完成。问题是如果两个服务器插件都这样做，它们最终会改变函数的汇编和签名，找到该函数的签名将不再有效。

有一个简单的解决方案，但我们可以安全地假设这个请求永远不会得到满足。如果它实现了，这个仓库将出于明显的原因被存档。

与此同时，我创建了这个静态链接的 hacklioteque，它会为你处理所有的烂摊子。只要你使用的语言支持与 C 的 FFI，你就可以使用这个库。

重要提示

1. 此库不是线程安全的。不要在主线程之外调用这些函数。
2. 小心处理地图更改之间的状态。你应该彻底测试这一点。回调仍然会在地图更改之间触发。您无法注销回调。

签名

如果此库中的签名已过时，请通知我或提交 PR - 签名可以在这里找到。

使用方法

如果您不使用 Rust，您可以从发布页面下载预编译的静态库。

事件

您可以挂钩到三个事件。

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);
}