# 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.