Kepler - Java v14+ server (SnowStorm, BattleBall, Camera, Wobble Squabble)

[Quackster]

Kepler

What is this?

Kepler is a Habbo Hotel emulator that is designed to fully emulate the v14 version from 2007 era, and upwards. The server is written in Java (JDK 11) and it's using various libraries, which means it's multiplatform, as in supports a wide range of operating systems. Windows, Linux distros, etc.

The server has many features added, and a lot of configuration settings. Most of the configuration settings will be explained below. This server supports version v9 through to v26, and different clients can connect at once, by the server configuration generated:

[Global]
bind=127.0.0.1
v9.version.port=0
v14.version.port=12321
v15.version.port=0
v21.version.port=12357
v26.version.port=0

So in theory you can have two clients targeting different versions connect on these ports.

How to install and run Shockwave:

Shockwave Information ~ 2019

Spoiler:

Pale Moon

Pale Moon is a necessity to run Shockwave correctly, as it's one of the few browsers that still supports NPAPI plugins correctly.

Since Shockwave is quite old, the 32-bit version of Pale Moon is required, here you can download the Portable or the Full version.

Shockwave 12

You must install the Shockwave 12 MSI first and then proceed to install the Visual Studio 2008 C++ x86 redist.

Download list

Adobe Shockwave 12.3 MSI: Download

Microsoft Visual C++ 2008 Redistributable Package (x86): Download

Also please make sure you do not have a browser open when installing the Shockwave MSI, as you will need to start a fresh Windows installation, since the current installation breaks with a browser open.

Shockwave 11

These have been tested to install and work without being dependent on official Shockwave download servers, for the time being this version is recommended.

While Shockwave 11.6 is older than the latest version that is Shockwave, for Habbo, the latest version experiences issues with crashing while playing music from the Trax Machine or Jukebox, and also messsages in the instant messenger are always stuck at 12:00 (this is a bug with getting the time in Shockwave).

For these reasons, Shockwave 11 is recommended to install instead since these issues are not present in this version.

You can download the official Shockwave 11.6 installer MSI here.

Libraries Used

- Netty https://netty.io

- HikariCP https://github.com/brettwooldridge/HikariCP

- SLF4J https://www.slf4j.org/

- Log4j https://logging.apache.org/log4j/2.x/

- Apache Commons-Configuration https://commons.apache.org/proper/co...configuration/

Features

Spoiler:

• User
  
  • Login by SSO ticket
  • Load fuserights
  • Load credits
  • In-game register
  
  
  
  
• Navigator
  
  • Lists all public rooms
  • Lists all private rooms
  • Navigator category management with rank checking for private rooms
  • Navigator category management with rank checking for public rooms
  • Show recent private rooms created in the categories even if the room owner wasn't online
  • Create private rooms using the navigator
  • Show own rooms
  • Hide room owner name
  • Edit room settings
  • Delete room
  
  
• Habbo Club
  
  • Purchase Habbo club
  • Expiry of Habbo club
  • Show days left
  • Habbo club gifts
  
  
• Messenger
  
  • Search users on console
  • Send user a friend request
  • Accept friend request
  • Reject friend request
  • Send friend message
  • Delete friend
  • Change messenger motto
  • Mark messages are read
  • Show offline messages
  • Follow friend
  • Automatic update friends list
  
  
• Private room
  
  • Walking
  • Walk to door
  • Chat (and message gets worse quality if you're further away from someone in public rooms)
  • Shout
  • Whisper
  • Password protect room
  • Use room doorbell
  • Room voting (with expiry)
  
  
• Public Room
  
  • All possible public rooms added (some may be missing)
  • All public rooms are fully furnished to what official Habbo had
  • Sitting on furniture in public rooms
  • Walk between public rooms
  
  
• Lido and Diving Deck
  
  • Change clothes working (with curtain closing)
  • Pool lift door closes and opens depending if a user is inside or not
  • Buying tickets work for self and other players
  • Diving
  • Swimming
  • Queue works (line up on first tile and the user automatically walks when there is a free spot)
  • Lido voting
  
  
• Item
  
  • Show own hand (inventory) with items in it
  • Place room items
  • Move and rotate room items
  • Pickup room item
  • Place wall items
  • Pickup wall items
  • Stack items
    
  • Apply room decorations
  
  
• Completed Item Interactions
  
  • Dice
  • Bottles
  • Teleporters
  • Rollers
  • Scoreboard
  • Lert
  • Camera
  • Gate
  • Trax
  • Jukebox
  
  
• Catalogue
  
  • Show catalogue pages
  • Show catalogue items and deals (aka packages)
  • Purchase items and packages
  • Purchase items with credits
  • Recycler
  
  
• Purse
  
  • Redeem vouchers to get credits
  • Redeem vouchers to get credits and items
  • Redeem vouchers to get items
  
  
• Games
  
  • Chess
  • Tic-Tac-Toe
  • BattleShips
  • Wobble Squabble
  
  
• BattleBall and SnowStorm
  
  • Join games
  • Cancel games
  • Spectate games
  • All power ups
  • Flood fill
  
  
• SnowStorm
  
  • Join games
  • Cancel games
  • Spectate games
  • Snowballs
  • Snow machines
  • Other features all 100%
  
  
• Ranked features
  
  • Add badge automatically if they are a certain rank
  • Command registration checking
  
  
• Commands
  
  • :about
  • :help
  • :reload items/settings/models
  • :pickall
  • :whosonline/usersonline
  • :givedrink <target>
  • :afk/idle
  • :motto
  • :givebadge
  • :setprice <sale code> <price>
  • :setconfig <config entry in settings table> <new value>
  • :hotelalert <msg>
  • :talk <msg>

Screenshots

Spoiler:

(Hotel view)



(Automatic rare cycler)



(Camera)



(BattleBall)





(SnowStorm)





(Chess)



(Tic Tac Toe)

Frequently Asked Questions (FAQ)

What database system does this use?

Kepler was designed with MariaDB in mind, which is a fork of MySQL and it's compatible with all programs libraries designed to work with MySQL. https://downloads.mariadb.org/

How can I customise my server?

Upon initial loading of Kepler, it will insert its default configuration options into the settings table, from there, you can edit the automatic rare system, enable/disable and set the welcome message, and many other types of configurations.

What's the automatic rare system?

This is a system designed to rotate a selection of rares in however many days/hours/minutes you set. To edit this, adjust the following:

• rare.cycle.refresh.timeunit
• rare.cycle.refresh.interval

The following valid timeunits are: DAYS/HOURS/MINUTES/SECONDS and the interval is how many of that timeunit you want before the next rare happens.

For example, if I set the interval to 1 and then the timeunit to DAYS, then a new rare will cycle every 1 DAYS.

How do I configure rare prices?

First of all, it finds any items with the catalogue header and "catalog_rares_headline1" and with a minimum rank allowed of 5, and considers any items in those pages to be rares.

To configure prices, in the "settings" table, the entry "rare.cycle.pages" has a value looking like this:

28,3|29,3|31,3|32,3|33,3|34,3|35,3|36,3|40,3|43,3|30,6|37,6|38,6|39,6|44,6

The first number is the page id, the second number is the number of hours required (taking in the credit scheduler into account) before that item is affordable. This doesn't control which items end up in the rare cycle by the way, just the hours required.

For example, if you set 20 credits every 15 minutes, and made it so you need 3 hours to earn an item, it would cost 240 credits.

How do people get credits?

The current system is designed so you need to be in a room when you get credits, not afk on the hotel view, there's three settings which adjust how many credits you get, and how often.

• How many credits to receieve: credits.scheduler.amount
• How many timeunits you set are required, in numbers (eg 1 for 1 DAY): credits.scheduler.interval
• The unit how often to get credits (DAYS/HOURS/MINUTES/SECONDS): credits.scheduler.timeunit

Download:

The full source is at: https://github.com/Quackster/Kepler

Compiled jar: https://github.com/Quackster/Kepler/releases

Massive Thanks To:

• Sefhriloff
• Hoshiko
• ThuGie
• Ascii
• Lightbulb
• Raptosaur
• Romuald
• Glaceon
• Nillus
• Holo Team
• Meth0d
• office.boy

[MentaL_BOT]

[pipitt05000]

It's juste awesome ! :O

But you have delete all your r21 work ?

Thank's for this release :D

[Quackster]

It's juste awesome ! :O

But you have delete all your r21 work ?

Thank's for this release :D

Oh I forgot to say, when you start kepler.jar, in settings.ini when it's created, change "version=14" to "version=21" and the server will work for v21 dcrs.

There was only a few things which changed to work for v21, the console and the Trax machine.

[pipitt05000]

Woaaaaaaaaaaaaaa ! That's awesome ! :O I love it !

Wich versions are supported ??

[Quackster]

Woaaaaaaaaaaaaaa ! That's awesome ! :O I love it !

Wich versions are supported ??

Officially, should work from v14-v21. It would work with v23 but without messenger as there's also yet again packet differences with the messenger/console.

[pipitt05000]

Officially, should work from v14-v21. It would work with v23 but without messenger as there's also yet again packet differences with the messenger/console.

OKAY ! This is perfect ! :D

[Emily]

This isn't good, this isn't great... this is amazing! Good job on this and all those features still take me back to 2006 when I started Habbo.

[pipitt05000]

Hey, now i think a little: can you share your r14 DCR please ? :D

[Quackster]

Hey, now i think a little: can you share your r14 DCR please ? :D

Here you go:

https://www.mediafire.com/file/ta0kc...d/v14.zip/file

Note: the kepler.sql was made for v21 so some furniture might not work and you'll have to mark it as "is_hidden" to 1 (for true) in the catalogue. I'm talking about some of the Alhambra and Executive furniture.

[treebeard]

Damn.. Now I see what you are doing :P

I'll say it again, good job Quack

(:

[Lex]

It looks amazing! Is there any 'installation guide' for windows?

[TheOman]

Awesome work!
Just got everything up and running and it looks great. :)

[Quackster]

It looks amazing! Is there any 'installation guide' for windows?

It's pretty simple to setup, but instead of .NET you need Java, start the server and then edit the MySQL details...

[CUS7OM]

What a Masterpiece, Alex.

Thank you for all your time spent on this project and for bringing to this community something so nostalgic and clean.

I hope you keep going with the project and I guess there's still interesting stuff to show up.

Cheers!

[Quackster]

What a Masterpiece, Alex.

Thank you for all your time spent on this project and for bringing to this community something so nostalgic and clean.

I hope you keep going with the project and I guess there's still interesting stuff to show up.

Cheers!

Thanks! Yeah, there's still some things missing, wobble squabble, public room bots, infobus and banning with mod tools for example.