A powerful desktop toolkit for VRChat group owners and moderators. Fast login, rich group insights, member management, posts, calendar events, invites, audit logs, Discord webhooks, and moreβall in one modern WPF app.
- Secure VRChat login with 2FA (TOTP/Email) support
- Session caching for instant re-login
- Automatic session restoration on app startup
- Group name, privacy level, member counts, and online stats
- Creation date, owner info, and group links
- Rules, description, and gallery preview
- Role management and permissions overview
- Upcoming and past events display
- Search any VRChat user by username or User ID
- View detailed user profiles with avatar, bio, and badges
- Age verification status display (18+ badge)
- Highlight existing group members
- Moderation Actions:
- Kick users from group
- Ban/Unban users
- Assign and remove roles
- Send group invites
- Search users by name or paste User ID directly
- Click-to-preview user profile before inviting
- View age verification status and bio
- Quick "Use" button to select user
- One-click invite sending
- Instance Inviter: Detect users in your current VRChat instance and invite them to your group.
- Filter by Trust Level (Visitor, New User, User, Known, Trusted).
- 18+ Only Filter: Only show users with confirmed 18+ age verification.
- "Select All" and bulk invite capabilities.
- Anti-abuse protection: Prevents sending group invites from another group's instance.
- Friend Inviter: Quickly invite your online friends to your group.
- Game Log Scanner: Parse VRChat game logs to find and invite users you've recently encountered.
- Filter by 18+ verification status.
- View trust levels and last seen timestamps.
- Bulk invite capabilities.
- Join Requests: Monitor and process group join requests.
- Filter requests by 18+ status (age verification check).
- Approve or block users directly.
- View user details and profile pictures.
- Create and manage group events
- Event Options:
- Title, description, category
- Start/end time with date pickers
- Visibility (Public/Group)
- Platform tags (Windows, Android, iOS)
- Language tags with searchable dropdown
- Send notification toggle
- Thumbnail upload support
- Recurrence Support:
- Weekly (select days)
- Monthly (specific dates)
- Specific dates list
- Recurrence end date
- Templates: Save and reuse event configurations
- Sync events from VRChat
- Duplicate and delete events
- View existing group posts with pagination
- Create new posts with title and content
- Visibility settings (Public/Group/Friends)
- Send notification option
- Edit existing posts
- Delete posts
- Build VRChat launch links with full customization:
- Region selection (US, EU, JP)
- Access type (Public, Friends+, Friends, Invite+, Invite, Group)
- Queue enabled toggle
- Age gate (18+) toggle
- Schedule instances with time zone support
- Copy link, send invite, or launch directly
- Browse all group members
- Filter by role
- View member details
- Quick moderation actions
- View all banned users
- Unban users with one click
- Ban details and dates
- Full audit log history
- Filter by action type
- Date range selection
- Search functionality
- Auto-refresh toggle
- Fetch complete history
- Cached locally for speed
- Real-time Security Monitoring: Automatically tracks suspicious actions
- Instance & World Info: View instance IDs and world names for relevant log entries
- Enhanced CSV Export: Export logs with instance and world data
- Scan entire group for age verification status
- Filter by verified/unverified/unknown
- Moderation Actions:
- Manual selection with checkboxes
- Select All Unverified / Unselect All buttons
- Kick Selected members
- Kick All Unverified (bulk action)
- Rate-limited to 500ms per action
- Copy to Clipboard:
- Copy unverified user list
- Copy filtered results
- Pipe-delimited format (DisplayName|UserID)
- Export results to CSV
- Progress tracking with real-time stats
- Emergency bulk role removal from group members
- Automatically creates a snapshot before removing roles
- Select specific members or roles to remove
- Snapshot & Restore:
- All role assignments saved to local database before removal
- View historical snapshots with timestamps
- Restore roles individually or in bulk
- Track which roles have been restored
- Rate-limited API calls to avoid VRChat restrictions
- Progress tracking with success/failure counts
- Excludes default "Member" role from removal
- Create Snapshots: Save complete member lists with roles and join dates
- Disaster Recovery: Restore members after mass removals or attacks
- Smart Comparison: See exactly who's missing vs who's new
- Selective Restore: Re-invite only missing members or everyone
- Backup History: Keep multiple snapshots with custom descriptions
- Progress Tracking: Real-time progress for backup/restore operations
- Rate Limited: Automatic delays to respect VRChat API limits
- Status Tracking: See which members were successfully re-invited
- Automated Threat Detection: Monitor and respond to suspicious moderator behavior
- Configurable Thresholds: Set limits for kicks, bans, role removals, and more
- Preemptive Ban Tracking: Separate thresholds for banning non-group-members vs group members
- Trusted User Exclusions: Exempt specific trusted users from all security threshold monitoring
- Automatic Response: Remove roles from users exceeding thresholds
- Discord Alerts: Receive rich notifications when incidents are detected
- Owner Protection: Require owner role for automatic actions
- Incident History: View all security events with full details
- Action Tracking: Every monitored action logged to database
- Multiple Categories:
- Excessive kicks (e.g., 5 kicks in 10 minutes)
- Excessive bans (e.g., 3 bans in 10 minutes)
- Mass role removals (e.g., 5 removals in 10 minutes)
- Bulk invite rejections (e.g., 10 rejections in 10 minutes)
- Content deletions (e.g., 5 posts deleted in 10 minutes)
- Separate Webhook: Configure dedicated security alert webhook
- Age Gate Enforcement: Automatically close group instances that aren't age-gated (18+)
- Region Restrictions: Optionally restrict instances to specific regions (US, EU, JP)
- Configurable Intervals: Set how often to check for non-compliant instances
- Discord Notifications: Receive alerts when instances are auto-closed
- Manual Override: View and manually close any active group instance
- Real-time Monitoring: Toggle monitoring on/off with status tracking
- Configure webhook URL (supports discord.com and discordapp.com)
- Comprehensive Event Notifications:
- Member Events: Joins, leaves, updates, role assignments
- Role Events: Create, update, delete role changes
- Instance Events: Create, update, delete instances
- Group Events: Name, description, icon, banner, privacy changes
- Invite & Join Events: Requests, invites, approvals, rejections
- Announcement Events: Create, update, delete announcements
- Gallery Events: Image submissions, approv
- Security Events: Threshold violations and automatic responses (via separate webhook)als, deletions
- Post Events: Create, update, delete posts
- Bulk Controls:
- Select All / Deselect All toggles
- Organized by event categories
- Test webhook connection
- Rich embed notifications with color coding and emojis
- Auto-Update System:
- Automatic update checks on startup
- Downloads from GitHub releases
- One-click update and restart
- ZIP-based updates with automatic executable replacement
- Startup Options:
- Start with Windows (registry integration)
- Theme customization
- Region and timezone settings
- Local data management
- About and version info
- Download: Get the latest release from Releases or build from source
- Run: Launch
VRCGroupTools.exe- Windows SmartScreen Warning? This appears because the app isn't code-signed (signing certificates cost $$$). The app is safe and open source. Click "More info" β "Run anyway"
- Login: Enter your VRChat credentials + 2FA code
- Set Group: Enter your Group ID (
grp_...or short code) in the sidebar - Explore: Navigate modules from the left sidebar
Windows SmartScreen Warning: The application may show "Windows protected your PC" on first run. This is normal for unsigned applications. To proceed:
- Click "More info"
- Click "Run anyway"
The application is:
- β Open Source - All code is visible on GitHub
- β Scanned by GitHub Actions - Built in a clean environment
- β No Telemetry - Your data stays local
- β Community Verified - Check the issues and discussions
Why unsigned? Code signing certificates cost $300-500/year. Once the project grows, we'll invest in proper signing.
- OS: Windows 10/11 (64-bit)
- Runtime: .NET 8 Desktop Runtime (included in self-contained builds)
- Account: VRChat account with group moderator/owner rights for moderation features
- .NET 8 SDK or later
- Windows 10/11
- Git (optional, for cloning)
:: Clone the repository
git clone https://github.com/0xE69/VRCGT.git
cd VRCGT
:: Run the build script
build.bat:: Navigate to source directory
cd src
:: Restore packages
dotnet restore
:: Build release version
dotnet build -c Release
:: Publish self-contained executable
dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -o bin/PublishThe compiled executable will be in src/bin/Publish/VRCGroupTools.exe
- Install Inno Setup
- Open
installer/setup.iss - Compile to create the installer
This project includes automated builds via GitHub Actions:
- On Push/PR: Builds and uploads artifacts
- On Tag (v):* Creates a GitHub Release with the compiled binary
To create a release:
git tag v1.0.7
git push origin v1.0.7All data is stored locally in %LocalAppData%\VRCGroupTools\:
settings.json- App configurationvrcgrouptools.db- SQLite database for caching, security logs, and backupsLogs/- Application logsCrashReports/- Error reports
Privacy:
- Credentials are sent directly to VRChat's official API
- No data is sent to third parties
- Discord webhooks are configured and stored locally
- All security monitoring and backups stored locally
MIT License - see LICENSE for details.
This project is not affiliated with, endorsed by, or connected to VRChat Inc. VRChat and related marks are trademarks of VRChat Inc. Use at your own risk and in accordance with VRChat's Terms of Service.
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
π Security Enhancements & Auto Closer
New Features:
-
Instance Auto Closer π«
- Automatically close non-age-gated (18+) group instances
- Optional region restrictions for instances
- Configurable check intervals
- Discord notifications when instances are closed
- Manual instance management with refresh and close buttons
- Real-time monitoring toggle
-
Game Log Scanner π
- New tab in Inviter Hub to parse VRChat game logs
- Find and invite users you've recently encountered
- Filter by 18+ verification status
- View trust levels and last seen timestamps
- Bulk invite capabilities
-
Trusted User Exclusions β
- Add trusted staff user IDs exempt from all security thresholds
- Useful for staff who perform bulk moderation actions
-
Preemptive Ban Differentiation π‘οΈ
- Separate threshold settings for preemptive bans (banning non-members)
- Higher default threshold (20) since banning known troublemakers is common
- Distinguishes between group member bans vs non-member bans in security tracking
Improvements:
- Audit Logs: Now display instance ID and world name for relevant events
- CSV Export: Audit log exports include instance and world data
- Instance Inviter: Anti-abuse protection prevents invites from other groups' instances
- Security Monitor: Better differentiation between action types
π¬ Inviter Hub & Moderation
New Features:
- Inviter Hub: Centralized tab for all recruiting tools.
- Instance Inviter: Detect and invite users from your current VRChat instance. Includes 18+ filtering.
- Friend Inviter: Bulk invite online friends.
- Join Requests: Manage group requests with new 18+ verification filters.
- Profile Viewer: Click on any user in search/lists to view their full profile (Bio, Status, Badges).
- 18+ Filters: Added verified 18+ filtering to Instance Inviter, Friend Inviter, and Join Requests.
Improvements:
- UI Tweaks for better readability.
- Performance improvements in API scanning.
π§ Stability & Caching
Improvements:
- Prevent duplicate Discord audit webhook posts
- Added cache load options for group info, posts, bans, and badge scans
π Security & Recovery Features
New Features:
-
Security Monitor System π
- Automatic detection of suspicious moderator behavior
- Configurable thresholds for kicks, bans, role removals, invite rejections, and content deletions
- Automatic role removal for users exceeding limits
- Dedicated Discord webhook for security alerts
- Owner-only protection mode
- Complete incident history and action logging
- Real-time monitoring integrated with audit logs
-
Member Backup & Recovery System πΎ
- Create complete snapshots of all group members with roles
- Smart comparison between backups and current membership
- Selective member restoration (missing only or all)
- Multiple backup history with custom descriptions
- Progress tracking for backup/restore operations
- Visual status indicators (missing/re-invited)
- Rate-limited API calls for safe restoration
Improvements:
- Enhanced database schema with security and backup tables
- Additional VRChat API methods for member role management
- Improved error handling and logging throughout
- Better performance with indexed database queries
- Initial public release
- Core group management features
- Discord webhook integration
- Kill Switch functionality
- 18+ Badge Scanner
- Calendar events and posts management
- VRChat community for feedback and testing
- Material Design In XAML for UI components
- All contributors and supporters