Lizenz im ACP aktivieren

Dieses Tutorial führt dich vom Lizenzschlüssel bis zur freigeschalteten Premium-Funktion – in wenigen Minuten, ohne Konfigurationsdateien.

Voraussetzung: Der Core läuft (siehe Installation) und du bist im ACP als Owner/Admin mit der Berechtigung core.license.manage angemeldet. Du hast einen Lizenzschlüssel der Form JN-XXXX-XXXX-XXXX-XXXX aus dem JuByte-Store.

1. Die Lizenz-Seite öffnen

Im ACP unter System → Lizenz. Du siehst zwei Karten:

Token-Übersicht – aktueller Plan, Status, freigeschaltete Module, Ablauf. Frisch installiert steht hier Plan: free und „Freigeschaltete Module: keine".
Lizenz aktivieren – das Eingabefeld für deinen Schlüssel.

Erscheinen oben Hinweis-Banner („NEXUS_LICENSE_SERVER_URL ist nicht gesetzt" o. ä.), ist dein Core-Build veraltet → siehe Lizenzserver einrichten. Standardmäßig sind Server-URL und Public-Key bereits vorkonfiguriert.

2. Schlüssel eingeben und aktivieren

Trage den Schlüssel ein und klicke Aktivieren. Der Core

schickt den Schlüssel an das JuByte-Lizenzsystem (/api/v1/license/issue),
erhält ein signiertes Entitlement-Dokument,
prüft dessen Signatur lokal mit dem hinterlegten Public-Key,
schaltet die enthaltenen Module (und ggf. das ACP) automatisch frei.

Bei Erfolg zeigt die Token-Übersicht den Plan, den Status active und die freigeschalteten Module als Badges. Premium-Module (z. B. AntiCheat-Hub, Shop) sind ab jetzt aktivierbar bzw. laufen automatisch.

3. Was danach automatisch passiert

Persistenz: Der Schlüssel wird gespeichert (<data-dir>/license.key) und übersteht Neustarts.
Auto-Refresh: Der Core holt das Entitlement regelmäßig neu (Standard alle 6 h), damit Verlängerungen und Widerrufe greifen.
Soft-Degradation: Ist der Lizenzserver kurz nicht erreichbar, läuft die letzte gültige Lizenz innerhalb der Kulanzzeit weiter – ein Lizenzproblem legt nie den Spielserver lahm.

Fehlerbilder

Meldung	Bedeutung	Lösung
Banner „SERVER_URL/PUBLIC_KEY nicht gesetzt"	Veralteter Core-Stand	Über das ACP aktualisieren (Lizenz → Updates) oder den Nexus-Installer erneut ausführen
`NX-1042 … (HTTP 500)`	Lizenzserver-interner Fehler	Kurz warten und erneut versuchen; besteht der Fehler, den JuByte-Support kontaktieren
„Signierung … nicht aktiviert" (503)	Lizenzserver nicht fertig eingerichtet	JuByte-Support kontaktieren
„Lizenzschlüssel unbekannt"	Kein aktiver Lizenzdatensatz zu diesem Key	Lizenz im Store-Admin anlegen/zuweisen
„Public-Key passt nicht"	Public-Key ≠ Signaturschlüssel	Keys neu abgleichen (How-To)

Mehr Details: Lizenzserver einrichten und Lizenz-API-Referenz.