100 Community Guides & Mentors resources for MUD players
MUDs rely on text-based interfaces where new players often quit within the first session due to parser confusion or isolation. Effective mentor systems require both softcode infrastructure for flagging and communication, plus documented escalation paths that prevent volunteer burnout. This resource covers implementation across PennMUSH, TinyMUX, RhostMUSH, and Evennia codebases with specific SQL queries, softcode snippets, and Discord webhook integrations used by active MUDs on Grapevine.
Mentor Role Architecture and Recruitment
- 1
Implement Softcoded Newbie Flags
intermediatehighUse PennMUSH @adesc or TinyMUX & attributes to create automatic NEWBIE flags triggered by connection count under 5 or account age under 48 hours. Check against last.cc or custom SQL tables via @hook scripts.
- 2
Establish Permission Hierarchies
advancedhighConfigure MUSH wizard bits to separate MENTOR, GUIDE, and BUILDER permissions. Use @lock/user commands to restrict mentor-only channels while allowing page access to all players for help requests.
- 3
Recruit from Active Playerbase
beginnerstandardTarget players with 90+ days tenure and zero warnings in @sitelock logs. Post recruitment calls via @wall or +bboard systems rather than Discord to ensure in-game cultural alignment.
- 4
Vet Candidates with Scenario Testing
intermediatemediumCreate a +mentorquiz command using softcode that presents three common MUD parser confusion scenarios. Log responses to SQLite for review by wizards before flag assignment.
- 5
Design Rotation Schedules
intermediatemediumAvoid permanent on-duty status. Implement weekly rotation via @schedule commands or external cron jobs hitting MUSH telnet ports to toggle +mentor/onduty flags automatically.
- 6
Create Shadowing Requirements
beginnerstandardRequire 10 hours of shadowing existing mentors via @follow commands or paired room assignments before solo duty. Log hours via custom +shadowlog attribute tracking.
- 7
Separate IC and OOC Mentor Roles
intermediatehighMaintain distinct flags for in-character guides (IC teachers) versus OOC helpers (technical support). Use channel locks to prevent crossover confusion in roleplay-enforced MUDs.
- 8
Implement Demotion Protocols
advancedstandardBuild automated @alevel reduction triggers based on player complaint logging or 30-day inactivity. Archive mentor notes to flatfile before flag removal for continuity.
- 9
Establish Recognition Systems
intermediatemediumCreate +mentor/thanks command allowing players to award points logged to SQL. Display monthly totals via +bboard or in-game @title changes to maintain motivation without monetary rewards.
- 10
Define Time Commitment Contracts
beginnerstandardDocument minimum 4-hour weekly shifts in plain text files stored in MUSH txt/ directory. Require digital acknowledgment via @email to adminalias@muddomain before flag assignment.
Technical Infrastructure and Cross-Platform Tools
- 1
Configure PennMUSH @adesc Systems
advancedhighSet up automatic @adesc notifications on the NEWBIE flag that trigger when players enter public spaces. Use softcode to check +mentor/onduty list and page active helpers with location data.
- 2
Bridge to Discord via Webhooks
advancedhighImplement bot integration using Discord API webhooks to mirror MUD mentor channels. Use Python scripts with pydiscord library parsing MUSH output via Pueblo or external log tailing for real-time cross-platform help.
- 3
Integrate Grapevine API for Cross-MUD Mentoring
intermediatemediumConnect to to fetch online user counts and share mentor availability across MUD networks. Use JSON endpoints to synchronize help queue status between sister games.
- 4
Build SQLite Logging for Help Requests
advancedhighModify MUSH hardcode or use @hook commands to INSERT help requests into SQLite tables with timestamps, mentor IDs, and resolution status. Query via +mentor/stats for response time analytics.
- 5
Automate Newbie Detection Logic
intermediatehighScript login triggers that check against player creation dates stored in sql/ databases or flatfiles. Auto-page new connections with +help index links after 30-second delays to avoid spam.
- 6
Create Mentor Lounge Rooms
beginnerstandardBuild isolated grid rooms with @lock/zone restrictions allowing only mentor-bit players. Include +meetme commands for private consultations away from public spam.
- 7
Implement Command Logging
intermediatemediumEnable LOG_COMMANDS in mush.cnf or equivalent, then parse logs with AWK scripts to identify which mentors handle which command types. Correlate with player retention rates in monthly reports.
- 8
Set Up Paging Priority Queues
intermediatehighSoftcode a +page/urgent system that bypasses normal @lock restrictions for players flagged NEWBIE within their first 24 hours, ensuring mentor availability overrides busy status.
- 9
Deploy Mudlet Package for Mentors
intermediatemediumDistribute XML packages via containing triggers for highlighting newbie pages, automated greeting macros, and quick-sql query buttons for checking player stats during sessions.
- 10
Configure TinyMUX Channel Architecture
intermediatestandardUse @channel/add with specific levels to create dark-mode mentor-only channels invisible to non-mentor bits. Implement +channel/hide for sensitive administrative discussions separate from general help.
Training Curricula and Documentation
- 1
Develop Softcode Syntax Primers
intermediatemediumCreate plain-text guides stored in MUSH txt/ directory explaining basic @commands, &attributes, and functions. Require mentors to demonstrate understanding of switch(), case(), and iter() before handling complex queries.
- 2
Build Scenario-Based Roleplay Tests
intermediatehighDesign five common MUD scenarios: parser failure, theme confusion, building permission errors, social norm violations, and technical disconnects. Store scenarios in +help files accessible only during training status.
- 3
Document Escalation Decision Trees
beginnerhighCreate ASCII flowcharts in +help escalation showing when to involve wizards versus handling via +policy explanations. Include specific @email addresses and @sitelock procedures for harassment cases.
- 4
Compile Theme Enforcement Guidelines
beginnerstandardExtract world-building documents from MUSH wiki exports or flatfiles. Provide mentors with searchable offline copies via password-protected HTML or local text files to ensure consistent lore explanations.
- 5
Create Command Reference Sheets
beginnerstandardGenerate PDF or plain-text quick-reference cards listing common MUD commands by category: communication, movement, building, and administration. Host on HTTPS-accessible paths for mentor download.
- 6
Establish Navigation Assistance Protocols
beginnermediumTrain mentors to use @find and search commands effectively. Document grid topology in +help grid or external Obsidian vaults shared via Git repositories for version-controlled accuracy.
- 7
Write Cultural Sensitivity Guidelines
intermediatemediumAddress text-based communication challenges including tone interpretation, trigger warnings for mature themes, and handling of out-of-character boundary violations in mixed IC/OOC environments.
- 8
Develop Mechanic Tutorial Scripts
advancedmediumCreate step-by-step softcode examples for explaining combat systems, economy, and crafting. Use +demonstrate commands that show calculated outputs without risking actual game state changes.
- 9
Implement Shadowing Checklists
intermediatestandardBuild +shadow/required command tracking completion of specific observation tasks: handling a page, explaining a command, escalating a dispute, and using SQL query tools.
- 10
Archive Session Logs for Review
beginnerstandardInstruct mentors to use @log or client-side logging during training. Submit sanitized logs to admin @email for review of tone, accuracy, and adherence to escalation protocols before full clearance.
Retention Metrics and Burnout Prevention
- 1
Query Retention Correlations via SQL
advancedhighRun monthly SQLite reports joining player creation dates, mentor interaction logs, and last connection timestamps. Calculate 30-day retention rates for mentored versus non-mentored cohorts using GROUP BY statements.
- 2
Monitor Ticket Response Times
intermediatehighParse MUSH logs or SQL tables to calculate average time between +help requests and first mentor response. Alert admin when averages exceed 15 minutes during peak hours via @email or Discord webhook.
- 3
Track Session Length Differentials
intermediatemediumCompare connection duration for new players who receive mentor contact within first 10 minutes versus those who self-navigate. Export data to CSV for analysis in R or Python pandas.
- 4
Implement Volunteer Satisfaction Surveys
intermediatemediumDeploy monthly +mentor/feedback forms storing Likert-scale responses in SQL. Track satisfaction trends and correlation with retention metrics to identify systemic issues before burnout occurs.
- 5
Enforce Mandatory Break Periods
intermediatehighConfigure softcode to automatically toggle off +mentor/onduty status after 4-hour continuous shifts. Require 30-minute minimum offline time before system allows reactivation to prevent fatigue errors.
- 6
Create Succession Documentation
beginnerstandardMaintain Git repositories of mentor procedures, softcode snippets, and escalation contacts. Ensure three-deep redundancy for critical passwords and admin contact methods to prevent single points of failure.
- 7
Analyze Complaint Patterns
intermediatemediumWeekly SQL queries on complaint logs joined to mentor IDs. Identify outliers requiring retraining or rest periods before formal disciplinary action via @alevel reduction.
- 8
Automate Recognition Thresholds
intermediatestandardScript monthly @title changes or +bboard posts when mentors hit specific help-count milestones (50, 200, 500 sessions). Pull data from SQLite interaction logs rather than manual tracking.
- 9
Calculate Burnout Predictors
advancedhighUse Python scripts analyzing log data to flag mentors showing reduced response rates, increased escalation delegations, or negative sentiment in page logs. Trigger automatic wellness check pages from admin alts.
- 10
Archive Institutional Knowledge
intermediatestandardQuarterly exports of +help files, softcode repositories, and SQL schemas to offsite storage. Test restoration procedures on development MUSH instances to ensure continuity during host migrations.