## Overview
\nPlayerWaypointColors lets players set their own waypoint colors and lets admins set colors for other players. Optional PlaceholderAPI integration for automatic color assignment on join, exporting a player’s current color to other plugins (chat, scoreboards, etc.), and configurable server defaults.<\/p>\n
## Features ## Compatibility ## Installation ## Commands & Permissions ## Configuration Example config: PWC integrates with PlaceholderAPI in both directions: it can **read** a placeholder to assign a color on join, and it **exposes** its own placeholder so other plugins can read each player’s current color.<\/p>\n ### Reading colors from a placeholder (auto-apply on join)<\/p>\n Set `variable` in config.yml to a placeholder (e.g., `%luckperms_meta_color%`) that returns a hex code in the format `#00FF00` or `00FF00`.<\/p>\n The easiest setup uses LuckPerms meta: Alternatively, use the PlaceholderAPI String expansion (particularly `%string_replaceCharacters_ ### Exposing a player’s current color to other plugins<\/p>\n PWC registers `%pwc_color_ | Placeholder | Returns | Example | Add your own keys in config.yml to support whatever syntax your chat or scoreboard plugin needs. Templates can use these variables (case-sensitive):<\/p>\n – `{HEX}` \u2014 uppercase 6-char hex (e.g. `FF0000`) Example: a chat plugin using `<#hex>` MiniMessage syntax can format messages like `%pwc_color_minimessage% If a player hasn’t picked or been assigned a color, the placeholder returns an empty string regardless of the format requested.<\/p>\n ## Default Color on Join<\/p>\n Set `default-color` to a hex value (e.g. `00FF00`) to apply that color to players who don’t already have one. Leave empty to disable.<\/p>\n `default-color-force`: Manage 1.21.6+ player locator bar waypoint colors, and automatically set custom colors on join<\/p>\n","protected":false},"featured_media":122895,"template":"","meta":{"_minecraft_slug":"playerwaypointcolors","_minecraft_project_id":"2VlkAkjw","_minecraft_author":"hyperkids","_minecraft_license":"MIT","_minecraft_downloads":96,"_minecraft_follows":6,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"playerwaypointcolors.zip","_minecraft_size_bytes":3485647,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T19:46:01.416570Z","_minecraft_date_created":"2025-07-11T05:13:34.789591Z","_minecraft_date_modified":"2026-05-02T12:46:20.050267Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/playerwaypointcolors","_minecraft_icon_attachment_id":122895,"_minecraft_imported_at":"2026-06-07T05:28:23+00:00","_minecraft_import_hash":"a4dbf5b584f5012bd67a4ac07fe9b03d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,129,92],"mod_loader":[132,134],"minecraft_version":[40,41,79,80,81,82,83,167,163],"class_list":["post-122894","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– Assign custom hex colors to player waypoints (e.g., `#FF0000` or `FF0000` for red)
\n– Simple commands for players and admins
\n– Configurable default color applied to players on join
\n– Optional PlaceholderAPI integration:
\n – Read a player’s color from a placeholder on join (e.g., from LuckPerms meta)
\n – Export the player’s current color via `%pwc_color_
\n– **Minecraft:** Spigot 1.21.11+ or Paper 1.21.11+
\n– **Optional:** PlaceholderAPI<\/p>\n
\n1. Download the latest `PlayerWaypointColors.jar`.
\n2. Place it in your server’s `plugins` folder.
\n3. (Optional) Install PlaceholderAPI if you want PAPI features.
\n4. Start or reload your server.<\/p>\n
\n| Command | Description | Permission | Default |
\n|————————————————–|——————————————–|—————————–|———|
\n| `\/pwc help` | Show help message | playerwaypointcolor.help | all |
\n| `\/pwc set
\n| `\/pwc setother
\n| `\/pwc get` | Get your own waypoint color | playerwaypointcolor.self | OP |
\n| `\/pwc get
\n| `\/pwc reset` | Reset your own waypoint color | playerwaypointcolor.self | OP |
\n| `\/pwc reset
\nThe plugin creates a `config.yml` file on first run. Existing files are upgraded in place when new options are added.<\/p>\n
\n“`yaml
\nplaceholderapi:
\n auto-apply-on-join: false
\n variable: “”
\nplaceholders:
\n formats:
\n minimessage: “<#{HEX}>”
\n hex: “#{HEX}”
\n raw: “{HEX}”
\n legacy: “&x&{R1}&{R2}&{G1}&{G2}&{B1}&{B2}”
\ndefault-color: “”
\ndefault-color-force: false
\n“`
\n## PlaceholderAPI Integration<\/p>\n
\n1. Set the permission `meta.color.#FF0000` on a group
\n2. Set `auto-apply-on-join` to `true`
\n3. Set `variable` to `%luckperms_meta_color%`
\n4. Save config.yml and restart your server<\/p>\n
\n|—————————|—————————|——————|
\n| `%pwc_color_minimessage%` | MiniMessage hex tag | `<#FF0000>` |
\n| `%pwc_color_hex%` | hex with leading `#` | `#FF0000` |
\n| `%pwc_color_raw%` | bare 6-character hex | `FF0000` |
\n| `%pwc_color_legacy%` | Spigot legacy color codes | `&x&F&F&0&0&0&0` |<\/p>\n
\n– `{hex}` \u2014 lowercase 6-char hex (e.g. `ff0000`)
\n– `{R1}` `{R2}` `{G1}` `{G2}` `{B1}` `{B2}` \u2014 each channel split into its two hex digits<\/p>\n
\n– `false` (default): only applies the default if the player has no color set. Won’t overwrite a color they picked with `\/pwc set`.
\n– `true`: applies the default on every join, overwriting whatever color the player previously had \u2014 except a color set by `auto-apply-on-join` above, which always wins.<\/p>\n","protected":false},"excerpt":{"rendered":"