Website-Bridge anbinden (Lua)
Die Bridge verbindet den Spielserver mit dem Website-Backend (Odoo 20) von www.echtwelt-life.de: User Authentication, E-Commerce-Verknüpfung, Whitelist-Status und Event-Ingest.
Voraussetzungen
- Auf der Website: unter Echtwelt Bridge → Game-Server einen Server-Eintrag
anlegen und per „Token generieren" ein
ew_…-Token erzeugen (gespeichert wird nur der SHA-256-Hash). - Lua-Config in der FiveM-Ressource:
Config.BridgeURL = 'https://www.echtwelt-life.de'
Config.BridgeToken = 'ew_…' -- aus der Website-Verwaltung
Auth-Header
Jeder Request trägt den Header:
X-EW-Token: <token>
Account-Verknüpfung (User Authentication)
Der Spieler erzeugt im Website-Profil einen zeitlich begrenzten Code (30 min) und lässt ihn ingame einlösen:
PerformHttpRequest(Config.BridgeURL .. '/ew_bridge/link', function(status, body)
local resp = json.decode(body or '{}')
if resp.ok then
print(('Verknuepft mit %s (Whitelist: %s)'):format(resp.partner.name, tostring(resp.whitelisted)))
else
print('Fehler: ' .. tostring(resp.error))
end
end, 'POST', json.encode({
code = 'AB-CD-EF', -- Code aus dem Website-Profil
identifier = 'license:' .. playerIdHex,
character_name = 'Max Mustermann',
}), { ['X-EW-Token'] = Config.BridgeToken, ['Content-Type'] = 'application/json' })
Antwort: ok, partner und whitelisted — oder error
(missing_parameters, code_not_found, code_expired_or_used).
Gekaufte Vorteile abrufen (E-Commerce)
Shop-Käufe, Membership-Pläne, Abos und Filebase-Freischaltungen:
PerformHttpRequest(Config.BridgeURL .. '/ew_bridge/benefits/' .. identifier,
function(status, body)
for _, b in ipairs(json.decode(body).benefits) do
-- b.ref, b.type ('shop'|'membership'|'subscription'|'filebase'), b.products …
-- Im Spiel ausliefern, dann bestaetigen:
end
end, 'GET', nil, { ['X-EW-Token'] = Config.BridgeToken })
Auslieferung bestätigen (idempotent):
PerformHttpRequest(Config.BridgeURL .. '/ew_bridge/benefits/consume',
function() end, 'POST', json.encode({
identifier = identifier,
benefit_ref = 'sale.order/42',
benefit_type = 'shop',
}), { ['X-EW-Token'] = Config.BridgeToken, ['Content-Type'] = 'application/json' })
Whitelist-Status prüfen
PerformHttpRequest(Config.BridgeURL .. '/ew_bridge/whitelist/' .. identifier,
function(status, body)
local r = json.decode(body)
-- r.known, r.whitelisted, r.partner_id
end, 'GET', nil, { ['X-EW-Token'] = Config.BridgeToken })
Events melden
PerformHttpRequest(Config.BridgeURL .. '/ew_bridge/event',
function() end, 'POST', json.encode({
identifier = identifier,
event_type = 'join', -- join|leave|whitelist_granted|purchase_delivered|custom
payload = { server_slot = 128 },
}), { ['X-EW-Token'] = Config.BridgeToken, ['Content-Type'] = 'application/json' })
Events landen als ew.event in der Website-DB — Grundlage für Chronik und Automatisierungen.
Bei join wird automatisch last_seen_at des verknüpften Accounts aktualisiert.
Identifier
Der Identifier ist die eindeutige Spielkennung, z. B. license:<hex> aus der
FiveM-License. Er taucht in allen Bridge-Endpunkten auf und bildet den Spiel-Account
(ew.account) auf den Website-Benutzer ab.
Fehlerverhalten
- Fehlender/ungültiger Token → Zugriff verweigert (nur aktive Server-Token matchen).
- Unbekannter Identifier →
{'linked': false}bzw. leere Benefits-Liste, kein Fehler. consumeist idempotent: erneutes Bestätigen derselbenbenefit_refliefertalready: true.