3.9 KiB
Kepler
Kepler is a Habbo Hotel emulator that is designed to fully emulate the v14 version from 2007 era. The server is written in Java and using various libraries, such as Netty, an asynchronous networking library, Log4j and the Apache commons libraries.
It is quite possibly the most complete v14 Habbo Hotel released to date, and has been in development since January 2018.
Screenshots
(Hotel view)
(Automatic rare cycler)
(Camera)
(BattleBall)
(Chess)
(Tic Tac Toe)
Download
Download the latest development build from the releases page.
Requirements
To be honest, this server doesn't require much. I'd argue that the MariaDB server is more resource demanding than the emulator itself.
- JDK >= 17
- MariaDB server
Installation
Install MariaDB server, connect to the database server and import Kepler.sql (located in /tools/Kepler.sql).
Download the latest development build from the releases page and rename the files to remove the short build hash version, for convenience.
Install any JDK version that is equal or above >= 17 to run the jar files.
Open run.sh (Linux) or run.bat (Windows) to start Kepler.
❗ Once registered as an admin, make yourself admin by setting your rank to 7 in the users table.
As for the client, you can find version 14 DCRs: https://github.com/Quackster/Kepler-www/
Setup the loader files on a web server, and once Kepler is started, ensure the loader is connecting to the correct IP and ports for both the standard connection and MUS connection. The MUS connection is used for the camera.
Docker installation
Install Docker and git (optional) on your device.
1. Clone repository
git clone https://github.com/Quackster/Kepler.git
You can also download this repository and unzip it.
1. Configure variables
Copy .env.example file to .env:
cp .env.example .env
Note: The default ports are set to 133xx to avoid conflicts with other local services. Adjust in .env if needed.
2. Start Kepler & Web Loader
You can use the helper script to start the entire stack:
./start.sh
Or manually:
docker compose up -d
3. Access the Hotel
- Game Server:
localhost:13321 - Web Loader: http://localhost:8080/loader.php
To stop the server:
./stop.sh
or
docker compose down
Docker FAQ
Reset MariaDB database
You need to first stop Kepler, then remove MariaDB volume :
docker compose down && docker volume rm kepler-mariadb
You can now start Kepler again, database will be wiped out !
License
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Cloning this repository
$ git clone --recursive https://github.com/Quackster/Kepler
or
$ git clone https://github.com/Quackster/Kepler
$ git submodule update --init --recursive
Thanks to
- Hoshiko
- ThuGie
- Ascii
- Lightbulb
- Raptosaur
- Romuald
- Glaceon
- Nillus
- Holo Team
- wackfx
- Meth0d
- office.boy
- Leon Hartley
- Alito
- wackfx