MSM — Minecraft Server Manager

One desktop app for your entire Minecraft server lifecycle — create, import, mod, modpack, tunnel, play.

Create servers from the official Mojang / Fabric / Forge / NeoForge / Quilt APIs · search & install mods from Modrinth and CurseForge · expose your server through ngrok — all wrapped in one clean, dark-themed desktop app.

---

Features

Create & Manage Servers

• Create New Server — choose a type, pick a version straight from the live official API, and MSM downloads the real server file for you:

  Type	Source	What you get
  Vanilla	Mojang piston-meta	server.jar, SHA-1 verified
  Fabric	meta.fabricmc.net	runnable launcher jar
  Quilt	meta.quiltmc.org	runnable launcher jar
  Forge / NeoForge	official maven	installer jar

• Import Existing Server — point MSM at any folder; it detects the Minecraft version, loader, mods count, world, EULA state and port before you confirm.

• Live server cards with status dot, version, loader, port and RAM.

• Remove any server: keep the files on disk, or wipe the folder — always behind a double confirmation.

Mods

• Search Modrinth (live) and CurseForge (with API key) in one place.
• Filter by Minecraft version, loader, category; sort by relevance, downloads or last update.
• Details view + version picker with compatibility validation — nothing is installed that doesn't match your server's MC version and loader.
• Required dependencies are resolved automatically, with an explicit "Install Dependencies?" prompt first.
• Duplicate protection: Update / Keep Existing / Cancel — never a silent overwrite.
• Per-server mod list: enable / disable, remove (with dependents warning), one-click update checks.

Modpacks

• Import .mrpack (Modrinth) or MSM archives; export your own pack that automatically excludes worlds, logs and runtime junk.
• Visual builder: metadata, mod list with per-mod version lock, export and install-to-server.
• Installing to an existing server shows a full summary with a Backup and Install option.

Downloads

Every byte MSM fetches — server jars, loaders, mods, pack files — flows through one central download manager: queue, progress & live speed, SHA-1 verification, automatic retries, pause/resume, cancel. Watch everything on the Downloads page.

Networking & Public Access

• Network interface discovery, bind-address profiles (localhost only / LAN), smart port checking with process detection.
• One-click Test Local / Test LAN / Test Public.
• Windows Firewall helper scoped to MSM-created rules only — each change is confirmed and requires administrator rights.
• Tunnels: go public without touching your router via ngrok (auto-reconnect built-in), with more providers planned.

Built-in Safety

• All keys & tokens stored in the Windows Credential Manager — shown masked, revealed only on demand, never written to logs or files.
• Destructive actions (delete server, remove rule, erase folder) always require explicit confirmation.
• Downloaded files are hash-verified before installation; compatibility is validated against your server's Minecraft version and loader.

---

Quick Start

git clone https://github.com/bimnova001/MSM.git
cd minecraft-server-manager
pip install -r requirements.txt
python main.py

Your first server in 60 seconds:

1. SERVER → + Add Server → Create New Server
2. Pick a type — the version list loads from its official API
3. Choose a directory, RAM and port → tick the EULA box → OK
4. Watch the download finish on the DOWNLOADS page ✔

Optional extras:

• Go public via ngrok — install the ngrok agent, paste your authtoken under SETTINGS → Tunnel Providers, then NETWORK → Public Access → Start Tunnel.
• Enable CurseForge search — add an API key under SETTINGS → API Keys.

---

Roadmap

• Server runtime — start / stop / restart with realtime console & commands
• server.properties editor (friendly GUI + raw mode)
• File browser, player list, resource monitor
• Backup & restore service
• CurseForge modpack installer
• Light theme

---

Disclaimer

MSM is not affiliated with, endorsed by, or associated with Mojang Studios, Microsoft, Modrinth, CurseForge, Fabric, NeoForge, Quilt or Forge. Running a public Minecraft server means you agree to the Minecraft EULA — MSM writes eula.txt for convenience, but accepting it remains your responsibility.

_{built for people who just want their server up}

This repo was use to test Ai model coding but don't worry I already test the code