CLICommands

matchmaking

snug matchmaking <COMMAND>

Matchmaking service operations.

Subcommands

CommandWhat it does
poolPool management
ticketTicket management
rulesetRuleset management
proposalProposal operations
matchMatch operations

Run snug matchmaking <command> --help for that command's own options. The global options apply everywhere.

Examples

# Create a streaming pool with capacity 100
snug matchmaking pool create -p ranked-1v1 -n 'Ranked 1v1' -m streaming -c 100

# Create a batching pool bound to a ruleset
snug matchmaking pool create -p mixer -n 'Mixer' -m batching -r skill-based

# Inspect a pool
snug matchmaking pool get -p ranked-1v1

# Update a pool's capacity
snug matchmaking pool update -p ranked-1v1 -c 500

# List pools (paginated)
snug matchmaking pool list --limit 20 --offset 0

# Delete a pool (blocked while tickets are waiting)
snug matchmaking pool delete -p ranked-1v1
# Submit a ticket with attributes and priority
snug matchmaking ticket submit -p ranked-1v1 -a '{"skill": 1500, "region": "us-west"}' --priority 100

# Submit a party ticket (grouped) with a 5-minute TTL
snug matchmaking ticket submit -p ranked-1v1 -a '{"skill": 1500}' --group-id squad-7 --ttl-seconds 300

# Poll ticket status
snug matchmaking ticket get -t <ticket-id>

# Cancel a ticket (owner only)
snug matchmaking ticket cancel -t <ticket-id>
# Create a named ruleset
snug matchmaking ruleset create -r skill-based -n 'Skill-Based Matching'

# Create a ruleset with hard constraints and soft preferences
snug matchmaking ruleset create -r balanced -n 'Balanced' --hard-constraints '[]' --soft-preferences '[]'

# Get a ruleset
snug matchmaking ruleset get -r skill-based

# Delete a ruleset
snug matchmaking ruleset delete -r skill-based
# Inspect a proposal
snug matchmaking proposal get -p <proposal-id>

# Accept a proposal
snug matchmaking proposal respond -p <proposal-id> -r accepted

# Reject a proposal
snug matchmaking proposal respond -p <proposal-id> -r rejected

# Get a confirmed match roster
snug matchmaking match get -m <match-id>

Next

On this page