> For the complete documentation index, see [llms.txt](https://wiki.stmod.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.stmod.net/private-servers/recorder.md).

# Recorder

<figure><img src="https://1662484209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSrVu0j9CYXbvJXRYgHnk%2Fuploads%2Fgit-blob-dd8554fbb8166e1f9741f2e89c1de5ccac4b2b91%2Frecorder-tab.png?alt=media" alt="Action recorder tab"><figcaption><p>Action recorder (build v021026)</p></figcaption></figure>

The **Action recorder** saves what you do at NPCs and repeats it for you. It's found under **General → Recorder**.

Typical uses: handing in quest items, restarting a dungeon run, buying from an NPC, or picking up a repeatable quest — anything you'd otherwise click through by hand every few minutes.

## Recording something

1. Press **Record**, then do your actions in game: talk to an NPC, choose dialogue options, hand in items, use items, drag items around the inventory, type commands, enter a dungeon.
2. Press **Record** again to stop. Every action appears in the **Actions** list with the moment it happened.
3. Press **Do** to play it back. The same actions run again with the same delays, then repeat.

{% hint style="warning" %}
Stay on the map where you recorded — the recording is tied to that map, and the NPCs won't be found anywhere else. The map it was recorded on is shown under the status line.
{% endhint %}

{% hint style="info" %}
A recording belongs to the settings profile that's loaded, so press **Save** in the [Settings window](/private-servers/settings-window.md) to keep it.
{% endhint %}

## Recordings (left panel)

You can keep several recordings side by side — one per dungeon, or per NPC run. The **Actions** list on the right always belongs to the recording marked with `>`.

Each line reads like `> [-] Recording 1 (0)`:

* `>` — this is the recording currently open for editing.
* `[-]` / `[1]`, `[2]` … — its turn in the farm sequence, or `-` if it isn't sequenced.
* `Recording 1` — its name.
* `(0)` — how many actions it contains.
* **New** — Adds an empty recording using the name typed in the box above.
* **Name** — Renames the selected recording.
* **Del** — Deletes the selected recording.
* **Open** — Switches to the recording you picked, so the Actions list and the Record/Do buttons apply to it.
* **Seq** — Puts the selected recording into the farm sequence, or takes it out.
* **Up** / **Down** — Moves the selected recording earlier or later in that sequence.

## Actions (right panel)

Lists every recorded step in order, each with the time it happened. Recorded steps include talking to an NPC, choosing a dialogue option, typing a value into an NPC window, handing an item to an NPC, using an item, using one item on another, moving an item to another inventory slot, and writing in chat.

* **Record** — Starts/stops recording. Starting a new recording replaces whatever was in the current one.
* **Do** — Plays the recording back, then repeats it on the interval below.
* **Clear** — Removes every action, to start over.
* **Del. selected** — Removes just the action you picked, to drop a wrong step without re-recording.

## Options

* **Deliver with teleport** — Teleports to the NPC to hand items in, instead of walking there.
* **Click NPC with teleport** — Teleports to the NPC to talk to it.
* **Disable quests** — Stops quest windows from opening while the recording plays.
* **Show progress in chat** — Prints each step to the chat as it runs, so you can see what the recorder is doing. On by default.
* **Repeat every (s)** — How often the whole recording runs again. It can never be shorter than the recording itself — a shorter value is raised to the recording's own length.

{% hint style="warning" %}
Both teleport options depend on your server's protections. On some servers they may not work, or may be logged.
{% endhint %}

## Status line

Below the options you'll see the current state and totals, e.g. `idle 0 / 0s`:

* **idle** / **recording...** / **playing...** — what the recorder is doing right now.
* The first number is how many actions the open recording holds; the second is how long it takes to play through.
* Underneath, **Map:** shows which map the recording was made on, and the order line shows the farm sequence when one is set.

## Running recordings from the farmbot

Two options in **Farming → Farm settings → Options** let the farmbot trigger recordings for you:

* **Play recording if nothing to attack** — When the farmbot runs out of things to kill, it pauses, plays the recording once, then goes back to farming.
* **Play all recordings in order** — Runs every recording you marked with **Seq**, one after another, before farming continues. If no recording is sequenced, every recording that has actions is played instead.

This is the usual way to hand in items, restart a dungeon, or pick up a quest between farm runs. Record the actions in this tab first.