📏 FX-SCALE

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

---

📦 Installation

ensure fx-scale

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

---

⚙️ Basic Settings

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

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

---

🌐 Locale System

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

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

---

🎯 Command System

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

• Opens edit menu via command • Example → /editplayer

---

groups = {"admin","mod"}

• Restricts command usage • Leave empty → everyone can use

---

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

• Allows targeting other players • /editplayer 12

---

scaleLimit = { min = 0.50, max = 1.35 }

• Defines allowed player scale range • Prevents extreme values

---

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

• Defines price for changes • Supports cash and gold

---

🧍 NPC Shop System

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

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

---

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

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

---

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

• Static camera for editing • Focuses on player and clone

---

🎯 Prompt System

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

• Interaction prompt for NPC • Hold key to open menu

---

⚙️ Mode Settings

Config.UseTarget = false
Config.UseCoords = true

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

---

🔄 Dynamic Mode (Command & Event)

TriggerEvent("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

Name Change
Scale Change
NPC System
Command System
Event System

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

---

🔐 Security System

Server-side validation
Session tracking

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

---

🎯 HUD Integration

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

• Hides HUD during menu • Compatible with fx-hud

---

🔔 Notification System

Notify({
  text = "Success"
})

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

---

🌐 Server Config

SV_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