> For the complete documentation index, see [llms.txt](https://lng.gitbook.io/lng-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lng.gitbook.io/lng-docs/simple-name-tags/readme.md).
# Welcome to Simple Name Tags
Welcome to the official documentation for Simple Name Tags.
*Finally, name tags that actually workβand look good doing it.* This mod has evolved from a basic script into a fully configurable, feature-rich identity system. It is designed to be highly optimized and crash-proof, featuring soft-dependency architecture that integrates seamlessly with other mods like Expansion Hardline without requiring hard links that cause server crashes.
***
### β¨ Core Features
* π§ Creature & Zombie Tags: You can now assign custom name tags to AI entities! Give specific boss zombies custom names, levels, and colors, or let the system automatically pull their vanilla names.
* ποΈ Voice Integration: A dynamic microphone icon appears and lights up green when a player is actively talking (fully Push-to-Talk compatible).
* π€ Automated AFK System: Players are automatically marked as `[AFK]` (in red) and their rank icons are hidden if they haven't moved for a set time, reducing screen clutter.
* π€ Expansion Hardline Sync: Automatically detects Expansion Hardline and displays the player's Reputation value right next to their name. No hard dependency required!
* ποΈ Ranks & Reputation: Assign custom icons (Vanilla or Modded) and Star Ratings (1-5 Stars) to specific players via their SteamID.
* π Unlimited Custom Tags: Create custom roles (e.g., `[OWNER]`, `[MEDIC]`, `[VIP]`) with unique hex colors and assign them to your community members.
* π΅οΈ Admin Incognito Mode: Admins can press `Ctrl + H` to toggle their tag completely OFF. Your tag becomes invisible to players, but turns grey on your screen so you know stealth is active.
* π Live Auto-Reloading: The server can be set to automatically reload the config every X minutes, or admins can manually press `Ctrl + N` to live-reload tags without restarting the server.
* π‘οΈ Crash-Proof Configs: Our built-in "Auto-Patcher" detects outdated config files and automatically updates them with new features. You never have to delete or wipe your config after a mod update.
***
### β οΈ PvP vs. PvE Server Warning
This mod was primarily designed for PvE and Co-op servers where identifying friends quickly is more important than absolute stealth.
For PvP Server Owners:
Simple Name Tags utilizes a "Smart Raycast Filter" that stops tags from showing through solid walls and terrain. However, to prevent the frustrating "flickering" found in other mods, it is designed to see through "soft" objects like bushes, grass, and invisible mod triggers (like Safezones). This means it may occasionally reveal a player hiding in dense foliage.
> π‘ Recommendation for PvP: We highly recommend lowering the `MaxDistance` in your configuration to 10m - 20m (Default is 50m). This simulates realistic "face recognition" rather than long-range spotting.
***
### π Installation & File Migration
1. Copy the `@SimpleNameTags` folder to your server directory.
2. Copy the `.bikey` file from the `Keys` folder to your server's `Keys` folder.
3. Add `-mod=@SimpleNameTags` to your server start parameters.
Important Note for Existing Users:
The configuration files have migrated! Upon your first run, the mod will automatically move your old files to the new unified studio folder:
`$profile:LNGStudio/SimpleNameTags/`
***
### π Documentation Navigation
Select a section below to start configuring your tags:
#### βοΈ The Configuration Guide
*(Link to next page)*
The complete breakdown of the `SimpleNameTagsConfig.json` and `CreaturesTags.json`. Learn how to set up your layout styles, assign SteamIDs, and configure the AFK timers.
***
*Special Thanks to @Lufson for the great ideas and feedback used to improve this mod!*
***
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://lng.gitbook.io/lng-docs/simple-name-tags/readme.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.