Styled Nicknames [Unofficial NeoForge Port]

Mod Overview

Important: This is an unofficial port of the Styled Nicknames mod by Patbox for the NeoForge platform. If you encounter issues, contact the port author, not the original developer.

The Styled Nicknames modification provides a flexible system for customizing player display names on your server. Users with appropriate permissions can change their nicknames with full color and styling formatting support.

Command System and Permissions

Here's a list of available commands and required permissions:

• Main command /styled-nicknames (requires permission: stylednicknames.main - granted by default)
• Configuration reload /styled-nicknames reload (requires: stylednicknames.reload)
• Change another player's nickname /styled-nicknames set <player> <value> (requires: stylednicknames.change_others)
• Reset another player's nickname /styled-nicknames clear <player> (requires: stylednicknames.change_others)
• Change own nickname /nickname set <value> or /nick set <value> (requires: stylednicknames.use)
• Clear own nickname /nickname clear or /nick clear (requires: stylednicknames.use)

Configuration Settings

The configuration file is located at ./config/styled-nicknames.json. Here are the main parameters:

{
    "CONFIG_VERSION_DONT_TOUCH_THIS": 1,
    "allowByDefault": false,           // Enable nickname change commands by default
    "defaultPrefix": "#",              // Default nickname prefix
    "maxLength": 32,                   // Maximum nickname length (without formatting), 0 = no limit
    "changeDisplayName": true,         // Change player's display name
    "changePlayerListName": false,     // Change name in player list (may conflict with some mods)
    "allowLegacyFormatting": false,    // Allow legacy text format (&X) in nicknames
    "nicknameChangedMessage": "...",   // Message sent after successful nickname change
    "nicknameResetMessage": "...",     // Message sent after clearing nickname
    "defaultEnabledFormatting": {
      /"tag_name": value/             // Configuration of available formatting tags by default
    }
}

Permission System

To use nickname change commands, players need the stylednicknames.use permission. Additional styling options require permissions stylednicknames.format.[tag_name], where [tag_name] corresponds to simplified text formatting tags.

Players with the stylednicknames.ignore_limit permission can ignore the nickname length limit (noting that formatting tags already don't count toward length).

Administrators should be granted the stylednicknames.change_others permission to manage other players' nicknames.