bevy-steamworks

This crate provides a Bevy plugin for integrating with the Steamworks SDK via the steamworks crate.

Installation

Add the following to your Cargo.toml:

[dependencies]
bevy-steamworks = "0.1.0"

Ensure that your computer has all the needed requirements to use bindgen.

Download and install the steamworks sdk and set the environment variable STEAM_SDK_LOCATION to point to it.

At runtime, a "steam_appid.txt" file with the registered Steam App ID of the game is required in the same directory as the executable.

Usage

To add the plugin to your game, simply add the SteamworksPlugin to your AppBuilder.

use bevy::prelude::*;
use bevy_steamworks::SteamworksPlugin;

fn main() {
  App::build()
      .add_plugins(DefaultPlugins)
      .add_plugin(SteamworksPlugin)
      .run()
}

The plugin adds steamworks::Client as a Bevy ECS resource, which can be accessed like any other resource in Bevy. The client implements Send and Sync and can be used to make requests via the SDK from any of Bevy's threads. However, any asynchronous callbacks from Steam will only run on the main thread.

The plugin will automatically call SingleClient::run_callbacks on the Bevy main thread every frame, so there is no need to run it manually.

NOTE: If the plugin fails to initialize (i.e. Client::init() fails and returns an error, an error wil lbe logged (via bevy_log), but it will not panic. In this case, it may be necessary to use Option<Res<Client>> instead.

use bevy_steamworks::{Client, FriendFlags};

fn steam_system(steam_client: Res<Client>) {
  for friend in client.friends().get_friends(FriendFlags::IMMEDIATE) {
    println!("Friend: {:?} - {}({:?})", friend.id(), friend.name(), friend.state());
  }
}

fn main() {
  App::build()
      .add_plugins(DefaultPlugins)
      .add_plugin(SteamworksPlugin)
      .add_startup_system(steam_system.system())
      .run()
}

Events/Callbacks

All of the callback based events sent by Steam's SDK will be forwarded to Bevy and can be read via a EventReader system param.

use bevy_steamworks::{Client, P2PSessionRequest};

fn handle_p2p_session_requests(
  steam_client: Res<Client>,
  requests: EventReader<P2PSessionRequest>
) {
  for request in requests.iter() {
    println!("P2P Session Request from: {:?}", request.remote);
    steam_client.networking().accept_p2p_session(request.remote);
  }
}

fn main() {
  App::build()
      .add_plugins(DefaultPlugins)
      .add_plugin(SteamworksPlugin)
      .add_system(handle_p2p_session_requests.system())
      .run()
}