FAQ & Troubleshooting
The admin menu does not appear
Run /wskindiag in game and read the F8 console. It prints the detected framework and the result of every individual permission check, so you can see exactly which one is failing.
The most common cause is that an add_ace line was added to server.cfg but the server was never restarted. Ace lines only load at server boot, and restarting the resource does not re-read server.cfg. To apply one immediately, paste it into the live server console instead:
add_ace group.admin orb.weaponskins allowA YouTube link will not load
Live streams and age-restricted videos cannot be resolved. Regular videos work.
If nothing loads at all, check the server console: the resource logs every resolution attempt and prints the reason when one fails.
A direct .mp4 URL always works and never depends on any external service.
The weapon shows no skin
That weapon's texture name is not what the config expects. See Adding Weapons and use /wskinscan.
Part of the weapon stays unskinned
Its magazine or stock uses a texture name outside the default list. /wskinparts will find it.
The skin looks like a black patch
The video has letterboxing (black bars). Once mapped onto a weapon those bars become black areas. Use a full-frame clip.
Players see a "slow down" message
The resolver is rate limited, by default one request every five seconds per player. This stops a player from spamming the menu and flooding the video service. Adjust it with Config.ResolveCooldown.
Does every player need to download the video?
Each client streams the video itself while a skin is active. Short, low resolution loops are much lighter than long clips, which is another reason seamless loops are the right choice.
Does it work on the Enhanced build?
Yes, on a current build. If you are on an older GTA V Enhanced early-access client, update it: several appearance and texture natives were broken there and fixed in later patches.
Can players upload their own videos?
No, and that is deliberate. Only admins publish skins. Players choose from the published library, which keeps you in control of what appears on your server.