ServerWatch - Minecraft Server Status Monitor

A modern, real-time Minecraft server status monitoring application with a beautiful UI and powerful features.

Features

• 🚀 Real-time server status monitoring
• 🔍 Search any Minecraft server by IP or domain
• 📊 Live player counts and server information
• 🌐 Popular server tracking (Hypixel, Mineplex, etc.)
• 📱 Fully responsive design
• ⚡ Fast API responses with caching
• 🎨 Modern glassmorphism UI design

Quick Deploy to Railway

Manual Setup

Prerequisites

• Node.js 16 or higher
• npm or yarn

Installation

1. Clone the repository:

git clone <your-repo-url>
cd serverwatch

2. Install dependencies:

npm install

3. Start the development server:

npm run dev

4. Open your browser and navigate to http://localhost:3000

Production Deployment

For production, use:

npm start

Project Structure

serverwatch/
├── public/
│   └── index.html          # Frontend HTML file
├── server.js               # Express server and API routes
├── package.json            # Dependencies and scripts
├── railway.toml            # Railway deployment config
└── README.md               # This file

API Endpoints

GET /api/servers

Returns status for popular Minecraft servers.

Response:

[
  {
    "name": "Hypixel Network",
    "host": "mc.hypixel.net",
    "port": 25565,
    "online": true,
    "players": 47892,
    "maxPlayers": 200000,
    "version": "1.20.4",
    "motd": "Hypixel Network",
    "ping": 45
  }
]

POST /api/server/check

Check the status of any Minecraft server.

Request Body:

{
  "address": "example.com:25565"
}

Response:

{
  "name": "example.com",
  "host": "example.com",
  "port": 25565,
  "online": true,
  "players": 23,
  "maxPlayers": 100,
  "version": "1.20.4",
  "motd": "A Minecraft Server",
  "ping": 78
}

Environment Variables

The application uses the following environment variables:

• PORT - Port to run the server on (default: 3000)

Railway Deployment

1. Connect your GitHub repository to Railway
2. Railway will automatically detect the Node.js application
3. The railway.toml file configures the deployment settings
4. Your app will be available at https://your-app-name.railway.app

Local Development

1. Install dependencies: npm install
2. Start development server: npm run dev
3. The server will restart automatically when you make changes

Technologies Used

• Backend: Node.js, Express.js
• Minecraft API: minecraft-server-util
• Frontend: Vanilla HTML/CSS/JavaScript
• Deployment: Railway.app
• Styling: Custom CSS with glassmorphism effects

Features in Detail

Server Search

• Search any Minecraft server by IP address or domain
• Supports custom ports (e.g., play.example.com:25566)
• Real-time status checking with detailed information

Popular Servers

• Pre-configured monitoring for major Minecraft networks
• Automatic status updates every 30 seconds
• Player count tracking and historical data

Modern UI

• Glassmorphism design with backdrop blur effects
• Smooth animations and hover effects
• Fully responsive for mobile and desktop
• Dark theme optimized for gaming

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Commit your changes: git commit -am 'Add feature'
4. Push to the branch: git push origin feature-name
5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For support and questions:

• Open an issue on GitHub
• Check the Railway deployment logs for errors
• Ensure your server allows connections on the specified port

Changelog

v1.0.0 (2025)

• Initial release
• Real-time server monitoring
• Custom server search
• Popular server tracking
• Modern responsive UI