FiveM peds are character models used for players, jobs, ambient NPCs or scripted scenes. An add-on ped normally adds a new model name; a replacement ped overwrites an existing GTA V model. Add-ons are usually easier to isolate and roll back, while replacements can affect any resource that calls the original model.
Technical basis: reviewed 9 August 2026 against the official Cfx.re resource manifest documentation. Always follow the package’s own license and install notes.
What a ped package should contain
A streamable model commonly includes drawable and texture files plus a resource manifest. The exact files differ by model type. Do not rename files or copy them into another resource until you understand the package structure; model names, metadata and script references must continue to match.
Add-on or replacement?
| Typ | Najlepsze dla | Główne ryzyko |
|---|---|---|
| Add-on ped | Nazwane postacie, zawody i opcjonalne modele graczy | Kolizje nazw modeli lub skrypt, który nie obsługuje niestandardowych modeli |
| Zamienny ped | Celowa globalna zamiana wizualna | Nieoczekiwane zmiany wszędzie tam, gdzie używany jest oryginalny model |
| Skryptowany NPC | Sklepy, misje i sceny | Błędy związane z tworzeniem po stronie klienta, własnością sieciową lub czyszczeniem |
Przepływ pracy instalacji
- Sprawdź licencję i potwierdź, że redystrybucja i użycie na serwerze komercyjnym są dozwolone.
- Utwórz dedykowany zasób, zamiast mieszać niepowiązane modele.
- Zachowaj dostarczony manifest i strukturę folderów, chyba że dokumentacja mówi inaczej.
- Dodaj zasób do konfiguracji serwera stagingowego i zrestartuj w kontrolowanym oknie.
- Wygeneruj model za pomocą udokumentowanej komendy, menu lub skryptu – nie zakładaj uniwersalnej komendy.
- Przetestuj ponowne połączenie, ubrania/komponenty, animacje, pojazdy, broń i renderowanie na odległość.
Testy wydajności i jakości
- Sprawdź rozdzielczość tekstur i rozmiar pliku. Wizualnie prosty ped może nadal zawierać nadmiernie duże tekstury.
- Przetestuj kilka kopii naraz; pojedynczy model w pustej scenie nie reprezentuje ruchliwego serwera.
- Uważaj na brakujące tekstury, uszkodzone poziomy szczegółowości, przenikanie i niedopasowanie animacji.
- Potwierdź, że model został usunięty po zatrzymaniu zasobu nadrzędnego lub zakończeniu sceny skryptowej.
- Sprawdź wyjście konsoli F8 klienta i serwera pod kątem błędów strumieniowania lub modeli.
Typowe błędy
Jeśli model jest niewidoczny, sprawdź, czy zasób został uruchomiony, a żądana nazwa modelu pasuje do przesłanych plików. Jeśli brakuje tekstur, przywróć oryginalne nazwy plików i strukturę pakietu. Jeśli tylko skrypt nie może wybrać postaci, upewnij się, że skrypt obsługuje dodatkowe modele, a wszelkie listy dozwolonych używają poprawnej nazwy. Wycofaj dedykowany zasób, jeśli po wdrożeniu pojawią się awarie lub problemy z pamięcią.
Przed publikacją postaci
Zachowaj twórcę, licencję, wersję, adres URL źródła i uwagi dotyczące instalacji wraz z zasobem. Unikaj ponownego publikowania modelu, gdy licencja jest nieobecna. W przypadku decyzji o zakupie dla całego serwera użyj FiveMX lista kontrolna przed zakupem.