scripthookv-rs

Scripthookv-rs为ScriptHookV和GTA 5本地提供了Rust绑定。

免责声明：此包仍在早期开发阶段，API可能会更改。

包

libscripthookv-sys

此包包含ScriptHookV的原始绑定，没有任何包装。

安装

将以下内容添加到您的cargo.toml依赖项中

libscripthookv-sys = "0.1.0"

scripthookv-rs

此包包含ScriptHookV的包装API

安装

将以下内容添加到您的cargo.toml依赖项中

scripthookv-rs = "0.3.0"
once_cell = "1.9.0"
winapi = { version = "0.3.9", features = [ "consoleapi", "winuser", "wincon" ] }
async-trait = "0.1.52"

scripthookv-rs-gta

此包包含GTA 5本地的包装API。应与scripthookv-rs包一起安装。

安装

此包尚未发布。

使用

入口点

对于您的入口点，您可以使用shv_entrypoint宏。此宏为您生成DllMain。

extern "C" fn script_main() {
  loop {
    // On tick logic

    script_yield();
  }
}

#[shv_entrypoint]
fn entrypoint(module: ModuleHandle) -> ScriptHookV {
  ScriptHookVBuilder::new(module)
    .script(script_main)
    .build()
}

本地

可以使用native_call宏直接调用本地，如下所示

call_native!(Vehicle, 0xAF35D0D2583051B0, adder_hash, coords, heading, false, false, false);
//           ^^^^^^^  ^^^^^^^^^^^^^^^^^^  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
//       Return type         Native hash                                        Parameters

或者，您可以使用我的nativedb生成类似于natives.h文件的包装。

路线图

• 包装所有ScriptHookV函数*。
• 为所有包提供专门的README。
• 为ScriptHookV提供更优雅的包装。
• 为大多数本地提供优雅的API。
• 提供一个类似于LemonUI的UI包。
• 自动化测试。

* 排除已弃用函数。

贡献

欢迎提交拉取请求。对于重大更改，请首先打开一个问题以讨论您想要更改的内容。

致谢

• ScriptHookVDotNet，为包装本地API提供了很大启发。
• Salted，Daniel 和 ikt 提供了一般帮助。

许可证

MIT