Chaosium IDs - Genii-Locorum/aov GitHub Wiki

Chaosium IDs (CIDs) 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.

CIDs are a way to identify items, actors etc across game items and compendia where different languages may also be used without relying on an item name.

CIDs have an ID, Language and Priority. Generally where two things have the same ID and Language then the one with the higher priority is selected

For example - you creating a Weapon you choose from a list of weapon skills - this list is generated using CIDs. If you had two weapons skills with a CID of "i.skill.knife", language = "EN" and Priorities of 5 and 10, the one with priority 10 is selected.

Finding the CID

A small fingerprint icon with "CID" appears at the top of the relevant document sheet. If the icon is white then a CID has been created, if it's red then you need to create one. If the icon is "orange" then the game has auto-created the CID but you may wish to review and update it. See CID Settings to find out how to activate this auto-create option.

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

The top section shows the three elements of the CID System ID: a three part string e.g. 'i.skill.shield-medium-round' Language: e.g. 'English' or 'French' Priority: a number, higher numbers take precedence over lower numbers

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.

In some circumstances (where the keywords have been predefined in the language pack) you will have a drop down menu to the left of the wand icon which will let you select the pre-defined CID (you can always select the 'Custom System ID' option to manually enter the keyword)

The info section below will warn you if there are multiple documents in the world or the compendia with the same CID 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 CIDs in the system Weapon Categories - you choose a weapon category for a weapon(e.g. 1H Axe) - the Weapon Category CID is stored in the weapon. If you update the Weapon Category (e.g. you change the name) then it will update the Weapon automatically without having to relink the category to the weapon.

Updating Items on an Actor

Let's say you've added the Dodge Skill to an Actor but you later realise you've set the name to "Ddge". Rather than going through all the Actors where you've added the skill and make the change, you can change the name on the skill in either the Game World or Compendium to "Dodge" - make sure you use the one with the highest priority. You can then use the "Active Item Replacement" GM Tool to update all the actors in one go.

More functionality will be added for CIDs as automation is added (e.g. I will look to have a healing option which will find the appropriate skill based on the CID 'i.skill.first-aid', these will be covered in the Specific Use Cases page.