🎮 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)

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	☕ 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	⚙️ 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

---

🎨 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 (NSIS installer)

---

🛠️ 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

cd electron-app
npm run electron:build
# Output: electron-app/release/Minecraft Local Server GUI Setup 1.0.0.exe

---

📋 Requirements

For Users (Installer)

• Windows 10/11 (64-bit)
• 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.

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