{"id":13620614,"url":"https://github.com/Quackster/Kepler","last_synced_at":"2025-04-14T22:32:07.344Z","repository":{"id":45344694,"uuid":"157942247","full_name":"Quackster/Kepler","owner":"Quackster","description":"A server created in Java designed to revive Habbo Hotel v14 from the 2007 era.","archived":false,"fork":false,"pushed_at":"2025-02-02T07:08:40.000Z","size":97709,"stargazers_count":244,"open_issues_count":1,"forks_count":66,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-02-02T08:18:56.113Z","etag":null,"topics":["2007","emulation","emulator","habbo","java","private-server","server"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Quackster.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-17T02:11:04.000Z","updated_at":"2025-02-02T07:08:04.000Z","dependencies_parsed_at":"2024-02-11T23:32:25.912Z","dependency_job_id":"11cf11a4-b2e4-4082-a3c1-d0661387b019","html_url":"https://github.com/Quackster/Kepler","commit_stats":null,"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quackster%2FKepler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quackster%2FKepler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quackster%2FKepler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quackster%2FKepler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Quackster","download_url":"https://codeload.github.com/Quackster/Kepler/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248971909,"owners_count":21191684,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["2007","emulation","emulator","habbo","java","private-server","server"],"created_at":"2024-08-01T21:00:57.750Z","updated_at":"2025-04-14T22:32:03.050Z","avatar_url":"https://github.com/Quackster.png","language":"Java","readme":"# Kepler\n\nKepler is a Habbo Hotel emulator that is designed to fully emulate the v14 version from 2007 era. \nThe server is written in Java and using various libraries, such as Netty, an asynchronous networking library, Log4j and the Apache commons libraries.\n\nIt is quite possibly the most complete v14 Habbo Hotel released to date, and has been in development since January 2018.\n\n# Screenshots\n\n(Hotel view)\n\n![https://i.imgur.com/8eFvtdA.png](https://i.imgur.com/8eFvtdA.png)\n\n(Automatic rare cycler)\n\n![https://i.imgur.com/8RTFFqD.png](https://i.imgur.com/8RTFFqD.png)\n\n(Camera)\n\n![https://i.imgur.com/emseVbU.png](https://i.imgur.com/emseVbU.png)\n\n(BattleBall)\n\n![https://i.imgur.com/a3MgkzU.png](https://i.imgur.com/a3MgkzU.png)\n\n![https://i.imgur.com/eUGmcwR.png](https://i.imgur.com/eUGmcwR.png)\n\n(Chess)\n\n![https://i.imgur.com/xundc8M.png](https://i.imgur.com/xundc8M.png)\n\n(Tic Tac Toe)\n\n![https://i.imgur.com/tTG5SVE.png](https://i.imgur.com/tTG5SVE.png)\n\n# Download\n\nDownload the latest development build from the [releases page](https://github.com/Quackster/Kepler/releases).\n\n### Requirements\n\nTo be honest, this server doesn't require much. I'd argue that the MariaDB server is more resource demanding than the emulator itself. \n\n- JDK \u003e= 17\n- MariaDB server\n\n# Installation\n\nInstall MariaDB server, connect to the database server and import Kepler.sql (located in /tools/Kepler.sql).\n\nDownload the latest development build from the [releases page](https://github.com/Quackster/Kepler/releases) and rename the files to remove the short build hash version, for convenience. \n\nInstall any JDK version that is equal or above \u003e= 17 to run the jar files.\n\nOpen run.sh (Linux) or run.bat (Windows) to start Kepler.\n\n❗ Once registered as an admin, make yourself admin by setting your ``rank`` to 7 in the ``users`` table.\n\nAs for the client, you can find version 14 DCRs [here](https://web.archive.org/web/20220724030154/https://raw.githubusercontent.com/Quackster/Kepler/master/tools/Quackster_v14.zip).\n\nSetup 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.\n\n# Docker installation\n\nInstall [Docker](https://docs.docker.com/engine/install/) and [git](https://git-scm.com/downloads) (optional) on your device.\n\n### 1. Clone repository\n\n```shell\ngit clone https://github.com/Quackster/Kepler.git\n```\n\n_You can also [download](https://github.com/Quackster/Kepler/archive/refs/heads/master.zip) this repository and unzip it._\n\n### 2. Configure variables\n\nCopy `.env.example` file to `.env` :\n\n```shell\ncp .env.example .env\n```\n\nYou can now configure all variables in `.env` file with values needed.\n\n_Don't change `MYSQL_HOST` except if you change the name of the service `mariadb` in Docker compose file._\n\n_You neither should change `MYSQL_PORT`._\n\n### 3. Start Kepler\n\nYou just need to run Docker compose inside of Kepler directory :\n\n```shell\ndocker compose up -d\n```\n\nTo stop Kepler :\n\n```shell\ndocker compose down\n```\n\n### Docker FAQ\n\n#### Reset MariaDB database\n\nYou need to first stop Kepler, then remove MariaDB volume :\n\n```shell\ndocker compose down \u0026\u0026 docker volume rm kepler-mariadb\n```\n\nYou can now start Kepler again, database will be wiped out !\n\n## License\n\nThis 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.\n\n\n## Cloning this repository\n\n```\n$ git clone --recursive https://github.com/Quackster/Kepler\n```\n\n**or**\n\n```\n$ git clone https://github.com/Quackster/Kepler\n$ git submodule update --init --recursive\n```\n\n# Thanks to\n\n* Hoshiko\n* ThuGie\n* Ascii\n* Lightbulb\n* Raptosaur\n* Romuald\n* Glaceon\n* Nillus\n* Holo Team\n* Meth0d\n* office.boy\n* Leon Hartley\n* Alito\n* wackfx\n","funding_links":[],"categories":["Java"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FQuackster%2FKepler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FQuackster%2FKepler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FQuackster%2FKepler/lists"}