A standalone desktop application for managing Minecraft servers no command line, no VPS, no Docker. Java auto-downloaded on first launch. Packaged as a single Electron executable for Windows.
No prerequisites. Just download and run.
- Download
MC Server Manager Setup x.x.x.exefrom the link above - Run the installer (default settings are fine)
- Launch from the desktop shortcut or Start Menu or from the installer itself
- The app opens as a desktop window with the home dashboard
- Click New Server in the sidebar/top right or Create your first server in the middle
- Choose a type (Vanilla, Fabric, or Modpack from Modrinth(modpacks are broken currently))
- Select a Minecraft version and set RAM, then click Create
- On the server dashboard, click Start and accept the EULA
- Friends on the same WiFi can join at
192.168.x.x:25565(or wan if you portforward it)
- Download (Playit.gg and open it (from the desktop or on the start menu)
- Create your account and make sure that you verify it from you email
- On the "Where do you want to integrate Playit?" screen click on computer
- Copy the link shown on the command prompt (e.g. https://playit.gg/claim/123abcd) (use ctrl+c)
- Paste it in the text box and click "Validate & Continue", it will take a bit of time so don't worry
- On the next screen click on "Continue" (and don't worry that stuff doesn't go to me)
- Click on "Add Agent" (it'll take some time)
- Click on "Create a Tunnel"
- Give it a name click next then choose "Minecraft Java" as a Tunnel Type and click next
- Click "Next"
- To find the Local IP part follow this tutorial or this short tutorial (nor the video or the blog are mine)
- After finding the IP copy it then put it on the Local IP text box (the 1st one)
- Click "Next" then "Create Tunnel"
- It's gonna show that it's allocating your address, just wait a bit then when it shows up, copy it and give it to your friends
- On the MC Server Manager, go to your server's dashboard then switch on "Use Playit.gg instead" (P.S: The server HAS to be ON/already started)
nothing to troubleshoot yet
Default port is 8080. To change it, launch from a command prompt:
set MCSERVERGUI_WEB_PORT=9090
MC Server GUI.exe
- Node.js 18+ (nodejs.org)
- pnpm:
npm install -g pnpm - Java JDK 17+ (for running test servers)
- Git
git clone https://github.com/draftedname/minecraft_server_manager.git
cd minecraft_server_manager
pnpm install
pnpm dev
Starts the Express backend on port 3456 and Vite frontend on port 5173 with hot reload. Open http://localhost:5173.
pnpm build
npx electron-builder --win --dir
Output: dist-electron/win-unpacked/MC Server GUI.exe
pnpm build
npx electron-builder --win
Output: dist-electron/MC Server GUI Setup x.x.x.exe
| Variable | Purpose | Default |
|---|---|---|
MCSERVERGUI_WEB_PORT |
Web UI port | 8080 |
MCSERVERGUI_DATA_DIR |
Override data directory | OS sandbox |
Modpacks are currently in a broken state. The mod filtering system may install client-only mods or skip server-required mods. Some modpacks may not work at all. This is being actively worked on. Expect improvements in future updates.
- VERY BROKEN CURRENTLY Modpack installer with 3-layer filtering (Modrinth API, blacklist, JAR inspection) to skip client-only mods
- Log analysis via mclo.gs, detects crashes, mod conflicts, and common problems
- Modrinth browser search and install mods directly from the app
- Fabric loader version selection for modpacks and Fabric servers
- World management import, backup (local + Google Drive), restore, activate, and delete
- Console with color-coded output, filtering, search, and mclo.gs analysis
- File browser with text editor integration
- Playit.gg tunneling for public access without port forwarding
- Auto-Java download if not found on the system
| Layer | Technology |
|---|---|
| Desktop Shell | Electron 34 |
| Backend | Node.js, Express 5, TypeScript, Socket.IO |
| Frontend | React 19, TypeScript, Vite 6, Tailwind CSS v4, shadcn/ui |
| Monorepo | Turborepo + pnpm workspaces |
| State Mgmt | TanStack React Query v5 |
| Mods API | Modrinth REST API v2 |
| Server Jars | Mojang version manifest, Fabric meta API |
| Cloud Backup | Google Drive API v3 (OAuth 2.0) |
| Tunneling | playit.gg via Windows Service Control Manager |
| Authentication | bcryptjs, jsonwebtoken |
| Security | express-rate-limit |
| Process Monitoring | pidtree, pidusage |
| Auto-Updating | electron-updater |
| Packaging | electron-builder 25 (NSIS) |
GNU General Public License v3.0 see LICENSE.
- Email: imusingscout@gmail.com
- X: @drafted_name
- Bugs & features: GitHub Issues
- Sponsorships: email above