Add-on-Ped unsichtbar oder crasht? So behebst du es
Ein Add-on-Ped, der als gar nichts lädt, als graue oder lila Schaufensterpuppe erscheint oder den Client crasht, hat fast immer eine von sechs Ursachen. Prüf sie in dieser Reihenfolge.
1. Die Dateien liegen nicht in stream/
FiveM streamt nur Assets in einem Ordner namens stream (in beliebiger Tiefe darunter). Ein Ped, der im Root der Resource oder in einem Ordner namens models liegt, lädt nie. Prüf, ob jede .ydd, .yft, .ytd und .ymt des Peds unter stream/ liegt.
2. peds.meta fehlt oder wird nicht geladen
Ein neuer Ped braucht einen Eintrag in peds.meta, und das Manifest muss sie laden:
files { 'peds.meta' }
data_file 'PED_METADATA_FILE' 'peds.meta'Ohne das existiert zwar der Modellname, aber das Spiel hat keine Ped-Definition und spawnt nichts oder fällt auf einen Standard-Ped zurück.
3. Die Namen stimmen nicht überein
Der Modellname in peds.meta, die .yft, die .ydd und die .ytd müssen alle denselben Basisnamen haben. Ein Tippfehler, und die Texturen oder Drawables schlagen stillschweigend fehl. Schreib alles klein; vermeide Leerzeichen und Bindestriche.
4. Zu große Texturen
Ein zu großes Texture Dictionary (eine einzelne .ytd über 16 MB oder eine Handvoll 4K-Maps) lädt unter Umständen einfach nicht. Das zeigt sich als unsichtbarer oder untexturierter Ped und auf schwächeren Clients als Crash. Verkleinere die Texturen; ein Ped braucht selten Maps über 2048 px.
5. Ein Skelett, das GTA nicht kennt
Wenn der Ped erscheint, aber in T-Pose steht, rutscht oder verdrehte Gliedmaßen hat, passen Skelett und Weights nicht zu dem, was GTAs Animationen erwarten. Wenn du auf dem Freemode-Skelett aufbaust, vermeidest du das komplett: Darauf läuft jede Animation und jedes Emote.
6. Zu viele Kleidungs-Collections
Wenn mit dem neuen Ped plötzlich jeder männliche oder weibliche MP-Ped crasht, liegt das Problem nicht am Ped, sondern an den Kleidungs-Collections, die mitgeladen werden: GTA lädt nur eine begrenzte Anzahl an .ymt-Kleidungsdateien pro Geschlecht. Schau dir dazu den Guide zum YMT-Limit an.
Isoliert testen
Starte einen Server nur mit deinem Framework und dem Ped und spawne ihn mit SetPlayerModel. Funktioniert er dort, überschreibt eine andere Resource denselben Modellnamen oder überschreitet ein Limit.
Häufig gefragt
Der Ped ist unsichtbar, aber ich sehe seinen Schatten oder sein Namensschild. Warum?
Das Modell wurde gestreamt, seine Drawables aber nicht: meistens ein Texture Dictionary, das nicht geladen werden konnte (zu groß oder falscher Name), oder Drawables, die anders heißen, als das Modell erwartet.
Der Ped steht in T-Pose und bewegt sich nicht. Warum?
Sein Skelett ist keins, das GTAs Animationen kennen. Animationen laufen auf benannten Bones; ein Ped mit eigenem Skelett spielt nur Animationen ab, die für ihn gemacht wurden.
Kann ein einziger kaputter Ped alle crashen?
Ja. Ein Ped, dessen Dateien die Streaming-Limits überschreiten oder dessen Meta fehlerhaft ist, kann jeden Client crashen, der ihn streamt. Deshalb sieht es oft wie ein zufälliger Absturz an einer bestimmten Stelle aus.
Kostenlos ausprobieren
Erstelle ein kostenloses Konto, tritt für deine Credits dem Discord bei und baue dein erstes Asset in wenigen Minuten.