Skip to content

Viewer Management

ekudram edited this page Nov 6, 2025 · 1 revision

Viewer Management 👥

Viewer Management Dialog

The Viewer Management system allows you to monitor and manage all viewers who interact with your stream. Track coins, karma, platform IDs, and assigned pawns while maintaining control over your community! 🎮


Interface Overview 🔍

Header Section

  • Total Viewers Counter 📊 - Shows total and filtered viewer counts
  • Search Bar 🔍 - Find viewers by username or display name
  • Sort Buttons 📊 - Organize by Username, Coins, or Karma
  • Mass Actions Menu ⚡ - Bulk operations for managing all viewers

Left Panel: Viewer List 👥

  • Color-coded usernames based on role:
    • Broadcaster 🔴 - Bright red (you!)
    • Moderators 🟢 - Green (channel mods)
    • VIPs 🟡 - Gold (special supporters)
    • Subscribers 🔵 - Blue (subscribed viewers)
    • Banned Users ❌ - Red (banned from interaction)
  • Click any viewer to select and view details

Right Panel: Viewer Details 📋

  • Pawn Assignment 🎭 - Current assigned pawn with portrait
  • Platform IDs 🌐 - Twitch and other platform user IDs
  • Economy Controls 💰 - Manage coins and karma values
  • Activity Tracking 📈 - Message counts and last seen timestamps
  • Ban Controls 🚫 - Ban/unban viewers from interaction

Viewer Roles & Colors 🎨

Role Hierarchy

  • Broadcaster ⭐ - Streamer (highest priority)
  • Moderator 🛡️ - Channel moderators
  • VIP 💎 - Special supporters
  • Subscriber 🔔 - Subscribed viewers
  • Regular Viewer 👤 - Standard chat participants
  • Banned 🚫 - Blocked from using commands

Visual Identification

  • Each role has distinct color coding in the viewer list
  • Banned users are clearly marked with red text
  • Active viewers show real-time status
  • Role badges appear in detail headers

Pawn Assignment Management 🎭

Assigned Pawn Display

  • Live Portrait 🖼️ - Real-time pawn rendering with current appearance
  • Health Status ❤️ - Current health percentage and condition
  • Location Info 🗺️ - Current map position or status
  • Race & Name 👤 - Pawn type and assigned name

Pawn Management Actions

  • Unassign Pawn 🔄 - Remove current pawn assignment
  • Clear Deceased 💀 - Remove assignments for dead pawns
  • Portrait Preview 👀 - Visual representation of assigned pawn

Economy Controls 💰

Coin Management

  • Current Balance 💵 - Display current coin total
  • Give Coins ➕ - Add specified amount to balance
  • Take Coins ➖ - Remove specified amount from balance
  • Set Coins ⚡ - Directly set to specific amount
  • Input Validation ✅ - Ensures values stay within limits

Karma Management

  • Current Karma ⚖️ - Display current karma level
  • Karma Limits 📏 - Respects global min/max karma settings
  • Adjustment Tools 🛠️ - Give, take, or set karma values
  • Role Impact 🎯 - Some roles may have karma modifiers

Activity Tracking 📈

Viewer Statistics

  • Message Count 💬 - Total messages sent in chat
  • Last Seen 🕒 - Timestamp of last activity
  • Active Status 🔴 - Real-time "Active Now" indicator
  • Inactivity Tracking ⏰ - Time since last activity in minutes

Platform Integration

  • Twitch IDs 📺 - Public Twitch user identifiers
  • Multi-Platform 🌐 - Support for multiple streaming platforms
  • ID Management 🔑 - Track viewers across different platforms

Mass Actions ⚡

Bulk Operations Menu

  • Award Coins to Active 💰 - Reward all currently active viewers
  • Reset All Coins 🔄 - Set all viewers to starting coin amount
  • Reset All Karma ⚖️ - Set all viewers to starting karma level
  • View Statistics 📊 - Show comprehensive viewer analytics

Confirmation Dialogs

  • Safety Checks ⚠️ - All mass actions require confirmation
  • Undo Protection 🛡️ - Prevents accidental bulk changes
  • Success Feedback ✅ - Clear messages after operations complete

Ban Management 🚫

Ban Controls

  • Ban Viewer 🚫 - Prevent viewer from using commands
  • Unban Viewer ✅ - Restore command access
  • Visual Indicators 🔴 - Clear banned status display
  • Confirmation ⚠️ - Requires confirmation to prevent mistakes

Ban Effects

  • Command Block 🛑 - Banned users cannot use any chat commands
  • Economy Freeze ❄️ - Coins and karma remain unchanged
  • List Visibility 👀 - Still visible in management for moderation

Search & Filtering 🔍

Search Features

  • Username Search 👤 - Find viewers by Twitch username
  • Display Name Search 🏷️ - Search by display names
  • Real-time Filtering ⚡ - Instant results as you type
  • Case Insensitive 🔤 - No need for exact capitalization

Sorting Options

  • Alphabetical 🔤 - A-Z or Z-A by username
  • Wealth-based 💰 - Sort by coin balance (high to low)
  • Karma-based ⚖️ - Sort by karma levels
  • Toggle Direction 🔄 - Ascending or descending order

Usage Tips 💡

  • Regular Monitoring 👀 - Check viewer activity and pawn assignments frequently
  • Economy Balance ⚖️ - Use mass actions to maintain fair coin distribution
  • Role Recognition 🎭 - Leverage color coding for quick role identification
  • Ban Wisely 🚫 - Reserve bans for disruptive behavior only
  • Pawn Management 🎮 - Clear deceased pawn assignments to free up slots
  • Backup Regularly 💾 - Viewer data saves automatically but keep backups

💾 All changes save automatically when closing the window or making modifications.


Statistics & Analytics 📊

Access comprehensive viewer statistics including:

  • Total vs Active 👥 - Compare registered vs currently active viewers
  • Economy Overview 💰 - Total coins in circulation and averages
  • Role Distribution 🎭 - Breakdown of moderators, VIPs, subscribers
  • Ban Statistics 🚫 - Number of currently banned users

Related Links 🔗

Next: Command Editor ⌨️

Clone this wiki locally