rust-samp 3.3.0

Write SA-MP and open.mp plugins in safe Rust instead of C++. A single binary runs natively on both servers, with proc macros (`#[native]`, `initialize_plugin!`) that hide the FFI boilerplate and ABI-correct marshalling for Linux (Itanium) and Windows (MSVC).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

# rust-samp

Write SA-MP and open.mp plugins in safe Rust instead of C++. The same source
compiles to a single binary that runs natively on both servers; the macros
hide the FFI boilerplate and ABI-correct marshalling for Linux (Itanium) and
Windows (MSVC).

This is the main crate — depend on it from your plugin's `Cargo.toml`.

> **Not affiliated.** Independent community fork of
> [samp-rs](https://github.com/Pycckue-Bnepeg/samp-rs). Not affiliated with,
> endorsed by, or connected to SA-MP, the open.mp (Open Multiplayer) project,
> or the upstream `samp-rs` repository. "SA-MP" and "open.mp" belong to their
> respective owners and are named only to describe compatibility.

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

[dependencies]
# Published as `rust-samp` to avoid name collision; aliased to `samp` so
# the import is short.
samp = { package = "rust-samp", version = "3" }
```

Minimal plugin:

```rust
use samp::prelude::*;
use samp::{SampPlugin, initialize_plugin, native};

#[derive(SampPlugin, Default)]
struct Hello;

impl Hello {
    #[native(name = "Hello_Echo")]
    fn echo(_amx: &Amx, text: &AmxString) -> bool {
        println!("{}", &**text);
        true
    }
}

initialize_plugin!(type: Hello, natives: [Hello::echo]);
```

Build for 32-bit (both servers are 32-bit):

```sh
cargo build --target i686-unknown-linux-gnu --release
cargo xwin build --xwin-arch x86 --target i686-pc-windows-msvc --release
```

## Related crates in this workspace

- [`rust-samp-sdk`](https://crates.io/crates/rust-samp-sdk) — low-level FFI
  bindings (AMX VM, open.mp component ABI). Depend on it directly only if
  you want raw access without the macros.
- [`rust-samp-codegen`](https://crates.io/crates/rust-samp-codegen) — the
  proc macros (`#[native]`, `initialize_plugin!`, `#[derive(SampPlugin)]`).
  Re-exported by `rust-samp`; no need to depend on it directly.

## Repository and full documentation

Source, examples and the long-form guide live at
<https://github.com/NullSablex/rust-samp>.