https://github.com/envid-tech/mc-server-manager-ui
A simple GUI for creating Minecraft servers in a Docker container using Portainer, MongoDB, and Velocity.
https://github.com/envid-tech/mc-server-manager-ui
css docker javascript js minecraft mongo mongodb nextjs portainer scss server ts typescript
Last synced: 6 months ago
JSON representation
A simple GUI for creating Minecraft servers in a Docker container using Portainer, MongoDB, and Velocity.
- Host: GitHub
- URL: https://github.com/envid-tech/mc-server-manager-ui
- Owner: enVId-tech
- License: mit
- Created: 2025-06-24T02:26:53.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-07-25T09:19:56.000Z (7 months ago)
- Last Synced: 2025-07-25T15:29:47.517Z (7 months ago)
- Topics: css, docker, javascript, js, minecraft, mongo, mongodb, nextjs, portainer, scss, server, ts, typescript
- Language: TypeScript
- Homepage: https://mc-server.etran.dev
- Size: 18.9 MB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# MC Server Creator & Manager
A comprehensive web application for creating, deploying, and managing Minecraft servers with advanced configuration options, real-time monitoring, and automated infrastructure management.
## 🚀 Overview
MC Server Creator is a full-stack Next.js application that provides users with a complete solution for managing Minecraft servers. From initial creation with custom configurations to ongoing management through an intuitive dashboard, this platform streamlines the entire server lifecycle.
## ✨ Features
### 🎮 Server Creation & Management
- **Multi-step Creation Wizard**: Step-by-step interface for creating custom Minecraft servers
- **Multiple Server Types**: Vanilla, Spigot, Paper, Bukkit, Purpur, Forge, and Fabric support
- **Version Support**: Minecraft 1.8 through 1.21+ with version-specific configurations
- **Advanced Configuration**: 50+ server properties including world settings, performance tuning, and player management
- **File Upload**: Plugin, mod, and world file import capabilities
### 🖥️ Dashboard & Monitoring
- **Real-time Server Status**: Live monitoring of server online/offline status
- **Server Management**: Start, stop, and delete servers with progress tracking
- **Advanced Security**: Multi-step deletion confirmation with subdomain verification
- **Auto-refresh**: Automatic dashboard updates every 60 seconds
### 📁 File Management & Editor
- **WebDAV Integration**: Browse and manage server files through the web interface
- **Built-in File Editor**: Edit configuration files directly in the browser
- **Real-time Preview**: View file contents with syntax highlighting
- **Auto-save Protection**: Unsaved changes warning when navigating away
- **File Navigation**: Breadcrumb navigation and folder browsing
### 💬 User Interface & Notifications
- **Styled Notification System**: Beautiful notifications replacing browser alerts
- **Confirmation Dialogs**: Themed modal confirmations for destructive actions
- **Real-time Feedback**: Success, error, warning, and info notifications
- **Auto-dismiss**: Smart notification timing with manual close options
- **Mobile-responsive**: Touch-friendly interface on all devices
### 🔐 Authentication & Security
- **JWT Authentication**: Secure session management with HTTP-only cookies
- **User Registration**: Account creation with validation
- **Protected Routes**: Automatic authentication checks and redirects
### 🌐 Infrastructure Integration
- **Docker Containers**: Automated server deployment via Portainer
- **Dynamic Port Allocation**: Automatic port assignment with conflict resolution
- **File System**: WebDAV integration for server file management
### 🔧 Developer Tools & Logging
- **Console Configuration**: File-specific logging controls with blacklist/whitelist modes
- **REST API Logging**: Toggleable request/response logging with detailed options
- Request/response headers and body logging
- Request timing and performance metrics
- Error-only logging mode for production
- Configurable via environment variables
- **Debug Mode**: Enhanced development logging with timestamps and colors
### 🎨 User Experience
- **Responsive Design**: Mobile-first approach that works on all devices
- **Professional UI**: Styled notifications and confirmation dialogs
- **Real-time Feedback**: Live progress tracking and status updates
- **Error Handling**: Comprehensive error messages and recovery options
- **Progressive UI**: Loading states, progress indicators, and smooth animations
- **Accessibility**: Keyboard navigation and screen reader support
## 🛠️ Technology Stack
- **Frontend**: Next.js 15, React 19, TypeScript, SCSS Modules
- **Backend**: Next.js API Routes, MongoDB, JWT Authentication
- **Infrastructure**: Docker, Portainer, WebDAV
- **UI/UX**: React Context API, Custom Notification System, Mobile-responsive Design
- **Development**: ESLint, TypeScript, SASS, Node.js 18+
## 🚦 Quick Start
1. **Clone and Install**
```bash
git clone
cd MinecraftServerCreator
npm install
```
2. **Environment Setup**
Create `.env.local` with your MongoDB, Portainer, and WebDAV credentials
3. **Start Development**
```bash
npm run dev
```
Open `http://localhost:3000`
For detailed setup instructions, see the installation guide in the project documentation.
## 📝 License
This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
## ⚠️ Legal Disclaimer
This website and repository/codebase is not an official Minecraft website and is not associated with Mojang Studios or Microsoft. All product and company names are trademarks or registered trademarks of their respective holders. Use of these names does not imply any affiliation or endorsement by them.
## 🙏 Acknowledgments
- **itzg/minecraft-server** - Docker image for Minecraft server deployment
- **Portainer** - Container management platform
- **MongoDB** - Database platform
- **Next.js Team** - Framework development
- **React Community** - Component libraries and tools