🎮 Minecraft Local Server GUI

The ultimate tool for installing and managing Minecraft servers — beautiful, modern, and effortless.

---

⬇️ Download & Install

One-click installation — No Python or Java required!

Platform	Download
Windows	📦 Download Installer (.exe)
Linux	📦 Download AppImage (.AppImage)

Note: The app automatically downloads and manages Java for you. Just install and play!

---

✨ Features

🚀 Server Management One-click server creation — Vanilla, Paper, Spigot, Forge Multiple server profiles — Switch between servers instantly Live console with real-time logs and command input Start/Stop controls with visual status indicators Server Conflict Guard — Prevents running multiple servers simultaneously with an integrated stop-and-switch flow

☕ Automatic Java Zero configuration — Java 8/17/21 downloaded automatically Smart detection — Matches Java version to Minecraft version No more errors — Eliminates UnsupportedClassVersionError Isolated installations — Won't affect your system Java

📊 Dashboard Real-time stats — CPU, RAM, and uptime monitoring One-Click Public Server — Use Pinggy (Experimental) to share your server globally via SSH tunnel Region Selection — Choose between EU, US, and Asia for best latency Local IP display — Easy LAN connection for friends Quick command input — Send commands from dashboard 🧩 Mods Mod search & install — browse mods and install them in one click Installed mods list — see what is currently installed Smart warning for non-modded servers — Vanilla/Paper show a hint to install a mod loader (Setup Wizard) 🌍 Worlds & Backups World list with last modified time Fast loading — world sizes are computed in the background and cached One-click backups — create ZIP backups and keep them inside your server folder

⚙️ Configuration Visual settings editor — No file editing required server.properties GUI — All options organized by category RAM allocation — Customize min/max memory per server Player management — Op, ban, whitelist with one click 👥 Players Accurate online players — player counter is tracked from server logs and /list Cleaner console — internal /list output is hidden from the console UI Faster refresh — avoids full UI reloads during periodic updates

---

🎨 Modern UI

Built with React and Tailwind CSS, featuring:

• 🌙 Dark theme — Easy on the eyes
• ✨ Glassmorphism — Blurred, translucent panels
• 🎬 Smooth animations — Powered by Framer Motion
• 📱 Responsive layout — Scales to any window size

---

🔧 Tech Stack

Layer	Technology
Frontend	Electron + React + Vite
Styling	Tailwind CSS + Framer Motion
Backend	Python + FastAPI + Uvicorn
Packaging	electron-builder (GitHub Actions CI/CD)
Automation	GitHub Actions (Auto-Release on Tag)

---

🛠️ Development Setup

Want to contribute or run from source?

# Clone the repository
git clone https://github.com/CalaKuad1/Minecraft-Local-Server-GUI.git
cd Minecraft-Local-Server-GUI

# Backend setup
cd backend
python -m venv venv
venv\Scripts\activate  # Windows
pip install -r requirements.txt

# Frontend setup
cd ../electron-app
npm install

# Run in development mode
npm run dev

Building the Installer (Production)

Local build (Windows/macOS detects platform automatically):

cd electron-app
npm run electron:build

Automated Multi-platform Release: This project is configured with GitHub Actions. To trigger a new release with Windows and Linux binaries:

1. Bump version in package.json
2. Push a tag: git tag v1.1.x && git push origin v1.1.x
3. GitHub will build and publish everything automatically!

---

📋 Requirements

For Users (Installer)

• Windows 10/11 (64-bit)
• Linux (Any disto supporting AppImage or .deb)
• Internet connection (for initial Java download)
• ~500MB disk space

For Developers

• Node.js 18+
• Python 3.8+
• npm or yarn

---

❓ FAQ

Why is it downloading Java?

The app automatically downloads the correct Java version for your Minecraft server. This is sandboxed and won't affect your system Java installation.

Can my friends connect to my server?

For LAN: Share the Local IP shown in the dashboard.
For Internet: Use a tunneling service like playit.gg (recommended) or configure port forwarding on your router.

Is the UI available in English?

Yes — the app UI and system messages are in English.

Where are my servers stored?

Server files are stored in the location you choose during setup. App configuration is saved in %APPDATA%/MinecraftServerGUI.

How do I import an existing server?

Click "Add Server" → "Use Existing" → Select your server folder. The app will auto-detect the server type and version.

---

📄 License

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

---

⭐ Support

If this project helped you, please star the repository ⭐
It helps others discover the tool and motivates development!

Made with ❤️ by CalaKuad1