Crate bevy_mod_indigauge 

Indigauge Game SDK (Bevy)

The Indigauge Game SDK is a lightweight Rust library for sending structured analytics and player feedback from your Bevy games to the Indigauge API.

It’s designed to be easy to integrate and is powerful enough for production use in indie games.

---

Features

• Bevy 0.17 compatible — easy drop-in plugin
• Lightweight event macros: ig_info!, ig_warn!, ig_error!, …
• Built-in Feedback UI panel for in-game bug reports & suggestions
• Works on both native and WASM builds*
• Tracing support — log events to the Indigauge API through tracing

[!WARNING] On wasm builds, the panic handler is disabled. No crash reports will be sent as events to the Indigauge API.

---

Installation

[dependencies]
bevy = "0.17"
bevy-mod-indigauge = { version = "0.5" }

Feedback backend features

• feedback (default): feedback panel rendered with Bevy UI + picking
• feedback_egui (optional): render feedback panel with bevy_egui

# Keep default Bevy UI panel (no extra feature needed)
bevy-mod-indigauge = { version = "0.5" }

# Enable optional bevy_egui feedback panel backend (native only)
bevy-mod-indigauge = { version = "0.5", features = ["feedback_egui"] }

Examples

• minimal - An example showing start session, sending info events and triggering feedback form.
• breakout – An example showing a more realistic setup with a real game and game states.
• feedback_egui - A focused example showing the bevy_egui feedback panel triggers and props.

Running Examples

cargo run --release --example minimal

cargo run --release --example breakout

# Or with tracing feature:
cargo run --release --example breakout --features tracing

# Run the bevy_egui feedback demo (optional feature)
cargo run --release --example feedback_egui --features feedback_egui

Quick Start

• Setup game project Indigauge
• Create a public key for the game.
• Add the plugin to your game.

use std::time::Duration;
use bevy::{prelude::*, time::common_conditions::on_timer};
use bevy_mod_indigauge::prelude::*;

fn main() {
  App::new()
    .add_plugins(DefaultPlugins)
    .add_plugins(
      IndigaugePlugin::<EmptySessionMeta>::new(
        "YOUR_PUBLIC_KEY",
        "My game name",
        env!("CARGO_PKG_VERSION")
      )
      // Optional: Set mode (Defaults to live). Dev mode is useful for testing and debugging and does not send events to the server.
      .mode(IndigaugeMode::Dev)
      // Optional: Set preferred log-level (Defaults to Info)
      .log_level(IndigaugeLogLevel::Info)
    )
    .add_systems(Startup, setup)
    .add_systems(Update, (trigger_feedback_with_question, track_counter.run_if(on_timer(Duration::from_secs(2)))))
    .run();
}

fn setup(mut commands: Commands) {
  commands.spawn((Camera2d, IsDefaultUiCamera));
  commands.trigger(StartSessionEvent::new());
}

fn trigger_feedback_with_question(
  mut commands: Commands,
  keys: Res<ButtonInput<KeyCode>>,
) {
  if keys.just_pressed(KeyCode::KeyF) {
    // This is how you manually trigger the feedback panel
    commands.insert_resource(
      FeedbackPanelProps::with_question("What did you think about level 3?", FeedbackCategory::Gameplay),
    );
  }
}

fn track_counter(mut counter: Local<u32>) {
  *counter += 1;
  ig_info!("counter.increase", { "value": *counter });
}

Sending events

Send structured events with macros. The events will only be sent if a session was successfully started.

ig_info!("player.jump", { "height": 2.4 });
ig_error!("physics.failed", { "component": "rigid_body" });

Tracing support

Send events to the Indigauge API through tracing. This is useful for debugging and monitoring your game.

Enable the tracing feature

[dependencies]
bevy = { version = "0.17", features = ["bevy_mod_indigauge"] }
bevy-mod-indigauge = { version = "0.5", features = ["tracing"] }

use std::time::Duration;
use bevy::{log::{LogPlugin, BoxedLayer}, prelude::*, time::common_conditions::on_timer};
use bevy_mod_indigauge::{prelude::*, tracing::{IndigaugeLayer, default_bevy_indigauge_layer}};

/// Default tracing layer, will send all events to the Indigauge API.
pub fn default_indigauge_layer(_app: &mut App) -> Option<BoxedLayer> {
  Some(Box::new(default_bevy_indigauge_layer()))
}

/// Custom tracing layer, will only send events that has an event_type, is either info, warn, or 
/// error and is not from the bevy_mod_othercrate module to the Indigauge API.
pub fn custom_indigauge_layer(_app: &mut App) -> Option<BoxedLayer> {
  Some(Box::new(
    default_bevy_indigauge_layer()
      .with_event_type_required(true) 
      .with_filters(vec!["bevy_mod_othercrate"])
      .with_levels(vec![
        IndigaugeLogLevel::Info,
        IndigaugeLogLevel::Warn,
        IndigaugeLogLevel::Error,
      ]),
  ))
}

fn main() {
  App::new()
    .add_plugins(DefaultPlugins.set(LogPlugin {custom_layer: custom_indigauge_layer, ..default()}))
    .add_plugins(IndigaugePlugin::<EmptySessionMeta>::new("YOUR_PUBLIC_KEY", "My game name", env!("CARGO_PKG_VERSION")))
    .add_systems(Startup, setup)
    .add_systems(Update, (track_counter.run_if(on_timer(Duration::from_secs(2)))))
    .run();
}

fn setup(mut commands: Commands) {
  commands.spawn((Camera2d, IsDefaultUiCamera));
  commands.trigger(StartSessionEvent::new());
}

fn track_counter(mut counter: Local<u32>) {
  *counter += 1;
  info!(ig = "counter.increase", value = *counter);
}

Bevy Compatibility

bevy	bevy-mod-indigauge
0.17	0.5
0.16	0.4
0.15	0.1, 0.2, 0.3

Modules

plugin

prelude

tracing