WeeXnes/minecraft_server_manager
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
a minecraft server manager for the web written in Nuxt3
11 commits 1 branch 0 tags 428 KiB
Find a file
WeeXnes 1b1ebf4b9a added LICENSE
2025-06-12 18:10:52 +00:00
.password_hash_gen added authentication 2025-06-07 21:13:57 +02:00
core added authentication 2025-06-07 21:13:57 +02:00
img updated README.md and changed default password 2025-06-12 20:06:56 +02:00
middleware added authentication 2025-06-07 21:13:57 +02:00
pages added authentication 2025-06-07 21:13:57 +02:00
public initial commit 2025-03-01 12:00:12 +01:00
server added authentication 2025-06-07 21:13:57 +02:00
types added file upload and checksum checks 2025-03-05 13:08:04 +01:00
util added authentication 2025-06-07 21:13:57 +02:00
app.vue initial commit 2025-03-01 12:00:12 +01:00
ecosystem.config.js added pm2 start config 2025-03-06 05:23:16 +01:00
LICENSE added LICENSE 2025-06-12 18:10:52 +00:00
nuxt.config.ts added file upload and checksum checks 2025-03-05 13:08:04 +01:00
package.json updated README.md and changed default password 2025-06-12 20:06:56 +02:00
panel.config.ts updated README.md and changed default password 2025-06-12 20:06:56 +02:00
README.md updated README.md and changed default password 2025-06-12 20:06:56 +02:00
tailwind.config.js initial commit 2025-03-01 11:59:31 +01:00
tsconfig.json initial commit 2025-03-01 12:00:12 +01:00

README.md

🌐 Minecraft Server Panel

A sleek and modern Minecraft server manager built with Nuxt for ease of use. Features include live console output via log polling, full server configuration, and intuitive control — all from your browser.

Dashboard View Edit Server View

🚀 Features

  • 🖥️ Manage Multiple Servers
    Add, edit, start, and stop Minecraft servers through a modern web interface.

  • 🎮 Server Configuration
    Configure difficulty, game mode, max players, render/simulation distance, PVP toggle, command blocks, and more.

  • 📡 Live Console Output
    Real-time output is streamed by polling the logs/latest.log file — no need for RCON or WebSockets.

  • 🔐 Password-Protected Admin Access
    Protect access to the panel using a configurable admin password.

  • 🧭 Modern UI/UX
    Fully responsive dark interface designed with Tailwind CSS and Nuxt 3.

  • 💾 Persistent Settings
    All server configurations are saved and restored between sessions.

⚙️ Server Configuration Options

  • Difficulty: peaceful, easy, normal, hard
  • Game Mode: survival, creative, adventure, spectator
  • Slots: Max player count
  • Render Distance & Simulation Distance: In chunks
  • Booleans: Enable/disable PVP, command blocks, etc.
  • Extras: Upload a custom server banner image

🧪 Tech Stack

  • Frontend: Nuxt 3 + Tailwind CSS
  • Backend: Node.js via Nuxt server routes (for serving the panel and handling server commands)
  • Real-Time Console: Filesystem polling of logs/latest.log (no need for RCON or WebSockets)
  • Minecraft Integration: Designed for PaperMC or compatible server JARs (like Spigot or Bukkit)

📦 Getting Started

Prerequisites

  • Node.js ≥ 16
  • Java 17+ (for running Minecraft)
  • Minecraft server JAR (e.g. paper-1.20.6.jar)
  • PM2 for process management (optional but recommended)

Installation

git clone https://git.weexnes.dev/WeeXnes/minecraft_server_manager.git
cd minecraft_server_manager
npm install

Development Mode

npm run dev

🔐 Admin Password Setup

By default, the admin password is: admin

You can set a custom admin password using the following command:

npm run password_gen <your_password>

This securely stores the hashed password in panel.config.ts so it can be used for login.

🚀 Production Mode (PM2)

  1. Build the app:
npm run build
  1. Start it with PM2:
pm2 start

This uses the configuration in ecosystem.config.js to launch the Nuxt server from the build output.

🔒 Security

This panel is intended for local or LAN use If hosting publicly:

  • Use HTTPS with a reverse proxy (e.g. Nginx or Caddy)