MATT Write to Journal - ironmonk88/monks-module-wiki GitHub Wiki

Write to Journal

Adds text to a journal entry.

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 current 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 current token to the journal.
  • {{user.name}} Sends the name of the current 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.

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

Page Last Updated

MATT 11.19

⚠️ **GitHub.com Fallback** ⚠️