✨ Locator Docs Improvements

Author: SnaveSutit

src/routes/docs/[...4]the-blueprint-format/[...6]locators/+page.md

@@ -7,6 +7,14 @@ description: Locators are used to execute commands at a specific position / rota
 
 { $frontmatter.description }
 
+## Creating a Locator
+
+To create a locator, locate the `Add Locator` button above the outliner.
+
+![add-locator-action](/img/steps/locator/1.png)
+
+If this button isn't there, you can press `h` and then search for `Add Locator`.
+
 ## Config Options
 
 - ### Use Entity
@@ -31,13 +39,64 @@ description: Locators are used to execute commands at a specific position / rota
 
   If `Use Entity` is enabled, the commands will be executed as the locator's entity.
 
-## Excuting Commands as / at Locators
+## Animating Locators
+
+### Position / Rotation
+
+Locators must be a child of a Bone in order to be positioned / rotated.
+
+### Command Keyframes
+
+When selecting a Locator in `Animate Mode`, you can add Command Keyframes to it's Timeline to play commands at specific times during an animation.
+
+![locator-keyframes](/img/steps/locator/2.png)
+
+#### Command Keyframe Options
+
+- #### Command
+
+  The command(s) that will be executed. Supports multiple commands (one per line) similar to a `mcfunction`, and supports [MC-Build](https://mcbuild.dev/) syntax.
+
+- #### Repeat?
+
+  If enabled, the command will be executed every `Repeat Frequency` ticks until the next keyframe.
+
+- #### Repeat Frequency
+
+  The amount of ticks between each repeated command execution. A value of `1` will execute the command every tick.
+
+  `Repeat Frequency` is relative to the animation, and will pause / play with the animation.
+
+  If your animation's length is not evenly divisible by the `Repeat Frequency`, the time between the last command execution and the end of the animation will be less than the `Repeat Frequency`.
+
+- #### Execute Condition
+
+  A condition that must be met in order for the command to be executed.
+
+  Expects a chain of [execute sub-commands](https://minecraft.wiki/w/Commands/execute#Syntax) without `execute` or `run`.
+
+  :::admonition type=info title=Example
+
+  ```txt title="A Simple Execute Condition"
+  if entity @s[tag=my_tag]
+  ```
+
+  ```txt title="A More Complex Execute Condition"
+  aligned xyz positioned ~.5 ~ ~.5 if entity @n[tag=my_tag,distance=..0.1]
+  ```
+
+  :::
+
+## Excuting Commands as / at Locators Externally.
+
+Sometimes you may want to execute commands at a specific locator's position / rotation from an external function. This can be done by getting the locator's information using the data entity's `data.locators.<locator_name>` NBT.
 
 :::admonition type=info title=Example
 Execute at a specific locator's position
 
 ```txt title="foo/as_root.mcfunction"
-execute as <root> on passengers if entity @s[tag=aj.data] run function foo:position with entity @s data.locators.<locator_name>
+execute as <root> on passengers if entity @s[tag=aj.data] run \
+  function foo:position with entity @s data.locators.<locator_name>
 ```
 
 ```txt title="foo/position.mcfunction"
@@ -52,7 +111,8 @@ Execute as a specific locator's entity
 Note that this method will only work if you have the Locator's `Use Entity` config option enabled.
 
 ```txt title="foo/as_root.mcfunction"
-execute as <root> on passengers if entity @s[tag=aj.data] run function foo:select with entity @s data.locators.<locator_name>
+execute as <root> on passengers if entity @s[tag=aj.data] run \
+  function foo:select with entity @s data.locators.<locator_name>
 ```
 
 ```txt title="foo/select.mcfunction"
@@ -66,7 +126,9 @@ $execute as $(uuid) run ...
 Executing commands at all of a Rig Instance's locators that have an entity associated with them.
 
 ```txt title="foo/as_root.mcfunction"
-execute as <root> run function animated_java:<export_namespace>/as_own_locator_entities {command:'function foo:as_locator'}
+execute as <root> run \
+  function animated_java:<export_namespace>/as_own_locator_entities \
+  {command:'function foo:as_locator'}
 ```
 
 ```txt title="foo/as_locator.mcfunction"