Cross-Game Infrastructure for Pokémon FireRed/LeafGreen + Emerald. A unified Randomizer experience powered by Archipelago.
-critical){kind=icon}
Project Celio is not just another randomizer; it is a full-stack infrastructure project designed to merge Kanto (FRLG) and Hoenn (Emerald) into a single, seamless experience.
By leveraging a custom fork of Archipelago and a specialized Client Launcher, we aim to solve the "Alt-Tab Fatigue" of multi-game randomizers.
Instead of running two disconnected emulator windows, Project Celio's future client will manage focus dynamically. When you step onto a warp tile in Kanto, the client automatically brings the Hoenn instance to the foreground, creating the illusion of a massive, continuous world map.
The project is built on a containerized microservices architecture ("The Factory").
| Component | Tech Stack | Role |
|---|---|---|
| The Factory | Python (Flask), Docker | Web interface for generating seeds and spawning server instances. |
| Core | Archipelago (Custom Fork) | The logic backend handling item shuffling across generations. |
| Proxy | Apache2 + Cloudflare | Reverse proxy handling secure connections and routing. |
| Client | Python / Electron | [Phase 2] The unified launcher handling save sync and focus management. |
⚠️ ACTIVELY IN DEVELOPMENTThe Network Center is currently being built. Source code, documentation, and installation instructions are coming soon.
Phase 1 (Infrastructure & Web) is currently in progress. Check the Discord for live updates.
- VPS Setup & Security Hardening
- Domain & Cloudflare DNS Propagation
- Docker Orchestration ("The Factory") Deployment
- Web Interface for "Stateless" YAML Generation
- Apache2 Reverse Proxy Configuration
- Unified Launcher development
- "Window Swapping" logic implementation (BizHawk/RetroArch)
- Save File Syncing
- User Accounts & Persistent History
- Cross-Game Leaderboards
- "Rivals" System
This is a community-driven project. We welcome "Core Engineers" to help build the bridge between regions. Contribution guidelines will be published once the core infrastructure is stable.
Distributed under the MIT License. See LICENSE for more information.
Developed with 💙 by TheLovenityJade
Pokémon is a trademark of Nintendo/Creatures Inc./GAME FREAK inc. Project Celio is a fan project and is not affiliated with Nintendo.