🏷️ groups.yml

This file controls how LiteNameTags groups are defined and displayed.

---

Overview

The groups.yml file is based on named group entries.

Each group defines:

• who receives it

• how important it is compared to other groups

• how the nametag should look

• which lines should be displayed

• optional conditions for advanced setups

---

Group Structure

Each group includes the following main sections:

• permission

• weight

• scale

• condition

• display

• background

• lines

---

permission

Defines which permission a player must have in order to receive the group.

Example: permission: litenametags.group.admin

---

weight

Defines the group's priority.

Higher weight means higher priority.

If a player matches multiple groups, the group with the highest weight will normally be used.

---

scale

Controls the overall nametag scale.

This can be useful if you want certain groups to appear slightly larger or smaller.

---

condition

Defines an optional condition that must also be true for the group to apply.

This allows more advanced setups beyond simple permissions.

For example, a group can require both a permission and a minimum Vault balance.

---

display

The display section controls how the nametag is rendered.

Main options

• default-billboard

• y-offset

• view-distance

• sneak-opacity

• lighting

Notes

• y-offset changes the vertical position of the nametag

• view-distance controls how far away the nametag can be seen

• sneak-opacity changes transparency while sneaking

• lighting can be used if you want fixed light values

---

background

The background section controls the nametag background.

Main options

• type

• enabled

• opacity

• shadowed

• seeThrough

Depending on the selected type, you may also use:

• hex

• red

• green

• blue

Notes

• hex backgrounds are useful for direct color-based setups

• integer RGB backgrounds allow separate red, green, and blue control

• disabling the background gives a cleaner floating-text style

---

lines

The lines section defines the text shown in the nametag.

You can use:

• plain text

• legacy colors

• placeholders

• multiple lines

Example:

lines:
  - "&f%player_name%"
  - "&8Ping: &a%player_ping%ms"

---

Example Groups

Your default file includes three example groups:

admin

A high-priority group for administrators.

It includes:

• a red background

• an ADMIN title line

• the player's name

vip_millonario

A conditional VIP group.

This group requires:

• the VIP permission

• at least 1,000,000 balance

It also shows the player's money as an extra line.

default

The base group for normal players.

It includes:

• the player's name

• ping

• rounded health

---