ravenous_roll20/docs/macros.md

1.5 KiB

Ravenous Roll20 macro memo

These actions can be pasted into Collections → Macros → Action. Install the corresponding scripts from roll20_mod/ first. Enable Show as Token Action when the macro operates on a selected token.

Player craft import

The player selects a token linked to a character they control. The JSON must be stored in the GM Notes of a handout shared with or controlled by that player.

Name: Ravenous — Importer un objet

!ravenous-import-craft --handout ?{ID du handout d'artisanat}

Players cannot import into another player's character or read an unshared handout through the script. A GM can use the same macro with any character and handout.

GM character import

Character import creates a new journal character and remains GM-only. Put the export JSON in a private handout's GM Notes.

Name: Ravenous — Importer un personnage

!ravenous-import --handout ?{ID du handout personnage}

GM character export

Select one token linked to the character to export.

Name: Ravenous — Exporter le personnage

!ravenous-export

GM craft import by character ID

Useful when the destination character has no token selected.

Name: Ravenous — Import artisanat par ID

!ravenous-import-craft --id ?{ID du personnage} --handout ?{ID du handout d'artisanat}

Roll20 IDs are the final identifier in the character or handout URL. Handout imports are preferred over pasting JSON into a query because JSON punctuation can interfere with Roll20's query syntax.