Installation

config.lua anpassen (Grenzwerte, Blacklist, Datumsformat).
Die alte Identity-Resource entfernen oder deaktivieren (siehe unten).

Die SQL-Änderungen laufen beim Start automatisch (je nach erkanntem Framework: ESX users, QB players).

cfg
ensure oxmysql
ensure es_extended   # oder qb-core / qbx_core
ensure HCS_lib
ensure HCS_identity

ESX (Ersatz für esx_identity)

stop esx_identity bzw. den Resource-Ordner entfernen.
ensure HCS_identity nach es_extended eintragen.
esx_multicharacter bleibt kompatibel (Events und Callback esx_identity:*).

Falls esx_multicharacter esx_identity fest als Dependency einträgt: In dessen fxmanifest.lua die Dependency auf HCS_identity ändern oder die Zeile entfernen.

QBCore / Qbox

Bei einem neuen Charakter-Slot:

lua
TriggerClientEvent('HCS_identity:client:openRegistration', src, citizenid)

Alternativ über die Events:

lua
TriggerClientEvent('qb-multicharacter:client:startIdentity', src, citizenid)
TriggerClientEvent('qbx_core:client:registerIdentity', src, citizenid)

Oder per Server-Export:

lua
exports['HCS_identity']:OpenRegistration(src, citizenid)

Standalone

Speichern und Prüfen bindest du in shared/functions.lua an, beides auf dem Server:

Funktion	Beschreibung
`Functions.SaveIdentity(src, identity)`	Identität in deinem Framework speichern, bei Erfolg `true` zurückgeben. Standard: löst `HCS_identity:completedRegistration` aus.
`Functions.HasIdentity(src)`	`true`, wenn der Spieler schon eine Identität hat. Verhindert, dass sich jemand ein zweites Mal registriert.

identity enthält firstName, lastName, dateOfBirth (Format aus Config.DateFormat), sex ('m' oder 'f'), height und nationality.

Solange Functions.HasIdentity immer false zurückgibt, kann ein Spieler die Registrierung erneut auslösen und seinen Namen ändern. Binde die Funktion unter Standalone an.

SQL (automatisch)

Beim Start der Resource läuft automatisch die passende Migration (HCSConfig.Framework bzw. automatische Erkennung):

ESX: nationality in users (entspricht sql/esx_install.sql)
QBCore / Qbox: nationality in players (entspricht sql/qb_install.sql)
Standalone: keine Datenbank-Änderung

Zum Nachschlagen oder für eine frische Installation:

sql/esx_install.sql: ADD COLUMN nationality in users
sql/esx_full.sql: komplette users-Tabelle inklusive nationality
sql/qb_install.sql: ADD COLUMN nationality in players
sql/qb_full.sql: komplette players-Tabelle inklusive nationality

ZurückKonfiguration

WeiterKonfiguration