teams.yml

Customize the look and feel of teams. This file controls colors, symbols, chat prefixes, and nametags.

Where to find it

Generated after the first server start:

  • plugins/Zentrix/teams.yml

What you edit here

  • Team colors (&#RRGGBB and legacy &c codes)

  • Team names and symbols

  • Chat and nametag templates

  • Friendly fire per team

circle-info

This page does not decide when players get assigned to a team. Team assignment rules live in Team System.

Introduction

teams.yml is your team branding file. Use it to make teams instantly readable in fights. Good visuals reduce “who is who” confusion.

Important logic: teams are assigned sequentially

The comment “Teams are assigned to players sequentially” matters. Zentrix walks the list from top to bottom. It assigns the next team each time a new team is needed.

When it reaches the end, it loops back to the first team. So the order in this file is meaningful.

File structure

Everything lives under the teams: key. Each team is a keyed block like teams.<team-id>:.

Configuration fields

Visuals

color

The base color for the team. Supports:

  • Hex: &#RRGGBB (example: &#FF5555)

  • Legacy: &c, &7, &l, etc.

Keep it consistent with display-name, symbol, and formats. That makes the team identity feel “locked in”.

display-name

The full name shown in scoreboards and messages. Usually you include the team color at the start.

symbol

A compact icon for Tab lists and tight UI areas. Unicode is supported, so you can use clean symbols.

Keep symbols short. One character reads best during combat.

Gameplay

friendly-fire

If true, teammates can damage each other. If false, teammate damage is blocked.

Formatting & layout

chat-format

Template for team chat lines. It supports placeholders and color codes.

Default example pattern:

nametag-format

Template for the name above a player’s head. Use this to show the team symbol and color in-world.

Placeholders

These placeholders can be used inside chat-format and nametag-format.

Placeholder
What it becomes

{team}

Team display name

{color}

Team base color

{symbol}

Team symbol

{player}

Player name

{message}

Chat message (chat only)

circle-exclamation

Example breakdown: Red team

This is one full team entry. It shows how color + symbol + formats combine.

What players see:

  • Chat prefix: red before the name.

  • Separator: &7: makes the colon grey.

  • Message color: message inherits the team red.

  • Nametag: a red above the player’s head.

Full configuration

chevron-rightExpand: default teams.ymlhashtag

Last updated