Entity Creation¶

Clientseitig platzierte Entities für NPC-Setups, Props, Deko und interaktive Szenen. Die Erstellung läuft über cv.world.createEntity() im npccreator-Modul und nutzt Native-Funktionen statt ESX oder ox_lib.

Übersicht¶

Features¶

✅ Clientseitige Entity-Erstellung - Objekte direkt auf dem Client erzeugen
✅ Optionen pro Entity - Freeze, Collision, Visibility, Invincible, Mission Entity
✅ Ground Placement - Optional automatisch auf den Boden setzen
✅ Netzwerksteuerung - Netzwerked oder lokale Entities möglich
✅ Cleanup bei Resource Stop - Erstellte Entities werden automatisch entfernt

Client API¶

`cv.world.createEntity(modelHash, coords, heading?, options?)`¶

Erstellt ein Entity-Objekt clientseitig.

Parameter¶

modelHash - Model-Hash oder Hash-Key des Props
coords - vector3, vector4 oder Tabellenform mit x, y, z
heading - optionaler Heading-Wert in Grad
options - optionale Konfiguration

Optionen¶

freeze (boolean, default true) - friert die Entity ein
collision (boolean, default true) - bei false wird Collision deaktiviert
invincible (boolean, default true) - macht die Entity unverwundbar
visible (boolean, default true) - bei false wird die Entity versteckt
placedOnGround (boolean, default true) - setzt das Objekt auf den Boden
missionEntity (boolean, default true) - markiert die Entity als Mission Entity
networked (boolean, default true) - erstellt ein Netzwerk-Objekt
dynamic (boolean, default false) - setzt die Entity dynamisch
clearModel (boolean, default true) - gibt das Model nach der Erstellung frei

Rückgabewert¶

entity - Entity Handle oder nil bei Fehler

Beispiel¶

local prop = cv.world.createEntity(`prop_park_ticket_01`, vector4(214.74, -811.04, 29.70, 160.06), 160.06, {
    freeze = true,
    collision = false,
    invincible = true,
    visible = true,
    placedOnGround = true,
})

if prop then
    print('Prop erfolgreich erstellt')
end

NPC-Modul Integration¶

cv.world.createNPC() bleibt für Ped-Erstellung zuständig, cv.world.createEntity() ergänzt das Modul für Props und andere World-Objekte.

Kombinierte Nutzung¶

local npc = cv.world.createNPC(`a_m_m_business_1`, vector4(214.74, -811.04, 29.70, 160.06))
local sign = cv.world.createEntity(`prop_park_ticket_01`, vector4(214.74, -811.04, 29.70, 160.06), 160.06, {
    freeze = true,
    collision = false,
})

Hinweise¶

Erzeugte Entities werden im Client-Modul intern in cv.world.entityList gespeichert.
Beim Resource-Stop werden alle registrierten Entities automatisch gelöscht.
Für serverseitige Entity-Lifecycle-Logik bleibt das separate cv.entities-Modul zuständig.