"Another launcher? How original. This one at least works."
Custom Free Realms launcher built with PySide6 for offline play, OSFR login, server management, and portable distribution.
"You click button. Game starts. Revolutionary."
FreeRealmsJS Launcher is a modern, customizable launcher for running the Free Realms client with:
- Offline/local server support
- OSFR login integration
- Custom server management
All wrapped in a single, clean interface.
"Behold... the ritual of unnecessary suffering."
The classic OSFR launcher experience:
- Click
start_launcher.bat - Nothing happens (yet)
- Question reality
- Click
start_server.bat - Suddenly...
💥 5 command prompt windows appear out of nowhere
💥 Logs start flying
💥 Something might be working
💥 Something is definitely broken
💥 You have no idea which is which
"Ah yes... clarity."
Now you just sit there:
- Waiting
- Watching black windows spam text
- Hoping you did not summon a demon instead
Eventually:
- Maybe the launcher connects
- Maybe it does not
- Maybe one window silently died 10 minutes ago
"Truly a user-friendly experience."
"Or... you click one button like a civilized being."
- Press Play
- No ritual
- No guessing
- No command prompt army invasion
Everything starts automatically:
- Server stack ✔
- Login ✔
- Client ✔
"Same result. Fewer existential crises."
"Yes, it has features. Try not to be overwhelmed."
- 🎮 Custom Free Realms launcher UI (PySide6)
- ⚡ One-click offline/local server startup
- 🌐 OSFR server login support
- 🧩 Custom server list (add/edit/remove)
- 📦 Portable build workflow (PyInstaller)
- 💬 Discord Rich Presence
- 🎨 Themed UI with custom fonts and icons
- 🔔 Built-in popup / overlay system
- 📊 Server status display
Status: Online | Players: X - 🛑 Game state detection with Play / Stop Game
"Even you can manage this. Probably."
On first launch:
- Set your Display Name
- Select your Free Realms folder /
FreeRealms.exe
"No servers? No problem. I'll just make some."
Automatically starts the local stack:
- Login server
- Gateway
- Auth bridge
➡️ One click → fully local Free Realms
"Ah yes, other humans. How unfortunate."
- Login to OSFR servers
- Built-in popup authentication system
"Control everything. Like a responsible wizard. Or not."
- Add new servers
- Edit server name and address
- Protect default profiles
- Manage everything from the UI
"It works. That already puts it above expectations."
- ✅ Offline Mode launches full local server stack
- ✅ OSFR login popup implemented
- 🚧 Browser profile support (coming soon)
- ✅ Server list fully manageable
- ✅ Game state detection (Play → Stop Game)
- ✅ Client process detection
"Magic. Fine. Python."
- Python + PySide6
- Modular file structure
- PyInstaller packaging
- Runtime extraction / bundled asset support
- Includes:
- assets
- fonts
- icons
"Because the original launcher is gone. And we have standards."
This launcher exists to:
- Modernize the Free Realms launching experience
- Simplify offline/local server usage
- Manage multiple server profiles in one place
- Enable easy portable distribution
"No, this is not official. Obviously."
- Community / preservation project
- Free Realms officially shut down in 2014
- Projects like OSFR keep it alive
"If something breaks, it is probably your fault. But fine... open an issue."