Skip to content

Releases: Gamer100309/MC-Server-Status-Bot

🚀 MC Server Status Bot - v5.1.0 Release

19 Dec 19:19
0afe0f7

Choose a tag to compare

The easiest way to display your Minecraft server status on Discord!

In this release, we've introduced a brand-new Universal Cross-Platform Installer that handles the entire setup process for you. No more manual file editing or terminal headaches - works on Windows, Linux, and macOS!


📦 What's New in v5.1.0?

Universal Cross-Platform Installer:

  • Automatically detects your operating system and architecture
  • Supports Windows, Linux (x64 & ARM64), and macOS (Intel & Apple Silicon)
  • One-line installation for Linux users
  • Smart system validation (checks Node.js, npm, permissions)

🎯 Smart Configuration:

  • Interactive setup wizard guides you through the process
  • Discord Bot Token validation (minimum 50 characters)
  • Automatic creation of required directories
  • Language support (English, German, more coming soon)

🚀 Automatic Deployment:

  • Installs all npm dependencies automatically
  • Creates platform-specific start scripts (start_bot.bat / start_bot.sh)
  • Option to launch the bot immediately after installation
  • No admin/sudo rights required (installs to user directory)

🛡️ Enhanced Reliability:

  • Comprehensive error handling and logging
  • Validates bot permissions in Discord channels
  • Multi-guild support out of the box
  • State management for persistent status messages

📚 Complete Documentation:

  • New comprehensive Wiki with 16 pages
  • Installation guides for all platforms
  • Troubleshooting & FAQ sections
  • Translation & contribution guidelines

🖥️ Platform Support & Downloads

Windows

Linux

macOS

Support Levels:

  • Full Support - Officially tested and supported by RedCity Industries
  • ⚠️ Community Support - Provided but not officially tested. Community feedback welcome!

🛠️ Installation Instructions

Windows Installation

One-Click Installer (Recommended)

  1. Download: RedCity_Industries_MC_Stats_Bot_Installer_Windows_x64.exe
  2. Run: Double-click the downloaded file
  3. Follow: The installation wizard will guide you through the setup
  4. Done! The bot can start immediately after installation

Note: Windows may show a security warning (normal for unsigned apps). Click "More info" → "Run anyway"


Linux Installation

Method 1: One-Line Install (Easiest)

Simply paste this command in your terminal:

bash <(curl -sSL https://raw.githubusercontent.com/Gamer100309/MC-Server-Status-Bot/main/install.sh)

The script automatically detects your architecture (x64 or ARM64) and downloads the correct installer!

Method 2: Manual Download

For standard Linux (Ubuntu, Debian, Fedora, etc.):

wget https://github.com/Gamer100309/MC-Server-Status-Bot/releases/download/v5.1.0_Release/RedCity_Industries_MC_Stats_Bot_Installer_Linux_x64
chmod +x RedCity_Industries_MC_Stats_Bot_Installer_Linux_x64
./RedCity_Industries_MC_Stats_Bot_Installer_Linux_x64

For Raspberry Pi / ARM64 systems:

wget https://github.com/Gamer100309/MC-Server-Status-Bot/releases/download/v5.1.0_Release/RedCity_Industries_MC_Stats_Bot_Installer_Linux_ARM64
chmod +x RedCity_Industries_MC_Stats_Bot_Installer_Linux_ARM64
./RedCity_Industries_MC_Stats_Bot_Installer_Linux_ARM64

macOS Installation

⚠️ Important: macOS blocks unsigned binaries by default. Follow these steps carefully.

For Apple Silicon Macs (M1/M2/M3/M4):

# Download
curl -L https://github.com/Gamer100309/MC-Server-Status-Bot/releases/download/v5.1.0_Release/RedCity_Industries_MC_Stats_Bot_Installer_macOS_ARM64 -o installer-macos

# Remove quarantine attribute (required!)
xattr -d com.apple.quarantine installer-macos

# Make executable and run
chmod +x installer-macos
./installer-macos

For Intel Macs:

# Download
curl -L https://github.com/Gamer100309/MC-Server-Status-Bot/releases/download/v5.1.0_Release/RedCity_Industries_MC_Stats_Bot_Installer_macOS_x64 -o installer-macos

# Remove quarantine and run
xattr -d com.apple.quarantine installer-macos
chmod +x installer-macos
./installer-macos

If you still get "cannot be opened" error:

  • Go to System Preferences → Security & Privacy
  • Click "Open Anyway" next to the blocked app message

📋 System Requirements

Minimum Requirements:

  • Windows: Windows 10 or higher
  • Linux: Any modern distribution (Ubuntu 20.04+, Debian 10+, Fedora 35+, etc.)
  • macOS: macOS 10.15 (Catalina) or higher

For Running the Bot:

  • Node.js 18+ and npm (installer will check and guide you)
  • Discord Bot Token (How to create one)
  • Internet connection (for downloading bot files and dependencies)

📚 Documentation

Complete setup guide and documentation available in the Wiki:

🔗 Visit the Full Wiki

Quick Links:


📂 What the Installer Does

The automated installer handles everything:

  1. System Validation - Checks for Node.js and npm
  2. Downloads Bot Files - Latest version from GitHub
  3. Creates Directory Structure - configs/, states/, Icons/, logs/
  4. Configuration Setup - Interactive Discord token input
  5. Dependency Installation - Runs npm install automatically
  6. Start Scripts - Creates platform-specific launch scripts
  7. Optional Auto-Start - Launch the bot immediately

No manual setup required! 🎉


🎯 After Installation

Once installed, you can:

  1. Start the bot:

    • Windows: Double-click start_bot.bat
    • Linux/Mac: Run ./start_bot.sh
  2. Configure your servers:

    • Use /setup command in Discord
    • Interactive menus guide you through server setup
    • Supports multiple Minecraft servers per guild
  3. Available Commands:

    • /setup - Interactive setup wizard
    • /botinfo - Show bot information
    • /checkperms - Check bot permissions
    • /reload - Reload configuration
    • /refresh - Recreate status messages

🐛 Troubleshooting

Windows Issues

"Windows protected your PC" warning

  • Click "More info" → "Run anyway"
  • This is normal for unsigned executables

Antivirus blocks the installer

  • Add an exception for the installer
  • The installer is safe and open-source

Linux Issues

"Permission denied" error

chmod +x RedCity_Industries_MC_Stats_Bot_Installer_Linux_x64

"Node.js not found" after installation

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

macOS Issues

"App cannot be opened" error

xattr -d com.apple.quarantine installer-macos

Or use System Preferences → Security → Open Anyway

For more help, see the Troubleshooting Wiki Page


📸 Screenshots

Server Status Embed

Real-time Minecraft server status with player count and latency

Setup Menu

Interactive setup menu with multiple configuration options


🔒 Security & Privacy

Is this installer safe?

✅...

Read more