RetroPed - Known Issues & Solutions
Common issues you may encounter and their solutions. If you find an error here that matches your situation, you can resolve it by applying the solution.
Invisible Ped Model
Section titled “Invisible Ped Model”Symptom: Your custom ped does not appear in-game after spawning.
How to Fix
Section titled “How to Fix”-
Verify that your ped files are placed correctly based on your installation method:
- Method 1: Inside the
[retroped]category folder - Method 2: Directly in the
resourcesfolder
- Method 1: Inside the
-
Make sure you have a valid FiveM Patreon subscription (minimum: Cfx.re Element Club Argentum) for asset streaming on production servers
-
For local testing without a license, set
sv_maxclients 1in yourserver.cfg:sv_maxclients 1
Broken Face or Hair Issues
Section titled “Broken Face or Hair Issues”Symptom: Ped’s face looks deformed, eyes are glitched, or hair color changes when rotating the camera.
Root Cause
Section titled “Root Cause”This is typically caused by incompatible clothing scripts that apply head blend data to all ped models, including custom ones that don’t support it. Default ESX/QBCore clothing stores often trigger this.
How to Fix
Section titled “How to Fix”Switch to a clothing menu that properly handles custom peds:
- illenium-appearance - Recommended, full custom ped support
- Raid Clothes - Also compatible with add-on models
Clothing Menu Compatibility
Section titled “Clothing Menu Compatibility”Standard ESX and QBCore clothing scripts do not fully support custom peds. We recommend using illenium-appearance or Raid Clothes for the best experience.