Smart Unique ID Display for QBCore — LOS / Spectator / Vehicle / Death Hidden — Clean 3D Text
Lightweight and privacy-friendly Unique ID display system for QBCore servers. The ID shows above players only when they are visible and in line of sight, and auto-hides when the player is spectating, dead, sleeping, or inside a vehicle (optional). Fully configurable through config.lua.

📌 Full Description

This script provides a clean and dynamic 3D Unique ID system for Roleplay servers using QBCore. It improves player visibility and identification while still protecting privacy and immersion by only showing IDs when it makes sense.

The Unique ID will display above players’ heads, turning green when they are talking. The script includes built-in smart hiding logic to ensure your RP environment stays immersive and realistic.

✅ Features

• Clean 3D text display (no background box — sleek RP look)

• Smart hiding system:

  • Hidden when no Line Of Sight (LOS)

  • Hidden during Spectator Mode

  • Hidden when dead

  • Hidden when sleeping / laying down

  • Hidden inside vehicles (toggleable)

• Talking detection — ID turns green while the player is speaking

• Lightweight & performance optimized (distance checks + thread sleeping)

• Configurable settings in config.lua

• Full client ↔ server sync for Unique IDs

• Easy setup & clean code with comments

🎮 Why this script?

Unlike basic name tag scripts, this system is fully LOS-based, meaning you can’t see an ID through walls or obstacles — just like real RP visibility. It also automatically disables during spectator mode to prevent meta-gaming or administrative spying abuse.

Perfect for:

• Serious roleplay servers

• Staff enforcement without revealing player identities globally

• Immersive / hardcore RP style

• Clean UI setups

📂 Included Files

• client/main.lua

• server/main.lua

• config.lua

• Installation Guide (README)

• Optional customization instructions

🔧 Requirements

• QBCore Framework

• FiveM Server

🛠 Installation

1. Drag the resource into your server resources folder

2. Add ensure qb-uniqueid in your server.cfg

3. Adjust values in config.lua (distance, vehicle toggle, etc.)

4. Restart and enjoy

🤝 Support

This resource comes with support for setup or minor adjustments.