FX-WORKER

#📦 Installation

bashensure fx-worker

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

---

#⚙️ Basic Settings

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

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

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

---

#🧠 Framework System

luaFramework = "VORP" or "RSG"

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

---

#🏪 Worker Market System

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

• Defines worker shop locations
• Spawns NPC and stash

---

luamodel = "mp_chu_rob_rathskeller_males_01"
stashModel = "p_storagecartnbx01x"

• NPC model for worker market
• Stash object model

---

luablips = {
  name = "Worker Shop"
}

• Map blip system
• Fully customizable

---

#🎯 Interaction System

luaConfig.UseTarget = true

• Supports:
• ox_target
• murphy_interact
• pc_interaction

---

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

• Prompt fallback system
• Used if target disabled

---

#📦 JSON Data System

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

luaConfig.MaximumWorkerCount = 5

• Limits worker count per player

---

luaConfig.MaximumWorkerCountChars = {
  [51] = 5
}

• Overrides limit per charid

---

#⚡ Stamina System

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

• Workers regenerate stamina over time
• Prevents infinite working

---

#🍞 Food System

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

• Feed workers to restore stamina
• Includes cooldown system

---

#📊 Level System

luaConfig.Levels = {}

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

---

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

• Defines work duration
• Controls XP gain and stamina cost

---

#🏭 Job System

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

• Defines worker job types
• Each job has separate logic

---

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

• Items worker can collect
• Supports luck system

---

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

• Work locations
• Multiple slots per job

---

#🎭 Animation System

luaanimation = function(ped)

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

---

#📦 Warehouse System

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

• Limits stored items
• Prevents overflow

---

#💰 Economy System

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

luaNotify({
  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