Mr. Johnson (talk | contribs) |
Mr. Johnson (talk | contribs) No edit summary |
||
| Line 2: | Line 2: | ||
{{Needs Improvement|The XML importer is not perfect. This function should be considered experimental and unstable.}} | {{Needs Improvement|The XML importer is not perfect. This function should be considered experimental and unstable.}} | ||
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. As it operates on the raw XML datafiles, it does not take into account any [https://github.com/chummer5a/chummer5a/wiki/Custom-Data-Files Custom Data Files] configured in Chummer. | 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. As it operates on the raw XML datafiles, it does not take into account any [https://github.com/chummer5a/chummer5a/wiki/Custom-Data-Files Custom Data Files] configured in Chummer. | ||
==General Tips== | ==General Tips== | ||
{{:Table:Chummer XML Sources}} | {{:Table:Chummer XML Sources}} | ||
| Line 8: | Line 7: | ||
* It neither checks for not overwrites duplicates. It imports everything in the XML file fresh every time. | * It neither checks for not overwrites duplicates. It imports everything in the XML file fresh every time. | ||
* Imported items are [[Importer Review|marked for review]], as with the [[Chummer Character Importer]]. | * Imported items are [[Importer Review|marked for review]], as with the [[Chummer Character Importer]]. | ||
==How To Import Items== | ==How To Import Items== | ||
{{Imagebox|sr5-chummer-item-import.png|Chummer XML Importer|s=0.16.1|f=11.315}} | |||
# Download and install '''Chummer5a'''. | # Download and install '''Chummer5a'''. | ||
# Select the '''Item Directory''' in Foundry's sidebar. | # Select the '''Item Directory''' in Foundry's sidebar. | ||
Revision as of 22:23, 22 November 2023
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, November 22, 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. As it operates on the raw XML datafiles, 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.
- 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
/langsubfolder in Chummer's installation directory. - Select the XML files to import from the
/datasubfolder. Only the files shown in the importer UI are compatible with the parser; other item types cannot be imported. - 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".
Not Implemented
As of SR5 v0.16.1, all except three Item types that exist in Chummer are imported — Adept Powers, 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.