Skip to content

Migration Tutorial

Jump to bottom
Brianna A edited this page Jun 7, 2024 · 14 revisions

System Migration

I recently made a critical change in the latest update for Project FU for FoundryVTT, version 2.1.0. In this release, I changed the package ID from fabulaultima to projectfu. If you are creating a new world you won't have to worry about this.

Action Required for Users with Existing Worlds: If you have existing worlds created with an older version of the FU system (both Legacy & Main Build [pre-2.1.0]), please note that you will need to take the following steps:

World-Migration-Tutorial.mp4

[NOTE] Always make sure to back up your world before attempting to make changes!

  1. Navigate to the following directory
  • Windows C:\Users\<username>\AppData\Local\FoundryVTT\Data\worlds\<worldname>\world.json
  • MacOS ~/Library/Application Support/FoundryVTT/worlds/<worldname>/world.json
  • Linux /home/$USER/.local/share/FoundryVTT/Data/worlds/<worldname>/world.json
  1. Edit this file with any text editor.
  2. Find the corresponding lines "system": "fabulaultima", and replace each one of them with the following "system": "projectfu",
  3. Save changes
  4. Relaunch Foundry VTT

If you are upgrading from Legacy Build: Do note that while most of data would transfer over from Legacy Build to the new Project FU Build, there are a few exceptions.

  • Class Benefits
  • Weapon hand, type, and category (changed from uppercase to all lowercase)
  • NPC Affinities
  • And Character Bonds
  • NPC consumables has been removed and will not be available upon updating

Important

When migrating from the legacy version you might run into problems with the following types of document:

  • Character
  • NPC
  • Class
  • Misc. Ability
  • Spell
  • Weapon

There may be cases where any of these document types do not retain certain changes through a reload of Foundry. In that case, please duplicate the document and remove the old document. The new document should work without problems. For more information see this comment

Expect data for the following fields to not transfer over until a migration script is implemented in the late future. You can still access inaccessible data by exporting your Actor/Item Data as a json.

To update to Project FU from Legacy Build you can follow the Sem-Automatic Installation guide:

  1. Delete the legacy build from your game systems tab. (Installing new system will automatically overwrite Legacy build)
  2. Open the Foundry Setup screen and navigate to the Game Systems tab.
  3. Click the "Install System" button.
  4. Use the following Manifest URL: https://github.com/League-of-Fabulous-Developers/FoundryVTT-Fabula-Ultima/releases/latest/download/system.json
  5. Click "Install."

Migrating World for Forge Users: To migrate a world to be used with the new system first you need to navigate to Game Configuration.

Game_Configuration

Then, you will see several options. If you only have 1 world, you will just click Export World if you have 2 or more worlds, you will need to select the world and then click Export World.

Export_World

  1. From there, it will download a .zip of your world files. You will want to extract it.
  2. Navigate to the world.json file that can found inside of the world/ folder
  3. Edit this file with any text editor.
  4. Find the corresponding lines "system": "fabulaultima", and replace each one of them with the following "system": "projectfu",
  5. Then re-zip the parent folder into a new .zip package.

I've made a video of what that looks like for Windows 11.

Extract_Edit_Zip.mp4

Then, back at game configurations, they will need to choose Summon Import Wizard

Import_Wizard

Lastly, you'll just need to choose ZIP from the top options, browse to the newly created .zip package and import it, uncheck "Install found packages from the Bazaar", then click Analyze.

Import

It should then import the edited world - HOPEFULLY making it compatible to use with the new system.

Techno Fantasy Migration

Following the international release of Techno Fantasy, we have migrated Class Features from the Playtest Module over to the system. Following System Update V2.3.7+ & Playtest Module Update v2.3.7+, a class feature migration dialog will popup prompting you to migrate your techno fantasy data.

Important

The following features will be migrated:

  • Psychic Gift
  • Therioform
  • Vehicle
  • Armor Module
  • Weapon Module
  • Support Module

Items or Actors in compendium that contain the above features will require a few extra steps

image

  1. Navigate to your compendium tab
  2. Search for the affected compendiums, right click and select "Toggle Edit Lock"
  3. A dialog prompting you to unlock compendium, press "Yes".

image

Back to "Class Feature Migration" dialog, when all the affected compendiums are unlocked, you can now start migration. Press "Yes".

Clone this wiki locally