Introduction
With 1.16's introduction of full RGB colour code support, it's easier than ever to equip your players with sleek-looking coloured name gradients as an added perk. Gone are the days where you were limited to only 15 colours to form such gradients, making them look unappealing and dated.
For instance, how about you provide your players with BuiltByBit's own charity event gradients, which are featured in the default configuration shown below:
This plugin is easily customisable and there's no need to define each colour within a gradient - simply define the start & end colours and all the conjoining colours required will be interpolated automatically!
Screenshots/GIFs
With TAB and PlaceholderAPI dependencies:
(the below doesn't show an animated gradient, but one account selecting different gradients from the menu sequentially and the other observing those changes)
Spoiler: Selecting a gradient
Spoiler: Clearing a gradient
Spoiler: Menu pagination
Commands & Permissions
Code:
/gradient - opens the main menu for selecting colour gradients
/namegradient - main plugin command/show usage
/namegradient reload - reload configuration file
/namegradient clear <player> - clear a player's gradient
/namegradient change <player> <gradient_id> - change a player's gradient provided they have permission to use that gradient in the first place
Code:
namegradient.use - permission to open selector menu
namegradient.gradient.<id> - permission to use a gradient with the given ID
namegradient.reload
namegradient.others.clear
namegradient.others.change
namegradient.override.exempt
Code:
%namegradient_name% - placeholder for accessing a player's gradient within other supported plugins (PlaceholderAPI must be installed)
Defaults back to the player's name if they don't have an active gradient
Configuration & Language
Code:
# _______ ________ .___.__ __
# \ \ _____ _____ ____ / _____/___________ __| _/|__| ____ _____/ |_
# ______ ______ / | \\__ \ / \_/ __ \/ \ __\_ __ \__ \ / __ | | |/ __ \ / \ __\ ______ ______
# /_____/ /_____/ / | \/ __ \| Y Y \ ___/\ \_\ \ | \// __ \_/ /_/ | | \ ___/| | \ | /_____/ /_____/
# \____|__ (____ /__|_| /\___ >\______ /__| (____ /\____ | |__|\___ >___| /__|
# \/ \/ \/ \/ \/ \/ \/ \/ \/
#
#
# NameGradient - Fully customisable 1.16 RGB username gradients
# Developed by Harry [https://www.mc-market.org/resources/authors/87939/] [Majored#8062] [[email protected]]
# DO NOT MODIFY
# The version of NameGradient this configuration is compatible with.
config-version: "1.3"
# Whether or not an update check against MC-Market's Ultimate API should be ran during starup.
version-check: true
## NAME SETTINGS
## Altering these settings will likely require a server restart due to the varying dependency checks within different modes.
name:
mode: "PLAYERNAME" # available modes: "PLAYERNAME", "DISPLAYNAME", "ESSENTIALS", "CMI", AND "PLACEHOLDER".
colour-dependent: false # if true, NameGradient will not apply a gradient if the name to be replaced already has colours present.
placeholder-source: "%player_name%" # the PlaceholderAPI placeholder to use if mode is set to "PLACEHOLDER".
override-displayname: true # must be false when using the "DISPLAYNAME" or "ESSENTIALS" modes.
## CHAT SETTINGS
## Within "REPLACE_ONLY" mode, you may use PlaceholderAPI placeholders within any plugin which alters the chat format (eg. EssentialsChat).
## Wrap placeholders within curly brackets {}, instead of % symbols. For instance, use "{namegradient_name}".
chat:
mode: "OVERRIDE_FORMAT" # available modes: "OVERRIDE_FORMAT", "REPLACE_ONLY" AND "OFF".
format: "{GRADIENT}&8: &7{MESSAGE}" # placeholders available: {GRADIENT} and {MESSAGE} (PlaceholderAPI support if installed also).
## GRADIENT SETTINGS
gradients:
1: # must be an integer and unique to this gradient.
name: "AbleGamers Name Colour" # name of the gradient displayed within GUI (limited to ~27 characters due to item name length limitations).
startColour: "#F2709C" # starting colour of this gradient.
endColour: "#FFB454" # ending colour of this gradient.
alternatePermission: "yourserver.ablegamers" # an optional alternative permission node giving a player access to this gradient.
overridePermission: "yourserver.ablegamers.override" # an optional permission node which will force this gradient to be applied.
overrideWeight: 1 # if a player has multiple override permissions, the gradient with the highest weight will be applied.
2:
name: "Beyond Blue $25 Name Colour"
startColour: "#59EAA4"
endColour: "#089CCC"
3:
name: "Beyond Blue $300 Name Colour"
startColour: "#59EAA4"
endColour: "#CD03FF"
4:
name: "Make-A-Wish Colour"
startColour: "#f74fdb"
endColour: "#940ee2"
5:
name: "SpecialEffect Name Colour"
startColour: "#ffd728"
endColour: "#ff7328"
6:
name: "Water.org Name Colour"
startColour: "#33E7FF"
endColour: "#0368FF"
## GUI/MENU SETTINGS
menu:
title: "&8Gradients"
size: 45 #must be a multiple of 9
per_page: 21 #amount of gradients shown per page
panes:
slots: [0,1,2,3,4,5,6,7,8,9,17,18,26,27,35,36,37,38,42,43,44]
name: "&7"
material: BLACK_STAINED_GLASS_PANE
gradient_item:
material: NAME_TAG
lore_permission:
- "&7♦ &eClick to apply this gradient."
lore_no_permission:
- "&7♦ &cYou don't have sufficient permission."
page_back_item:
slot: 39
material: ARROW
name: "&7Page Back"
page_forward_item:
slot: 41
material: ARROW
name: "&7Page Forward"
clear_gradient_item:
slot: 40
material: BARRIER
name: "&cClear current gradient"
## LANGUAGE SETTINGS
lang:
apply: "&7≫ &eA new gradient has been applied. You're now '{GRADIENT}&e'."
clear: "&7≫ &eYour current gradient has been cleared."
same_gradient: "&7≫ &cYou already have this gradient active."
no_permission_gradient: "&7≫ &cYou don't have permission to use this gradient."
no_permission: "&7≫ &cYou don't have permission to perform this action."
no_gradient: "&7≫ &cYou don't currently have an active gradient."
has_override_gradient: "&7≫ &cYou currently have an override gradient active."
has_coloured_source: "&7≫ &cYou currently have a coloured gradient source which cannot be overridden."
args_incorrect: "&7≫ &cYou entered the incorrect number or type of arguments."
gradient_nonexistent: "&7≫ &cA gradient with this ID doesn't exist."
attempt_change_own: "&7≫ &cPlease use /gradient to change your own gradient."
attempt_clear_own: "&7≫ &cPlease use /gradient to clear your own gradient."
target_offline: "&7≫ &cThis player is not currently online."
target_has_override_gradient: "&7≫ &cThis player currently has an override gradient active."
target_coloured_source: "&7≫ &cThis player currently has a coloured gradient source which cannot be overridden."
change_success: "&7≫ &eYou've updated this player's gradient."
change_target_success: "&7≫ &eYour gradient has been changed by another player."
clear_success: "&7≫ &eYou've cleared this player's gradient."
clear_target_success: "&7≫ &eYour gradient has been cleared by another player."
target_permission_error: "&7≫ &cThis player doesn't have permission to use this gradient."
config_reload_success: "&7≫ &eThe configuration was reloaded successfully."
config_reload_error: "&7≫ &cAn error occured during reloading, keeping config in memory."
Report
With 1.16's introduction of full RGB colour code support, it's easier than ever to equip your players with sleek-looking coloured name gradients as an added perk. Gone are the days where you were limited to only 15 colours to form such gradients, making them look unappealing and dated.
For instance, how about you provide your players with BuiltByBit's own charity event gradients, which are featured in the default configuration shown below:
This plugin is easily customisable and there's no need to define each colour within a gradient - simply define the start & end colours and all the conjoining colours required will be interpolated automatically!
Screenshots/GIFs
With TAB and PlaceholderAPI dependencies:
(the below doesn't show an animated gradient, but one account selecting different gradients from the menu sequentially and the other observing those changes)
Spoiler: Selecting a gradient
Spoiler: Clearing a gradient
Spoiler: Menu pagination
Commands & Permissions
Code:
/gradient - opens the main menu for selecting colour gradients
/namegradient - main plugin command/show usage
/namegradient reload - reload configuration file
/namegradient clear <player> - clear a player's gradient
/namegradient change <player> <gradient_id> - change a player's gradient provided they have permission to use that gradient in the first place
Code:
namegradient.use - permission to open selector menu
namegradient.gradient.<id> - permission to use a gradient with the given ID
namegradient.reload
namegradient.others.clear
namegradient.others.change
namegradient.override.exempt
Code:
%namegradient_name% - placeholder for accessing a player's gradient within other supported plugins (PlaceholderAPI must be installed)
Defaults back to the player's name if they don't have an active gradient
Configuration & Language
Code:
# _______ ________ .___.__ __
# \ \ _____ _____ ____ / _____/___________ __| _/|__| ____ _____/ |_
# ______ ______ / | \\__ \ / \_/ __ \/ \ __\_ __ \__ \ / __ | | |/ __ \ / \ __\ ______ ______
# /_____/ /_____/ / | \/ __ \| Y Y \ ___/\ \_\ \ | \// __ \_/ /_/ | | \ ___/| | \ | /_____/ /_____/
# \____|__ (____ /__|_| /\___ >\______ /__| (____ /\____ | |__|\___ >___| /__|
# \/ \/ \/ \/ \/ \/ \/ \/ \/
#
#
# NameGradient - Fully customisable 1.16 RGB username gradients
# Developed by Harry [https://www.mc-market.org/resources/authors/87939/] [Majored#8062] [[email protected]]
# DO NOT MODIFY
# The version of NameGradient this configuration is compatible with.
config-version: "1.3"
# Whether or not an update check against MC-Market's Ultimate API should be ran during starup.
version-check: true
## NAME SETTINGS
## Altering these settings will likely require a server restart due to the varying dependency checks within different modes.
name:
mode: "PLAYERNAME" # available modes: "PLAYERNAME", "DISPLAYNAME", "ESSENTIALS", "CMI", AND "PLACEHOLDER".
colour-dependent: false # if true, NameGradient will not apply a gradient if the name to be replaced already has colours present.
placeholder-source: "%player_name%" # the PlaceholderAPI placeholder to use if mode is set to "PLACEHOLDER".
override-displayname: true # must be false when using the "DISPLAYNAME" or "ESSENTIALS" modes.
## CHAT SETTINGS
## Within "REPLACE_ONLY" mode, you may use PlaceholderAPI placeholders within any plugin which alters the chat format (eg. EssentialsChat).
## Wrap placeholders within curly brackets {}, instead of % symbols. For instance, use "{namegradient_name}".
chat:
mode: "OVERRIDE_FORMAT" # available modes: "OVERRIDE_FORMAT", "REPLACE_ONLY" AND "OFF".
format: "{GRADIENT}&8: &7{MESSAGE}" # placeholders available: {GRADIENT} and {MESSAGE} (PlaceholderAPI support if installed also).
## GRADIENT SETTINGS
gradients:
1: # must be an integer and unique to this gradient.
name: "AbleGamers Name Colour" # name of the gradient displayed within GUI (limited to ~27 characters due to item name length limitations).
startColour: "#F2709C" # starting colour of this gradient.
endColour: "#FFB454" # ending colour of this gradient.
alternatePermission: "yourserver.ablegamers" # an optional alternative permission node giving a player access to this gradient.
overridePermission: "yourserver.ablegamers.override" # an optional permission node which will force this gradient to be applied.
overrideWeight: 1 # if a player has multiple override permissions, the gradient with the highest weight will be applied.
2:
name: "Beyond Blue $25 Name Colour"
startColour: "#59EAA4"
endColour: "#089CCC"
3:
name: "Beyond Blue $300 Name Colour"
startColour: "#59EAA4"
endColour: "#CD03FF"
4:
name: "Make-A-Wish Colour"
startColour: "#f74fdb"
endColour: "#940ee2"
5:
name: "SpecialEffect Name Colour"
startColour: "#ffd728"
endColour: "#ff7328"
6:
name: "Water.org Name Colour"
startColour: "#33E7FF"
endColour: "#0368FF"
## GUI/MENU SETTINGS
menu:
title: "&8Gradients"
size: 45 #must be a multiple of 9
per_page: 21 #amount of gradients shown per page
panes:
slots: [0,1,2,3,4,5,6,7,8,9,17,18,26,27,35,36,37,38,42,43,44]
name: "&7"
material: BLACK_STAINED_GLASS_PANE
gradient_item:
material: NAME_TAG
lore_permission:
- "&7♦ &eClick to apply this gradient."
lore_no_permission:
- "&7♦ &cYou don't have sufficient permission."
page_back_item:
slot: 39
material: ARROW
name: "&7Page Back"
page_forward_item:
slot: 41
material: ARROW
name: "&7Page Forward"
clear_gradient_item:
slot: 40
material: BARRIER
name: "&cClear current gradient"
## LANGUAGE SETTINGS
lang:
apply: "&7≫ &eA new gradient has been applied. You're now '{GRADIENT}&e'."
clear: "&7≫ &eYour current gradient has been cleared."
same_gradient: "&7≫ &cYou already have this gradient active."
no_permission_gradient: "&7≫ &cYou don't have permission to use this gradient."
no_permission: "&7≫ &cYou don't have permission to perform this action."
no_gradient: "&7≫ &cYou don't currently have an active gradient."
has_override_gradient: "&7≫ &cYou currently have an override gradient active."
has_coloured_source: "&7≫ &cYou currently have a coloured gradient source which cannot be overridden."
args_incorrect: "&7≫ &cYou entered the incorrect number or type of arguments."
gradient_nonexistent: "&7≫ &cA gradient with this ID doesn't exist."
attempt_change_own: "&7≫ &cPlease use /gradient to change your own gradient."
attempt_clear_own: "&7≫ &cPlease use /gradient to clear your own gradient."
target_offline: "&7≫ &cThis player is not currently online."
target_has_override_gradient: "&7≫ &cThis player currently has an override gradient active."
target_coloured_source: "&7≫ &cThis player currently has a coloured gradient source which cannot be overridden."
change_success: "&7≫ &eYou've updated this player's gradient."
change_target_success: "&7≫ &eYour gradient has been changed by another player."
clear_success: "&7≫ &eYou've cleared this player's gradient."
clear_target_success: "&7≫ &eYour gradient has been cleared by another player."
target_permission_error: "&7≫ &cThis player doesn't have permission to use this gradient."
config_reload_success: "&7≫ &eThe configuration was reloaded successfully."
config_reload_error: "&7≫ &cAn error occured during reloading, keeping config in memory."
Report