Azuriom statt einer Tebex-Website für FiveM nutzen

Du kannst Azuriom nutzen, um die Website deiner FiveM-Community aufzubauen und sie zum Ziel für Spieler zu machen, statt eines eigenständigen Tebex-Storefronts. Nutze es für Startseite, Regeln und Community-Informationen; verbinde deinen Gameserver über AzLink. Für kostenpflichtige Serverpakete bleibt Tebex im Zahlungsablauf: Die aktuelle Dokumentation von Cfx.re nennt Tebex als exklusiven Monetarisierungsanbieter und untersagt für diesen Zweck andere Zahlungsplattformen. Lies die Monetarisierungsanforderungen von Cfx.re, bevor du Verkäufe einrichtest.

Dieses Tutorial behandelt die Installation der Website, die offizielle Ressource AzLink-FiveM und eine praktische Checkliste für den Start. Es beruht auf einer Prüfung von Dokumentation und Quellcode am 9. November 2026; einen vollständigen FXServer- oder Zahlungstest behaupten wir nicht. Azuriom führt FiveM in seiner Dokumentation als unterstütztes Spiel auf. Der hier geprüfte Bridge-Code ist Commit d2c76cbdf4f7561bf7943aed8524bbce67a9ebc2 des offiziellen Repositorys; das zum Prüfzeitpunkt neueste veröffentlichte Release ist v0.1.1.

Entscheide, was Azuriom ersetzen soll

Eine Community-Website und ein Zahlungsdienst lösen unterschiedliche Probleme. Ein sinnvoller Ausgangspunkt ist eine selbst gehostete Azuriom-Seite mit einem sichtbaren Navigationslink „Store“ zu deinem bestehenden Tebex-Webstore. So bleiben die Pflege der Website und der Checkout samt Auslieferung der Pakete getrennt. Du kannst die Website starten, bevor du eine tiefere Shop-Integration versuchst.

AzLink ist eine separate Verbindung zwischen Azuriom und FXServer. Es tauscht Serverinformationen aus und kann Befehle ausführen, die die Website zurückgibt. Die Installation verbindet deine Tebex-Käufe nicht automatisch, importiert keine Abos und überträgt keine Kundendaten. Das offizielle AzLink-FiveM-Repository dokumentiert die Ressource; unser Vergleich von Azuriom und Tebex behandelt die weiteren Unterschiede bei Software und Shop.

Lass einen direkten Stripe- oder PayPal-Checkout aus dieser Monetarisierung für FiveM-Server heraus. Dass ein Zahlungs-Plugin verfügbar ist, begründet keine Erlaubnis, diesen Zahlungsweg für deinen Server zu nutzen.

1. Hosting vorbereiten und das funktionierende Setup sichern

Du brauchst für Azuriom einen Webhosting-Account oder VPS, eine Domain mit HTTPS, Datenbankzugriff und die Berechtigung, die Ressourcen deines FXServers und die Server-Konsole zu verwalten. Azuriom ist eine PHP-Anwendung; seine Dateien in den Ordner „resources“ von FiveM zu legen, erzeugt keine Website.

Zum Prüfzeitpunkt verlangen die offiziellen Installationsvoraussetzungen PHP 8.2 oder neuer, die aufgeführten PHP-Erweiterungen und Symlink-Unterstützung. MySQL/MariaDB oder PostgreSQL wird empfohlen. Lass den Hoster die vollständigen Anforderungen prüfen, statt dich auf einen Tarif zu verlassen, der nur als „PHP-Hosting“ beschrieben ist.

Speichere vor jeder Änderung eine Kopie von server.cfg, eines vorhandenen AzLink-Ordners und der aktuellen Website-Konfiguration. Wenn du ein bestehendes CMS ersetzt, sichere Dateien und Datenbank. Starte auf einem separaten Hostnamen, damit die bestehende Website und der Store während der Abnahme erreichbar bleiben. Notiere, wie du DNS und die vorherige Webserver-Konfiguration wiederherstellst.

Checkpoint: Dein vorgesehener Hostname lädt über HTTPS und du hast Zugriff auf das Hosting-Panel, die Datenbank und die FXServer-Konsole. Halte Datenbankpasswörter und Bridge-Schlüssel aus Screenshots und öffentlichen Support-Beiträgen heraus.

2. Die Azuriom-Website installieren

Lade das Installationspaket von der offiziellen Website von Azuriom herunter. Lade es an den von deinem Hoster vorgesehenen Website-Ort hoch und entpacke es dort, einschließlich versteckter Dateien. Folge den Webserver-Anweisungen des Herstellers; bei Nginx endet das dokumentierte Document Root der Anwendung auf /public.

Öffne die Seite im Browser, schließe den Installer ab, gib die Datenbankverbindung an und lege den ersten Administrator an. Wähle die FiveM-Identitätsoption, die zu deiner Community passt. Die Bridge unterscheidet Steam-basierte und Cfx-basierte Identitäten, halte die Wahl der Website also konsistent mit den Konten deiner Spieler. Gehe nicht davon aus, dass ein Discord-Anzeigename die Spielerkennung ist.

Nutze die Installationsanleitung für geplante Aufgaben, wenn aktivierte Funktionen sie benötigen. Lass die Debug-Ausgabe in der Produktion deaktiviert, beschränke den Dateizugriff passend zum Deployment-Modell deines Hosters und prüfe, dass private Konfigurationsdateien nicht heruntergeladen werden können.

Checkpoint: Melde dich als Administrator an, speichere eine kleine Inhaltsänderung und sieh sie dir dann abgemeldet an. Prüfe, dass ein normales Konto keine Verwaltungsseiten öffnen kann. Dass die Startseite lädt, ist nur die erste dieser Prüfungen.

3. Die Seite nützlich machen, bevor du den Shop anbindest

Lege die Seiten an, die Spieler brauchen: Servervorstellung, Beitrittsanleitung, Regeln und einen klaren Support-Kontakt. Setze den Store in die Hauptnavigation und nutze die URL deines bestehenden Tebex-Stores als Ziel. Teste diesen Link in einem abgemeldeten Browser und auf dem Handy.

Nutze ein Theme, das diese Aufgaben leicht auffindbar hält. Installiere Erweiterungen nur für Funktionen, die du auch betreiben willst, und notiere ihre Versionen, damit spätere Updates gegen dieselbe Konfiguration getestet werden können. Eine umfassendere Planungs-Checkliste findest du in unserem Leitfaden zum Erstellen einer Website für einen FiveM-Server.

Checkpoint: Ein neuer Besucher findet Beitrittsanleitung, Regeln, Support und Store des Servers, ohne eine Administrator-Sitzung zu nutzen.

4. Die offizielle Ressource AzLink-FiveM installieren

Lade die Ressource von der Releases-Seite des Repositorys herunter. Entpacke sie so, dass das Stammverzeichnis der Ressource azlink heißt und direkt fxmanifest.lua und das Verzeichnis server enthält. Vermeide einen zusätzlichen verschachtelten Archivordner.

resources/
└── azlink/
    ├── fxmanifest.lua
    └── server/

Für den ersten Start verwendet die README des Herstellers diese Anweisungen für die Server-Konsole. Führe zuerst refresh aus, wenn du den Ordner hinzugefügt hast, während FXServer bereits lief:

refresh
start azlink

Damit die Ressource nach einem Server-Neustart startet, trage sie in server.cfg ein:

ensure azlink

Das Manifest der Bridge deklariert eine reine Server-Ressource; diese Anweisungen installieren keine Gameplay-Integration für ESX, QBCore oder Qbox. Befehle, die Charaktere oder Inventare betreffen, brauchen eine eigene, Framework-spezifische Umsetzung und eigene Tests. Diese Quellcode-Prüfung belegt keine getrennte Laufzeit-Abnahme für GTAV Legacy und Enhanced.

Checkpoint: FXServer meldet, dass die Ressource ohne Fehler wegen fehlendem Manifest oder Skriptfehler gestartet ist. Das belegt den Start, aber noch keine funktionierende Verbindung zur Website.

5. FXServer mit der Website verknüpfen

Füge deinen Gameserver im Verwaltungsbereich von Azuriom unter Servers hinzu. Nutze die für diesen Server angezeigten Einrichtungswerte. Die geprüfte Befehlsimplementierung akzeptiert die Basis-URL der Website, gefolgt vom Site-Key:

azlink setup https://community.example.com YOUR_SERVER_SITE_KEY
azlink status
azlink fetch

https://community.example.com und YOUR_SERVER_SITE_KEY sind Platzhalter. Führe das echte Setup in der Server-Konsole aus, mit den Werten aus deinem eigenen Dashboard. Die Ressource hängt /api/azlink selbst an die Basis-URL an; hänge es nicht noch einmal an. Halte den Schlüssel privat.

Nach erfolgreichem Setup speichert die Ressource ihre Verbindungseinstellungen in config.json im Ressourcenverzeichnis. Behalte diese Datei beim Aktualisieren der Ressource. Behandle ihre Sicherung als sensibel, da sie die Zugangsdaten der Bridge enthält. Prüfe das Ergebnis nach einem Neustart der Ressource erneut, damit eine nur im Arbeitsspeicher bestehende Verbindung keine fehlgeschlagene Speicherung der Konfiguration verdeckt.

Checkpoint: Der Status bestätigt die Verbindung, der Abruf (fetch) läuft durch und die Website zeigt den verbundenen Server. Tritt mit einem Testaccount bei und vergleiche die Spielerinformationen mit FXServer. Prüfe den gewählten Identitätsmodus, bevor du spielerspezifische Aktionen versuchst.

6. Kostenpflichtige Pakete beim Tebex-Weg belassen

Für den einfachsten Start behältst du den Navigationslink zu deinem Tebex-Webstore. Richte die Auslieferung kostenpflichtiger Pakete über die bestehende Tebex-Verbindung ein und dupliziere diese Aktionen nicht in AzLink. Falls du diese Verbindung noch brauchst, erklärt unser Tutorial zur Einrichtung eines FiveM-Tebex-Stores die Store-Seite.

Wenn du später Pakete direkt in Azuriom durchsuchbar machen willst, führt der Marketplace eine Tebex-Integration-Erweiterung von Bricec6 eines Drittanbieters. Ihre Auflistung beschreibt eine Integration der Tebex Headless API. Prüfe vor dem Einsatz ihre aktuelle Kompatibilität, Abhängigkeiten und Pflege. Dieser Artikel hat die Erweiterung nicht getestet, daher hängt das oben beschriebene Basis-Setup nicht von ihr ab.

Bevor ein neuer Kaufablauf live geht, prüfe Kontozuordnung, das tatsächliche Checkout-Ziel, die Paketauslieferung und den Support-Weg. Behalte Kaufhistorie und aktive Abos im funktionierenden System, bis eine separat getestete Migration existiert. Ein Redesign der Website ist kein Beleg dafür, dass diese Datensätze oder Verlängerungsvereinbarungen mitgezogen sind.

AzLink-Fehlerbehebung

Die Ressource wird nicht gefunden

Prüfe den Ordnernamen und die Verschachtelung. Das Manifest gehört nach resources/azlink/fxmanifest.lua. Aktualisiere die Ressourcenliste, nachdem du Dateien hinzugefügt hast, und sieh dir dann den ersten Fehler in der Server-Konsole an.

Die Ressource startet, aber die Website ist getrennt

Prüfe die konfigurierte HTTPS-Basis-URL und den passenden Server-Key. Der HTTP-Client ruft den Endpunkt /api/azlink der Website auf. Sieh in den Zugriffs- und Fehlerprotokollen der Website nach diesem Pfad. DNS-Fehler, TLS-Probleme, Weiterleitungen auf einen anderen Hostnamen, Authentifizierungsschranken oder Browser-Challenges können verhindern, dass FXServer die erwartete API-Antwort erhält.

Behebe den Zugriff für die vorgesehene API-Route, ohne den Schutz der gesamten Website abzuschalten. Gib bei Hilfeanfragen HTTP-Status, Zeitstempel und Ressourcenversion an; schwärze Zugangsdaten und Spielerkennungen.

Der Status funktioniert, aber Spieler oder Aktion sind falsch

Prüfe den Abgleich von Steam- und Cfx-Identität, die aktuelle Verbindung des Spielers und die Anforderungen des Zielbefehls. Die Bridge setzt Spielerinformationen in Befehle ein und führt sie über die Server-Konsole aus. Eine erfolgreiche HTTP-Anfrage kann nicht beweisen, dass der Befehl die beabsichtigte Änderung im Gameplay bewirkt hat.

Nutze zuerst eine harmlose Aktion mit einem Testaccount. Teste das Verhalten bei getrennten Spielern separat, bevor du dich auf eine Aktion verlässt, die eine Server-ID eines Online-Spielers erwartet. Die Zugangsdaten für Website-Verwaltung und Bridge verdienen deshalb dieselbe Sorgfalt wie andere Wege, die Serverbefehle auslösen können.

Prüfungen für Start und Rollback

Gehe live, sobald die abgemeldete Website, die Berechtigungen normaler Nutzer, die mobile Navigation, die dauerhafte Bridge-Verbindung und der vorgesehene Tebex-Kaufweg geprüft sind. Halte die Versionen von CMS, Erweiterungen und Ressource, das Datum und das, was du tatsächlich getestet hast, schriftlich fest.

Wenn die Verbindung zur Website Probleme macht, leite Besucher auf die vorherige Website zurück, stelle bei Bedarf deren Konfiguration und Datenbank wieder her und stoppe AzLink, während du der Ursache nachgehst. Stelle die gesicherte Ressourcenkonfiguration nur wieder her, wenn sie noch zur vorgesehenen Website und zum Servereintrag passt. Halte das bestehende Shop-System während der gesamten Umstellung verfügbar.

Azuriom gibt dir die Kontrolle über die Website, die deine Spieler nutzen. Für einen FiveM-Server lässt dieser Leitfaden Tebex für den Monetarisierungsablauf zuständig sein, während AzLink die Verbindung zwischen Website und Server übernimmt.