Desktop launcher and server manager for Minecraft on Windows and Linux.
Create Java or Rust servers on your own PC, invite friends without touching router settings, inspect players in 3D, and explore your world map right from the app.
Releases · Release Notes · Changelog · Contributing · Architecture
If you just want to host a Minecraft world on your Windows or Linux PC for friends, or quickly spin up a test server for a modpack, ObserverLauncher keeps everything in one desktop window. You do not need an account, a cloud subscription, Docker, or a separate web panel, and your worlds never leave your computer.
- Download the Windows installer (
.exe) or Linux package (.AppImage) from Releases. - On first launch, pick your language and choose between Beginner (keeps only the essentials visible) or Advanced (shows every tool).
- Click Create new server, pick a folder, choose your server software (Vanilla, Paper, Fabric, Forge, Pumpkin, and more), and pick a Minecraft version.
- Click Start. If Java is missing or the wrong version for that server, ObserverLauncher downloads a portable OpenJDK build (Java 8, 17, 21, or 25) automatically. Native Rust servers like Pumpkin and Horizon run without Java at all.
- Play over local Wi-Fi using your LAN address, or turn on the built-in Playit.gg or Pinggy tunnel so friends can join over the internet without router port forwarding.
- Filter live console logs (
INF,WRN,ERR,CMD), search output, click any player name in the log to jump straight to their inspector, or export logs. - Monitor real-time TPS, MSPT, CPU, and RAM charts from 15 minutes up to 30 days with memory-leak and tick-drop diagnostics.
- When a server crashes, Crash Doctor reads the log and explains common causes such as wrong Java versions, missing dependencies, or out-of-memory errors.
New hosts can keep Beginner mode turned on to hide advanced tabs and Java memory sliders, leaving just Overview, Console, Players, Server properties, and Launcher settings. While running, Overview shows a simple "Your server is running!" box where you can switch between your Wi-Fi address and your internet tunnel in one click. You can toggle between Beginner and Advanced anytime in Launcher settings > Personal.
Personal settings also include 7 UI languages (en, vi, es, pt-BR, de, ru, zh-CN), a Lite animation mode for older PCs, per-server accent colors and icons in the sidebar, and Custom Resource Pack (.zip) support so 3D player armor and inventory icons match your resource pack.
- Run multiple servers in separate folders, tag them into sidebar groups, and start or stop everything at once.
- If the launcher closes or restarts while a server is still running, it detects the active server on startup and lets you reconnect without losing uptime.
- Built-in Playit.gg (Java TCP) and Pinggy (Bedrock UDP) tunnels let friends join without opening router ports.
- If Geyser or Floodgate is installed for Bedrock crossplay (phones and consoles), the launcher checks your config for common port and auth mistakes and can fix them in one click with a backup.
- Support for both standard Java servers and native Rust engines (Pumpkin and Horizon, typically using ~100 to 250 MB RAM with no Java required).
- Browse and manage large servers comfortably with 25 items per page pagination across plugins, mods, and datapacks, plus instant filtering and enable/disable toggles.
- Search and install plugins, mods, datapacks, and modpacks directly from Modrinth (and CurseForge when you add your own API key in settings).
- Check for updates (with one-click rollback if something breaks), import or export
.mrpackbundles, and detect duplicate mods, missing dependencies, or wrong-loader jars before startup. - Edit plugin configs in the built-in folder tree editor, tweak
server.propertieswith search and saved snapshot diffs, or manage backend routes invelocity.tomlfor Velocity proxies.
- Create manual world ZIP backups or turn on Auto-backup (
15m,30m,1h, or a custom interval) with automatic cleanup of old auto-backups. - Rename worlds, inspect or set seeds, adjust gamerules, and reorder datapacks.
- Enable Auto-restart on crash (with retry limits and delay) and set daily/weekly Start & Stop schedules.
- Send Discord (or generic JSON) webhook alerts when the server starts, stops, crashes, or when players join and leave.
- View each player in interactive 3D with their Mojang skin, outer skin layers, and equipped armor (including modded armor sets when textures exist in installed mods).
- Inspect players while they are online even if they have not saved a
.datfile yet, which works smoothly on first joins and native Rust servers. - Browse the 9x4 inventory and Ender Chest grid with item search, sorting, enchantments, and colored tooltips.
- When the server is stopped, edit saved health, hunger, XP, gamemode, or clear inventory (a backup is kept automatically). While live, run
/op,/whitelist,/tp,/kick, or/banstraight from the toolbar.
- Explore your world directly from saved
.mcaregion files without installing Dynmap or BlueMap: see biomes, terrain relief, surface blocks, water, structures (across legacy 1.12–1.17 and modern 1.18–1.21.11 / 26.x saves), and a 1:8 Overworld/Nether portal coordinate converter. - Turn on Low-Resource Mode on the map for lighter CPU/RAM usage, toggle Cheat Mode in settings to keep survival exploration fair by default, import/export Xaero's Minimap and JourneyMap waypoints, and click players or markers to
/tp.
| Software | Runtime | Ecosystem | Telemetry |
|---|---|---|---|
| Paper / Purpur / Leaf / Folia | Java 17 to 25 | Bukkit, Spigot, Paper plugins | Live TPS, MSPT, heap memory |
| Fabric / Quilt | Java 8 to 25 | Fabric mods | Player metrics, process telemetry |
| Forge / NeoForge | Java 8 to 25 | Forge & NeoForge mods | Live TPS, mod dependency checks |
| Spigot / CraftBukkit | Java 8 to 25 | Bukkit plugins | Heap memory, player list |
| Vanilla | Java 8 to 25 | Official Mojang server | Player list, console stream |
| Velocity | Java 17 to 25 | Multi-server proxy | Proxy routes, connection status |
| Pumpkin | Rust Native | Vanilla protocol clean-room | Process RAM/CPU, console TPS & MSPT |
| Horizon | Rust Native | MC 26.3 clean-room | Process RAM/CPU, server.toml sync |
All backend modules run without an Electron window (src/headless.js), enabling CLI control, remote dashboards, container export, metrics scraping, and local MCP automation.
observer status # Active server status, jar, and Java runtime
observer start --instance survival # Start a specific server instance
observer players # List online, whitelisted, op, and banned players
observer backup # Create a ZIP backup
observer doctor # Run crash, console, and performance diagnostics
observer docker create --type paper # Generate Dockerfile and docker-compose.ymlRun observer --help for full command flags (--json, --instance <id>, templates, modpack verify|build).
Enabled under Launcher settings > Integrations (off by default):
- Serves an in-memory web dashboard at
/(/ui) with live SSE streaming, protected by constant-time Bearer token auth, brute-force lockout (15 fails / 5m), rate limiting (300/min), Origin/Host checks (with optionalremoteAllowedHostsfor reverse proxies), and IP/CIDR allowlisting. - Endpoints:
GET /health,GET /events(SSE),GET /instances,GET /status,GET /metrics,GET /backups,GET /console,GET /players, plusPOST /action(start,stop,force_stop,restart,kick,backup,whitelist_add,whitelist_remove,ban,unban) andPOST /command(disabled when Read-only is enabled). - Binds to
127.0.0.1by default for safe tunneling over Tailscale; see docs/remote.md.
- Docker Export (Settings > Advanced): generates
Dockerfile,docker-compose.yml,.dockerignore, andREADME.docker.mdconfigured for either OpenJDK or slim native Rust binaries (./serverand./datamounts with healthcheck). - Prometheus Metrics: optional loopback-only (
127.0.0.1)/metricsendpoint for Grafana scraping.
ObserverLauncher exposes 80 server-management tools via src/mcp/bridge.js (stdio bridge forwarding to a per-launch authenticated loopback HTTP RPC server). Tools are grouped into read (always allowed), write (prompts in-app unless Auto-allow write tools is enabled), and destroy (always requires explicit GUI confirmation, disabled in Read-only mode). File reads pass through maskSecrets() to redact RCON passwords and tokens.
- Desktop platforms only: Prebuilt packages target Windows 10/11 (64-bit) and Linux
x86_64(.AppImage). There is no macOS build yet. - Built for local PCs, not 24/7 VPS clusters: Designed for hosting on a personal machine or testing modpacks locally. For multi-node Linux servers running 24/7 in Docker or Proxmox, use a dedicated web panel such as Crafty Controller or Pterodactyl.
- Native Rust engines are upstream WIP: Pumpkin and Horizon compatibility depends on upstream server progress; Bukkit/Paper plugins relying on JVM internals may not behave identically to Paper.
- OS: Windows 10/11 (64-bit) or Linux (
x86_64, glibc 2.31+) - CPU: 64-bit dual-core minimum (quad-core recommended for modded servers)
- RAM: 4 GB minimum (8 GB+ recommended for modded Java servers)
- Disk: ~1 GB for launcher files and Java runtimes, plus space for worlds and backups
- Java: Optional (auto-downloaded if missing for Java servers; not required for Pumpkin or Horizon)
The codebase uses Electron and plain Node.js without a bundler (src/ runs directly). NBT, Anvil .mca region parsing, LZ4 scheme-4 decompression, and ZIP inspection are implemented in JavaScript.
git clone https://github.com/Kag4286/ObserverLauncher.git
cd ObserverLauncher
npm install
npm start # Launch Electron app in development mode
npm test # Run unit and integration suite (185 test files)
npm run test:e2e # Run Playwright Electron E2E tests
npm run build:win # Windows installer (.exe)
npm run build:linux # Linux AppImage- Zero telemetry: Network requests happen only for server/mod/Java downloads, Mojang skin lookups, and user-enabled tunnels or webhooks.
- Renderer isolation: Windows run with
contextIsolation: trueandnodeIntegration: false, communicating strictly throughsrc/preload.js. - Filesystem boundaries: File reads, writes, and archive extractions validate canonical paths (
safeTarget) to block path traversal and Zip-Slip. - SSRF filtering: Download URLs and webhooks reject loopback, link-local, metadata endpoints, and private subnets.
Licensed under Apache-2.0.
Minecraft is a trademark of Mojang Synergies AB. ObserverLauncher is an independent open-source project and is not affiliated with Mojang or Microsoft.









