IronWriter is an open-source writing tool for solo playthroughs of the free tabletop RPG Ironsworn. Focus on writing your story and let IronWriter automatically manage your character sheet.
โ IMPORTANT NOTE: IronWriter is on an indefinte development hiatus. It also has not yet reached v1.0 and should be considered unstable, so please export and backup any data important to you. Backward compatibility is not guaranteed.
- Use simple markup embedded in your story to automatically update your character sheet
- Track all stats, momentum, status, and debilities
- Track progress on your vows, journeys, and combat
- Editing an event will update all events that follow it
- Remove events
- Track bonds and overall progress track
- Integrated dice rolls
- Roll against oracle tables
- Reroll oracle/dice
- Import/Export
- Save session to browser cache
- Track assets
- Track inventory items
- Manual bookmarking of events to reference later
- Auto-Bookmarking of events with bond and vow progress
IronWriter is an open-source writing tool for solo playthroughs of the free tabletop RPG Ironsworn. Copyright (C) 2019 Alex Larioza
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://github.com/SHiLLySiT/IronWriter/blob/master/LICENSE.txt.
- Visit www.alexlarioza.com/IronWriter or clone this repo and open index.html in your browser.
- As you write your story, progress is automatically saved to your browser's local storage so be aware that clearing site data will delete your save data.
- Use the import/export feature to safely store the your session outside of your browser.
- CTRL+Enter: Submit/Save event
- CTRL+M: Toggle mode
IronWriter represents moments or blocks of content in your stories as "events". How much content you choose to write into each card is up to you.
There are two types of events - "fiction" and "meta". Functionally there is nothing different about them, but they are visually distinct to help separate your fictional elements from your meta actions during your session such as moves, question prompts, etc.
IronWriter uses special markup (referred to as "tags") to automatically update the character sheet. These tags are case-insensitive (removeAsset
is the same as removeasset
) and should always be wrapped in square brackets []
. This documentation will use capitalization for clarity and leave out the brackets for brevity.
[health -2][momentum -1] Blood begins to pour out of the wounds on my arm as the wolf attempts to rip it off. I reach for my dagger tucked in my belt.
I pull the dagger from its sheath and stab the wolf in its neck.[progress wolf] It finally release my arm and whimpers in pain. Just as I think I'm about to make it out of this alive, three more wolfs come running out of the forest. [progress "Wolf Pack" formidable]
For a full example, see the example session.
Tags contain parameters which are used to control how the tags change the character sheet or other event-based features like bookmarks. Parameters are separated by spaces, so if you want to include spaces wrap the parameter in double quotes e.g. rename "Brynn Tahir"
. In the documentation, parameters that are wrapped in carets <parameter>
are required and those wrapped in curly braces {parameters}
are optional.
All events are stored in a history stack so that when you edit an event, any subsequent ones that are dependent on it will be replayed on top of your changes.
IronWriter includes a bookmarking system to help you quickly traverse the history for noteworthy events. There are two types of bookmarks - those created by the system when you make/break a bond or make progress on a vow, and those you create yourself using the bookmark
tag. Both types of bookmarks are saved between sessions and exist in exports.
Renames your character.
rename <character name>
<character name>
The desired name.
rename Maura
Sets the character name to "Maura".rename "Brynn Tahir"
Sets the character name to "Brynn Tahir".
Changes a stat's value. Note that the first parameter is not literally "stat" but the stat that you wish to change.
<stat> {modifier}<value>
- edge
- heart
- iron
- shadow
- wits
- health
- supply
- spirit
- momentum
- experience
- experienceSpent
<stat>
The stat you wish to change.<value>
The value to be applied to the specifiedstat
.{modifier}
How you want thevalue
parameter to be applied. The following options can be used:+
Adds the specifiedvalue
.-
Subtracts the specifiedvalue
.- Not specifying a modifier sets the stat to the specified
value
.
health +1
increases health by 1spirit -2
decreases spirit by 2iron 3
sets iron to 3
Adds and removes debilities and automatically changes max momentum and momentum reset stats.
is <debility>
not <debility>
- wounded
- shaken
- unprepared
- encumbered
- maimed
- corrupted
- cursed
- tormented
<debility>
The debility that you is to add or remove.
is wounded
Adds the wounded debility.not wounded
Removes the wounded debility.
Starts, compeltes, or marks progress on a specific track.
progress <name> {modifier}
<name>
The name of the progress track.{modifier}
How you wish to modify the track. The following options can be used:complete
Removes the progress track from your character sheet.challenge rank
The rank of a new progress track. The following options can be used:troublesome
Each progress is 12 ticks.dangerous
Each progress is 8 ticks.formidable
Each progress is 4 ticks.extreme
Each progress is 2 ticks.epic
Each progress is 1 ticks.
{+/-}<value>
The number of ticks to add, remove, or set.+
Adds the specifiedvalue
.-
Subtracts the specifiedvalue
.- Not specifying a modifier sets the number of ticks to the specified
value
.
- Not passing this parameter automatically adds the number of ticks as specified by the
challenge rank
.
progress "Kill Martu" formidable
Creates a new progress track called "Kill Martu" and sets it's rank toformidable
progress "Kill Martu"
Increases the number of ticks by 4.progress "Kill Martu" +1
Increases the number of ticks by 1.progress "Kill Martu" -2
Decreases the number of ticks by 2.progress "Kill Martu" 8
Sets the number of ticks to 8.progress "Kill Martu" complete
Removes the progress track called "Kill Martu".
Adds a bond to your list of bonds and adds a tick to your bond progress track.
bond <name>
unbond <name>
<name>
Text describing the bond.
bond Father
Adds a bond called "Father" and adds 1 tick to the bond progress track.unbond Father
Removes the bond called "Father" and removes 1 tick from the bond progress track.bond "Mai Lucia"
Adds a bond called "Mai Lucia" and adds 1 tick to the bond progress track.
Adds and updates your character's assets.
asset <name> <perk>
asset <name> <property> {modifier}<value>
removeAsset <name>
You must add an asset before adding perks or properties, e.g.
[asset Ritualist] // add asset first
[asset Ritualist 1] // add first perk point
<name>
The name of the asset.<perk>
Unlocks the perk in the specified slot.<property>
The name of an asset property.{modifier}
How you want thevalue
parameter to be applied. The following options can be used:+
(Number Only) Adds the specifiedvalue
.-
(Number Only) Subtracts the specifiedvalue
.- Not specifying a modifier sets the stat to the specified
value
.
<value>
The value of the property. Can be a number or text.
asset Ritualist
Adds an asset called "Ritualist".asset Ritualist 1
Unlocks the perk in slot "1" for asset called "Ritualist".asset Hawk Health 1
Sets the "Health" property to "1" for the asset called "Hawk".asset Hawk Health +10
Adds "10" to the "Health" property for the asset called "Hawk".asset Hawk Health -5
Subtracts "5" from the "Health" property for the asset called "Hawk".asset Wright Specialty Herbalism
Sets the "Specialty" property to "Herbalism" for the asset called "Wright".removeAsset Wright
Removes the "Wright" asset.
Adds and updates your character's inventory.
item <name> <quantity>
item <name> <property> {modifier}<value>
removeItem <name>
<name>
The name of the item.<quantity>
The value you wish to set for the "Quantity" property of the item. Defaults to1
if not specified. The following options can be used:{+/-}<value>
The quantity to add, remove, or set.+
Adds the specifiedvalue
.-
Subtracts the specifiedvalue
.- Not specifying a modifier sets the "Quantity" property to the specified
value
.
<property>
The name of an item property.{modifier}
How you want thevalue
parameter to be applied. The following options can be used:+
(Number Only) Adds the specifiedvalue
.-
(Number Only) Subtracts the specifiedvalue
.- Not specifying a modifier sets the stat to the specified
value
.
<value>
The value of the property. Can be a number or text.
item Dagger
Adds an item called "Dagger" with the default "Quantity" property set at "1".item Arrows 5
Adds an item called "Arrows" with the "Quantity" property set at "5".item Dagger Condition 3
Sets the "Condition" property to "3" for the item called "Dagger".item Dagger Condition +2
Adds "2" to the "Condition" property for the item called "Dagger".item Dagger Condition -5
Subtracts "5" from the "Condition" property for the item called "Dagger".item Waterskin Level Full
Sets the "Level" property to "Full" for the item called "Waterskin".removeItem Waterskin
Removes "Waterskin" from the inventory.
Adds a Bookmark to the bookmark list.
bookmark <name>
<name>
The name of the bookmark.
bookmark "Arrived at Greathill"
Adds a bookmark called "Arrived at Greathill".