Documentation
Everything you need to know about using MC Status to monitor Minecraft servers, create custom MOTDs, and integrate our services into your applications.
API Documentation
Integrate our API into your applications
MOTD Editor Guide
Learn how to create custom server MOTDs
FAQ
Frequently asked questions
Getting Started
Checking Server Status
MC Status makes it easy to monitor any Minecraft server in real-time. Here's how to get started:
Navigate to the Homepage
Visit the main page and you'll see the server status checker.
Enter Server Details
Input the server hostname/IP (e.g., "mc.hypixel.net") and select the server type (Java or Bedrock).
Complete Verification
Complete the Cloudflare Turnstile verification to prevent abuse.
View Server Status
Get real-time information including player count, version, MOTD, server icon, and response time.
Shareable URLs
Each server check generates a unique URL (e.g., /server/mc-hypixel-net) that you can bookmark or share with others.
MOTD Editor Guide
The MOTD (Message of the Day) editor allows you to create custom server messages with colors, formatting, and special characters. Perfect for server owners who want to make their server stand out.
Features
Color Picker
Choose from all 16 Minecraft colors including RGB/Hex colors (1.16+)
Text Formatting
Apply bold, italic, underline, strikethrough, and obfuscated effects
Live Preview
See exactly how your MOTD will look in-game with authentic Minecraft font
Pre-made Templates
Start with popular templates and customize them to your liking
Export Options
Copy as formatted JSON or plain code for server.properties
Special Characters
Insert Unicode characters, symbols, and Minecraft-specific icons
How to Use
- Navigate to the MOTD Editor
- Type your message in the text editor (supports up to 2 lines)
- Select text and apply colors/formatting using the toolbar
- Preview your MOTD in real-time
- Copy the generated code and paste it into your
server.propertiesfile - Restart your Minecraft server to apply changes
Server Version Compatibility
RGB/Hex colors require Minecraft 1.16+. Legacy color codes (§) work on all versions. Make sure your server version supports the features you use.
Frequently Asked Questions
Why is there a 40-second cooldown between checks?
The cooldown prevents abuse and reduces server load. Server status doesn't change frequently, so checking every 40 seconds provides up-to-date information while being respectful to Minecraft servers.
Can I check Bedrock Edition servers?
Yes! Our checker supports both Java Edition and Bedrock Edition servers. Simply select "Bedrock" from the server type dropdown when checking status.
Why do I need to complete Turnstile verification?
Cloudflare Turnstile helps us prevent automated abuse and bot attacks. It's a privacy-friendly alternative to traditional CAPTCHAs and only takes a second to complete.
What does "Server is offline or unreachable" mean?
This error can occur for several reasons:
- The server is actually offline or not running
- The hostname/IP address is incorrect
- The port number is wrong (default: 25565 for Java, 19132 for Bedrock)
- Firewall or network issues preventing connection
- The server has query disabled in server.properties
How accurate is the player count?
The player count is as accurate as the server reports it. Most servers report accurate numbers, but some may have modified their query response to show fake player counts.
Can I use this to monitor multiple servers?
Yes! You can bookmark or save the URL for each server you check. Each server gets a unique URL that you can return to at any time. We're also working on a favorites feature for easier access.
Is there an API I can use?
Yes! Check out our API Documentation for details on integrating server status checks into your own applications.
My MOTD colors don't show up in-game. Why?
Make sure you're copying the code correctly into your server.properties file. The MOTD should be on a single line. Also, check that your server version supports the color codes you're using (RGB/Hex requires 1.16+).
Is this service free?
Yes, completely free! This is an open-source project. You can even self-host it if you want. Check out our GitHub repository for more information.
How can I report bugs or request features?
We welcome feedback! Please open an issue on our GitHub Issues page. Include as much detail as possible to help us understand and address your concern.
Troubleshooting
Common Issues
Slow Response Times
If server checks are taking a long time, it could be due to:
- High latency to the target server (check from closer location)
- Server is under heavy load
- Network congestion or routing issues
- Server firewall slowing down query responses
Rate Limit Errors
If you're seeing rate limit errors:
- Wait for the cooldown period to expire (shown in error message)
- Don't spam the check button
- Consider using our API with proper caching if you need frequent checks
Turnstile Verification Fails
If verification keeps failing:
- Make sure JavaScript is enabled in your browser
- Try a different browser or clear cache/cookies
- Disable VPN or proxy temporarily
- Check if your firewall is blocking Cloudflare services
Need More Help?
Can't find the answer you're looking for? We're here to help!