The Chummer XML Importer allows the user to scrape Chummer5a's datafiles and bring them into Foundry as SR5 system-compatible Items for use on Actors.
This article was last edited Wednesday, December 27, 2023 by Mr. Johnson.
Keep in mind that it is a bulk import and unfiltered, so it can produce hundreds or thousands of Items, some of which may never actually be used, and all of which will need to be manually reviewed before being fully functional. Furthermore, it operates on the raw XML datafiles so it does not take into account any Custom Data Files configured in Chummer.
General Tips
XML | Item Types |
---|---|
weapon.xml | Weapons, some Gear Modifications |
armor.xml | Armor, some Gear Modifications |
gear.xml | Ammo, Devices, Equipment, and Programs |
spells.xml | Spells and Rituals |
complexforms.xml | Complex Forms |
qualities.xml | Qualities |
cyberware.xml | Cyberware |
bioware.xml | Bioware |
critterpowers.xml | Critter Powers |
- The importer is sensitive to the exact content of Chummer5a's XML files. Be sure to check the notes in the Chummer XML Import interface to make sure the data files used are compatible.[git 2]
- It neither checks for not overwrites duplicates. It imports everything in the XML file fresh every time.
- Imported items are marked for review, as with the Chummer Character Importer.
How To Import Items
- Download and install Chummer5a.
- Select the Item Directory in Foundry's sidebar.
- Click Import Chummer Data at the bottom.
- If you want the imported items in a language other than English, choose a translation file from the
/lang
subfolder in Chummer's installation directory. - Select the XML files to import from the
/data
subfolder. Only the files shown in the importer UI are compatible with the parser; other item types cannot be imported. You can select all the XML files in the file picker, but the incompatible ones will be ignored. - Select wether or not the default icons will be applied to imported items.
- Press Import.
The selected files will be imported into Foundry's Items Directory, inside a folder named "SR5e". To reduce the download impact during user logins, it's best to move them to a Compendium.
Not Implemented
As of SR5 v0.16.1, all except three Item types that exist in Chummer are imported — Adept Powers[git 3], Echoes, and Metamagics are not yet available.
Other item types are not present in Chummer's XML files and will never be imported in bulk: Actions, Contacts, Hosts, Lifestyles, and Summon/Compile Items.
References
GitHub Issues
- ↑ The Importer Project gathers relevant issues.
- ↑ Issue #978
- ↑ Issue #504