LexoNETDocs
Docs 0.6.0Anmelden
Architektur und API

LexoNET Bridge und FiveM

lexo_bridge verbindet einen Spielserver mit dem MDT. Police, Medic, Mechanic und Crime laufen eigenständig und werden nicht durch die MDT-Anbindung installiert.

#Bezug und Lieferumfang

Die LexoNET Bridge wird im Shop über Tebex verkauft und über das Cfx.re-Konto ausgeliefert. Voraussetzungen: ESX Legacy, oxmysql, ox_lib (empfohlen). Unterstützte Framework-Versionen, ACE-Regeln und weitere Befehle stehen in der mitgelieferten Anleitung.

#Installation vorbereiten

  1. Die Bridge über das Cfx.re-Konto herunterladen.
  2. In die Ressourcenstruktur des Servers entpacken. Ressourcenordner lexo_bridge verwenden; keine zweite verschachtelte Kopie starten.
  3. Framework und benötigte Adapter gemäß Paketdokumentation zuerst starten.
  4. Im Kundenbereich die Spielanbindung des richtigen Workspace und Servers öffnen. Nur die dort ausgegebene Zieladresse und den passenden Schlüssel verwenden.
  5. Den Konfigurationsblock serverseitig eintragen. Die Werte unten sind Platzhalter, keine Zugangsdaten.
server.cfg
set lexonet_url "<ZIELADRESSE-AUS-DER-SPIELANBINDUNG>"
set lexonet_key "<SERVERSEITIGER-SCHLUESSEL>"
ensure lexo_bridge

Für den Schlüssel set, niemals setr verwenden. Konfiguration mit echten Werten nicht committen oder fotografieren. Schlüssel und Ticketadressen nicht ins NUI oder in allgemeine Clientevents übernehmen.

#Verbindung und Anmeldung prüfen

  1. Ressource starten; fehlende Abhängigkeiten und Verbindungsfehler prüfen.
  2. Integrationsstatus im MDT kontrollieren. Ein Kontakt erteilt noch kein Fachrecht.
  3. Job und Behörden-Slug zuordnen; fiktiven Testnutzer mit aktiver Mitgliedschaft vorbereiten.
  4. Im eigenen MDT-Profil einen Einmalcode erstellen und im Spiel /mdtlink CODE ausführen. Laut Connector-Vertrag ist der Code zehn Minuten gültig und einmal nutzbar.
  5. Dienstmeldung und Schnelllogin getrennt testen. Ein Ticket gilt 60 Sekunden und einmal; beim erneuten Öffnen ein neues anfordern.

#Zwei getrennte API-Verträge

Die Plattform erzeugt einen Bearer-Serverkey für /api/v1/game/. Der MDT-Connector v1 verwendet dagegen eine eigene HMAC-Integration und X-HS-*-Köpfe. Der generierte server.cfg-Block adressiert die Plattform, nicht automatisch die Connector-Basis. Die Bridge übernimmt die Kommunikation mit beiden Seiten. Den Plattform-Key nicht als HMAC-Geheimnis einsetzen.

#Rechte und Leistung

Fachrechte liegen im MDT: beispielsweise dienst.melden und desktop.nutzen. Ein ESX-Job oder Discord-Rang ersetzt sie nicht. Zusätzliche ACE-Regeln nur aus der Anleitung der Bridge übernehmen.

Für resmon gibt es keinen festen Zielwert. Vor dem Livebetrieb Leerlauf, geöffnetes MDT, mehrere Nutzer, Netzfehler und Wiederverbindung messen. Clientzeit, Serverzeit, Speicher, Anfragefrequenz und Queue-Länge dokumentieren. Permanente Tick-Abfragen für HTTP und ungebremste Wiederholungen vermeiden; ping laut API-Vertrag höchstens alle fünf Minuten senden.

#Typische Fehler

ProblemPrüfen
Ressource fehltOrdnername, Paketstruktur, Startreihenfolge
401 zeitSystemuhr synchronisieren; Signatur mit neuer Sendezeit bilden
Nicht verknüpftKennung, Einmalcode, Mandant
Login verweigertMitgliedschaft, Sperre, desktop.nutzen, IC-Zugangsrichtlinie
NUI blockiertFreigegebene CSP-Herkunft; keine ungültigen Hostnamen

#Wer darf das?

Serveradministration installiert und konfiguriert die Ressource. Systemleitung verwaltet Integrationen und MDT-Rechte. Spieler verknüpfen nur die eigene Identität.