A comprehensive Discord bot designed for Minecraft Bedrock Edition servers with advanced anti-cheat features, player management, and server monitoring capabilities.
- Multi-Server Support: Connect and manage multiple Minecraft Bedrock servers
- Real-time Player Monitoring: Track player joins, leaves, and activities
- Chat Relay: Bidirectional chat between Discord and Minecraft
- Server Status Monitoring: Real-time server health and player count
- Automatic Backup System: Hourly configuration backups with restore capabilities
- Activity Tracking: Comprehensive server uptime and player activity monitoring
- Whitelist System: Advanced player whitelist with easy management
- Admin Management: Role-based administrator system
- Player Statistics: Detailed playtime, join count, and last seen tracking
- Player Notes & Warnings: Administrative note-taking and warning system
- Kick/Ban System: Automated and manual player moderation with reason tracking
- Welcome Messages: Customizable welcome system with MOTD support
- Alternative Account Detection: Xbox Live profile analysis
- Gamer Score thresholds
- Friends count analysis
- Followers count verification
- Device Restrictions: Platform-based access control
- Android, iOS, Xbox, Windows, PlayStation, FireOS, Nintendo Switch
- Security Monitoring: Advanced threat detection system
- Rapid join detection
- Suspicious activity logging
- Real-time security alerts
- Bot Detection: Automated bot account identification
- Invalid Character Detection: Username validation
- Player Statistics: Comprehensive playtime and activity tracking
- Activity Analytics: Daily and weekly server statistics
- Security Logs: Detailed security event tracking and analysis
- Uptime Monitoring: Server availability and performance metrics
- Data Persistence: Automatic data backup and recovery
- Slash Commands: Modern Discord command interface with 15+ commands
- Interactive Panels: Rich embed-based management interfaces
- Channel Configuration: Customizable logging channels
- Role Management: Automated role assignment
- Rich Embeds: Beautiful, informative Discord messages
- Enhanced Logging: Configurable command and activity logging
Opens the main management dashboard with access to:
- 🔐 Whitelist Management
- 📋 Allowlist Management
- 👑 Administrator Management
- 🔧 Maintenance Mode
- 🕵️ Alt Detection Configuration
- 📱 Device Restrictions
- 📺 Channel Settings
- 🎭 Role Configuration
Check for and install npm package updates automatically
- Node.js 18+ and npm
- Discord Bot Token
- Minecraft Bedrock Server access
-
Clone the repository
git clone https://github.com/Verxcy120/FairplayX-servers.git cd FairplayX-servers -
Install dependencies
npm install
-
Configure the bot
- Edit
config.jsonwith your settings:
{ "botToken": "YOUR_DISCORD_BOT_TOKEN", "clientId": "YOUR_DISCORD_CLIENT_ID", "username": "Bot Username", "servers": [ { "serverName": "Your Server Name", "host": "server.ip.address", "port": 19132, "logChannels": { "chat": "DISCORD_CHANNEL_ID", "kicks": "DISCORD_CHANNEL_ID", "joinsAndLeaves": "DISCORD_CHANNEL_ID" } } ] } - Edit
-
Build and start
npm run build npm start
Use the provided batch files:
install.bat- Install dependenciesbuild.bat- Build the projectstart.bat- Start the botupdate.bat- Update dependencies
botToken: Your Discord bot tokenclientId: Your Discord application client ID
"servers": [{
"serverName": "Display name for your server",
"host": "Server IP address",
"port": 19132,
"logChannels": {
"chat": "Channel ID for chat logs",
"kicks": "Channel ID for kick notifications",
"joinsAndLeaves": "Channel ID for join/leave logs"
}
}]"logging": {
"logCommands": true,
"detailedLogs": true
}"welcomeSystem": {
"enabled": true,
"channelId": "DISCORD_CHANNEL_ID",
"customMessage": "Welcome {player} to our server!",
"motd": "Enjoy your stay and follow the rules!"
}"security": {
"enabled": true,
"alertChannelId": "DISCORD_CHANNEL_ID",
"rapidJoinThreshold": 5,
"rapidJoinWindow": 60000,
"logToFile": true
}"altSystem": {
"maxGamerScore": 1000,
"maxFriends": 50,
"maxFollowers": 100
}"playerStats": {
"trackPlaytime": true,
"trackJoinCount": true,
"trackLastSeen": true
}"deviceRestrictions": {
"Android": true,
"iOS": true,
"Xbox": true,
"Windows": false,
"PlayStation": true,
"FireOS": false,
"NintendoSwitch": true
}"allowlist": [
"PlayerName1",
"PlayerName2",
"AdminPlayer"
]"maintenanceMode": {
"enabled": false,
"enabledBy": "",
"enabledAt": "",
"reason": "Server maintenance in progress"
}- Use
/managecommand - Select "📺 Channel Configuration"
- Set channels for different log types
- Use
/managecommand - Select "🎭 Role Configuration"
- Configure member and muted roles
- Hourly automatic backups of configuration files
- Manual backup creation via
/backup createcommand - Backup restoration with
/backup restorecommand - Automatic cleanup - keeps last 24 backups
- Backup listing to view available restore points
- Real-time player activity monitoring
- Server uptime tracking with detailed statistics
- Daily and weekly join/leave statistics
- Player playtime tracking with persistent data
- Activity commands (
/uptime,/activity) for insights
- Rapid join detection to prevent spam attacks
- Comprehensive security event logging
- Real-time Discord alerts for security events
- Security statistics and event history
- Configurable thresholds for different security checks
- Player notes system for administrative records
- Warning system with escalation tracking
- Enhanced player statistics with detailed metrics
- Welcome message system with customizable greetings
- Player profile lookup with comprehensive data
- Allowlist management for exclusive server access
- Maintenance mode with allowlist-only access control
- JSON-based data storage for all tracking systems
- Daily statistics persistence for long-term analysis
- Security event logging with severity levels
- Activity data retention for historical analysis
- Backup system for data protection
- Expanded slash command suite with 15+ new commands
- Rich embed responses with detailed formatting
- Interactive command menus for better UX
- Enhanced logging with command tracking
- Real-time notifications for all server events
- Player join/leave tracking
- Chat message logging
- Violation detection alerts
- Server performance metrics
- Violation reports
- Player statistics
- Behavior analysis data
- Custom analytics dashboards
- Xbox Live profile validation
- Alternative account detection
- Device fingerprinting
- Behavior pattern analysis
- Role-based permissions
- Device-specific restrictions
- Whitelist management
- Automated moderation
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
For support, please:
- Join The New Discord
- Message Owner
- Automatic backup system with hourly configuration backups
- Activity tracking with comprehensive server uptime monitoring
- Enhanced security monitoring with advanced threat detection
- Enhanced player management with notes/warnings system
- Welcome system with customizable MOTD support
- Improved Discord integration with modern slash commands
- Enhanced logging and data persistence
- Multi-server support improvements
- Initial release
- Core server management features
- Basic anti-cheat system
- Discord integration
Made with ❤️ for the Minecraft Bedrock community