Styled Nicknames

A configurable mod that allows server players and administrators to change their nicknames with full simplified text formatting support. Compatible with LuckPerms, PlayerRoles, and other mods using Fabric permission API, with automatic removal of nicknames for players without appropriate permissions.

Available Commands and Permissions

• /styled-nicknames — main command (permission stylednicknames.main, available by default)
• /styled-nicknames reload — reload configuration (requires stylednicknames.reload)
• /styled-nicknames set <player> <value> — change target player's nickname (requires stylednicknames.change_others)
• /styled-nicknames clears <player> — clear target player's nickname (requires stylednicknames.change_others)
• /nickname set <value> or /nick set <value> — change own nickname (requires stylednicknames.use)
• /nickname clear or /nick clear — clear own nickname (requires stylednicknames.use)

Configuration Settings

Configuration file is located at ./config/styled-nicknames.json. Formatting uses PlaceholderAPI's simplified text format.

{
    "CONFIG_VERSION_DONT_TOUCH_THIS": 1,
    "allowByDefault": false,           // Enable player commands by default
    "defaultPrefix": "#",              // Default nickname prefix
    "maxLength": 32,                   // Maximum nickname length (without formatting), 0 to disable limit
    "changeDisplayName": true,         // Change player's display name
    "changePlayerListName": false,     // Change nickname in player list (may be incompatible with some mods)
    "allowLegacyFormatting": false,    // Allow usage of legacy text format (&X)
    "nicknameChangedMessage": "...",   // Message after changing nickname
    "nicknameResetMessage": "...",     // Message after clearing nickname
    "defaultEnabledFormatting": {
      /"tagname": value/              // Settings for formatting tags enabled by default
    }
}

Permission System

Players require stylednicknames.use permission to use commands. Additional permissions stylednicknames.format.[tag_name] (where [tagname] is simplified text format tag) allow applying additional formatting.

The stylednicknames.ignore_limit permission disables nickname length limit for the player (already ignores tags). Administrators should be granted stylednicknames.change_others permission to remove inappropriate nicknames.