[RELEASE] af-nametag - Optimized Nametag System

FiveM Releases
, , ,
1

[RELEASE] af-nametag - Optimized Nametag System

a
a1920Ă—1200 127 KB

preview_but store

Version

Framework

Description

af-nametag is a highly optimized and feature-rich nametag system designed for FiveM servers. Built with performance in mind, this resource uses statebags and native text rendering to provide smooth and efficient nametag displays even on high-population servers.

Features

honest

Core Features

  • Multi-Framework Support: Works seamlessly with QB-Core, QBox, and ESX frameworks (auto-detection available)
  • Performance Optimized: Uses statebags for efficient data synchronization and native rendering methods
  • Raycast Line-of-Sight: Only displays nametags when players are visible (no wallhacks)
  • Distance-Based Rendering: Configurable maximum view distance to reduce overhead
  • Customizable Colors: Full RGBA color customization for all elements

Advanced Features

  • Damage Flash System: Nametags flash red when a player takes damage
  • AFK Detection: Automatically detects and marks AFK players with a different color
  • Player ID Toggle: Command to show/hide player IDs above nametags
  • Enemy Marking System: Mark specific players with a different color (persistent across restarts via JSON storage)
  • Text Outline: Optional outline for better visibility in all conditions
  • Underage Indicator: Automatically shows (M) marker for minor characters

Mask System

  • Dynamic Masking: Players can wear masks to hide their identity
  • Inventory Integration: Uses mask items from your inventory system (ox_inventory, qb-inventory, etc.)
  • Custom Mask Command: /wearmask to toggle masks on/off
  • Masked Name Display: Shows custom name (e.g., “Masked”) when wearing a mask
  • Force ID Display: Optionally show IDs even when masked
  • Smooth Animations: Realistic mask putting on/taking off animations

Screenshot_1
Screenshot_1675Ă—681 35.2 KB

Commands

  • /nametagid - Toggle display of player IDs (configurable)
  • /markenemy - Mark a player as an enemy (changes their nametag color)
  • /wearmask - Put on/remove mask (requires mask item in inventory)

Configuration

Extensive configuration options available:

  • Display distances and offsets
  • Font types and scales
  • Color schemes (text, damage, ID, enemy, AFK, outline)
  • Update intervals and raycast settings
  • Toggle features on/off
  • Mask system customization
  • AFK detection thresholds

Installation

  1. Download and extract af-nametag to your resources folder
  2. Add ensure af-nametag to your server.cfg
  3. Configure config.lua to your preferences
  4. (Optional) Add mask item to your inventory - see MASK_ITEM_SETUP.md for instructions
  5. Restart your server

Dependencies

  • QB-Core / QBox / ESX framework
  • No additional dependencies required

Customization

All aspects of the nametag system can be customized through the [config.lua] file, including:

  • Colors (RGBA values)
  • Distances and positioning
  • Font types and sizes
  • Feature toggles
  • Command names
  • Mask item and outfit settings

Notes

  • Uses statebags for optimal performance
  • Enemy marks are saved to JSON file for persistence
  • Line-of-sight checking prevents nametags showing through walls
  • Compatible with most clothing/outfit systems for mask functionality

inefablejuly-dog-with-a-helicopter-station-on-his-head

:bug: Support

in script trouble?

saul
saul400Ă—234 26.6 KB

Advanced Studio | Support Discord
Code is accessible No
Subscription-based No
Lines (approximately) 500
Requirements & dependencies Standalone
Support Yes
1 Like
2

Valid :100:

1 Like