# Overview Lead puts players into teams that everyone can see. Each team gets a name and a colour that shows up on nametags, in the tab list, and in chat, so you can tell at a glance who's with who. Built for events: factions in a civilisation server, squads in a battle royale, long-running teams on an SMP. It's free, from [lode.gg/plugin/lead](https://lode.gg/plugin/lead). ## Try it ``` /team create Red Dragons /team invite Steve ``` Steve accepts with `/team join <your name>`, and you're a team. Your names now carry the team colour wherever they appear. ## What players can do **Make a team and invite people.** Invitations have to be accepted, so nobody gets dragged into a team they didn't want. **Talk privately.** `/team chat` toggles team-only chat, or `/teammsg hello` sends a single message without switching modes. **Set a home.** Team leaders can set a team spawn to come back to. **Browse teams.** `/team list` opens a menu of every team on the server. ## What you can do as an admin **Sort people out.** Put players on teams, take them off, merge two teams, delete one, or shuffle everybody randomly across the teams that exist. **Change how a team looks.** Its colour, its display name, even its internal id. **Decide the rules.** Friendly fire, whether teammates collide with each other, and who can see whose nametags. Set it once for everyone, or per team. **Assign automatically.** Turn on auto-assign and anyone joining the server lands on a team without asking. ## Naming teams Players can pick their own names, or Lead can generate them for you: words, numbers, colours or symbols. Whichever you choose, teams keep their names between restarts. ## Where the colours show up Lead draws nametags and the tab list through whichever of these you have, in this order: 1. **Frame**, used automatically if installed. The best option, because it works out what each viewer should see individually, and it carries each team's collision and nametag rules across properly. 2. **TAB**, if you have it. Good on big servers, and it sidesteps the vanilla scoreboard's limits. 3. **The vanilla scoreboard**, if you have neither. You don't configure this. Lead picks the best available. ## Placeholders With PlaceholderAPI installed you get these anywhere placeholders work: | Placeholder | Gives you | |---|---| | `%lead_team_exists%` | Whether they're on a team | | `%lead_team_id%` | Their team's id | | `%lead_team_name%` | Their team's name | | `%lead_team_size%` | How many people are on it | | `%lead_team_color%` | Its colour | ## What you need | | | |---|---| | Server | Paper 1.20.4 or newer | Optional, and all picked up automatically if present: | Plugin | What it adds | |---|---| | Frame | The best nametag and tab list rendering | | TAB | Good rendering on large servers | | PlaceholderAPI | The placeholders above | | Bookshelf | Better chat handling | Lead runs on Folia, though that support is still experimental. ## Related Pages - [[Lead/Server Owners/Commands]], every command with examples - [[Lead/Server Owners/Configuration]], every setting explained - [[Lead/Developers/API Reference]], for plugin developers