API-Referenz
Exports
Client-Exports
Shutdown
Schließt den Ladebildschirm manuell.
luaexports['HCS_loadingscreen']:Shutdown()
UpdateCharacter
Aktualisiert die Charakterdaten im Ladebildschirm.
luaexports['HCS_loadingscreen']:UpdateCharacter({ name = 'John Doe', cash = '500 $' })
| Prop | Typ |
|---|---|
| character | table (Schlüssel aus Config.Character.Fields, z. B. name, cash, bank, job, playtime) |
PushConfig
Schickt die letzten Server-Daten erneut an den Ladebildschirm (ohne Wirkung, solange noch nichts empfangen wurde).
luaexports['HCS_loadingscreen']:PushConfig()
Server-Exports
SetPlayerCharacter
Setzt eigene Charakterdaten für einen Spieler (z. B. unter Standalone).
luaexports['HCS_loadingscreen']:SetPlayerCharacter(src, { name = 'John Doe', job = 'Police' })
| Prop | Typ |
|---|---|
| src | number |
| data | table |
| return | boolean |
GetPlayerCharacter
Gibt die ermittelten Charakterdaten eines Spielers zurück.
luaexports['HCS_loadingscreen']:GetPlayerCharacter(src)
| Prop | Typ |
|---|---|
| src | number |
| return | table |
ClearPlayerCharacter
Entfernt die eigenen Charakterdaten eines Spielers wieder.
luaexports['HCS_loadingscreen']:ClearPlayerCharacter(src)
| Prop | Typ |
|---|---|
| src | number |
RefreshDiscordCache
Lädt Team und Galerie sofort neu aus Discord.
luaexports['HCS_loadingscreen']:RefreshDiscordCache()
| Prop | Typ |
|---|---|
| return | boolean |
GetTeamCache
Gibt die aktuell zwischengespeicherten Teammitglieder zurück.
luaexports['HCS_loadingscreen']:GetTeamCache()
| Prop | Typ |
|---|---|
| return | table |
GetGalleryCache
Gibt die aktuell zwischengespeicherten Galerie-Bilder zurück.
luaexports['HCS_loadingscreen']:GetGalleryCache()
| Prop | Typ |
|---|---|
| return | table |
Events
Charakter- und UI-Daten kommen beim Verbinden hauptsächlich über deferrals.handover (window.nuiHandoverData). Die Events unten sind optional (Live-Aktualisierung, Exports).
Die Events heißen jetzt HCS_loadingscreen:*. Die alten Namen hcs_loading:* funktionieren nicht mehr.
Client-Events
Set Data
Schickt die kompletten UI-Daten an den Ladebildschirm.
luaTriggerClientEvent('HCS_loadingscreen:setData', src, payload)
| Prop | Typ |
|---|---|
| src | number |
| payload | table (character, team, gallery, Branding, Musik usw.) |
Update Character
Aktualisiert nur den Charakter-Bereich.
luaTriggerClientEvent('HCS_loadingscreen:updateCharacter', src, character)
| Prop | Typ |
|---|---|
| src | number |
| character | table |
Server-Events
Request Data
Optional: die kompletten UI-Daten neu anfordern (z. B. nach SetPlayerCharacter).
luaTriggerServerEvent('HCS_loadingscreen:requestData')
Request Character
Optional: nur die Charakterdaten neu anfordern.
luaTriggerServerEvent('HCS_loadingscreen:requestCharacter')
