Skip to content

Gamer100309/MC-Server-Status-Bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🤖 Minecraft Multi-Server Status Bot v5.1.0

Ein hochprofessioneller Discord-Bot für das Minecraft-Server-Monitoring mit Multi-Language-Support, jetzt inklusive Universal Cross-Platform Installer.

GitHub Release Platform License


✨ Features

  • 🚀 Universal Cross-Platform Installer – Automatische Einrichtung für Windows, Linux & macOS
  • 🌍 Multi-Guild Support – Ein Bot kann beliebig viele Discord-Server gleichzeitig bedienen
  • 🌐 Multi-Language System – Deutsch & Englisch out-of-the-box (einfach erweiterbar)
  • 🎨 Vollständig anpassbar – Farben, Emojis, Buttons und Texte frei konfigurierbar
  • 📊 Live Status Monitoring – Automatische Updates für Java- und Bedrock-Server
  • 🖼️ Server Icons – Automatisches Abrufen und Speichern von Server-Favicons
  • 🔧 30+ Debug Tools – Professionelles Testing & Fehlersuche integriert
  • ⚙️ Setup via Discord – Konfiguration über Slash-Commands, kein JSON-Editieren nötig
  • 🔐 Permissions System – Granulare Steuerung der Verwaltungsrechte

📦 Quick Installation

Windows

One-Click Installer:

⬇️ Download for Windows x64

  1. Download the installer
  2. Double-click the .exe file
  3. Follow the installation wizard
  4. Done! 🎉

Linux

One-Line Install (Recommended):

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

Automatically detects your architecture (x64 or ARM64) and installs the correct version!

Manual Download:


macOS

Community Support - Not officially tested, but installers are provided:

Note: macOS blocks unsigned binaries. See installation guide for instructions.


🛠️ Manual Installation

If you prefer to install manually or the installer doesn't work for your system:

# 1. Clone the repository
git clone https://github.com/Gamer100309/MC-Server-Status-Bot.git
cd MC-Server-Status-Bot/Mc\ Server\ Stats\ Bot

# 2. Install dependencies
npm install

# 3. Configure your bot token
# Copy global-config.example.json to global-config.json
# Edit global-config.json and add your Discord Bot Token

# 4. Start the bot
node index.js

💡 Need help creating a Discord Bot?
See our Discord Bot Setup Guide


🎯 Commands

Once the bot is running, use these slash commands in Discord:

Command Description
/setup Interactive setup wizard (add/remove servers)
/reload Reload configuration & restart monitoring
/refresh Recreate all status messages
/botinfo Show bot statistics and information
/checkperms Verify bot permissions in current channel

🖥️ Platform Support

Platform Architecture Status Download
Windows x64 ✅ Full Support Download
Linux x64 ✅ Full Support Download
Linux ARM64 ✅ Full Support Download
macOS Intel (x64) ⚠️ Community Download
macOS Apple Silicon ⚠️ Community Download

🌍 Language Support

Currently supported languages:

  • 🇬🇧 English
  • 🇩🇪 German (Deutsch)

Want to contribute a translation?
Check out our Translation Guide and submit a Pull Request!


📚 Documentation

Complete documentation is available in our Wiki:

🔗 Visit the Full Wiki

Quick Links:

🚀 Getting Started

📖 User Guide

🌍 Contributing

🔧 Development


🧪 Testing & Debugging

The bot includes a comprehensive test suite with 30+ debug tools:

Windows:

Test_all_debug_tools.bat

Linux / macOS:

./Test_all_debug_tools.sh

Individual Tests:

node Debug/token-validator.js
node Debug/config-validator.js
node Debug/network-test.js
# ... and many more

See Debug Tools for complete documentation.


📸 Screenshots

Server Status Embed

Real-time Minecraft server status with player count and latency

Setup Menu

Interactive setup menu with multiple configuration options


🤝 Contributing

We welcome contributions from the community!

Translation Contributions

Adding a new language translation? Please use our Pull Request template and include the Language File label.

Bug Reports & Feature Requests

Development

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

GNU General Public License v3.0

Permitted:

  • ✅ Commercial use
  • ✅ Modification
  • ✅ Distribution
  • ✅ Private use

⚠️ Conditions:

  • Modified versions must also be licensed under GPL v3
  • Original author (Gamer100309 | RedCity Industries) must be credited
  • Source code must be disclosed

See LICENSE file for full details.


📋 System Requirements

For running the bot:

  • Node.js 18+ and npm
  • Discord Bot Token (How to create)
  • Internet connection

Supported Operating Systems:

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

🙏 Credits & Info

Created by RedCity Industries | Gamer100309

  • 🤖 Version: v5.1.0
  • 📅 Release Date: December 25, 2025
  • 🔧 Engine: discord.js v14 & minecraft-server-util v5
  • 📜 License: GNU GPL v3.0

Special Thanks:

  • Discord.js team for the excellent library
  • minecraft-server-util developers
  • All contributors and testers
  • The Discord & Minecraft communities

⭐ Support This Project

If this bot helps you:

  • Star this repository on GitHub
  • 📣 Share with other Minecraft server owners
  • 🐛 Report bugs to help improve the bot
  • 💡 Suggest features you'd like to see
  • 🌍 Contribute translations in your language
  • 🤝 Submit pull requests with improvements

📞 Support & Community


Made with ❤️ by RedCity Industries

Free & Open Source Minecraft Tooling

🎄 Happy Holidays & Happy Hosting! 🎮

About

🤖 Multi-Server Minecraft Status Bot with Discord.js | Multi-Guild Support | Multi-Language | 30 Debug Tools | GPL v3.0

Resources

Stars

Watchers

Forks