BRP IDs - Genii-Locorum/brp GitHub Wiki

The BRPIDs used in this game are taken from the Call of Cthulhu and Runequest implementations in Foundry VTT so credit and thanks goes to those system developers. BRPIDs are a way to identify items etc across game items and compendia where different languages may also be used without relying on an item name. All items, actors, journals and role tables have BRPIDs.

Migrating to BRPIDs

BRPIDs were introduced in version 12.1.30 and as such a lot has changed in the structure of items. It is therefore important that you back up your world data before migrating. There are several macros included in the system to help with the migration - you can read more about them and migration here.

Finding the BRPID

A small fingerprint icon with "BRPID" appears at the top of the relevant document sheet. If the icon is white then a BRPID has been created, if it's red then you need to create one.

To create or edit a BRPID click on the fingerprint icon.

The top section shows the three elements of the BRPID System ID: a three part string e.g. 'i.skill.dodge' Language: e.g. 'English' or 'French' Priority: a number (higher numbers take precedence over lower numbers) but in game items take precedence over compendia.

The System ID consists of three parts separated by full stops (.) - letters to show the document type (e.g a = actor, i = item), the document type (e.g. skill or character) and then a keyword. The first two are automatically generated, you only need to enter the keyword. Clicking on the "wand" to the right of the keyword will automatically populate the keyword based off the name of the document.

The info section below will warn you if there are multiple documents in the world or the compendia with the same BRPID and language (and will list them).

Basic Functionality

So if we have two skills (one set up in world, and one in the compendia) with the id 'i.skill.dodge', 'en' and 0 but one is called "Dodge" and the other "Evade" the id tells us they are effectively the same skill, even if the language on one is changed the 'id' still tells us its the same skill, but if you are running your game in French it won't pull the English version back.

Here are some of the uses of BRPIDs in the system Skill Categories - you choose a skill category for a skill (e.g. Physical or Combat) - the Skill Category BRP ID is stored in the skill. If you update the Skill Category Bonus calculation in the best matched Skill Category (based on BRPID) then it will update the Skill automatically without having to relink the category to the skill.

Weapon Types - each weapon has a Skill Option (many Modern firearms use the Pistol skill). The system creates a list of the weapons skills and let's you select from this list, storing the BRPID of the skill in the weapon. When you add the weapon to the character the system will firstly check to see if the character has a skill where the BRPID matches and if not it will add it to the character sheet automatically (using the best matched skill) - if you changed the base percentage of the relevant skill before adding the weapon to the character then the skill added to the character sheet will use the new base percentage. Secondly when working out what your attack chance is the system will check the skills on your character sheet with the BRPIDs that match the weapon Skill Options BRPIDs.

Professions - a profession is made up of a list of skills or optional skills. These are stored as BRPIDs. If you change details of the skill then the profession will use the updated version (name, base chance etc) without you having to edit the profession.