free-resources
Status

Status

Lightweight, High-Performance Player Status System | Framework Agnostic

lcky-status is a modern player status system with advanced Bridge system for full framework compatibility.


✨ Features

FeatureDescription
🌉 Bridge SystemAuto-detects qbx_core, qb-core, or ESX
💾 Metadata StorageUses native framework metadata (no SQL tables)
🎨 Modern UIox_lib context menus and input dialogs
👁️ Multi-TargetingWorks with ox_target and qb-target
🔊 Proximity AlertsNotifies players within 10m when status changes
Optimized0.00ms idle performance
🛠️ Developer APIComprehensive exports for integration

📦 Compatibility

Supported Frameworks

  • ✅ Qbox (qbx_core)
  • ✅ QBCore (qb-core)
  • ✅ ESX (es_extended)

Supported Target Systems

  • ✅ ox_target
  • ✅ qb-target

Dependencies


� Installation

# 1. Place in resources folder
# resources/lcky-status/
 
# 2. Add to server.cfg
ensure lcky-status
 
# 3. Restart server

🎮 Usage

For Players

Set Status

/status

Opens a menu where you can:

  • Set Status - Enter a custom message (e.g., "Working", "AFK - Brb")
  • Clear Status - Remove your current status

View Others' Status

Press your interaction key (default Alt) while looking at another player to see their status.


🔊 Proximity Notifications

When you update your status, players within a 10-meter radius receive a notification informing them of the change.


💻 Developer API

Server-Side Exports

-- Get a player's status
local status = exports['lcky-status']:GetPlayerStatus(source)
-- Returns: "Working at the Forge" or nil
 
-- Set a player's status
exports['lcky-status']:SetPlayerStatus(source, "Custom Status")

Client-Side Exports

-- Get your current status from server
local status = exports['lcky-status']:GetPlayerStatusFromServer()

📄 License

Developed by LuckyScripts Special thanks to Qbox Project and Overextended team