The ultimate tool for installing and managing Minecraft servers — beautiful, modern, and effortless.
- Permanent domain — Your server gets a permanent address like
survival.play.tudominio.appthat never changes - Auto-generated — A unique subdomain is created automatically when the tunnel starts
- Duplicate protection — Subdomains are permanently reserved for your server, never released
- Inline editing — Edit your subdomain directly in the Dashboard with availability checking
- Cloudflare DNS Proxy — Open-source Worker manages SRV records (repo:
MLSG-DNS-Worker)
- Search & filter — Search bar and level badges (CMD/INF/WRN/ERR)
- Export logs — Download console history as
.txt - Always works — REST API fallback when WebSocket is disconnected
- Premium/No Premium — Quick online-mode toggle in the Dashboard header
- Auto-restart on crash — Toggle to auto-restart server on unexpected shutdown
- Auto-Tunnel — Tunnel starts automatically with the server (toggle in Advanced)
- Boot from library — "Boot" button on server cards in the library
Earlier versions
- Server automatically restarts after unexpected shutdowns — toggle it on/off from the Dashboard header
- Up to 3 restart attempts with a 3-second delay between retries
- Export logs — Download button saves the full console history as a
.txtfile - Search & filter — Search bar and level filter (All/CMD/INF/WRN/ERR) for quick log navigation
- Always usable input — Console input stays enabled even when WebSocket is disconnected (REST API fallback)
- Logs persist across tab switches — No more losing console logs when navigating between panels
- Dashboard mini-console — REST API fallback for sending commands when WebSocket is down
- Connection status — Clear "Disconnected" indicator instead of misleading "Loading..." state
Earlier: v1.2.0 — UI Redesign & NeoForge
- Pixel art icon system — Custom 16x16 pixel icons throughout the entire UI
- Visual effects — Mouse spotlight, noise grain, magnetic buttons, abstract backgrounds
- Server Library — Redesigned grid view with search, recently opened, engine type icons
- NeoForge as a new server engine + Modpacks tab for browsing and installing from Modrinth
- Multi-Language (i18n) — English, Spanish, French, and Russian with language selector in App Settings
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!
|
|
|
|
Built with React and Tailwind CSS, featuring:
- Dark theme — Deep, high-contrast dark design
- Glassmorphism — Blurred, translucent panels
- Pixel art icons — Custom Minecraft-inspired icon set
- Smooth animations — Powered by Framer Motion
- Interactive effects — Mouse spotlight, noise grain, magnetic buttons
| Layer | Technology |
|---|---|
| Frontend | Electron + React + Vite |
| Styling | Tailwind CSS + Framer Motion |
| Backend | Python + FastAPI + Uvicorn |
| i18n | Custom React Context (en/es/fr/ru) |
| Packaging | electron-builder (GitHub Actions CI/CD) |
# 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 devcd electron-app
npm run electron:buildAutomated Multi-platform Release:
- Bump version in
package.json - Push a tag:
git tag v1.x.x && git push origin v1.x.x - GitHub will build and publish everything automatically!
- Windows 10/11 (64-bit) or Linux (AppImage / .deb)
- Internet connection (for initial Java download)
- ~500MB disk space
- Node.js 18+
- Python 3.8+
- npm or yarn
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 other languages?
Yes — the app UI is available in English, Spanish, French, and Russian. You can switch languages from App Settings.
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" in the Library, then select your server folder. The app will auto-detect the server type and version.
Where is app data stored on Linux?
On Linux, all app data is stored in ~/.minecraft_server_gui/. On Windows, it's in %APPDATA%/MinecraftServerGUI.
This project is licensed under the MIT License — see the LICENSE file for details.
If this project helped you, please star the repository
It helps others discover the tool and motivates development!
Made with love by CalaKuad1