👷 FX-WORKER

Advanced worker management system for RedM that allows players to hire workers, send them to jobs, collect resources, manage stamina, and trade workers dynamically.

---

📦 Installation

ensure fx-worker

• Place script into your resources folder • Add to server.cfg • Restart your server • Automatically detects framework (VORP / RSG)

---

⚙️ Basic Settings

Config.Language = "en"
Config.UseSql = true
Config.UseTarget = true

• Language → UI language system • UseSql → true = SQL / false = JSON system • UseTarget → enables target system (ox_target, etc.)

---

🌐 Locale System

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

• Multi-language support • Supports dynamic variables (${value}) • Fully customizable messages

---

🧠 Framework System

Framework = "VORP" or "RSG"

• Auto-detects framework • Handles inventory, money, and player data • Unified wrapper system (FXAddItem, FXRemoveMoney, etc.)

---

🏪 Worker Market System

Config.Markets = {
  ["BLACKWATER"] = {
    coords = vector4(...)
  }
}

• Defines worker shop locations • Spawns NPC and stash

---

model = "mp_chu_rob_rathskeller_males_01"
stashModel = "p_storagecartnbx01x"

• NPC model for worker market • Stash object model

---

blips = {
  name = "Worker Shop"
}

• Map blip system • Fully customizable

---

🎯 Interaction System

Config.UseTarget = true

• Supports: • ox_target • murphy_interact • pc_interaction

---

Config.Prompts = {
  ["market"] = {}
}

• Prompt fallback system • Used if target disabled

---

📦 JSON Data System

workers.json
stash.json
sales.json
workersInformation.json

• Stores all worker data • stash.json → warehouse system • sales.json → worker marketplace • workersInformation.json → names & models

---

👷 Worker System

Config.MaximumWorkerCount = 5

• Limits worker count per player

---

Config.MaximumWorkerCountChars = {
  [51] = 5
}

• Overrides limit per charid

---

⚡ Stamina System

Config.RechargeStamina = {
  recharge = true,
  rechargeTime = 10,
  rechargeValue = 5.0
}

• Workers regenerate stamina over time • Prevents infinite working

---

🍞 Food System

Config.Foods = {
  {
    item = "bread",
    stamina = 25
  }
}

• Feed workers to restore stamina • Includes cooldown system

---

📊 Level System

Config.Levels = {}

• XP-based leveling system • Higher level = better rewards

---

Config.WorkTimes = {
  [1] = {stamina = 1, addXP = 25}
}

• Defines work duration • Controls XP gain and stamina cost

---

🏭 Job System

Config.Jobs = {
  ["Fisherman"] = {}
}

• Defines worker job types • Each job has separate logic

---

items = {
  {item = "fish", min = 1, max = 3}
}

• Items worker can collect • Supports luck system

---

coords = {
  {
    coord = vector4(...)
  }
}

• Work locations • Multiple slots per job

---

🎭 Animation System

animation = function(ped)

• Each job has custom animation • Includes: • Fishing • Mining • Lumberjack • Farming

---

📦 Warehouse System

Config.WareHouseLimits = {
  ["copper"] = 100
}

• Limits stored items • Prevents overflow

---

💰 Economy System

gold = { min = 1000, max = 1000 }

• Worker price system • Supports gold & cash

---

🔄 Worker Lifecycle

• Hire worker • Send to work • Consume stamina • Generate items • Store in warehouse • Recall worker • Sell worker

---

🔔 Notification System

Notify({
  text = "Message"
})

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

---

⚠️ Important Notes

• JSON files must exist • Worker jobs must be configured • Inventory items must match config • Target system optional • SQL mode must match setup

---

🚨 Common Issues

• Workers not spawning → wrong coords • Cannot hire → max worker reached • Worker not working → no stamina • No items gained → wrong job config • Warehouse full → limit reached

---

🏁 Summary

FX-WORKER provides:

• Worker hiring system • Job-based resource system • Stamina & food system • XP & leveling system • Market & trading system • Warehouse storage system • Multi-framework support

---

© Fixitfy Development