PlaceholderAPI Support

📝 Placeholders Overview

Introduction

---

This section provides a comprehensive list of placeholders used in the NameGradient plugin.

Placeholder	Description
%namegradient_gradient_name%	It will give the name of the player formatted with the gradient (ideal for use in chat or tab).
%namegradient_gradient_name_id%	It will give the ID of the gradient name that the player has equipped.
%namegradient_gradient_chat_id%	It will give the ID of the gradient chat that the player has equipped.
%namegradient_text_gradient_[#RRGGBB,#RRGGBB]_[TEXT]_[STYLE]%	It will format your text with the colors and stylo assigned to it.
%namegradient_cooldown_custom%	Cooldown before you can change the custom gradient again.

​

⚙️ Advanced placeholder

Placeholder	Description
%namegradient_gradient_name_HEX%	With this placeholder you can get your name in HEX format &#RRGGBB
%namegradient_gradient_name_LEGACY_HEX%	With this placeholder you can get your name in HEX format &x&R&R&G&G&B&B
%namegradient_gradient_name_ANGLE_BRACKETS%	With this placeholder you can get your name in HEX format <#RRGGBB>
%namegradient_gradient_name_STANDARD%	With this placeholder you can get your name in HEX format #RRGGBB

🧾 Placeholder Fields Overview

Placeholder Field	Description
placeholder	Displays the name or label of the requirement (e.g. "Kills", "Playtime").
condition	The condition operator required to fulfill the requirement (e.g. >=, ==).
value	The target value that must be reached (e.g. 100, 3600).
success	Message shown if the requirement is completed.
fail	Message shown if the requirement is not completed.
completed	Returns true if the requirement has been completed, false otherwise.
lore	A pre-formatted visual line that uses success or fail based on the completion status.

---

📌 Placeholder Context Types

Context Prefix	Purpose
requirements_...	Shows data for a specific gradient and requirement, regardless of what is equipped.
current_requirements_...	Shows data for the currently equipped gradient and its requirements.

---

✅ Example: Using a Requirement Placeholder

Assume you have a NAME type gradient called FireTrail, with a requirement to have at least 100 kills:

Placeholder	Example Value
%namegradient_requirements_NAME_FireTrail_1_placeholder%	Kills
%namegradient_requirements_NAME_FireTrail_1_condition%	>=
%namegradient_requirements_NAME_FireTrail_1_value%	100
%namegradient_requirements_NAME_FireTrail_1_success%	✔ Requirement complete!
%namegradient_requirements_NAME_FireTrail_1_fail%	✖ You need more kills.
%namegradient_requirements_NAME_FireTrail_1_completed%	true (if player has ≥ 100 kills)
%namegradient_requirements_NAME_FireTrail_1_lore%	✔ Requirement complete! (if completed) or ✖ You need more kills. (if not)

You can use %namegradient_current_requirements_NAME_*% to automatically refer to the currently equipped gradient instead of specifying one.