MATT Write to Journal - ironmonk88/monks-module-wiki GitHub Wiki
Write to Journal
Adds text to a journal entry.
Select Entity
Use this to directly target an entity; the following entity types are able to be targeted.
- Journals in the directory or within a compendium.
Player Tokens
Current Action Collection
Writes to the current journal collection.
Use this following a Roll Table action to write to the result if its a journal.
I have no idea why you would want to write to a random journal every time, but the option is there. -Crow
Page
The dropdown will be populated with a list of pages if targeting a multi-page journal.
Create Page if Not Found
Check this to create a new page. Requires the New Page Name to be filled out.
New Page Name
Name of the page to be created. This accepts the same handlebar expressions the text field does.
Text
The text to be added to the journal
Handlebar Expressions
The text field here accepts Handlebar Expressions, which can be used to customize the message based on existing data.
{{actor.name}}Sends the name of the actor of the triggering actor to the journal.{{datetime}}Adds an in-game world timestamp to the journal. Requires Simple Calendar.{{scene.name}}Sends the name of the scene to the journal.{{timestamp}}Adds a real-time timestamp to the journal.{{token.name}}Sends the name of the triggering token to the journal.{{user.name}}Sends the name of the triggering user to the journal.{{value.items.0.name}}If used following an Add Item action, it will send the item name to the journal.{{value.text.[0]}}Sends the results of a previous Roll Table action to the journal.
Custom HTML
The text field here accepts custom HTML formatting that will be used when writing to the journal.
<p>text here</p>Defines a paragraph. https://www.w3schools.com/tags/tag_p.asp
Write
- Append
- Append Line
- Prepend
- Prepend Line
- Insert
- Overwrite
Language
Having Polyglot installed and active adds this dropdown; it will be populated by a list of languages in your world's settings. Leave it blank to have it not use Polyglot.
Notes
- This action continues to store its text information when swapped into another action, even if that action does not contain a text field. It's recommended to just delete this action instead if you need to replace it with something else to help keep data sizes down.
- Prior to MATT 10.8, this action required Monk's Enhanced Journals. It was moved to core MATT as it technically didn't require any code provided by MEJ. The old action provided by MEJ is still in the code as a separate action, and will no longer be getting updated. You will need to convert the old ones over to the core MATT action manually.
- Will not work when targeting a MEJ List journal, as they don't use a standard text entry.
Sample Tiles That Use This Action
- [Encounter Logger](/ironmonk88/monks-module-wiki/wiki/ST-Encounter-Logger)
Page Last Updated
- Foundry 12.331
- MATT 12.02