gta6/prompts
appearance
Vaultintermediateappearance

Ped Model Selector

ESX/QBCore/QBox ped-model swap menu that loads special/creature peds, re-applies saved appearance, and persists the chosen model server-side.

NON-TESTÉ — the reference Lua is syntax-validated, not run in a live FiveM server. Adapt and test on your own dev server before shipping.
Est. Lua
~92 loc
Claude
Claude Opus 4.x / Sonnet 4.x
Validation
syntax-validated
Updated
2026-06-25

Description

A menu-driven ped-model selector that lets a player switch to any special or creature ped, then automatically re-applies their saved appearance so the swap doesn't wipe their look. The chosen model is validated and persisted server-side so it survives reconnects — a steady utility servers running non-human peds keep paying for.

Prompt Template

Write a FiveM Lua resource for a ped-model selector menu, targeting <esx|qbcore|qbox accessed via its exports (never hardcode the framework global).

🔒 Eyes-only — locked prompt body

The full prompt template and its reference Lua are part of a one-time pack. Pick your depth — both are lifetime access, no subscription, ever.

Core$49one-time
  • 60 prompts + syntax-validated reference Lua
  • Lifetime access — pay once
Most Popular · Best Value
Vault$199one-time
  • All 510 prompts — the full library
  • Per-prompt profit/trend intelligence (CSV + playbook)
  • Lifetime free updates — new niches as the market moves
Get the Vault — $199

$49 for 60 · $199 for all 510 + intelligence — one-time, no subscription.

Expected Output

See content/expected-outputs/appearance/25-ped-model-selector.lua — implements an allow-listed ped swap that requests/loads the model, re-applies appearance, and persists the choice through a…

🔒 Eyes-only — locked prompt body

The full prompt template and its reference Lua are part of a one-time pack. Pick your depth — both are lifetime access, no subscription, ever.

Core$49one-time
  • 60 prompts + syntax-validated reference Lua
  • Lifetime access — pay once
Most Popular · Best Value
Vault$199one-time
  • All 510 prompts — the full library
  • Per-prompt profit/trend intelligence (CSV + playbook)
  • Lifetime free updates — new niches as the market moves
Get the Vault — $199

$49 for 60 · $199 for all 510 + intelligence — one-time, no subscription.

Known Failure Modes & Corrective Prompt

  • Swapping the model resets ped components, so the saved skin is lost unless re-applied after load.
  • SetPlayerModel fires before HasModelLoaded returns true, spawning a default ped.
  • A malicious client could persist a non-allowed model if the server doesn't re-check the allow-list.

Corrective re-prompt: "The new ped spawns naked/default. After SetPlayerModel, re-request and re-apply the saved appearance components, and confirm the model allow-list is re-validated server-side before persisting — return the corrected client.lua and server.lua."

Framework Integration

  • ESX: resolve identity with ESX.GetPlayerData() client-side and persist via a server event using xPlayer.identifier.
  • QBCore: read/write the skin through exports['qb-clothing'] and store the model on Player.PlayerData.metadata.
  • QBox: use exports.qbx_core:GetPlayer(src) and persist the model in player metadata via the qbx player API.

Profit Potential

$150–$2000/mo on Tebex (expected ~$500). [INFERRED] priced in the $50-389 script band against the signal-scraper tebex_snapshot corpus (median seller $11.85K/mo, n=100), scaled for a stable utility niche.

Trend Signal

→ stable — inferred: Full ped-model swap with appearance re-apply is a steady utility for non-human/special-ped servers.

Sales Angle

Position as the persistent ped-identity layer for creature/special-ped RP servers. Recommended Tebex price $79.

Difficulty & Ship Time

intermediate · ships in 2-4h.