Kepler Environment

Kepler is a highly accurate emulation of the v14 (2007 era) Habbo Hotel. This was the "Peak Shockwave" era, featuring the old-school UI, BattleBall, SnowStorm, and the classic Lido.

🛠 Tech Stack

Language: Java 17+ (Eclipse Temurin)
Framework: Netty (Networking), Log4j
** Protocol**: v14 (Fusescript/Shockwave)
Client: Adobe Shockwave (requires Pale Moon 32-bit or specialized browser wrapper)

🚀 Key Features

Ranked Games: Full implementation of BattleBall and SnowStorm with rankings.
Public Rooms: Accurate public room layouts with original bots and logic (Lido diving, etc.).
Wobble Squabble: Working pool minigame.
Camera: Working photos (if configured with correct asset paths).
Sound: Trax machine and Jukebox support.

📂 Project Structure

Located in /kepler, the structure is:

kepler/
├── Kepler-Server/    # Java Server Source
├── Kepler-www/       # Web Loader Source
├── tools/            # Database schemas and tools
└── Dockerfile        # Container definition

🔌 Ports

Port	Description
`13321`	Game Server Port
`8080`	Internal Web Loader (mapped port may vary, check docker-compose)

🕹 Playing

Because Kepler targets the Shockwave era, you cannot play it in Chrome/Edge/Firefox.

Requirements:

A 32-bit browser that supports NPAPI plugins (e.g., Pale Moon 32-bit Portable).
The Adobe Shockwave Player 12 MSI/Installer.
Access the loader at http://localhost:8080/loader.php (or configured port).

🛠 Setup & Running

Use the management script:

./docker-manage.sh start kepler

This will spin up the kepler-server container and link it to the unified database.

1.9 KiB Raw Blame History