NationTags

NationTags Plugin Documentation

Custom player run nation systems featuring chat prefixes, tab list integration, scoreboard team banners, and MiniMessage formatting support.

What NationTags Does

NationTags allows players to form organized groups called Nations, providing unique custom name tags that display prominently across multiple game interfaces.

• Nation Creation: Lets any player create a new Nation and become its leader.
• Community Joining: Allows other players to join an existing Nation.
• Custom Tags: Gives each Nation a custom tag supporting colors, gradients, bold, italic, underline, strikethrough, and more.
• Multi-Area Display: Displays the custom tag in chat, the tab list, and as a scoreboard team prefix above players' heads or in compatible plugins.
• Leader Management: Allows leaders to delete their Nation with a safe confirmation step to prevent accidents.
• Staff Tools: Includes administrative utilities for server staff to manage all active Nations.

Player Commands

<thead> </thead> <tbody> </tbody>

Command	Description
/nationtags create <name>	Creates a new Nation and makes you leader. Names must be 2–32 letters with optional underscores.
/nationtags join <name>	Joins an existing Nation. Leaders cannot join other groups while leading their own.
/nationtags leave	Leaves your current Nation. Leaders must delete their Nation instead of leaving.
/nationtags tag <text>	Leaders only. Sets the Nation's tag/prefix using MiniMessage formatting.
/nationtags delete <name>	Leaders only. Deletes your Nation. Requires appending confirm at the end to execute.

Tag Formatting

When customizing a tag via /nationtags tag, you can incorporate the following supported formatting tags:

• Hex Colors: <#FF0000>
• Named Color Tag: <color:#FF0000>
• Shorthand Color Tag: <c:#FF0000>
• Gradients: <gradient:#FF0000:#0000FF>text (supports two or more colors)
• Bold: <nowiki><b>text</nowiki>
• Italic: <nowiki><i>text</nowiki>
• Underline: <nowiki><u>text</nowiki>
• Strikethrough: <st>text
• Obfuscated (Magic/Scramble): <obf>text
• Rainbow: <rainbow>text

Any unsupported tag will be rejected with an error message; simply remove or correct it and try again. By default, newly created Nations default to their name enclosed in brackets (e.g., [wolves]) until modified by the leader.

Admin Commands

<thead> </thead> <tbody> </tbody>

Command	Description
/nationtags admin list	Lists all Nations, their leader's UUID, and member counts.
/nationtags admin properties <name>	Displays detailed information about a specific Nation (leader, tag, member count).
/nationtags admin diagnostics <player>	Shows a player's UUID and assigned Nation (player must be online).
/nationtags admin tag <name> <text>	Force-sets any Nation's tag, bypassing the leader-only restriction.
/nationtags admin delete <name> [confirm]	Force-deletes any Nation. Requires confirmation just like the player command.
/nationtags admin reload	Reloads Nation data from disk, discarding any unsaved memory changes.

Example Workflow

A typical lifecycle of creating, styling, and removing a Nation looks like this:

• /nationtags create wolves
• /nationtags tag <gradient:#FF0000:#0000FF>[Wolves]
• /nationtags delete wolves confirm