PDA

View Full Version : 5E Custom Item Importer


Bokeelia
May 27th, 2025, 15:03
https://forge.fantasygrounds.com/shop/items/2251/view

Full Description
The 5E Custom Item Importer enables you to quickly import multiple items into Fantasy Grounds from bulk-formatted text. It's ideal for converting gear lists, magic item compendiums, or player-created inventories without manually entering data.
There are three available import methods:
• Legacy Import – Fast, delimiter-based single-line format
• 2024 Import – Redirects to the ruleset’s default import tool
• List Import – Supports both Legacy and 2024 item fields via labeled field blocks
The Import List button appears in the Items list window. Hovering over the button displays the tooltip: "Import List".
________________________________________
How It Works:

Legacy Import
• Click the Import Legacy button
• Use double-spaced values in this format: Name ⠀⠀Cost ⠀⠀Weight ⠀⠀Description ⠀⠀DM Notes
• Skips malformed entries and blank lines
• Supports Legacy format only

List Import
• Click the Import List button
• Paste multi-line item blocks using field triggers (e.g., Name:)
• Each item must begin with a Name: line
• Recognized fields (Legacy and 2024):
• Name, Non-Identified Name, Non-Identified Notes
• Type, Subtype, Rarity, Cost, Weight
• Bonus, Damage, AC Base, Dex Bonus
• Strength, Stealth, Properties, Mastery
• Description, DM Only, Version
• Fields are optional and may appear in any order
• Supports both Legacy and 2024 formats
________________________________________
2024 Ruleset Compatibility
• The Import 2024 button redirects to the ruleset's default importer
• Only the List Import method supports 2024 fields and formats directly
• Fields such as Mastery and Version are parsed when present
________________________________________
Current Limitations
• Field name typos are not detected
• Multi-paragraph descriptions must be flattened (line breaks not supported yet)
• No validation for required fields—Name: is mandatory to start an item block
________________________________________
Vision for This Tool
The Custom Item Importer is designed to simplify item creation in Fantasy Grounds. Whether you need fast entries via Legacy format or detailed item blocks compatible with 2024 rules, the tool gives you the speed and structure to build your library efficiently.
________________________________________
Questions, feedback, or bug reports?
Reach out to ClewDM#1008 on Discord.

Examples for Legacy and 2024 versions below.
Name: Potion of Healing
Non-Identified Name: Murky Red Liquid
Non-Identified Notes: The liquid is thick and smells faintly of berries.
Type: Consumable
Subtype: Potion
Rarity: Common
Cost: 50 gp
Weight: 0.5
Description: A red liquid that glimmers when agitated. Restores 2d4+2 HP.
DM Only: Basic healing potion, found in starter loot.
Version: Legacy

Name: Sword of Dawn
Non-Identified Name: Gilded Longsword
Non-Identified Notes: A longsword with a faint pink tint, humming faintly.
Type: Weapon
Subtype: Longsword
Rarity: Rare
Cost: 1,000 gp
Weight: 3
Bonus: +1
Damage: 1d8 slashing
Properties: Versatile (1d10)
Description: This blade glows with a faint pink hue at dawn.
DM Only: Secretly reacts to undead.
Version: 2024
Bokeelia
May 27th, 2025, 18:29
v1.1 added import by list.
v1.2 fixed Legacy import. 2024 importing can be done utilizing the legacy import, just be sure to call that line 2024. I''ll work on a more permanent fix for 2024 when I am able.
MrDDT
May 27th, 2025, 23:35
Nice work.
Bokeelia
May 28th, 2025, 01:19
Thanks man!
GrumpyGramp
June 2nd, 2025, 17:52
Hi, could you provide one or two examples how to write an item?
Bokeelia
June 2nd, 2025, 18:12
I'll be sure to provide one tomorrow. Already in bed here and thought I'd check my email before putting my phone down. Please check the Forge as well because I am pretty sure one if the images in the description shows an example. Not 100% on that, but there should be one.
Bokeelia
June 2nd, 2025, 19:16
Hi, could you provide one or two examples how to write an item?

Please check the updated description at the bottom of 1st post. I initially had it in the long description of The Forge, but there is some weird bug that is either too long of a description or something causes the store page to bug out. So I removed it and referenced people to the forum for the description.
MColeman030
August 17th, 2025, 16:43
Greetings! I recently got this mod, but I've noticed it stopped working properly. The item information I place in both Legacy and the 2024 import tool fail to correctly import the item. I even tried using your examples in your post, but those also fail to import properly. Also, I tested this in a brand-new campaign, with no other mods loaded. What happens instead is each line of text is used to create a new item, though it only populates the name of the item. I'm not sure what's causing it but would love to see this working properly again. Thank you for all your work on this!
Bokeelia
August 18th, 2025, 02:50
Greetings! I recently got this mod, but I've noticed it stopped working properly. The item information I place in both Legacy and the 2024 import tool fail to correctly import the item. I even tried using your examples in your post, but those also fail to import properly. Also, I tested this in a brand-new campaign, with no other mods loaded. What happens instead is each line of text is used to create a new item, though it only populates the name of the item. I'm not sure what's causing it but would love to see this working properly again. Thank you for all your work on this!

I will see what I can do. I tested and see what is happening. Not trying to make excuses, but I am barely 1 month out of a major surgery, so please bear with me as I correct this extension as I am physically/mentally able to sit at my computer.
Bokeelia
August 18th, 2025, 11:47
Greetings! I recently got this mod, but I've noticed it stopped working properly. The item information I place in both Legacy and the 2024 import tool fail to correctly import the item. I even tried using your examples in your post, but those also fail to import properly. Also, I tested this in a brand-new campaign, with no other mods loaded. What happens instead is each line of text is used to create a new item, though it only populates the name of the item. I'm not sure what's causing it but would love to see this working properly again. Thank you for all your work on this!

Please let me know if this newest version is working correctly for you. You should be able to utilize the legacy import button to do both 2024 and legacy. I'll have to see what FGU changed to fix the 2024 button import. Feels redundant though if it works elsewhere.
MColeman030
August 21st, 2025, 22:21
Thank you so much! I'm sorry for the bad timing, and I hope you're on the mend! The item importer is working correctly for me, you're amazing!
Bokeelia
August 22nd, 2025, 00:55
Thank you so much! I'm sorry for the bad timing, and I hope you're on the mend! The item importer is working correctly for me, you're amazing!

It's life man. Happy the importer is working correctly again.
LaoclesJarkin
September 26th, 2025, 18:49
Hi there, I was trying this out and the only thing I can't get to populate is the DM only information -- I tried using your example and still dont see it65515
LaoclesJarkin
September 26th, 2025, 19:14
Hi there, I was trying this out and the only thing I can't get to populate is the DM only information -- I tried using your example and still dont see it65515



Hey sorry didn't see the other item in the Forge I just purchased that one

also ...THANK YOU!
Bokeelia
September 27th, 2025, 00:46
I was just going to suggest that. I can be quite the doofus at times too. Took me quite a bit to learn how to even add the DM Only section (so many reloads/hours until it was right) as I am not a coder. Just learning as I go and couldn't stand that 2E has it but 5E didn't.