#🎭 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

bashensure fx-pedmenu

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

---

#🗄️ SQL Setup

sqlCREATE 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

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

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

---

#🌐 Locale System

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

• Multi-language support
• Fully customizable messages

---

#⏳ Ped Time System

luaConfig.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

luaConfig.UseWeaponKidPeds = true

• Allows child peds to use weapons

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

• Restricts allowed weapons for kid peds

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

• Defines which models are considered kid peds

---

#🧩 Ped Categories

luaPedList = {
  { 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

lua/pedmenu

• Opens ped selection menu
• Automatically detects framework

---

#🔄 Character Refresh System

luaConfig.RefreshCharacter = function(data)

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

---

#🎨 After Model Change

luaConfig.AfterSetPlayerModel = function()

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

---

#🖥️ HUD Integration

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

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

---

#🔔 Notification System

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

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

---

#📤 Exports

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

• Returns last used ped model

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

• Loads saved ped model with attributes

---

#🔗 Version Checker

luaversionchecker.lua

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

---

#🌐 Server Config

luaSV_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

luaLoadPlayerComponents(...)

• Required for ped persistence after reload

---

#🔴 Reload After Death

luavorpcharacter:reloadafterdeath

• Ensures last ped is restored after death

---

#🔵 Reload Command

luaRegisterCommand(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