0 Releases 14 Tags

• v1.0.2 01a297884a

  Compare

  v1.0.2

  remco released this 2026-07-28 18:07:26 +02:00 | 949 commits to main since this release

  EpicNext-CMS v1.0.2

  Modern, high-performance CMS for Habbo hotel emulators — built on Next.js 16, React 19 and Prisma 7. Integrates with Polaris / Arcturus Morningstar databases.

  Menu

  • What is EpicNext-CMS?
  • System Requirements
  • Installation Wizard
  • How it is used
  • Changes
  • Linked repositories

  What is EpicNext-CMS?

  EpicNext-CMS is a full public-facing hotel website plus an administrative panel. It features NextAuth authentication (argon2id/bcrypt with MD5 upgrade), real-time RCON communication with the emulator, Server-Sent Events for live radio, smooth page transitions and extensive extensibility. Full documentation: https://gitlab.epicnabbo.nl/remco/EpicNext-Cms/src/branch/main/README.md

  System Requirements

  What you need to install before running the CMS:

  Component	Version	Notes
  Node.js	>= 22	Required by Next.js 16
  pnpm	>= 10.33.4	Package manager (npm/yarn not supported)
  MySQL / MariaDB	8.0+ / 10.6+	Shared with the emulator
  Redis	7.x+	Optional — caching, rate limiting, SSE
  Java	17+	Only if building the emulator
  Maven	3.9+	Only if building the emulator

  The CMS shares its database with the Polaris / Arcturus emulator. It only reads/writes emulator-owned tables and never alters them.

  Installation Wizard

  A complete hotel stack = EpicNext-CMS (this repo) + Polaris Emulator + Nitro V3 client + Catalogus data. Follow the steps in order.

  Quick links: Full setup guide · EpicNext-CMS repo · Reference configs in this repo

  1. Clone & Install the CMS

  git clone https://gitlab.epicnabbo.nl/remco/EpicNext-Cms.git
  cd EpicNext-Cms
  pnpm install
  

  2. Database Setup

  The CMS shares the emulator database. Import the Polaris/Arcturus database first, then create the CMS schema:

  CREATE DATABASE IF NOT EXISTS epicnext_cms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  

  3. Configure Environment

  cp .env.example .env
  

  Edit .env with at minimum: DATABASE_URL, AUTH_SECRET, HOTEL_NAME and APP_URL. See .env.example for RCON, email, Redis, OAuth and PayPal options.

  4. Generate Prisma Client

  pnpm prisma:generate
  

  5. Run CMS Migrations

  pnpm db:migrate
  

  Creates all CMS-owned tables (website_, radio_, acl_*, admin_audit_log). Emulator tables are never touched. Check status with pnpm db:migrate:status.

  6. Polaris Emulator

  Clone and build the emulator (requires Java 17+ and Maven 3.9+):

  git clone https://github.com/duckietm/Polaris-Emulator.git /var/www/emulator
  cd /var/www/emulator/Emulator
  mvn clean package
  

  Place the built Habbo-*-jar-with-dependencies.jar next to config.ini (see setup/emulator/config.ini), then create a systemd unit from setup/emulator/emulator.service with the emulator launcher so it starts on boot. The bundled update-Nitrov3.sh in this repo automates cloning, building and updating the emulator and Nitro — run it any time to pull the latest commits and rebuild:

  ./update-Nitrov3.sh
  

  7. Nitro V3 & Renderer

  Clone both Nitro repos and build the client:

  git clone https://github.com/duckietm/Nitro_Render_V3.git /var/www/Nitro_Render_V3
  git clone https://github.com/duckietm/Nitro-V3.git /var/www/Nitro-V3
  cd /var/www/Nitro_Render_V3 && yarn install && yarn link
  cd /var/www/Nitro-V3 && yarn install && yarn link "@nitrots/nitro-renderer" && yarn build
  

  Copy the reference configs from setup/nitro/ into /var/www/Nitro-V3/public/configuration, keep them as *.json, and replace MY_DOMAIN with your domain, API URL and gamedata paths (see the Full setup guide, NitroV3_And_Emulator.md).

  8. Catalogus (catalog & gamedata)

  Catalogus holds the daily-updated catalog/gamedata. Clone the Beta-3 branch alongside the other components:

  git clone -b Beta-3 https://gitlab.epicnabbo.nl/remco/Epicnabbo-Catalogus-Updated-Daily.git /var/www/catalogus
  

  9. Build & Start the CMS

  # Development (hot reload)
  pnpm dev
  
  # Production
  pnpm build && pnpm start
  

  Open http://localhost:3000 in your browser.

  10. First Login

  1. Register at /register, or log in with an existing emulator account.
  2. Grant admin access: UPDATE users SET rank = 7 WHERE username = 'yourname';
  3. Visit /admin and configure your hotel via Admin -> CMS Settings.

  How it is used

  • Public site: browse the hotel, news, radio and the Nitro client at /client.
  • Admin panel: /admin for CMS settings, theming (12 presets), users, radio and more.
  • Background jobs: run pnpm jobs:worker for daily backups and cleanup.
  • Optional: Cloudflare Turnstile / reCAPTCHA, OpenAI moderation and email/PayPal via .env.

  Changes

  Initial release of EpicNext-CMS (739 commits).
  

  Linked repositories (exact commits)

  The game components below are pinned to the exact commits used by this release and are deployed alongside the CMS:

  Component	Repository	Commit
  Catalogus	https://gitlab.epicnabbo.nl/remco/Epicnabbo-Catalogus-Updated-Daily	8d93be5bca73411b79e7158c5d5c17dc94deab8b
  Nitro-V3	https://github.com/duckietm/Nitro-V3	a3d0e9eed6dc19895b399ac167440316f1369eb0
  Nitro-Render-V3	https://github.com/duckietm/Nitro_Render_V3	1111d1a178d4c7915c33c109a3bab6ddebc8987a
  Polaris Emulator	https://github.com/duckietm/Polaris-Emulator	39018b800a57570dcba649510c4dfb40fe11c4c9

  Nitro-V3 · Nitro Renderer · Polaris Emulator · Catalogus

  ---

  Automated release from Gitea Actions

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)