3 releases (breaking)

0.3.0 Jan 18, 2020
0.2.0 Jan 11, 2020
0.1.0 Jan 6, 2020

#532 in #procedural

30 downloads per month
Used in sm-ext

GPL-3.0-or-later

36KB
696 lines

SourceMod + Rust

FFI wrappers and helpers for writing SourceMod extensions in Rust.

Safety

This crate makes heavy use of unsafe for interoperability with SourceMod but aims to expose safe interfaces with no unsound behaviour. However it may be possible to violate some of Rust's safety constraints (particularly aliasing guarantees) using APIs exposed by SourceMod. The aim of this project is to make it easier to write stable SourceMod extensions than when using C++, not to be 100% safe Rust.

Building

  • Documentation

    cargo +nightly doc --no-deps
    
  • Windows Debug Build

    RUSTFLAGS="-C target-feature=+crt-static" cargo build --all --all-targets --target=i686-pc-windows-msvc
    
  • Windows Release Build

    RUSTFLAGS="-C target-feature=+crt-static -C codegen-units=1" cargo build --all --all-targets --target=i686-pc-windows-msvc --release
    
  • Linux Debug Build

    cargo build --all --all-targets --target=i686-unknown-linux-gnu
    
  • Linux Release Build

    cargo build --all --all-targets --target=i686-unknown-linux-gnu --release
    

You'll probably want to wrap something around the cargo build to rename the output binary to match SourceMod's convention, and on Linux you'll want to strip release binaries before distribution with strip --strip-debug.

Dependencies

~1.5MB
~33K SLoC