promotional bannermobile promotional banner

Nicknames Easy

Most efficient custom nickname mod for Paper & Folia
Download

Nickname Easy (Folia / Paper 1.21.x)

Lightweight, Folia-safe nickname plugin. Let players set fun nicknames (with color codes), show them in chat and the tab list, and look up a player’s real Mojang username from their nickname—colors ignored. Fully Unicode-aware (Cyrillic and other scripts supported).

Works on: Folia 1.21.x (and Paper 1.21.x)
Requires: Java 21

✨ Features

     /nick & /unnick — players can set or clear their nickname.

     /realname — type a nickname (e.g. &aAsd) and get the real Mojang name (Asd).
     By default, it matches letters-only and ignores color codes, so minor punctuation/spaces don’t matter.

     Cyrillic & full Unicode — nicknames accept all letter scripts (e.g., Алексей, Мира-2025).

     Color codes — supports legacy & codes (e.g., &a, &l, &x&F&F&0&0&0&0).

     Tab list & chat display — enable/disable each in config.

     Persistent storage — nicknames saved in plugins/NicknameEasy/nicks.yml.

     Folia-safe by design — all Bukkit/Paper API calls run on the correct region thread; background file I/O never      touches the API.

📦 Commands

 
/nick <newName|off> # set your nick or turn it off /unnick [player] # clear your own nick, or someone else's (with permission) /realname <nickname> # returns the player’s Mojang username

How /realname matching works

     Strips legacy color/format codes (& or §, incl. legacy hex).

     (Default) letters-only comparison: punctuation, spaces, and digits are ignored for matching.
     Example: /realname Asd matches &aA-s_d, and returns Asd.

     You can switch to “exact minus colors” matching in the config.

🔐 Permissions

 
nicknameeasy.nick # allow setting your own nickname (default: true) nicknameeasy.nick.reset # allow /unnick yourself (default: true) nicknameeasy.realname # allow /realname (default: true) nicknameeasy.nick.colors # allow using & color codes (default: op) nicknameeasy.nick.others # allow clearing others' nicknames (default: op)

LuckPerms examples

 
/lp group default permission set nicknameeasy.nick true /lp group default permission set nicknameeasy.realname true # staff /lp group staff permission set nicknameeasy.nick.others true /lp group staff permission set nicknameeasy.nick.colors true

⚙️ Configuration (plugins/NicknameEasy/config.yml)

The Nicknames Easy Team

profile avatar
Mental
Owner
  • 3
    Followers
  • 7
    Projects
  • 145.6K
    Downloads

More from MentalView all