-
Notifications
You must be signed in to change notification settings - Fork 0
FAQ
Common questions and answers about the MC Server Status Bot.
A Discord bot that monitors Minecraft servers and displays real-time status updates with player counts, latency, and server icons.
Yes! Completely free and open source under GPL v3.
- Java Edition (all versions)
- Bedrock Edition (all versions)
Unlimited! Monitor as many servers as you want.
No! The bot can run on:
- Your home PC (Windows/Linux/Mac)
- Raspberry Pi
- VPS/Cloud server
- Any computer with Node.js
Yes, but your PC must stay on. For 24/7 uptime, consider:
- VPS (cheap, $3-5/month)
- Raspberry Pi (one-time cost)
- Free tier cloud services
Very light:
- RAM: ~50-150 MB
- CPU: <1% idle, ~5% when updating
- Disk: ~100 MB
Yes! You need to create a bot on Discord Developer Portal. See Discord Bot Setup.
Yes! One bot can serve unlimited Discord servers (guilds).
Common causes:
- Bot offline
- Missing
applications.commandsscope - No permissions in channel
- Discord cache (restart Discord)
See the complete guide: How to Stop the Bot
Quick commands:
-
Windows:
taskkill /F /IM node.exe -
Linux/macOS:
pkill -f "node index.js"
Started in background mode? The bot might run as the installer binary. See the full guide.
Cause: The bot is running multiple times!
How to check:
Windows:
tasklist | findstr "node.exe"Linux/macOS:
ps aux | grep "node index.js" | grep -v grepIf you see multiple processes, you have multiple bot instances running.
Solution:
- Stop ALL bot processes - see How to Stop the Bot
- Start the bot only ONCE
- Verify only one process is running
Wait a few minutes! Discord can take 2-5 minutes to update the bot's status.
If bot is still online after 5+ minutes:
The bot is still running somewhere!
Check these locations:
- Your PC - Check Task Manager / terminal
- VPS/Server - SSH and check processes
- Another computer - Did you start it somewhere else?
- Background process - Installer binary might still be running
How to find it:
See the complete guide: How to Stop the Bot
Special checks:
Linux - Check for installer binary:
ps aux | grep "RedCity_Industries" | grep -v grep
pkill -9 -f "RedCity_Industries"Windows - Check for installer binary:
tasklist | findstr "RedCity_Industries"
taskkill /F /IM RedCity_Industries*.exeStill online? Check the logs:
tail -f logs/bot-$(date +%Y-%m-%d).logThen run a command in Discord. If the log updates, the bot is running on that machine!
MC-Server-Status-Bot/
├── global-config.json # Bot token, global settings
└── configs/
└── [guild-id].json # Per-server settings
Yes! Edit configs/[guild-id].json:
{
"updateInterval": 60000
}(60000 = 1 minute, in milliseconds)
Edit global-config.json:
{
"language": "de"
}Then run /reload
Available: en, de (more coming!)
Possible causes:
- Server is actually offline
- Wrong IP/port
- Firewall blocking queries
- Server doesn't allow status queries
Solution:
- Verify server is online
- Check IP and port are correct
- For Java: Enable
enable-query=trueinserver.properties
Default: Every 60 seconds
Customizable per guild (see configuration question above).
No, the bot shows:
- Online/Offline status
- Player count (current/max)
- Server latency
- Server icon (Java Edition)
- MOTD (Message of the Day)
Yes! Works with:
- Vanilla
- Forge
- Fabric
- Paper, Spigot, Bukkit
- Any server that responds to status queries
Yes! Edit your guild config:
{
"embedColor": "#00FF00"
}Yes! Edit your guild config:
{
"emojis": {
"online": "<:online:123456789>",
"offline": "<:offline:987654321>"
}
}Currently limited. The message format is defined in language files.
For advanced customization, edit languages/[language].json
See our Contributing Translations guide!
Yes! Edit the language file and submit a PR, or customize locally.
Currently:
- 🇬🇧 English (
en) - 🇩🇪 German (
de)
More coming! Contribute yours!
Common causes:
- Invalid bot token
- Missing dependencies
- Node.js version too old
Solution:
- Check
global-config.jsonhas valid token - Run
npm install - Update Node.js to 18+
If bot uses >300 MB:
- Restart bot
- Check for memory leaks in logs
- Update to latest version
- Report issue on GitHub
Your token is stored in global-config.json locally.
Keep it safe:
- Never commit to Git (use
.gitignore) - Don't share screenshots with token
- Regenerate if exposed
No, config files are local to your installation.
No! The bot:
- ✅ Does NOT collect user data
- ✅ Does NOT send data to external servers
- ✅ Only queries your configured Minecraft servers
- ✅ Completely open source (audit the code!)
No, this is 100% free forever.
Only if you want 24/7 uptime on a VPS.
Free options:
- Run on your PC (free, but must stay on)
- Raspberry Pi (one-time cost)
- Some cloud services have free tiers
⭐ Star the repo on GitHub!
🐛 Report bugs
🌍 Contribute translations
📣 Share with others
# Pull latest changes
git pull
# Update dependencies
npm install
# Restart botUsually no, but check the changelog for breaking changes.
Always backup configs/ before updating!
- Watch the GitHub repo
- Check [Releases(https://github.com/Gamer100309/MC-Server-Status-Bot/releases)
- Join Discussions for announcements