Skip to content

Pawn Queue Management

ekudram edited this page Mar 19, 2026 · 6 revisions

🎮 Pawn Queue Management

Pawn Queue Management Dialog

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.


📋 Overview

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

🎨 Interface Layout

🏷️ Header Section

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)

👥 Available Pawns Panel

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

📊 Queue Details Panel

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

📋 Queue List Section

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

🚀 Usage Guide

🔄 Basic Workflow

  1. Open Dialog → Main Menu > RICS > Pawn Queue Management
  2. Select Pawn → Click available pawn from left panel
  3. Choose Viewer → Either:
    • Type username manually
    • Click "Select" next to queue entry
    • Use "Select Random" for random choice
  4. Send Offer → Click "Send Offer" or "Assign" button
  5. Confirm → System sends chat message to viewer

🎲 Random Assignment

// Quick random assignment process:

  1. Click "Select Random" button
  2. System auto-selects random viewer from queue
  3. Auto-selects first available pawn if none chosen
  4. Username field populated automatically
  5. Click "Send Offer" to complete

🔍 Advanced Filtering

Search Examples:

  • "John" → Finds pawns with "John" in name
  • "human" → Shows human pawns only
  • "hussar" → Filters for hussar xenotype
  • "20" → Pawns around age 20

📤 Sending Pawn Offers

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


⚙️ Best Practices

🎯 Stream Integration Tips

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

🔧 Technical Notes

// 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

🚫 Common Issues

"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

Clone this wiki locally