Placeholders.md

@@ -46,6 +46,22 @@ These only resolve when used inside a talent skill context (e.g. inside the `Con
 | `<caster.talent.max_points>`         | The talent's `MaxPoints` value.                                                  |
 | `<caster.talent.pointed_needed>`     | Points the caster still needs to invest in the *tree* before the talent unlocks. |
 
+### Cast State
+
+These resolve against the target entity's current [cast-time](/Spells/Casting#cast-time) cast. If the target isn't casting, defaults are returned (`false` / `0` / empty string, depending on the metric).
+
+| Placeholder                              | Returns                                                                         |
+|------------------------------------------|---------------------------------------------------------------------------------|
+| `<caster.cast.active>`                   | `true` while the entity is casting; `false` otherwise.                          |
+| `<caster.cast.spell>`                    | Internal id of the spell being cast.                                            |
+| `<caster.cast.display>`                  | Display name of the spell being cast.                                           |
+| `<caster.cast.remaining>`                | Remaining cast time in seconds (e.g. `1.34`).                                   |
+| `<caster.cast.total>`                    | Total cast time in seconds.                                                     |
+| `<caster.cast.progress>`                 | Cast progress as a `0.00`–`1.00` value.                                         |
+| `<caster.cast.interruptible>`            | `true` if the active cast is interruptible.                                     |
+
+`<target.cast.*>` and `<trigger.cast.*>` work the same way against their respective scopes.
+
 
 ## PlaceholderAPI Integration
 
@@ -99,5 +115,12 @@ These work in any plugin that resolves PAPI placeholders.
 ### Casting State
 
 | Placeholder                              | Returns                                                                                 |
-|------------------------|--------------------------------------------------------------------------|
+|------------------------------------------|-----------------------------------------------------------------------------------------|
 | `%mythic_is_casting%`                    | `true` while quickcasting is active for the player, otherwise `false`.                  |
+| `%mythicrpg_is_spell_casting%`           | `true` while a [cast-time](/Spells/Casting#cast-time) cast is in progress, else `false`.|
+| `%mythicrpg_casting_spell%`              | Internal id of the spell currently being cast (empty if none).                          |
+| `%mythicrpg_casting_spell_display%`      | Display name of the spell currently being cast.                                         |
+| `%mythicrpg_cast_progress%`              | Cast progress as a `0.00`–`1.00` value (`0` if not casting).                            |
+| `%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).                    |