Nicked

Packet-level nickname plugin with skin changing, a developer API, and PlaceholderAPI support.

Nicked replaces a player's name and skin with someone else's. Other players see only the new identity. Nicked rewrites it at the packet level, so nobody needs a client mod.

Features

• Packet-level nicking. Nicked rewrites names inside PLAYER_INFO_UPDATE packets before they reach any client. No client mods needed. Runs on Paper, Spigot, Purpur, Folia, and Bukkit 1.20+.
• Skin changing. Nicked fetches the matching Mojang skin off the main thread and injects it into the same packet. The nicked player sees their own new skin in first-person too, which you can turn off.
• Identity leak protection. Minecraft builds death, join/leave, and advancement broadcasts from the real name, which gives a nicked player away. Nicked can rewrite each of those to use the nick, and can hide the real skin when a nick's skin fails to fetch. Every toggle is separate and starts off.
• Random nicking. Run /nick with no arguments to draw a name from your configured pool.
• Persistence. Nicks survive disconnects and full server restarts. Nicked stores them in plugins/Nicked/nicks.yml and reapplies them when the player joins.
• Developer API. Other plugins can read nick state, apply or remove nicks, and listen to five nick events (NickApplyEvent, NickRemoveEvent, NickChangeEvent, NickRandomSelectEvent, NickResolveEvent).
• PlaceholderAPI support. Three placeholders for any chat, scoreboard, or tab-list plugin that reads PlaceholderAPI:
  • %nicked_displayname%: the player's current display name (nick or real name)
  • %nicked_is_nicked%: true / false
  • %nicked_real_name%: the player's actual username
• Customisable messages. You edit every message in messages.yml using MiniMessage. Gradients, hex colours, and hover events all work.

Compatibility

Optional soft dependency: PlaceholderAPI enables the %nicked_*% placeholders.

Commands

The nicked.admin permission covers every command and goes to OPs by default.

Quick Start

1. Drop Nicked.jar into your server's plugins/ folder.
2. Restart the server. Nicked generates plugins/Nicked/config.yml and messages.yml.
3. Grant nicked.admin to trusted staff (OPs already have it).
4. Run /nick Dream. Your name and skin change on the spot.
5. Run /nick again with no arguments, or /unnick, to revert.

Developer API

Add Nicked as a compile-only dependency via JitPack:

Gradle (Groovy)

repositories {
    maven { url 'https://jitpack.io' }
}
dependencies {
    compileOnly 'net.pharogames:Nicked:VERSION:api'
}

Maven

<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>
<dependency>
    <groupId>net.pharogames</groupId>
    <artifactId>Nicked</artifactId>
    <version>VERSION</version>
    <classifier>api</classifier>
    <scope>provided</scope>
</dependency>

Replace VERSION with the latest release tag (e.g. v1.1.0). See the API documentation for the full reference.

Links

License

Nicked is licensed under the MIT License.