Migrating to BRP IDs - Genii-Locorum/brp GitHub Wiki

PLEASE BACK UP YOUR WORLDS BEFORE MIGRATING.

The changes in v12.1.30, including BRPIDs, are quite extensive I strongly urge you to back up your worlds first.

Whilst there isn't a migration script in the code (mostly because I've never created one before) there are several macros bundled with the system in a BRPID Macros compendium to help with the transition.

I'd recommend running them in the following order:

  • 1-Update all world items with BRPIDs
  • 2-Update all actor items with BRPIDs
  • 3-Create BRPIDs for actors
  • 4-No BRPID - game world (will list all actors, world items or actor items that don't have a BRPID - you will need to manually fix these)
  • 5-Update Hit Locs - run this if you are using Hits Per Location - it will update the Display Name attribute for all hit locations on actors or in game world
  • 6-Skill Category Update - this will convert the skill categories on all actor and game world skills. It assumed that you have skill categories in the BRP compendium with BRPIDs i.skillcat.combat, i.skillcat.communication, i.skillcat.manipulation, i.skillcat.mental, i.skillcat.perception, i.skillcat.physical, i.skillcat.supernatural and i.skillcat.social to mirror the previous categories.
  • 7-Add Skill Categories to existing characters - this will add missing skill categories to characters.
  • 8-Update Psychic Ability Skill Category - updates the skill category for all actor and game world Magic Spells and Psychic Abilities to i.skillcat.mental
  • 9-Update Weapon Skill IDs - this tries to convert a Skill ID to a Skill BRPID on each weapon. If it can't it will set it to "none". Remember that NPCs don't use the weapon skill ID so don't worry if they all default to none or another skill.

These macros will update tokens, but not any compendia. As mentioned here most inbuilt compendia have been moved from the system to a new module and these documents are already updated.

You will probably find that professions and personalities will no longer work properly. I couldn't work out a way to safely migrate them and so you may have to recreate them (I suggest using the new module compendia and then editing those).