Lone Wolf Development Forums  

Go Back   Lone Wolf Development Forums > Realm Works Forums > Realm Works Discussion


Thread Tools Display Modes
Prev Previous Post   Next Post Next
Senior Member
Join Date: Mar 2013
Location: Greater London, UK
Posts: 2,482

Old May 17th, 2021, 08:46 AM
Hello all,

I have started development on a Foundry VTT module which will allow you to import some material from Realm Works into Foundry.

The module requires that you generate an RWoutput file from Realm Works (not RWexport, but RWoutput).

The contents of this file are then processed by my module to generate entries in your world, stored in a named folder.

It creates Journal Entries from topics, Scenes from smart images (including map pins), Actors from HL portfolios and statblocks, and Playlists from audio snippets.

The module can be found at https://github.com/farling42/fvtt-import-realmworks

Note that due to the restrictions of what Realm Works will allow to be stored in the RWoutput file, it is not possible for you to transfer your RW-purchased modules using this method.

Donations for efforts can be made via any of Ko-Fi or Paypal



- read RWoutput from a file (or copy/paste directly into a text box)
- read a Hero Lab portfolio file directly (for PF1, DND5E and Savage Worlds)
- Each topic imported into its own Journal entry, grouped by topic category.
- most normal snippet types
- simple pictures
- statblocks used to create Actor (statblock stored in notes/description panel)
- HL portfolios used to created populated Actors for some game systems, otherwise as per statblock.
- links between RW articles/FVTT journal entries.
- table of contents for each parent showing all descendents (optionally only down to a specific level).
- (optional) inbound/outbound links listed at the end of a topic's entry.
- create Scenes from smart images
- snippet styles and GM-direction formatting transferred to journal entries.
- display annotations and gm_directions in a distinct way


- support more snippet types
- display more game systems for populated Actors (now only done on request)

GM-Directions on map pins are transferred to map Notes.
Create an Actor for EACH character in a HL portfolio file, not just the first one.
For PF1 characters, create sub-skills (e.g. Artistry, Perform, Profession).
Include prefix and suffix (if any) from the RW topic in title of journal entries.
Create thumbnails for each scene.

RW terminology used in standard section headings:
"Child Topics" changed to "Governed Content";
"Connections" changed to "Relationships";
"Links To/From Other Topics" changed to "Content Links: In/Out".
Format of relationships changed slightly, and includes any entered annotations.
README.md file updated with current information.
GM-Directions in topics converted to "secret" sections in journal entries.
Snippet styles change the background colour as per RW.

Snippet style is now displayed for all snippet types; and GM-directions are boxed with their other content.

This version works on both 0.7.9 and 0.8.6. It also reads weapons/ammo/armor/shields from embedded HL files for PF1.

I've added the ability to load just a .por file, so that it create Actors directly from that file.
It also decodes spells for PF1, and the correct number of levels of each class.

Hopefully improved performance for larger files.
Better decoding of Actors for PF1 (Skill Focus modifies the relevant skill; Correct number of monster levels)

Playlists are created from audio snippets. One playlist per topic, one sound within the playlist for each audio snippet within the topic.

Better decoding of Pathfinder 1st edition characters from Realms and HL portfolio files: unknown spells are added, class abilities are added.

Remember the settings selected in the dialogue window.

Fix a problem with not creating some links. I don't know if this is a new bug introduced by RW version 257 (I was searching for only <span> to contain links, but 257 sometimes uses <span class="RWSnippet">. This means searching will be slower since the longer span is used for all forms of text, not just links.

Fixed a problem for new FVTT worlds where the default location for asset files started with world instead of worlds.
ChangeLog and compatibleCoreVersion also updated.

Fixes compatibility with Foundry version 0.7.x.
In 0.7.x all playlists are put at the top level since folders for playlists is a new feature in Foundry 0.8.x

Converts BMP and TIF/TIFF files to PNG format before uploading to Foundry VTT.

A small improvement to place Actors into a sub-folder named after the containing topic. (But with the proviso that if the topic has only one actor AND the name of the actor is the same as the name of the topic, then no sub-folder is created.)

The module tries to store the statblock somewhere in the Actor sheet for ALL game systems.
For PF1, many of the other fields in the Actor sheet are extracted (this has been available for a long while).
For all other game systems, the HTML of the statblock will simply be copied into an appropriate Notes or Biography section of the Actor sheet.

Calculation of HP for imported PF1 actors should be better.
An internal change should also make processing a little faster when there are a LOT of actors in your realm.
Importing a HL .por file directly should work properly again (there was a bug which caused most of the actor data to disappear during creation).

Support the Cypher game system in Foundry VTT by creating "PC" Actors with the statblock put into the Notes section.
When importing a standalone Hero Lab .por file, if full Actor creation isn't supported then just store the HTML statblock(s) in the created Actor(s).

Add module configuration setting to set the preferred Actor type when generating Actors from statblocks.
When decoding PF1 Actors, check for presence of "challengerating" element to choose 'npc' Actor type instead of 'character'.
Better fix for HP calculation of PF1 Actors for Actors with multiple types of hit dice.
Create link at start of each Journal Entry to the parent topic. The label for this link is a configurable parameter.

The "Governed Content" will now contain the full hierarchy of descendents rather than only the direct children.
Provide link from Scene Notes journal entry back to the Scene.

Adds a configuration parameter in the module settings panel so that you can specify the maximum depth of the governed content added to journal entries.

Allow the asset files to be located in S3 storage (courtesy of the DirectoryPicker class from ddb-importer).

Adds decoding of Actor information from D&D 5E portfolio files.
Removes support for 0.7.9

Fixes a bug where the module would fail to start if the D&D 5E game system was not installed on your Foundry server (even though the game system you're importing to isn't D&D 5E).

The disposition on tokens for created Actors of NPCs is set to the HL allegiance when decoding portfolio files.
Decoding of basic "Savage World" HL portfolio files is now available - it supports both FVTT Savage World game system, and will use the "Savage Worlds Core Ruleset" if available.

Snippets are now placed immediately after the section header when the section has sub-sections. (Previously they were put AFTER all sub-sections, and so appeared to be part of the last sub-section.)

Ensure that ALL portfolios + statblocks in a topic are converted into Actors (instead of just the first one).
Prevent error when filename is missing for a portfolio or statblock.
Improve error logging to the console, particularly during actor creation.
Do NOT create actors in a topic when the actors are actually stored in a child topic (they are created for the child topic only).
The name of Actors created from Statblocks will now use the name from the snippet, and appended with the annotation if present (preceded by ":").
Fix an issue with processing a .por directly would fail if a character in the file had minions.

Links to the parent topic, and links to child topics, will now only contain the public name of the topic and will NOT include all the aliases.
Folders will be created with sorting set to MANUAL rather than AUTOMATIC, so that items in the folder retain the same order as in RW.
Speed up creation of Scenes by creating all Notes in a single call to the server.

Updates to PF1 Actor creation:
Attempt to automatically populate the Combat tab of Actors from all the weapons in their inventory.
Detect "masterwork" and "+X" weapons and armour (doesn't work if the item name has other item properties in it).

PF1 Actor decoding has more information in COMBAT tab:
Non-weapon attacks now added to COMBAT tab in the "Natural Attacks" section.
Special Attacks (probably from classes & feats) are added to the MISC section of the COMBAT tab.

Adds support for decoding Call of Cthulhu portfolios into Actors.
It works much better if the Foundry compendium and/or Items Directory contain definitions for weapons, skills, books and spells.


Author of the Realm Works Import tool, Realm Works Output tool and Realm Works to Foundry module

Donations gratefully received via Patreon, Ko-Fi or Paypal

Last edited by Farling; September 16th, 2021 at 07:04 AM.
Farling is offline   #1 Reply With Quote

Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump

All times are GMT -8. The time now is 11:35 AM.

Powered by vBulletin® - Copyright ©2000 - 2021, vBulletin Solutions, Inc.
wolflair.com copyright ©1998-2016 Lone Wolf Development, Inc. View our Privacy Policy here.