🎭 FX-PEDMENU

Advanced ped menu system for RedM that allows players to change their character model, manage ped requests, and integrate seamlessly with frameworks like VORP and RSG.

---

📦 Installation

ensure fx-pedmenu

• Place the script inside your resources folder • Add ensure fx-pedmenu to your server.cfg • Restart your server

---

🗄️ SQL Setup

CREATE TABLE IF NOT EXISTS `fx_pedmenu`
CREATE TABLE IF NOT EXISTS `fx_pedmenu_admin`

• Stores player ped data and admin requests • Required for saving ped selections and approvals

---

⚙️ Basic Configuration

Config.OpenMenu = "pedmenu"
Config.Language = "en"

• Command to open ped menu → /pedmenu • Language system for UI and notifications

---

🌐 Locale System

Config.Locale = {
  ["en"] = {
    ["successrequest"] = "..."
  }
}

• Multi-language support • Fully customizable messages

---

⏳ Ped Time System

Config.PedTimeSettings = {
  [1] = 1,
  [2] = 7,
  [3] = 30,
  [4] = 60,
  [5] = 90
}

• Defines how long a ped can be used (in days) • Minimum 1, maximum 5 options

---

👶 Kid Ped Settings

Config.UseWeaponKidPeds = true

• Allows child peds to use weapons

Config.whitelistKidWeapons = {
  [GetHashKey("WEAPON_MELEE_KNIFE")] = true
}

• Restricts allowed weapons for kid peds

Config.KidPedModels = {
  ["cs_mixedracekid"] = true
}

• Defines which models are considered kid peds

---

🧩 Ped Categories

PedList = {
  { name = "MAN PEDS" },
  { name = "WOMEN PEDS" },
  { name = "ANIMAL PEDS" }
}

• All ped categories are defined in peds.lua • Fully customizable list system • Supports unlimited ped entries

---

🎯 Command System

/pedmenu

• Opens ped selection menu • Automatically detects framework

---

🔄 Character Refresh System

Config.RefreshCharacter = function(data)

• Reloads character after ped change • VORP → /rc • RSG → /loadskin

---

🎨 After Model Change

Config.AfterSetPlayerModel = function()

• Runs after ped is applied • You can add custom logic here

---

🖥️ HUD Integration

Config.HideHud = function()
Config.ShowHud = function()

• Automatically hides HUD when menu opens • Works with fx-hud

---

🔔 Notification System

Notify({
  text = "Message",
  type = "success"
})

• Supports VORP and RSG frameworks • Handles server & client notifications

---

📤 Exports

exports['fx-pedmenu']:GetLastPed()

• Returns last used ped model

exports['fx-pedmenu']:LoadLastPed()

• Loads saved ped model with attributes

---

🔗 Version Checker

versionchecker.lua

• Automatically checks for updates from GitHub • Prints update logs in console

---

🌐 Server Config

SV_Config.Webhook = {
  url = "YOUR_WEBHOOK"
}

• Sends logs to Discord webhook • Optional system

---

⚙️ Framework Integration

• Supports VORP and RSG automatically • Uses internal framework detection • No manual switch required

---

🔧 VORP REQUIRED EDIT

🟠 Character Load Override

LoadPlayerComponents(...)

• Required for ped persistence after reload

---

🔴 Reload After Death

vorpcharacter:reloadafterdeath

• Ensures last ped is restored after death

---

🔵 Reload Command

RegisterCommand(Config.ReloadCharCommand, ...)

• Loads last ped if available • Falls back to default character

---

⚠️ Important Notes

• SQL must be installed before use • Do not mix with old pedmenu versions • Max 5 PedTimeSettings allowed • Framework auto-detection must work properly

---

🚨 Common Issues

• Ped not saving → SQL missing • Ped not loading → VORP edit not applied • Menu not opening → wrong command • Kid ped weapon issues → whitelist not configured

---

🏁 Summary

FX-PEDMENU provides:

• Advanced ped switching system • Admin request & approval system • Full framework compatibility • Persistent ped saving system • Export-based integration system • Highly customizable ped categories

---

© Fixitfy Development