Skip to content
kahlen-tech edited this page Nov 4, 2026 · 1 revision

Description

Plays your instrument in the background while you do other things. Once a minute, if Performance isn't already at 33 or above, it sends PLAY with your stored song, unless one of your play_no_use_scripts is running or you're in one of your play_no_use_rooms. It keeps running until you stop it.

If you have no stored song yet, it runs ;performance checksong first to pick one. See Performance Settings.
If you have neither your instrument nor your worn_instrument, it says "No instrument found. Exiting." It also stops straight away at 1750 Performance ranks.
It plays whatever instrument you're holding or wearing, and doesn't clean or tune it. Run ;performance now and then for that.

Settings

YAML Settings

worn_instrument: zills
instrument:
play_no_use_scripts:
- alchemy
- astrology
- attunement
- buff
- burgle
- carve
- combat-trainer
- craft
- enchant
- forge
- outdoorsmanship
- remedy
- researcher
- sew
- shape
- sigilharvest
- smelt
- smith
- spin
- theurgy
- tinker
- workorders
play_no_use_rooms:
- 1900
- Knife Clan, Triage
- !ruby/regexp '/^(?:First )?Provincial Bank,/'
- !ruby/regexp '/Carousel (?:Booth|Chamber)$/'

The lists above are the base.yaml defaults. If you set your own, it replaces the default, so copy any entries you want to keep.

Setting Default Purpose
worn_instrument zills Your worn instrument. It only checks you have it (or your instrument).
instrument A held instrument.
play_no_use_scripts (the list above) It doesn't play while any of these scripts is running.
play_no_use_rooms (the list above) It doesn't play in these rooms. Each entry is a room id, a room's full title without the brackets, or a !ruby/regexp that matches part of the title.

Argument Settings

None.

Usage

;play

Autostart

To play whenever you're logged in, add it to the autostarts: list in your setup YAML:

autostarts:
  - play

Clone this wiki locally