#📏 FX-SCALE

Advanced player identity and scale editing system for RedM with NPC shops, command system, and dynamic event-based usage.

---

#📦 Installation

bashensure fx-scale

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

---

#⚙️ Basic Settings

luaConfig.Debug = false
Config.Language = "en"

• Debug → enable/disable debug mode
• Language → system language

---

#🌐 Locale System

luaConfig.Locale = {
  ["en"] = {
    ["errorFirstname"] = "...",
  }
}

• Multi-language support
• Includes EN / TR / DE
• Fully customizable messages

---

#🎯 Command System

luaConfig.Command = {
  Enable = true,
  CommandName = "editplayer"
}

• Opens edit menu via command
• Example → /editplayer

---

luagroups = {"admin","mod"}

• Restricts command usage
• Leave empty → everyone can use

---

luaparams = {
  { name = "id", type = "number" }
}

• Allows targeting other players
• /editplayer 12

---

luascaleLimit = { min = 0.50, max = 1.35 }

• Defines allowed player scale range
• Prevents extreme values

---

luamoney = {
  changename = { cash = 1 },
  changescale = { cash = 1 }
}

• Defines price for changes
• Supports cash and gold

---

#🧍 NPC Shop System

luaConfig.Coords = {
  [1] = {
    npcCoord = vector4(...)
  }
}

• Defines NPC shop locations
• Player interacts with NPC to open menu

---

luapedCoords = {
  mainPed = vector4(...),
  clonePed = vector4(...)
}

• Main ped → player position
• Clone ped → preview model

---

luacamera = {
  coords = vector3(...),
  rotation = vector3(...),
  fov = 60.0
}

• Static camera for editing
• Focuses on player and clone

---

#🎯 Prompt System

luaConfig.Prompts = {
  ["change"] = {
    Label = "EDIT PLAYER"
  }
}

• Interaction prompt for NPC
• Hold key to open menu

---

#⚙️ Mode Settings

luaConfig.UseTarget = false
Config.UseCoords = true

• UseTarget → use target system
• UseCoords → use NPC locations

---

#🔄 Dynamic Mode (Command & Event)

luaTriggerEvent("fx-scale:server:forceOpenMenu", source)

• Opens menu without NPC
• Works from any script
• Uses player current position

---

• No teleport required
• Clone ped spawns next to player
• Camera auto-adjusts
• Works with admin tools

---

#🧠 Features

textName Change
Scale Change
NPC System
Command System
Event System

• Change firstname & lastname
• Adjust player height (scale)
• Supports multiple usage methods

---

#🔐 Security System

textServer-side validation
Session tracking

• All actions validated server-side
• Prevents exploit attempts
• Secure session system

---

#🎯 HUD Integration

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

• Hides HUD during menu
• Compatible with fx-hud

---

#🔔 Notification System

luaNotify({
  text = "Success"
})

• Supports VORP / RSG / REDEMRP
• Handles server & client notifications

---

#🌐 Server Config

luaSV_Config.Webhook = {
  url = ""
}

• Discord webhook system
• Logs player actions

---

#⚠️ Important Notes

• Scale limits must be configured
• NPC coords must be valid
• Command permissions must be set
• Prices must match economy
• Target system optional

---

#🚨 Common Issues

• Menu not opening → command disabled
• NPC not working → wrong coords
• Scale not changing → limit issue
• Name not saving → validation failed
• Camera broken → wrong camera config

---

#🏁 Summary

FX-SCALE provides:

• Player identity editing
• Scale (height) system
• NPC-based shops
• Command-based usage
• Event-based integration
• Secure server validation

---

© Fixitfy Development