This crate is not official, it is not supported by the Discord Game SDK Developers.

This crate provides Rust support to the following Discord features:

Activities (Rich Presence)
Users, Avatars and Relationships
Lobbies, Matchmaking and Voice communication
Faux-P2P Networking
Cloud Synchronized (or not) Storage
Store transactions
Achievements
...

https://crates.io/crates/discord_game_sdk

Requirements

Usage

Add this to your Cargo.toml:

[dependencies]
discord_game_sdk = "0.5.0-alpha.1"

Set the following environment variable:

export DISCORD_GAME_SDK_PATH=/path/to/discord_game_sdk

Ensure that appropriately named dynamic libraries are available when launching the program:

On Linux and OS X, the dynamic library must be renamed to libdiscord_game_sdk.so or libdiscord_game_sdk.dylib.

(TODO: ^ might be unnecessary, how to set the rpath in the output binary)

Status

This library is currently in early stages but is stabilizing. It is usable. I'm not aware of any good ways to test this crate, there are currently no tests.

Features:

link: (enabled by default, delegates to discord_game_sdk_sys/link) Provides the linker with an appropriately named dynamic library. This allows for cargo run to run flawlessly on Linux.

Safety

This crate relies on the SDK to provide correct data and behavior:

Non-null pointers to valid memory
UTF-8, NUL-terminated strings
No mutation of memory it should have no ownership of
No use of pointers after destroy is called

Legal

You MUST acquaint yourself with and agree to the official terms of the Discord Game SDK.

The code of the Rust crates discord_game_sdk and discord_game_sdk_sys are licensed under either of:

at your option.

Communication and Support

I can be reached via Discord twiikuu#0047, on the Official Game SDK Server (nicked as ldesgoui (rust wrapper)), as well as twitter and email. I reserve myself no obligation to support you, although I'm generally nice.