Placeholders.md

@@ -124,3 +124,17 @@ These work in any plugin that resolves PAPI placeholders.
 | `%mythicrpg_cast_time_remaining%`        | Remaining cast time in seconds (`0` if not casting).                                    |
 | `%mythicrpg_cast_time_total%`            | Total cast time in seconds (`0` if not casting).                                        |
 | `%mythicrpg_cast_interruptible%`         | `true` if the active cast is interruptible (`false` if not casting).                    |
+
+### Waystones
+
+See the [Waystones page](/Waypoints) for the full system.
+
+| Placeholder                                        | Returns                                                                                                                                  |
+|----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|
+| `%mythic_waystone_discovered_<id>%`                | `true` if the player has discovered the [waystone](/Waypoints) with the given id, otherwise `false`.                                     |
+| `%mythic_waystone_state_<id>%`                     | The player's current state for the waystone: `UNDISCOVERED`, `DISCOVERED`, or `ACTIVE`.                                                  |
+| `%mythic_waystone_name_<id>%`                      | The waystone's `DisplayName` (with formatting). Empty string if the id doesn't exist.                                                    |
+| `%mythic_waystone_distance_<id>%`                  | Distance in blocks from the player to the waystone, to one decimal place. Returns `-1` if the player and waystone are in different worlds. |
+| `%mythic_waystone_discovered_count%`               | Number of waystones the player has discovered.                                                                                            |
+| `%mythic_waystone_respawn%`                        | The id of the player's currently-bound respawn waystone, or empty if none.                                                                |
+| `%mythic_waystone_nearest%`                        | Id of the nearest **discovered** waystone in the player's world, or empty if none. Append `_all` to include undiscovered waystones too (`%mythic_waystone_nearest_all%`). |