Zum Inhalt springen

Website-Bridge anbinden (Lua)

Last updated 21.11.2026 17:53:49 by Administrator

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

  1. 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).
  2. 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.
  • consume ist idempotent: erneutes Bestätigen derselben benefit_ref liefert already: true.