# Name tag

Name tags are used to append custom texts above players and zombies with displaying condition.

## Features

* Option to customise text that appends above, you can also set to empty value for no name
* Option to hide player name tags, to make it harder to detect players in game (classic mode only)
* Configurable condition when to display this name tag for entities

<figure><img src="/files/35jXZGByAGrYL5qfLWGl" alt=""><figcaption></figcaption></figure>

## Configuration

```yml
custom-name:
  text: '<red>❤ <white>%health%/%max-health%'
  display-condition:
    type: damage
    condition: '5'
```

* `text` - The text to display, set to   (empty value) for no name tag
* `display-condition.type` - The type of condition, these can be
  * `damage` - to display only when the entity got damaged by something and appears for x seconds or always
  * `always` - always displays after a game has started
  * `below_health` - when the entity's health is under x condition `health < x`
* `display-condition.condition` - The condition to validate the type with
  * If the type is `below-health` you can use [mathematical operators](/ragemode-docs/mathematical-operations.md) for condition
    * ```yml
      condition: maxhealth - 2.0 # maxhealth = 20.0
      ```
      * \= 18.0, this case custom name will only appear if this condition met otherwise not
      * You can use `maxhealth` (for max health) and `currenthealth` (for current health) variables for health data
    * If the type is `damage` the custom name will only appear on mob damage (including health regeneration) for x seconds. Set to 0 to always display after damage


---

# Agent Instructions: 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:

```
GET https://mdswork.gitbook.io/ragemode-docs/global-game-guides/name-tag.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.