CLICommands
matchmaking
snug matchmaking <COMMAND>Matchmaking service operations.
Subcommands
| Command | What it does |
|---|---|
pool | Pool management |
ticket | Ticket management |
ruleset | Ruleset management |
proposal | Proposal operations |
match | Match 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
- matchmaking guide - what the service does and when to reach for it.
- API reference - every endpoint these commands call.
- CLI reference - global options, output modes, and exit codes.