Rolls the dice expression and sends the result.
d20 + 4
Repeats the grouped expression and sums the results.
2(d20+4)
Rolls a success check. The result is true or false.
d20 >= 10
Variables last for one submitted chat input or macro run.
x = 20 d20 + x
Changes the displayed speaker name for later lines in this submitted input.
name Jon This line is from Jon. name Goblin This line is from Goblin.
Sends text without trying to parse it as a roll. A leading backtick does the same thing.
say Roll d20 + str `Roll d20 + str
Runs only the lines under the matching branch.
x = 1 if x: d20 + 4 else: d20
Runs an indented block more than once, up to 20 times. loop and times also work.
repeat 3: d20 + 4
Opens this Help window. Use /help, /help macros, or /help sheets.
/help /help macros /help sheets
Picks one whitespace-separated option. Quotes keep words together.
choose goblin orc "gelatinous cube"
Randomizes the order of the options.
shuffle Alice Bob Carla
Rolls on a named table. Use mytable for a private table.
table rumors mytable secrets
Styles later lines in the same submitted input. Use /reset to clear styles.
/color red bold italic Danger! /reset This is plain.
Asks for a saved variable value and updates that variable before later lines run.
prompt power attack d20 + attack - power attack
Updates a saved variable without opening a prompt.
set power attack 3 d20 + attack - power attack
Uses a different spreadsheet for bare named cells and bracketed sheet expressions later in the same input.
sheet Garret d20 + attack d20 + [bab + str_mod]
Comments work in rolls, variables, control flow, choose, and shuffle. Raw text commands keep # as text.
bonus = 4 # favored terrain d20 + bonus
| create group | use the Macros section in the left panel |
| create macro | right click a macro group, then add a macro |
| run macro | click its button in the chat macro panel |
| edit macro | open it from the left panel to edit, test, or use it |
| macro body | runs as the same script you can type in chat, with saved variables added to scope |
| macro variable | attached to one saved macro; useful for per-button inputs |
| group variable | attached to a macro group; visible to that group |
| global variable | put it in global or globals |
| variable types | number, boolean, expression, ability score, choice |
| prompt variable | prompt power attack asks and updates that saved variable |
| set variable | set power attack 3 updates that saved variable directly |
| use group | use Yowa imports variables from another group |
| dotted name | Yowa.bab reads another group's variable |
| matching sheet | macro tab Yowa can read sheet Yowa |
| sheet command | sheet Garret changes sheet context for the rest of the input |
| named cell | d20 + attack uses named cell attack from that sheet |
| sheet formula | d20 + [str_mod + bab] evaluates a sheet expression |
| docs | Full macro docs |
| new sheet | click New Sheet... in the left panel |
| open sheet | click a sheet name in the left panel |
| edit cell | type text or a number directly into a cell |
| formula | start with =, like =str_mod + bab |
| cell refs | A1, a$, named columns, and named cells |
| name cell | right click a cell, then set or clear its name |
| rows/columns | right click headers to insert, delete, move, sort, or style |
| copy/paste | copy and paste tab-separated spreadsheet data |
| download | use the sheet menu to download TSV data |
| functions | use built-ins like sum, avg, round, and eval |
| docs | Full spreadsheet docs |
| Alignment: | |
| Link To Map: | |
| Link To Note: | |
| This map can't be deleted. | |
You or your browser has restricted reading the clipboard so we have this crappy dialog instead.
Paste into the textbox then hit ok.