GocxNicks - Nicknames & Colors v1.0.0

---

---

Overview

GocxNicks is a Minecraft nickname and rank color plugin designed for Spigot and PaperSpigot 1.8.8 servers.

The main purpose of this plugin is to let players use custom colored nicknames while also giving server owners a clean way to display automatic rank-based name colors using permissions, LuckPerms groups, and PlaceholderAPI placeholders.

GocxNicks is useful for server owners who want better-looking player names without replacing their entire chat system.

Unlike many nickname plugins, GocxNicks does not try to take over your chat plugin. Instead, it focuses on nicknames, rank colors, and placeholders. This allows you to keep using your current chat plugin, TAB plugin, scoreboard plugin, menus, holograms, or any other plugin that supports PlaceholderAPI.

---

What GocxNicks Can Be Used For

GocxNicks can be used on many types of Minecraft servers, including:

• FullPvP servers
• KitPvP servers
• Survival servers
• Factions servers
• Lobby servers
• Hub servers
• Rank-based servers
• Premium rank systems
• Staff name styling
• Network servers
• Servers using LuckPerms
• Servers using TAB
• Servers using PlaceholderAPI

The plugin is especially useful if your server has multiple ranks and you want each rank to have a different nickname or name color style.

---

Main Features

• Colored nickname system
• Players can change their nickname with /nick
• Players can reset their nickname with /nick reset
• Admins can change or reset other players' nicknames
• Automatic rank-based name colors
• LuckPerms group detection
• Visual in-game GUI editor
• Easy rank color editor using /gnicks
• PlaceholderAPI support
• TAB-friendly placeholders
• Scoreboard-friendly placeholders
• Optional display name bridge for chat plugins
• Spanish messages and GUI
• Lightweight configuration
• Designed for Minecraft 1.8.8
• Designed for Spigot and PaperSpigot
• Free community resource

---

In-Game Preview Images

Important: This resource includes in-game images showing how the plugin looks and works inside Minecraft.

Please check the image carousel for screenshots of:

• The GocxNicks main GUI
• The rank color editor
• Colored nickname examples
• TAB placeholder usage
• Command output such as /gnicks info or /gnicks scan

---

Nickname System

GocxNicks allows players to create custom colored nicknames using the /nick command.

Players can use color codes to personalize their name, depending on the permissions you give them.

Examples:


This allows players to personalize how their names appear while still giving the server owner control over permissions, formatting, limits, and restrictions.

Admins can also change or reset the nickname of another player.

---

Rank Color System

GocxNicks can automatically color a player's name based on their rank or permissions.

This is useful for servers that want ranks to have unique name colors across TAB, scoreboards, menus, chat formats, holograms, or other displays.

Example rank color use cases:

• VIP players can have gold-style names.
• Aqua players can have aqua-style names.
• Poseidon players can have dark aqua-style names.
• Admins can have red-style names.
• Helpers can have green-style names.
• Moderators can have purple-style names.

You can configure ranks such as:

• VIP
• Aqua
• Poseidon
• Glitch
• Shadow
• Nexus
• Helper
• Moderator
• Admin
• Owner

Each rank can have its own color combination.

This allows your server to have a clean, organized, and professional-looking rank style.

---

Visual GUI Editor

GocxNicks includes an in-game GUI editor that can be opened with:


The GUI allows staff members to manage rank colors without editing files manually.

With the GUI, you can:

• View configured ranks
• Edit rank colors
• Choose color combinations
• Save changes in-game
• Manage rank display visually
• Work faster without manually editing YAML files

This is useful for server owners who want to customize player name colors without constantly editing config files or restarting the server.

---

LuckPerms Support

GocxNicks works well with LuckPerms.

The plugin can detect LuckPerms groups and use permissions to determine which color a player should receive.

Recommended setup:

1. Create your groups in LuckPerms.
2. Give each rank a permission such as rank.vip, rank.aqua, rank.nexus, etc.
3. Configure the rank colors inside GocxNicks.
4. Use the GocxNicks placeholders in TAB, chat, scoreboard, menus, or holograms.

Example permissions:


LuckPerms is recommended if you want automatic rank detection and rank-based name colors.

---

PlaceholderAPI Support

GocxNicks provides PlaceholderAPI placeholders that can be used in other plugins.

These placeholders can be used in:

• TAB
• Scoreboards
• Chat formats
• Menus
• Holograms
• Server information displays
• Any plugin that supports PlaceholderAPI

Available placeholders:

---

Placeholder Explanation

• %gocxnicks_nick% - Shows the player's colored nickname or rank-colored name.
• %gocxnicks_colored_nick% - Alias for the colored nickname.
• %gocxnicks_chat_name% - Useful for chat formats.
• %gocxnicks_display_name% - Shows the display name version.
• %gocxnicks_nick_plain% - Shows the nickname without color codes.
• %gocxnicks_stripped_nick% - Alias for the plain nickname.
• %gocxnicks_real_name% - Shows the player's real Minecraft username.
• %gocxnicks_raw% - Shows the raw nickname value.
• %gocxnicks_has% - Returns whether the player has a custom nickname.

---

TAB Example

You can use GocxNicks with TAB by placing the placeholder in your TAB configuration.

Example:


Example TAB group configuration:


This allows TAB to show the player's colored nickname or rank-colored name.

---

Scoreboard Example

GocxNicks placeholders can also be used in scoreboards.

Example:


This is useful if you want your scoreboard to display a player's custom nickname or rank-colored name.

---

Commands

---

Permissions

---

Dependencies

Recommended dependencies:

• PlaceholderAPI - Recommended for using GocxNicks placeholders.
• LuckPerms - Recommended for rank/group detection and rank-based name colors.

The plugin can load without these dependencies, but PlaceholderAPI and LuckPerms are strongly recommended if you want the full feature set.

PlaceholderAPI:
https://www.spigotmc.org/resources/placeholderapi.6245/

LuckPerms:
https://luckperms.net/download

---

Compatibility

• Minecraft Version: 1.8.8
• Server Software: Spigot / PaperSpigot
• Recommended Java: Java 8
• Recommended Plugins: PlaceholderAPI, LuckPerms, TAB

This plugin is mainly designed for Minecraft 1.8.8 servers.

Please test the plugin on a development server before using it on a production server.

---

Why Use GocxNicks?

Many nickname plugins try to control too many things at once.

GocxNicks is different.

GocxNicks focuses on:

• Nicknames
• Rank colors
• Placeholders
• GUI editing
• LuckPerms compatibility
• TAB compatibility

This makes it easier to integrate with your current server setup.

You can keep your current chat plugin, current TAB plugin, current scoreboard plugin, and current permissions system. GocxNicks simply provides the nickname and color data that those plugins can use.

---

AI Transparency

GocxNicks was created with AI assistance and manually reviewed before release.

AI was used to help with:

• Code structure
• Refactoring
• Documentation
• Development speed
• Feature planning

However, the plugin was still reviewed, packaged, and prepared manually.

Important information:

• The plugin does not use an external AI API inside the Minecraft server.
• The plugin does not require an AI key.
• The plugin does not send player data to any AI service.
• The plugin does not require internet access for its core features.
• The plugin is not a chatbot.
• The plugin is simply a Minecraft nickname and rank color plugin.

---

Community Resource

GocxNicks is released as a free community resource.

Feedback, bug reports, suggestions, testing, and ideas are welcome.

If you find a bug, please report:

• Server version
• Java version
• Plugin version
• Installed dependencies
• Full console error
• Steps to reproduce the issue

The goal is to improve the plugin with real community feedback.

---

Bug Report Format

If you report a bug, please use this format:

---

Planned Improvements

Possible future improvements may include:

• More GUI customization options
• More rank color presets
• Better preview system inside the GUI
• More placeholder options
• Improved documentation
• More examples for TAB and scoreboard setups
• Community-requested features

Suggestions are welcome.

---

Final Notes

GocxNicks is designed for server owners who want a simple, clean, and flexible nickname and rank color system.

It is especially useful for servers that already use LuckPerms, PlaceholderAPI, and TAB.

Please test the plugin on a development server first before using it on a live production server.