NickMasterRK 1.4.0 — Ultimate Nickname Customization

NICKMASTERRK 1.4.0 DOCUMENTATION

INSTALLATION

1. Stop your server completely.
2. Remove or disable any other plugin that controls the /nick command.
3. Replace the previous JAR with NickMasterRK-1.4.0.jar.
4. Keep your existing plugins/NickMasterRK folder when updating.
5. Install PlaceholderAPI if you want to display NickMasterRK placeholders in other plugins.
6. Install LuckPerms if you want advanced permission management.
7. Install Vault if you want to charge players for nickname changes.
8. Start the server with an Internet connection. Required database libraries are downloaded automatically during the first startup.
9. Edit config.yml, storage.yml, and the files inside the lang folder.
10. Restart the server completely after changing the storage type.
11. Run /nick doctor to verify the installation.

NickMasterRK 1.4.0 automatically adds missing gradient presets and new configuration options without deleting your existing settings.

FIRST TEST

PLAYER COMMANDS

NICKNAME FORMAT EXAMPLES

Nicknames support legacy color codes, HEX colors, configurable gradients and formatting codes according to the server configuration and player permissions.

GRAPHICAL NICKNAME EDITOR

Open the editor with:

The graphical editor includes:

• 16 organized Minecraft color options.
• Live nickname preview.
• Configurable gradient selector.
• Bold, italic, underline, strikethrough and magic formatting.
• Green dye and enchantment glow for selected formats.
• Random nickname selector.
• Nickname favorites.
• Nickname history restoration.
• Temporary nickname information.
• Remaining nickname-change counter.
• Reset and clear-style buttons.
• Personal language selector.
• Confirmation button before applying the nickname.
• Configurable store button for players without nickname access.
• Protection against shift-click, number keys, dragging, double-clicking and item extraction.

Players can be allowed to open and preview the GUI without receiving permission to apply a nickname.

CONFIGURABLE GRADIENTS

NickMasterRK 1.4.0 includes these default gradient presets:

• Sunset
• Ocean
• Purple
• Fire
• Emerald
• Ice
• Rainbow

Gradients can be combined with bold, italic, underline and other supported formatting options.

Custom presets can be added inside config.yml:

Missing presets are added automatically when the plugin starts or when /nick reload is used.

TEMPORARY NICKNAMES

Players with permission can use:

Administrative temporary nickname:

Examples:

Supported duration units:

ADMINISTRATIVE COMMANDS

ADMINISTRATION GUI

Open the administration center with:

The administration GUI displays:

• Players with active nicknames.
• Original and visible names.
• Online or offline status.
• Nickname expiration.
• Pending nickname requests.
• Administrative reset actions.
• Nickname blocking and unblocking.
• History and audit access.
• Configuration reload shortcut.

NICKNAME REQUEST SYSTEM

Players can submit a nickname for staff approval:

Staff commands:

This system can be enabled only for selected ranks using LuckPerms.

CHANGE LIMIT SYSTEM

NickMasterRK can limit how many times each player changes their nickname.

Example LuckPerms permissions:

Example:

The player can view the used and remaining changes with:

Administrators can modify the counter with:

OPERATOR ACCESS

Server operators receive full access by default.

Set this option to false if you want operators to require explicit LuckPerms permissions.

The wildcard permission also grants complete access:

LANGUAGE SYSTEM

Included languages:

• English
• Spanish
• Portuguese

Commands:

Aliases:

The selected language is applied to messages and graphical menus for that player.

PLACEHOLDERAPI

Main nickname placeholders:

Change-limit and favorite placeholders:

Server and storage placeholders:

Integration placeholders:

Use the main placeholder in TAB, ChatManager, UnlimitedNameTags, InteractiveChat, DiscordSRV and other plugins that support PlaceholderAPI:

TAB or UnlimitedNameTags example:

ChatManager example:

SUPPORTED INTEGRATIONS

• PlaceholderAPI
• LuckPerms
• Vault
• TAB
• UnlimitedNameTags
• ChatManager
• InteractiveChat
• DiscordSRV
• ProtocolLib
• Other plugins that support PlaceholderAPI

NickMasterRK includes direct InteractiveChat nickname-provider integration and repeated visual synchronization for more consistent hover and click information.

Nicknames are refreshed after joining, changing worlds, changing a nickname, resetting a nickname and enabling compatible integrations.

STORAGE

Available storage types:

SQLite is recommended for a single server.

MySQL is recommended for an external database or multiple servers sharing nickname information.

The selected storage system preserves:

• Active nicknames.
• Original player names.
• Nickname expiration dates.
• Nickname history.
• Change counters.
• Favorites.
• Requests and administrative information.

Restart the server completely after changing the storage type.

NickMasterRK does not automatically migrate existing nickname data between different storage types.

IMPORTANT PLAYER PERMISSIONS

A player may receive nickmasterrk.gui without nickmasterrk.use. The GUI will open in preview mode, but the player will not be able to apply the nickname.

IMPORTANT ADMINISTRATIVE PERMISSIONS

Bypass permissions:

Update notification permission:

UPDATE AND DIAGNOSTIC TOOLS

/nick version displays the installed version and relevant server information.

/nick checkupdate performs a manual asynchronous update check.

/nick checkupdate --force bypasses the manual update-check cooldown when permitted.

/nick updateinfo displays the latest available version and official download page.

/nick doctor checks storage, configuration and supported integrations.

/nick doctor chat checks the supported chat integrations.

/nick doctor storage checks database health and loaded nicknames.

/nick doctor update displays update-check information.

/nick sync refreshes the visible nickname of one player.

/nick sync all refreshes all online players.

UPDATING TO 1.4.0

1. Stop the server completely.
2. Replace the previous NickMasterRK JAR.
3. Keep your existing plugins/NickMasterRK folder.
4. Start the server normally.
5. The new gradient presets and missing options will be added automatically.
6. Run /nick doctor.
7. Open /nick gui and verify the gradient selector.

You do not need to delete config.yml when updating.

SUPPORT INFORMATION

When reporting a problem, provide:

• Exact Minecraft server version.
• Java version.
• NickMasterRK version.
• Plugin list and versions.
• Storage type being used.
• Output from /nick doctor.
• The relevant section of logs/latest.log.
• The exact command used.
• Steps needed to reproduce the issue.
• Screenshots or videos when the problem is visual.

Official page:
NickMasterRK on SpigotMC

Do not use the Bukkit /reload command. Restart the server completely after updating the plugin or changing the storage type.