Installation

Installationsanleitung

Vom Download bis zum laufenden Server — Schritt für Schritt.

Voraussetzungen

Das brauchst du

Komponente Anforderung
Java JDK 8
Build-Tool Maven 3
Datenbank MySQL / MariaDB
Netzwerk Netty
Alternative Docker (Dockerfile im Repository enthalten)
Schritt für Schritt

Server aufsetzen

Abkürzung: Die Compiled-Version auf der Downloads-Seite enthält bereits ein fertiges JAR, die passende Datenbank (im Ordner base database/) und ein Start-Skript. Du musst die Datenbank nur noch importieren — Schritt 4 „Bauen" entfällt komplett.
  • 1. Herunterladen & entpacken
    Lade Compiled, Quellcode oder Developer Edition von der Downloads-Seite herunter und entpacke das ZIP-Archiv.
  • 2. Datenbank vorbereiten
    Richte einen MySQL- oder MariaDB-Server ein, lege eine leere Datenbank samt eigenem Benutzer an und importiere die Basis-Datenbank (SQL) von der Downloads-Seite.
  • 3. Konfigurieren
    Kopiere config.ini.example zu config.ini und trage Datenbank-Zugangsdaten sowie die gewünschten Server-Ports ein.
  • 4. Bauen
    Kompiliere das Projekt mit Maven — es entsteht eine ausführbare Datei unter target/.
  • 5. Starten
    Starte den Server per JAR-Datei oder nutze alternativ das mitgelieferte Dockerfile.
  • 6. Client verbinden
    Für den Nitro-Client zusätzlich das NitroWebsockets-Plugin installieren (siehe Downloads-Seite).

Schnellweg mit der Compiled-Version

$ unzip arcturus-morningstar-3.5.5-compiled.zip $ cd "Morningstar 3.5.5" $ mysql -u root -p -e "CREATE DATABASE arcturus;" $ mysql -u root -p arcturus < "base database/BaseDB MS 3.5.5.sql" $ # config.ini mit Datenbank-Zugangsdaten bearbeiten $ ./start.bat

Weg über den Quellcode

$ unzip arcturus-morningstar-3.5.5-source.zip $ cd Arcturus-Community $ mysql -u root -p -e "CREATE DATABASE arcturus;" $ mysql -u root -p arcturus < arcturus-base-database.sql $ cp config.ini.example config.ini $ # config.ini mit Datenbank-Zugangsdaten bearbeiten $ mvn clean package $ java -jar target/Habbo-*-with-dependencies.jar

Alternative mit Docker: docker build -t arcturus . und anschließend docker run arcturus.

Datenbank im Detail

Was es mit der SQL auf sich hat

Zwei Wege stehen zur Wahl: Die Compiled-Version bringt im Ordner base database/ bereits eine exakt auf 3.5.5 abgestimmte Datenbank mit. Wer stattdessen den Quellcode oder die Developer Edition nutzt, braucht die separate Basis-Datenbank von der Downloads-Seite.

Der Quellcode-Download enthält im Ordner sqlupdates/ nur Versions-Update-Skripte — sie führen eine bestehende Datenbank von einer Version zur nächsten, sind aber kein Basis-Schema für eine Neuinstallation. Dafür gibt es die separate Basis-Datenbank (SQL) auf der Downloads-Seite.

Diese separate Basis-Datenbank enthält alle 122 Tabellen inklusive Basisdaten (Katalog, Zimmer-Modelle, Rechte, Achievements, uvm.) und wurde ursprünglich aus einer laufenden MS3-Installation exportiert. Sie eignet sich damit sowohl für den Stable- (master) als auch den Developer-Download (dev).

Transparenter Hinweis: Es handelt sich nicht um eine offiziell versionierte Basis-Datenbank, sondern um einen Community-Export der Morningstar-Gruppe. Das ursprünglich im Hauptrepository verlinkte Datenbank-Repository ist auf der offiziellen Plattform nicht mehr erreichbar. Wir empfehlen, nach dem Import in eine leere Datenbank die Tabellenstruktur stichprobenartig zu prüfen und die Skripte aus sqlupdates/ anzuwenden, falls dein Core-Download neuer als der Datenbank-Export ist.

Fragen zur Datenbank oder Probleme beim Import? Der schnellste Weg ist unser Discord.

Hilfe

Nicht weitergekommen?

Server startet nicht? Prüfe zuerst die Zugangsdaten in config.ini und ob die konfigurierten Ports bereits belegt sind. Bei Verbindungsproblemen mit dem Client stelle sicher, dass du die passende Client-Version verwendest (siehe Voraussetzungen auf der Features-Seite).

Kommst du trotzdem nicht weiter, ist unser Discord die schnellste Anlaufstelle.

Bereit zum Start?

Lade den Emulator herunter und leg los.

Herunterladen Discord beitreten