quackster / kepler

A Habbo Hotel v14 server written in Java

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.

I highly recommend this browser to be able to play Adobe Shockwave movies in the present day.

❗ 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 here.

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.

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
• Meth0d
• office.boy

kepler's Issues

Cannot choose a room category!

Hello, I am having an issue with Kepler on V15. When creating rooms, you cannot choose a category for the room to go under. Will not let you click on any.

Habbo lido furniture layout is newer than the version it emulates

Reminder to myself to fix this issue at some point.

CFH tickets stucks

If users deletes their CFH ticket and try to make a new one they will get the avise that they have one still and if they want to delete it (but they already deleted it??) and so on, on staff clients the cfh button dissapearrs (if there arent more tickets to attend) leaving a unexistend ticket on a user side

Run.bat is missing inside Kepler folder

Run.bat is missing inside Kepler folder

unicode characters

Hi, i'm trying to use the external_texts from habbo.es but the spanish characters (á, é, í, ó, ú, ü, ñ, ¿, ¡) aren't showing correctly

Server cant start, error to set a variable in MySQL server i think!

The console output:

java.sql.SQLSyntaxErrorException: Variable 'sql_mode' can't be set to the value of 'NO_AUTO_CREATE_USER'
        at org.mariadb.jdbc.internal.util.exceptions.ExceptionMapper.get(ExceptionMapper.java:236)
        at org.mariadb.jdbc.internal.util.exceptions.ExceptionMapper.getException(ExceptionMapper.java:165)
        at org.mariadb.jdbc.internal.protocol.AbstractConnectProtocol.connectWithoutProxy(AbstractConnectProtocol.java:1199)
        at org.mariadb.jdbc.internal.util.Utils.retrieveProxy(Utils.java:560)
        at org.mariadb.jdbc.MariaDbConnection.newConnection(MariaDbConnection.java:174)
        at org.mariadb.jdbc.Driver.connect(Driver.java:92)
        at com.zaxxer.hikari.util.DriverDataSource.getConnection(DriverDataSource.java:138)
        at com.zaxxer.hikari.pool.PoolBase.newConnection(PoolBase.java:353)
        at com.zaxxer.hikari.pool.PoolBase.newPoolEntry(PoolBase.java:201)
        at com.zaxxer.hikari.pool.HikariPool.createPoolEntry(HikariPool.java:473)
        at com.zaxxer.hikari.pool.HikariPool.checkFailFast(HikariPool.java:562)
        at com.zaxxer.hikari.pool.HikariPool.<init>(HikariPool.java:115)
        at com.zaxxer.hikari.HikariDataSource.<init>(HikariDataSource.java:81)
        at org.alexdev.kepler.dao.Storage.<init>(Storage.java:51)
        at org.alexdev.kepler.dao.Storage.connect(Storage.java:71)
        at org.alexdev.kepler.Kepler.main(Kepler.java:85)

Maybe some MySQL server configuration?

Error on 1.41

When trying to start server I get the following error on 1.41, no issue on 1.4. Using java 17.

This error happens on Ubuntu, my server VPS using java 17:

Error: Could not find or load main class org.alexdev.kepler.Kepler
Caused by: java.lang.ClassNotFoundException: org.alexdev.kepler.Kepler

In Arch Linux, my main computer I get a different error using java 18:

Error: A JNI error has occurred, please check your installation and try again
Exception in thread "main" java.lang.SecurityException: Invalid signature file digest for Manifest main attributes
at java.base/sun.security.util.SignatureFileVerifier.processImpl(SignatureFileVerifier.java:340)
at java.base/sun.security.util.SignatureFileVerifier.process(SignatureFileVerifier.java:282)
at java.base/java.util.jar.JarVerifier.processEntry(JarVerifier.java:283)
at java.base/java.util.jar.JarVerifier.update(JarVerifier.java:239)
at java.base/java.util.jar.JarFile.initializeVerifier(JarFile.java:762)
at java.base/java.util.jar.JarFile.ensureInitialization(JarFile.java:1033)
at java.base/java.util.jar.JavaUtilJarAccessImpl.ensureInitialization(JavaUtilJarAccessImpl.java:72)
at java.base/jdk.internal.loader.URLClassPath$JarLoader$2.getManifest(URLClassPath.java:888)
at java.base/jdk.internal.loader.BuiltinClassLoader.defineClass(BuiltinClassLoader.java:848)
at java.base/jdk.internal.loader.BuiltinClassLoader.findClassOnClassPathOrNull(BuiltinClassLoader.java:760)
at java.base/jdk.internal.loader.BuiltinClassLoader.loadClassOrNull(BuiltinClassLoader.java:681)
at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:639)
at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188)
at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:521)
at java.base/java.lang.Class.forName0(Native Method)
at java.base/java.lang.Class.forName(Class.java:488)
at java.base/java.lang.Class.forName(Class.java:467)
at java.base/sun.launcher.LauncherHelper.loadMainClass(LauncherHelper.java:790)
at java.base/sun.launcher.LauncherHelper.checkAndLoadMain(LauncherHelper.java:685)

Trax not working

I'm using your v15 cct's (the ones that used to fix trax) and Shockwave 11.6. But still I can't use trax.

endless loading

I have endless loading to habbo server. I install all.

When teleporting the room name does not change

When teleporting to another room the bottom left corners room name and owner does not change.

Version: 1.33 (Unreleased) - Compiled from main branch.

problem with run.bat

hi, when i start the bat this appears:

"tile" no se reconoce como un comando interno o externo,
programa o archivo por lotes ejecutable. (is not recognized as an internal or external command,
executable program or batch file)

Error: A JNI error has occurred, please check your installation and try again
Exception in thread "main" java.lang.UnsupportedClassVersionError: org/alexdev/k
epler/Kepler has been compiled by a more recent version of the Java Runtime (cla
ss file version 54.0), this version of the Java Runtime only recognizes class fi
le versions up to 52.0
at java.lang.ClassLoader.defineClass1(Native Method)
at java.lang.ClassLoader.defineClass(Unknown Source)
at java.security.SecureClassLoader.defineClass(Unknown Source)
at java.net.URLClassLoader.defineClass(Unknown Source)
at java.net.URLClassLoader.access$100(Unknown Source)
at java.net.URLClassLoader$1.run(Unknown Source)
at java.net.URLClassLoader$1.run(Unknown Source)
at java.security.AccessController.doPrivileged(Native Method)
at java.net.URLClassLoader.findClass(Unknown Source)
at java.lang.ClassLoader.loadClass(Unknown Source)
at sun.misc.Launcher$AppClassLoader.loadClass(Unknown Source)
at java.lang.ClassLoader.loadClass(Unknown Source)
at sun.launcher.LauncherHelper.checkAndLoadMain(Unknown Source)
Presione una tecla para continuar . . .

I have the latest version of Java Runtime and java, my PC is Windows 8.1, why is this happening?

Any tutorial?, i'm little confused with the files, and the instalations of programs

thanks

V1.31 - Libsodium error

When running the server from the precompiled jar in a Debian server, the following error occures on the server, when a users want to make a new account.

Netty error occurred: 
java.lang.UnsatisfiedLinkError: Unable to load library '/tmp/nativeutils1203363710640636/libsodium.so': Native library (tmp/nativeutils1203363710640636/libsodium.so) not found in resource path (kepler.jar).

Also a manual install of libsodium does not solve the problem.
When a user wants to login, also an error will be raised:

Netty error occurred: 
java.lang.NoClassDefFoundError: Could not initialize class org.alexdev.kepler.dao.mysql.PlayerDao

How to run Kepler correctly

Hi, I'm really new here in the habbo retro server world, I know how to run Kepler.jar but I don't know hoe to access to the habno server, I visited the urls localhost:XXXX that Kepler suggest but it doesn't show anything

What I need? I need a habbo client?
Or a CMS?

V21 files

Hello,

Does anyone has the V21 files?

Do you know if you can link V21 with a CMS (with CMS sign in and sso-ticket) or is it only possible to client sign in?

Thank you in advance.

Add profile updating/birthdays/change password

V26: Trax, Spaces and achievements doesn't work

Hello,

1. When I try to use the Trax machine, I cannot add a disc to it and therefor I am unable to make music.
2. When opening the Spaces tab in the catalogue, I will be disconnect.
3. When opening the Achievements tab in the Badges window, I will be disconnect.

Thank you in advance.

Move furniture ids to UUIDs

Can you make guide?

Can you make instalation guide for linux, or windows.I use Linux and i dont know how to run it

Cannot launch run.bat with Public IP in server.ini config

2021-01-23T18:19:35.842 INFO [org.alexdev.kepler.Kepler] - Kepler - Habbo Hotel Emulation (max version supported: v26)
2021-01-23T18:19:35.844 INFO [org.alexdev.kepler.dao.Storage] - Connecting to MySQL server
2021-01-23T18:19:35.874 INFO [com.zaxxer.hikari.HikariDataSource] - processing - Starting...
2021-01-23T18:19:35.971 INFO [com.zaxxer.hikari.HikariDataSource] - processing - Start completed.
2021-01-23T18:19:35.971 INFO [org.alexdev.kepler.dao.Storage] - Connection to MySQL was a success
2021-01-23T18:19:35.972 INFO [org.alexdev.kepler.Kepler] - Setting up game
2021-01-23T18:19:36.216 INFO [org.alexdev.kepler.game.commands.CommandManager] - Loaded 26 commands
2021-01-23T18:19:36.518 ERROR [ErrorLogger] - Failed to start MUS server on address: redactedIP:12322
2021-01-23T18:19:36.518 ERROR [ErrorLogger] - Please double check there's no programs using the same port, and you have set the correct IP address to listen on.
2021-01-23T18:19:36.536 INFO [org.alexdev.kepler.server.rcon.RconServer] - RCON (remote connection) is listening on 127.0.0.1:12309
2021-01-23T18:19:36.564 ERROR [ErrorLogger] - Failed to start server on address: redactedIP:12321
2021-01-23T18:19:36.564 ERROR [ErrorLogger] - Please double check there's no programs using the same port, and you have set the correct IP address to listen on.

Server can launch just fine using localhost, I have checked ports, not in use, port forward, set static IP, etc.

Bugs/issues I've found.

1. I've noticed that club gifts have stopped working on latest release and now when you accept a gift the emulator just throws a null pointer exception.
2. Battleships and poker DC you, I understand that you probably haven't got around to adding the packets for them yet but if you did that would be amazing.
3. When entering the lido pool and crossing pass the diving line and then exiting the pool your still be swimming.
4. Camera isn't taking a photo and just forever says saving photo.

5. My biggest issue: I purchased two TCP proxys to use with the server, one for the game server and the other for MUS, every now and again my users just DC randomly for no reason, I assume this is because of the proxys but I cant imagine not using them on a public server as I like to have the most amount of security possible. Are you going to be implementing them properly like Arcturus for example? So that the emulator gets given the users real IP address. (This happens quite frequently and is very annoying!)

V21: white dots

Hello,

I see some white dots in the texts:

Thank you in advance.

Code poker for gamehall minigame

Reminder to myself to fix this issue at some point.

V26: Disconnected suddenly

Hello,

I was in the hotel for a while, and all of a sudden I was disconnected; I did nothing to trigger this user-side because I was doing things outside the hotel. The following error were listed:

ake room!;21.33.45 -updateProcess-Room Component Class-Attempted to remake room!;21.36.22 -getInt-Variable Container Class-Variable not found: "balloons.rightmargin";21.36.23 -eventProcUserObj-Room Interface Class-User object not found: 14541;21.37.43 -eventProcUserObj-Room Interface Class-User object not found: 11361;21.38.10 -eventProcUserObj-Room Interface Class-User object not found: 8185;21.42.09 -handle_error-Room Handler Class-Info: mod_warn/dvvd ;21.42.09 -handle_error-Navigator Handler Class-Info: mod_warn/dvvd ;21.42.09 -handleErr-Login Handler Class-Error from server: mod_warn/dvvd ;21.42.09 -create-Writer Manager Class-Writer already exists: dialog_writer_bold;22.28.42 -eventProcUserObj-Room Interface Class-User object not found: 73393;22.38.39 -getInt-Variable Container Class-Variable not found: "balloons.rightmargin";22.38.39 -eventProcUserObj-Room Interface Class-User object not found: 75853;22.44.47 -handleDisconnect-Login Handler Class-Connection was disconnected: Info;

Thank you in advance.

Shockwave .exe client

Hello,

does anyone know how I can create a .exe client that provides login at my retro made with Kepler (shockwave)?

Example classic habbo:
https://classichabbo.com/classichabbo_exe.zip

I appreciate the mac compatibility.

I can't connect to Kepler.

I think i've setted up everything okay, but when i try to open the client, this happens. Any ideas?

Shockwave question

Hi,

I did my setup and found out Shockwave is end of life and not supported in the latests browsers. I was wondering; wat is the best method to actually play on it?

Thanks!

With the new pathfinding its possible to walk into the pools with clothes on.

Teleports do not work!

None of the teleports work, might be an issue with my DCRS I have, not a clue

Remove support for versions higher than v14

This server should focus on a single version only to ensure there will be no issues, as there is bugs when trying anything higher than v14.

Using sso tickets with v14.

Log4J vulnerability

Hi,

I wanted to try creating a server using Kepler but I noticed it uses Log4J and it was recently found a vulnerability in it (CVE-2021-44228).

Is Kepler affected by it?

V26: Kepler is showing errors after installing SnowStorm

Hello,

After following the installation, I got the following errors within Kepler:

Thank you in advance. Keep up the good work you're doing, it is appreciated!

No sprites on furni

I managed to set up the hotel without problems but when I log in and try to buy furni all of them have no sprites on them.
Im using the v14 client.

How i can run it with Ruffle emu

Can i run in with ruffle emu?