2.2 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.
Player character backup and replacement
Select one token linked to a character the player controls. Export creates a handout controlled by that player, with JSON in its visible Notes.
Name: Ravenous — Sauvegarder le personnage
!ravenous-export
To restore that JSON into the same Roll20 character while preserving its ID, linked tokens, ownership, avatar, and GM Notes:
Name: Ravenous — Restaurer le personnage
!ravenous-import --replace --handout ?{ID du handout personnage}
Replacement deletes the destination's existing sheet attributes and abilities. The player must control both the selected character and the source handout.
GM character import
Character creation 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.