steamid-rs

A Rust library for parsing, validating, and converting Steam IDs between different formats.

Features

• Parse Steam IDs from multiple formats:
  • Steam2: STEAM_0:0:23071901
  • Steam3: [U:1:46143802]
  • SteamID64: 76561198006409530
• Convert between all formats seamlessly
• Validate Steam IDs
• Zero-copy parsing with comprehensive error handling
• No runtime dependencies (only regex and thiserror)

Installation

Add this to your Cargo.toml:

[dependencies]

steamid-rs = "2.1"

The library is imported as steamid in your code (the package name is steamid-rs because steamid was already taken on crates.io).

Usage

Parsing Steam IDs

use steamid::SteamID;

// Parse from any format using .parse()
let sid: SteamID = "STEAM_0:0:23071901".parse().unwrap();
let sid: SteamID = "[U:1:46143802]".parse().unwrap();
let sid: SteamID = "76561198006409530".parse().unwrap();

// Or use TryFrom
let sid = SteamID::try_from("[U:1:46143802]").unwrap();

// From a 64-bit integer
let sid = SteamID::from(76561198006409530u64);

Creating from Account ID

use steamid::SteamID;

// Create a SteamID from an individual account ID
let sid = SteamID::from_individual_account_id(46143802);
assert!(sid.is_valid());

Converting Between Formats

use steamid::SteamID;

let sid: SteamID = "76561198006409530".parse().unwrap();

// Convert to Steam2 format
println!("{}", sid.steam2(false).unwrap()); // "STEAM_0:0:23071901"
println!("{}", sid.steam2(true).unwrap());  // "STEAM_1:0:23071901"

// Convert to Steam3 format
println!("{}", sid.steam3()); // "[U:1:46143802]"

// Get the 64-bit representation
println!("{}", sid.steam_id64()); // 76561198006409530

// Display trait uses Steam3 format
println!("{}", sid); // "[U:1:46143802]"

Validation

use steamid::SteamID;

let sid: SteamID = "[U:1:46143802]".parse().unwrap();

// Check if valid according to Steam
assert!(sid.is_valid());

// Check if it's a valid individual user account
assert!(sid.is_valid_individual());

// Check for special account types
assert!(!sid.is_group_chat());
assert!(!sid.is_lobby());

Accessing Components

use steamid::{SteamID, Universe, AccountType, Instance};

let sid: SteamID = "[U:1:46143802]".parse().unwrap();

assert_eq!(sid.universe, Universe::Public);
assert_eq!(sid.account_type, AccountType::Individual);
assert_eq!(sid.instance, Instance::Desktop);
assert_eq!(sid.account_id, 46143802);

Error Handling

use steamid::{SteamID, SteamIdError};

let result: Result<SteamID, SteamIdError> = "invalid".parse();
assert!(result.is_err());

match result {
    Ok(sid) => println!("Parsed: {}", sid),
    Err(e) => println!("Error: {}", e),
}

API Reference

SteamID Struct

Enums

• Universe - Invalid, Public, Beta, Internal, Dev
• AccountType - Invalid, Individual, Multiseat, GameServer, AnonGameServer, Pending, ContentServer, Clan, Chat, AnonUser
• Instance - All, Desktop, Console, Web

Constants

• chat_instance_flags::CLAN - Flag for clan chat instances
• chat_instance_flags::LOBBY - Flag for lobby chat instances

License

MIT

Credits

This is a Rust port of node-steamid by DoctorMcKay.