Player Steps Recorder saves step recordings that map creators can record. They can be played via mannequin entities and can be helpful in maps or games where you have to use accurate player movement.
The features that PSR can support are:
- Movement
- Rotation
- Items & Armor
- Pose (standing, sneaking, crawling, swimming)
... More can be tracked by your datapack via actions!
How To Use
If you want a short command list, you can use /function psr:help, or read below for a more in-detail explanation.
Recording
function psr:record {name:<name>,x:<x>,y:<y>,z:<z>} (also works with ~ and ^)
Each recording starts with spawning an origin point, at x,y,z.
The origin point helps by replaying your recording anywhere you'd like.
function psr:stop_recording stops the recording
Playing your recording
function psr:play {name:<name>,x:<x>,y:<y>,z:<z>} (also works with ~ and ^)
Fun Fact: By moving the origin point, you can move the whole recording while it's playing.
Also, you can play multiple instances of the same recording at the same time!
function:psr:stop_playback {name:<name>} stops all playing recording instances with the same name. Be careful when playing multiple instances of the same recording!
Other / Documentation
Steps can only save values that have changed. For example, the longer you stay still, the less data will be saved.
Each recording gets stored like a file. If you want to access it via other datapacks, recordings is saved in this storage: psr:recordings recordings.
Recordings
Recordings are SNBT data in a storage that can be used to recreate player-like movement.
Components in storage
| Component | Type | Description |
|---|---|---|
| name | String | Name of the recording |
| version | String | Version the recording was saved in |
| frames | Int | Number of frames. Used to keep the recording from cutting off faster than usual when not updating anything |
| steps | Array (contains Steps) | Steps of the recording |
Steps
Steps are parts of a Recording. They track player properties and only save changes.
Components in storages
| Component | Type | Description |
|---|---|---|
| frame | Int | The frame that the step tracks. Since steps only track changing values, using the index value as a frame value would break the playback |
| Pos | Array | Position that the recorder had (relative to the origin point) |
| Rotation | Array | Rotation that the recorder had (relative to the origin point) |
| mainhand | Item NBT | Item that the recorder had in their mainhand |
| offhand | Item NBT | Item that the recorder had in their offhand |
| head | Item NBT | Item that the recorder was wearing on their head |
| chest | Item NBT | Item that the recorder was wearing on their chest |
| legs | Item NBT | Item that the recorder was wearing on their legs |
| feet | Item NBT | Item that the recorder was wearing on their feet |
| action | String | Action that the recorder triggered |
Actions
Actions are items that can be right clicked while recording to add comments or mark frames easily for other datapack purposes.
