Platform documentation
VIRCON Logger docs
VIRCON Logger is a Discord moderation system for VRChat communities. The website and bot run on separate deployments for security and scalability.
What VIRCON delivers
These are the live capabilities already running in the bot.
- Registration links Discord accounts to VRChat profiles for verified identity.
- Moderation tools cover bans, kicks, warnings, strikes, and audit trails.
- Analytics highlight activity, leaderboards, and staffing coverage gaps.
- Sync jobs keep member data fresh with both incremental and full refreshes.
At a glance
Command prefix
, (comma)
Processes
Bot, backups, watchdog
Database
SQLite with protection
Core capabilities
Moderation, analytics, and trust systems.
User registration
Link and manage VRChat profiles, including primary account control.
Activity tracking
Logs activity, leaderboards, heatmaps, and time-window analytics.
Moderation stack
Ban, unban, kick, warn, request bans, and capture reasons safely.
Incident workflows
Incident reports, evidence vault entries, and audit-ready history.
Staff operations
Availability status, callstaff pings, staffing gap detection.
Admin governance
Promotions, strikes, audits, and server configuration controls.
Reliability layers
The database is protected with multiple safeguards to reduce loss.
- Hourly automated backups with retention.
- Pre-save validation and corruption detection.
- Auto-recovery from last known good backup.
- Manual backup triggers for critical changes.
- Watchdog health monitoring with auto-restart.
- Database guard for real-time integrity checks.
Sync behavior
VRChat membership stays accurate through mixed sync modes.
Incremental sync
Sync the latest 500 members in seconds with `,syncinc`.
Full sync
Rebuild the entire roster with `,syncfull` (minutes for large groups).
Auto sync
Incremental every 15 minutes and full sync every 3 hours.
Operations & monitoring
VIRCON ships with a production-ready monitoring stack.
- PM2-managed services: main bot, database backup, watchdog.
- Status dashboard with uptime, latency, VRChat auth, cache health.
- Error logging to a dedicated Discord channel.
- Health checks for database size, cache age, and restart attempts.
Deployment split
The website and bot run on separate infrastructure.
Website
- - Public marketing pages and documentation
- - Discord OAuth login and session handling
- - Serverless APIs for dashboards and bot stats
- - Global CDN delivery for fast load times
Bot host
- - Discord bot runtime and VRChat API sessions
- - Long running sync jobs and background tasks
- - Database storage, backups, and watchdog
- - Private tokens and secure credentials
Deep dives
Detailed docs for all systems and operations.
Member registration
Link Discord to VRChat and verify identity.
Read more
Moderation stack
Bans, kicks, warnings, and punishment workflows.
Read more
Appeals & expiration
Contest punishments and auto-expire temporary actions.
Read more
Strike system
Staff accountability tracking and performance management.
Read more
Trust scoring
Behavior analysis and risk profiling for users.
Read more
Alt detection
Identify alternate accounts and ban evasion attempts.
Read more
World monitoring
Heatmaps of problem VRChat worlds and incident locations.
Read more
Activity & analytics
Leaderboards, time heatmaps, and staffing insights.
Read more
Sentiment tracking
Real-time emotional health monitoring and trend analysis.
Read more
Staff operations
Availability tracking, callstaff, and gap detection.
Read more
Training & probation
Structured onboarding with approval workflows for new moderators.
Read more
Role management
Staff role hierarchy, promotions, demotions, and cross-platform permission sync.
Read more
Shift & handover
Staff coverage tracking and seamless shift transitions.
Read more
Event mode & raids
Emergency response protocols and temporary stricter rules.
Read more
Bulk operations
Mass actions and automation workflows for efficiency.
Read more
Anomaly detection
Automated detection of unusual patterns and coordinated behavior.
Read more
Risk forecasting
Predictive analytics for staffing needs and escalation trends.
Read more
Simulations
Model hypothetical policy changes and scenarios before implementation.
Read more
Incident reports
Multi-user case management with evidence linking.
Read more
Evidence vault
Immutable proof storage with access controls.
Read more
AutoMod suggestions
Pattern detection that flags risks without auto-punishment.
Read more
Member sync
Incremental, full, and automatic VRChat sync workflows.
Read more
Reports & dashboards
Comprehensive analytics, performance metrics, and real-time insights.
Read more
Audit trail & rollback
Configuration change logging and snapshot-based recovery.
Read more
Timeline snapshots
Capture and replay point-in-time server states for historical analysis.
Read more
Backup & restore
Automated database backup, disaster recovery, and restore workflows.
Read more
Status & health
System diagnostics, uptime, and operational metrics.
Read more
Bot host ops
Deployment, migration, monitoring, and lock controls.
Read more
API keys & integrations
VRChat API, Discord webhooks, and external service authentication.
Read more
Deployment checklist
Pre-flight steps and verification for bot migrations.
Read more
Quick links
Keep this documentation close to your launch checklist.