# NetworkNick<\/p>\n
**NetworkNick** is a lightweight, network-aware nickname plugin for **Paper and Spigot** that provides persistent, Redis-backed nicknames with full support for **PlaceholderAPI**, **LuckPerms**, and modern multi-server environments.<\/p>\n
Designed for modern servers and proxy networks, NetworkNick focuses on **correctness, timing, and compatibility** \u2014 ensuring nicknames apply **before join messages**, **sync instantly across servers**, and respect **offline permissions**.<\/p>\n
—<\/p>\n
### Changelog<\/p>\n
**1.0.1**<\/p>\n
– Network-wide nicknames via Redis
\n– Join-time correctness (`%player_displayname%` works in join messages)
\n– Offline-safe nickname exemption (LuckPerms integration)
\n– Hide \/ unhide system with prior nickname restoration
\n– Robust enforcement against late plugin overrides
\n– PlaceholderAPI support
\n– Clean reload support
\n– Paper & Spigot compatible (no NMS, no ProtocolLib)<\/p>\n
—<\/p>\n
## Overview<\/p>\n
NetworkNick allows players to set nicknames that:<\/p>\n
– Persist across restarts and reconnects
\n– Synchronize instantly across multiple backend servers
\n– Appear correctly in join messages, chat, TAB, and scoreboards
\n– Respect permissions, formatting rules, and offline exemptions<\/p>\n
The plugin is built around a Redis source of truth, with careful handling of join timing to ensure `%player_displayname%` always reflects the correct nickname.<\/p>\n
—<\/p>\n
## Core Features<\/p>\n
### Nicknames
\n– Set custom nicknames with `\/nick`
\n– Supports legacy color codes (`&a`) and hex colors (`&#RRGGBB`)
\n– Optional formatting permissions (`&l`, `&o`, `&k`, etc.)
\n– Safe length enforcement (3\u201316 visible characters)<\/p>\n
### Hide \/ Unhide
\n– `\/hide` obfuscates your name using `&k`
\n– `\/unhide` restores your previous nickname or real name
\n– Prior nicknames are stored safely and restored correctly<\/p>\n
### Network Sync
\n– Redis-backed nickname storage
\n– Real-time updates across all servers
\n– Automatic re-application on join, reload, and reconnect<\/p>\n
### Exempt Players
\n– `networknick.exempt` prevents other players from changing or unhiding your nickname
\n– Uses the LuckPerms API to check permissions even when the player is offline
\n– Safe asynchronous handling (no main-thread blocking)<\/p>\n
### Enforcement System
\n– Optional short-term enforcement to beat late plugin overrides
\n– Protects against plugins that reset display names after join<\/p>\n
### Placeholder Support
\n– PlaceholderAPI integration
\n– Custom placeholders for network-aware name handling<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
– Java 21
\n– Paper or Spigot 1.20+
\n– Redis server (required)
\n– Optional but recommended: LuckPerms
\n– Optional: PlaceholderAPI<\/p>\n
—<\/p>\n
## Installation<\/p>\n
### Single-Server Setup<\/p>\n
1. Download `NetworkNick-1.0.0.jar`
\n2. Place it in your server\u2019s `plugins\/` directory
\n3. Start the server
\n4. Configure permissions (LuckPerms recommended)
\n5. Restart or run `\/networknick reload`<\/p>\n
—<\/p>\n
### Multi-Server Setup<\/p>\n
Recommended for Velocity or BungeeCord environments.<\/p>\n
**Requirements**
\n– Shared Redis instance
\n– Identical plugin configuration across all backend servers<\/p>\n
**Steps**
\n1. Configure Redis connectivity
\n2. Ensure all backend servers connect to the same Redis instance
\n3. Restart all servers<\/p>\n
**Features**
\n– Network-wide nicknames
\n– Instant synchronization across servers
\n– Consistent join messages everywhere<\/p>\n
Redis acts as the source of truth
\nLocal caches are ephemeral and safe<\/p>\n
—<\/p>\n
## Commands<\/p>\n
### Player Commands<\/p>\n
| Command | Description | Permission | ### Admin Commands<\/p>\n | Command | Description | Permission | —<\/p>\n ## Permissions<\/p>\n ### Core<\/p>\n | Permission | Description | Default | ### Moderation<\/p>\n | Permission | Description | ### Formatting<\/p>\n | Permission | Description | ### Protection<\/p>\n | Permission | Description | —<\/p>\n ## (PlaceholderAPI)<\/p>\n | Placeholder | Description | Note: `%player_displayname%` will also reflect the nickname, as NetworkNick applies it before join messages are processed. Just make sure if you’re using essentials you have change-displayname set to false in their config.<\/p>\n —<\/p>\n ## Planned Enhancements<\/p>\n – None currently. Open to suggestions<\/p>\n —<\/p>\n ## License<\/p>\n Licensed under the Apache License, Version 2.0 —<\/p>\n ## Credits<\/p>\n Developed by **Chumbucket** \u00a9 2025 Chumbucket \u2014 Apache-2.0 License<\/p>\n","protected":false},"excerpt":{"rendered":" Lightweight nickname plugin for networks using REDIS. \/nick & \/hide<\/p>\n","protected":false},"featured_media":110140,"template":"","meta":{"_minecraft_slug":"networknick","_minecraft_project_id":"GoAfnryN","_minecraft_author":"Sorekill","_minecraft_license":"Apache-2.0","_minecraft_downloads":214,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"networknick.zip","_minecraft_size_bytes":353487,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:31:32.392261Z","_minecraft_date_created":"2026-01-13T22:13:34.922195Z","_minecraft_date_modified":"2026-01-03T09:38:38.812872Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/networknick","_minecraft_icon_attachment_id":110140,"_minecraft_imported_at":"2026-06-06T11:20:25+00:00","_minecraft_import_hash":"6e2aee37f19f1631b0040948b0d22c8e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,873,127,867,129],"mod_loader":[132,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-110139","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-library","mod_category-paper","mod_category-social","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|——-|————-|————|
\n| `\/nick
\n| `\/nick off` | Clear your nickname | `networknick.nick.clear` |
\n| `\/hide` | Hide your name | `networknick.hide` |
\n| `\/unhide` | Restore your name | `networknick.unhide` |<\/p>\n
\n|——-|————-|————|
\n| `\/nick
\n| `\/nick
\n| `\/unhide
\n| `\/networknick reload` | Reload config and Redis | `networknick.reload` |<\/p>\n
\n|———–|————-|———|
\n| `networknick.nick` | Use `\/nick` | op |
\n| `networknick.nick.clear` | Clear own nickname | op |
\n| `networknick.hide` | Use `\/hide` | op |
\n| `networknick.unhide` | Use `\/unhide` | op |<\/p>\n
\n|———–|————-|
\n| `networknick.nick.others` | Set others\u2019 nicknames |
\n| `networknick.nick.others.clear` | Clear others\u2019 nicknames |
\n| `networknick.unhide.others` | Unhide others |<\/p>\n
\n|———–|————-|
\n| `networknick.nick.colors` | Color and hex codes |
\n| `networknick.nick.format.k` | Obfuscated |
\n| `networknick.nick.format.l` | Bold |
\n| `networknick.nick.format.m` | Strikethrough |
\n| `networknick.nick.format.n` | Underline |
\n| `networknick.nick.format.o` | Italic |
\n| `networknick.nick.format.r` | Reset |<\/p>\n
\n|———–|————-|
\n| `networknick.exempt` | Prevent others from changing or unhiding your nickname |<\/p>\n
\n|————|————-|
\n| `%networknick_name%` | Visible nickname (or real name) |
\n| `%networknick_unhidden%` | Real name or prior nickname |
\n| `%networknick_hidden%` | `true` or `false` |<\/p>\n
\nSee `LICENSE` for details.<\/p>\n
\nBuilt for the **Chumbucket Network**
\nhttps:\/\/www.chumbucket.net<\/p>\n