FiveM Peds sind Charaktermodelle, die für Spieler, Jobs, Umgebungs-NPCs oder geskriptete Szenen verwendet werden. Ein Add-on-Ped fügt normalerweise einen neuen Modellnamen hinzu; ein Ersatz-Ped überschreibt ein vorhandenes GTA V-Modell. Add-ons sind in der Regel einfacher zu isolieren und rückgängig zu machen, während Ersetzungen jede Ressource beeinflussen können, die das ursprüngliche Modell aufruft.
Bestätige die Ziel-GTA-Edition, bevor du Assets installierst oder exportierst. Legacy-Pakete sind nicht automatisch Enhanced-ready; befolge die offizielle Anleitung zur Enhanced-Asset-Konvertierung wenn dies dein Ziel ist.
Technische Grundlage: überprüft am 9. August 2026 anhand der offiziellen Cfx.re Ressourcenmanifest-Dokumentation. Befolge immer die eigene Lizenz und Installationshinweise des Pakets.
Was ein Ped-Paket enthalten sollte
Ein streamfähiges Modell enthält üblicherweise Drawable- und Texturdateien sowie ein Ressourcenmanifest. Die genauen Dateien unterscheiden sich je nach Modelltyp. Benenne keine Dateien um oder kopiere sie in eine andere Ressource, bevor du die Paketstruktur verstanden hast; Modellnamen, Metadaten und Skriptreferenzen müssen weiterhin übereinstimmen.
Add-on oder Ersatz?
| Typ | Am besten für | Hauptrisiko |
|---|---|---|
| Add-on-Ped | Benannte Charaktere, Jobs und Opt-in-Spielermodelle | Modellnamenskollisionen oder ein Skript, das keine benutzerdefinierten Modelle unterstützt |
| Ersatz-Ped | Ein bewusster globaler visueller Ersatz | Unerwartete Änderungen, wo immer das Originalmodell verwendet wird |
| Geskripteter NPC | Läden, Missionen und Szenen | Clientseitiges Spawning, Netzwerk-Ownership oder Bereinigungsfehler |
Installations-Workflow
- Überprüfe die Lizenz und bestätige, dass die Weiterverbreitung und die Nutzung auf kommerziellen Servern erlaubt sind.
- Erstelle eine dedizierte Ressource, anstatt nicht zusammenhängende Modelle zu mischen.
- Behalte das bereitgestellte Manifest und die Ordnerstruktur bei, es sei denn, die Dokumentation besagt etwas anderes.
- Füge die Ressource zur Staging-Serverkonfiguration hinzu und starte sie in einem kontrollierten Zeitfenster neu.
- Spawne das Modell über den dokumentierten Befehl, das Menü oder Skript – nicht über einen angenommenen universellen Befehl.
- Teste die Wiederverbindung, Kleidung/Komponenten, Animationen, Fahrzeuge, Waffen und das Rendern in der Ferne.
Leistungs- und Qualitätsprüfungen
- Überprüfe die Texturauflösung und Dateigröße. Ein visuell einfacher Ped kann immer noch überdimensionierte Texturen enthalten.
- Teste mehrere Kopien gleichzeitig; ein einzelnes Modell in einer leeren Szene repräsentiert keinen belebten Server.
- Achte auf fehlende Texturen, fehlerhafte Detailstufen, Clipping und Animationsfehler.
- Bestätige, dass gespawnte NPC-Entitäten von dem Skript bereinigt werden, das sie erstellt, wenn dessen Szene endet oder es stoppt; die Streaming-Ressource allein ist nicht für diesen Lebenszyklus verantwortlich.
- Überprüfe die F8-Konsole des Clients und die Serverkonsole auf Streaming- oder Modellfehler.
Häufige Fehler
Wenn das Modell unsichtbar ist, überprüfe, ob die Ressource gestartet wurde und der angeforderte Modellname mit den gestreamten Dateien übereinstimmt. Wenn Texturen fehlen, stelle die ursprünglichen Dateinamen und die Paketstruktur wieder her. Wenn nur ein Skript den Ped nicht auswählen kann, bestätige, dass das Skript Add-on-Modelle unterstützt und dass jede Zulassungsliste den richtigen Namen verwendet. Mache die dedizierte Ressource rückgängig, wenn Abstürze oder Speicherprobleme nach der Bereitstellung auftreten.
Bevor du einen Ped veröffentlichst
Bewahre den Ersteller, die Lizenz, die Version, die Quell-URL und die Installationshinweise bei der Ressource auf. Vermeide es, ein Modell erneut zu veröffentlichen, wenn die Lizenz fehlt. Für serverweite Kaufentscheidungen verwende die RPCrate-Checkliste vor dem Kauf.