Giter VIP home page Giter VIP logo

kepler's Introduction

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)

https://i.imgur.com/8eFvtdA.png

(Automatic rare cycler)

https://i.imgur.com/8RTFFqD.png

(Camera)

https://i.imgur.com/emseVbU.png

(BattleBall)

https://i.imgur.com/a3MgkzU.png

https://i.imgur.com/eUGmcwR.png

(Chess)

https://i.imgur.com/xundc8M.png

(Tic Tac Toe)

https://i.imgur.com/tTG5SVE.png

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.

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.

2. Configure variables

Copy .env.example file to .env :

cp .env.example .env

You can now configure all variables in .env file with values needed.

Don't change MYSQL_HOST except if you change the name of the service mariadb in Docker compose file.

You neither should change MYSQL_PORT.

3. Start Kepler

You just need to run Docker compose inside of Kepler directory :

docker compose up -d

To stop Kepler :

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
  • Meth0d
  • office.boy
  • Leon Hartley
  • Alito
  • wackfx

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.