Name Changer

A mod for changing a player’s name. Designed to replace the player’s name consistently across the game.

Useful for roleplay servers, content creation, screenshots, or simply using a different display name without changing your account username.

Needs to be installed on both the client and the server for full functionality.

Features

Name Changing

The primary feature of this mod is obviously changing the player's name. Here’s every place this affects:

UI & Display

• Chat name labels
• Nameplates above players
• Player list (under Tab)
• Social interactions screen
• Scoreboard sidebar display
• MOTD for LAN worlds

Commands & System Integration

• Entity selection in commands
  • Works with both suggestions and execution
  • Original names still work
• Various system messages
  • Death
  • Advancements
  • Join/Leave

Name Command

The /name command is used to set, reset, or inspect player names. It requires operator permissions and has two subcommands:

• /name set <target> <name> sets the name of the target player
• /name reset [<target>] resets the name of the target player (or self if target is omitted) to what it was originally
• /name inspect [<target>] shows information about the player's name like their original and custom name

Custom names are stored per-world and persist between reloads.

Config

The mod currently has two config options:

• Name Conflict Warning adds a warning when setting a name if it conflicts with other players' original or custom names
• Forbid Name Conflicts prevents setting a name if it would cause conflicts with other players' original or custom names

The config is available in the namechanger-common.toml file in the regular ./minecraft/config directory and also using config mods like Cloth Config on Fabric and natively on NeoForge.

Names

The custom name entered in the /name set command is a text component. You can read more about them on the Text Component page on the Minecraft Wiki.

Here are examples of using the /name set command:

Plain text:

/name set @s mineTomek

Plain text with spaces or other special characters:

/name set @s "mineTomek :3"

Formatted text:

/name set @s {text: "mineTomek", color: "#6dc53b", bold: true}

Formatting only affects chat messages and the player list.
In most other places, Minecraft strips formatting and displays plain text instead.