steamworks

This crate provides Rust bindings to the Steamworks SDK.

Fork notes

This project is forked from Noxime/steamworks-rs. Unlike the upstream version used as the fork base, which links the Steam API DLL, SO, or dylib directly, this fork loads the library dynamically with libloading. This allows applications to check whether the Steam API library is available before initializing Steamworks.

Usage

Add the following to your Cargo.toml:

[dependencies]
steamworks = "0.13.0"

Crate	SDK	MSRV
git	1.64	1.80.0
0.13.0	1.64	1.80.0
0.12.0	1.62	1.80.0
0.11.0	1.58a	1.71.1
0.10.0	1.54	1.56.1
0.9.0	1.53a	1.56.1

Example

You can find more examples in examples.

use steamworks::{steam_api_exists, AppId, Client, FriendFlags, PersonaStateChange};

fn main() {
    if !steam_api_exists() {
        eprintln!("Failed to load the Steam API dynamic library.");
        return;
    }

    let client = Client::init().unwrap();

    let _cb = client.register_callback(|p: PersonaStateChange| {
        println!("Got callback: {:?}", p);
    });

    let utils = client.utils();
    println!("Utils:");
    println!("AppId: {:?}", utils.app_id());
    println!("UI Language: {}", utils.ui_language());

    let apps = client.apps();
    println!("Apps");
    println!("IsInstalled(480): {}", apps.is_app_installed(AppId(480)));
    println!("InstallDir(480): {}", apps.app_install_dir(AppId(480)));
    println!("BuildId: {}", apps.app_build_id());
    println!("AppOwner: {:?}", apps.app_owner());
    println!("Langs: {:?}", apps.available_game_languages());
    println!("Lang: {}", apps.current_game_language());
    println!("Beta: {:?}", apps.current_beta_name());

    let friends = client.friends();
    println!("Friends");
    let list = friends.get_friends(FriendFlags::IMMEDIATE);
    println!("{:?}", list);
    for f in &list {
        println!("Friend: {:?} - {}({:?})", f.id(), f.name(), f.state());
        friends.request_user_information(f.id(), true);
    }

    for _ in 0..50 {
        client.run_callbacks();
        ::std::thread::sleep(::std::time::Duration::from_millis(100));
    }
}

Features

serde: This feature enables serialization and deserialization of some types with serde. image: This feature allows accessing image data like icons with image crate.

License

This crate is dual-licensed under Apache and MIT, except for the files in [steamworks-sys/lib/steam/]