Overview
PlayerWaypointColors lets players set their own waypoint colors on the 1.21.6+ locator bar, and lets admins set colors for other players. Supports automatic player color assignment using PlaceholderAPI.

Features

• Assign custom hex colors to player waypoints (e.g., #FF0000 or FF0000 for red)
• Simple commands for players and admins
• Optional PlaceholderAPI integration for automatic color assignment on join

Compatibility

• Minecraft: Spigot 1.21.7, Paper 1.21.7
• Optional: PlaceholderAPI

Installation

1. Download the latest PlayerWaypointColors.jar.
2. Place it in your server's plugins folder.
3. (Optional) Install PlaceholderAPI if you want dynamic color assignment.
4. Start or reload your server.

Commands & Permissions

• /pwc help Show help message
• /pwc set <color|hex> [#hexcode] Set your own waypoint color
• /pwc setother <player> <color|hex> [#hexcode] Set another player's waypoint color
• /pwc get Get your own waypoint color*
• /pwc get <player> Get another player's waypoint color*
• /pwc reset Reset your own waypoint color
• /pwc reset <player> Reset another player's waypoint color

*NOTE: /pwc get is only supported on Spigot (not on Paper) due to API limitations.

Permissions:

• playerwaypointcolor.help (defaults to everyone)
• playerwaypointcolor.self
• playerwaypointcolor.others

PlaceholderAPI Integration
If PlaceholderAPI is installed, you can use a placeholder to automatically assign hex colors when players join. Set the variable in config.yml to your desired placeholder (e.g., %luckperms_meta_color%), which must return hex colors in the format #00FF00 or 00FF00.

The easiest way to do this is by using LuckPerms meta functionality.

1. Set the permission meta.color.#FF0000 on a group
2. Set the config.yml option auto-apply-on-join to true
3. Set the config.yml option variable to %luckperms_meta_color%
4. Save config.yml, restart your server

Alternatively, you can use the PlaceholderAPI String expansion (particularly %string_replaceCharacters_<configuration>_<string>%) to manipulate your placeholder to return a valid hex code.