-
Notifications
You must be signed in to change notification settings - Fork 3
Pawn Queue Management

The Pawn Queue Management dialog provides streamers with a comprehensive interface to manage viewer pawn assignments from the waiting queue. This powerful tool allows you to efficiently assign available colonists to viewers who have joined the queue using the !joinqueue command.
The Pawn Queue Management window serves as the central hub for handling viewer pawn assignments. It displays both available pawns and the current queue of waiting viewers, enabling streamers to make informed decisions about pawn assignments.
Key Features:
- 👥 View Available Pawns - See all unassigned colonists with detailed information
- 📊 Queue Display - Current viewer queue with positions and usernames
- 🔍 Search & Filter - Find specific pawns by name or race
- 🎲 Random Selection - Automatically pick random viewer from queue
- 📤 Send Offers - Direct pawn assignment to specific viewers
- 🗑️ Queue Management - Remove viewers or clear entire queue
Header Components:
- 📈 Queue Status - Shows current number of viewers waiting
- 🔍 Search Bar - Filter available pawns by name or race
- 🎲 Select Random - Randomly choose viewer from queue
- 📤 Send Offer - Assign selected pawn to selected username
- 🗑️ Clear Queue - Remove all viewers from queue (with confirmation)
Displays all unassigned player colonists with:
- 🖼️ Small portrait with visual status
- 👤 Name, age, and gender symbols (♂️♀️⚧️)
- 🧬 Race and xenotype (if Biotech enabled)
- 🎯 Click to select for assignment
When pawn is selected, shows:
- 🖼️ Large Portrait - Detailed pawn visual
- 📝 Bio Information - Name, gender, age, backstories, traits
- ⚡ Skills Display - All skills with levels and passion symbols (🔥♨️)
- ✍️ Username Input - Field for entering viewer username
- ✅ Assign Button - Send pawn offer to specified viewer
Displays current viewer queue:
- #️⃣ Position Numbers - Queue order (1, 2, 3, etc.)
- 👤 Usernames - Viewer Twitch/YouTube names
- 🎯 Select Buttons - Auto-fill username for assignment
- ❌ Remove Buttons - Remove specific viewers from queue
- Open Dialog → Main Menu > RICS > Pawn Queue Management
- Select Pawn → Click available pawn from left panel
-
Choose Viewer → Either:
- Type username manually
- Click "Select" next to queue entry
- Use "Select Random" for random choice
- Send Offer → Click "Send Offer" or "Assign" button
- Confirm → System sends chat message to viewer
// Quick random assignment process:
- Click "Select Random" button
- System auto-selects random viewer from queue
- Auto-selects first available pawn if none chosen
- Username field populated automatically
- Click "Send Offer" to complete
Search Examples:
- "John" → Finds pawns with "John" in name
- "human" → Shows human pawns only
- "hussar" → Filters for hussar xenotype
- "20" → Pawns around age 20
When you send a pawn offer:
✅ Viewer receives chat message with !acceptpawn instructions ⏱️ Offer expires after configured timeout (default: 5 minutes) 📝 Pawn moves to "pending offers" until accepted/expired 🗑️ Viewer automatically removed from queue
For Interactive Streams:
- Use "Select Random" for fair viewer selection
- Explain pawn traits/skills when assigning
- Consider viewer preferences if known
- Mix manual and random assignments
Queue Management:
- Clear queue periodically if it gets too long
- Remove inactive viewers manually
- Keep queue under 20 viewers for manageability
// The system ensures:
- Only unassigned pawns appear in available list
- Dead pawns are grayed out and excluded
- Pending offers prevent pawn double-assignment
- Queue persists through game saves/loads
"No available pawns" → All colonists are assigned to viewers "Queue empty" → No viewers have used !joinqueue command "Offer failed" → Check username spelling and chat connection
🔗 Related Links
- 👥 Viewer Management - Overall viewer system overview
- ⚙️ Global Settings - Configure pawn offer timeouts
- 💬 Chat Commands - Viewer !joinqueue command details
- 🏪 Store Editor - Set up pawn assignment costs