# 🌟 [QB/ESX/Qbox] VSS Advanced Nametag - Extremely Optimized Next-Gen 3D Name & Beginner System

## 🚀 Extreme Optimization

The most significant feature of this script is its ultimate performance optimization.

## 🔰 Auto Beginner System

Comes with a built-in system to warmly welcome new players to your city.

It automatically tracks playtime in the database and displays a beginner icon (🔰) above the player's head for their first 5 hours (configurable). The icon disappears automatically once the time is up, so there is absolutely no manual management required by admins!

## 🎨 High Customizability

Players can open an intuitive UI via the `/namemenu` command to freely adjust their personal settings.

Nickname & Label Settings: Set a custom display name or a roleplay-specific title (label).

Custom Colors: Individually change the color of the name and label using a sleek color picker.

Visibility Toggle: Includes a feature to hide your own name from other players for a more immersive experience.

## 💡 Smart Features for Immersion

Auto-Hide in Vehicles: Names are automatically hidden while inside a vehicle to maintain realistic visibility.

Hide Behind Walls (RayCast): When enabled, names of players behind walls will not be displayed.

Multi-Language Support: The default language file provided is English (`en`) only, but you can easily translate and support any other language by adding and editing your own language files.

Auto Framework Detection: Automatically detects and works seamlessly with QBCore, Qbox, and ESX. No tedious setup required.

## 📋 Dependencies

 [ox_lib]

 [oxmysql]

 QBCore / Qbox / ESX

---

🔒 Safe Customizability (Escrow)

While the core logic is securely protected by the Tebex Escrow system, the `config.lua` and `locales/` folder (language files) are left completely open and accessible. You can freely configure and translate the script to match your server's needs immediately after purchase.