https://github.com/ubermorgott/nicknamechanger
Server-side Hytale plugin for custom display nicknames
https://github.com/ubermorgott/nicknamechanger
Last synced: 5 months ago
JSON representation
Server-side Hytale plugin for custom display nicknames
- Host: GitHub
- URL: https://github.com/ubermorgott/nicknamechanger
- Owner: UberMorgott
- License: mit
- Created: 2026-01-28T17:01:45.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2026-02-01T17:37:21.000Z (5 months ago)
- Last Synced: 2026-02-02T04:15:38.255Z (5 months ago)
- Language: Java
- Size: 312 KB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# NickNameChanger
[](README.md) [](README.ru.md)
A server-side plugin for Hytale that allows players to customize their display nickname with colors, gradients, and text styles.
## Features
- **UI Editor** — Graphical interface for nickname customization
- 12 preset colors + custom color picker
- 8 gradient presets + custom gradient colors
- Text styles: Bold, Italic, Underline
- Live preview
- **Chat** — Custom nickname displayed in chat messages
- **Nameplate** — Nickname shown above player's head
- **Map** — Custom name displayed on the world map
- **Tab List** — Nickname visible in the player list
- **LuckPerms** — Optional integration for chat formatting compatibility
## Commands
| Command | Description |
|---------|-------------|
| `/nick` | Open the nickname editor UI |
| `/nick ` | Set a nickname via command |
| `/nick reset` | Reset to your original username |
## Installation
1. Place `NickNameChanger-x.x.x.jar` into `Hytale\UserData\Mods`
2. Launch the game and open world settings
3. Enable the mod in the Mods section
4. Load the world
## Permissions
All permissions are **allowed by default** — the mod works out of the box with no configuration.
| Permission | Description | Default |
|---|---|---|
| `nickname.use` | Access to `/nick` command | ✅ Allowed |
| `nickname.format` | Use colors, gradients, bold/italic/underline | ✅ Allowed |
To **deny** a permission, use the `-` prefix:
**With LuckPerms:**
```
/lp group default permission set -nickname.format true # deny formatting for default group
/lp user Steve permission set -nickname.use true # deny /nick for specific player
```
**Without LuckPerms** (`permissions.json`):
```json
{
"groups": {
"Default": ["-nickname.format"],
"VIP": ["nickname.format"]
}
}
```
## Optional Dependencies
- **[LuckPerms](https://luckperms.net/)** — If installed:
- Nicknames sync to LuckPerms `display-name` meta
- Chat displays LuckPerms prefix/suffix alongside the nickname
- Permissions can be managed through LuckPerms
## Limitations
- **Inventory header** — Cannot be changed as it is rendered client-side
## Localization
- English (en-US)
- Russian (ru-RU)
## Credits
- **Author:** Morgott