Files
Archive/documentation/HAVANA.md

59 lines
1.9 KiB
Markdown

# Havana Environment
**Havana** is a unique emulator project targeting the "Transition Era" (v31+ from ~2009). This was the period where Habbo began introducing Flash elements alongside Shockwave, leading up to the full Flash migration.
## 🛠 Tech Stack
- **Language**: Java 17
- **Base**: Originally a fork of Kepler, evolved to support v31.
- **Client**: Supports dual connection:
- **Shockwave**: For v31 specific features.
- **Flash**: For r39+ era connections.
## 🚀 Key Features
- **Hybrid Support**: One of the few emulators attempting to bridge the gap between late Shockwave and early Flash.
- **Ecotron**: Working recycling system.
- **Games**: BattleBall, SnowStorm, Wobble Squabble.
- **CMS Integration**: Comes with a deeply integrated Java-based "Web" component (Havana-Web) acting as the CMS backend.
## 📂 Project Structure
Located in `/havana`, the structure is:
```
havana/
├── Havana_Repo/
│ ├── Havana-Server/ # Game Server Source
│ ├── Havana-Web/ # Integrated CMS/Web Source
│ └── tools/ # Assets and DB schemas
└── start_havana.sh # Helper script
```
## 🔌 Ports
| Port | Description |
| ------ | -------------------------------------------------------------------------- |
| `80` | Web Interface/CMS (Note: Conflicts with AtomCMS if running simultaneously) |
| `3307` | Dedicated DB Port (if not using unified) |
## 🛠 Setup & Running
**Important**: Havana usually demands port `80`. Ensure other web services (like AtomCMS in `/retro` or Apache/Nginx on your host) are stopped.
```bash
./docker-manage.sh start havana
```
Or using the specific script in the folder:
```bash
cd havana
./start_havana.sh
```
## 🌐 Access
- **Website**: `http://localhost` (Register/Login here)
- **Client**: Launched from the website after login. Requires Shockwave-compatible browser.