58 lines
1.9 KiB
Markdown
58 lines
1.9 KiB
Markdown
|
# 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:**
|
||
|
|
|
||
|
|
1. A 32-bit browser that supports NPAPI plugins (e.g., **Pale Moon 32-bit Portable**).
|
||
|
|
2. The Adobe Shockwave Player 12 MSI/Installer.
|
||
|
|
3. Access the loader at `http://localhost:8080/loader.php` (or configured port).
|
||
|
|
|
||
|
|
## 🛠 Setup & Running
|
||
|
|
|
||
|
|
Use the management script:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
./docker-manage.sh start kepler
|
||
|
|
```
|
||
|
|
|
||
|
|
This will spin up the `kepler-server` container and link it to the unified database.
|