Thread: 5E Custom Item Importer
-
May 27th, 2025, 15:03 #1
- Join Date
- Aug 2018
- Location
- Retired to the Philippines, but Native Floridian.
- Posts
- 46
5E Custom Item Importer
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: 2024Last edited by Bokeelia; June 2nd, 2025 at 19:13. Reason: Updated description
Clew • Army Vet • DM for Life
Homebrewer, worldbuilder, and coder of the old ways.
“If the adventure feels hollow, I fill it with fire.”
-
May 27th, 2025, 18:29 #2
- Join Date
- Aug 2018
- Location
- Retired to the Philippines, but Native Floridian.
- Posts
- 46
v1.1 added import by list.
Last edited by Bokeelia; May 28th, 2025 at 03:57.
Clew • Army Vet • DM for Life
Homebrewer, worldbuilder, and coder of the old ways.
“If the adventure feels hollow, I fill it with fire.”
-
May 27th, 2025, 23:35 #3
Nice work.
-
May 28th, 2025, 01:19 #4
- Join Date
- Aug 2018
- Location
- Retired to the Philippines, but Native Floridian.
- Posts
- 46
Thanks man!
Clew • Army Vet • DM for Life
Homebrewer, worldbuilder, and coder of the old ways.
“If the adventure feels hollow, I fill it with fire.”
-
June 2nd, 2025, 17:52 #5
- Join Date
- May 2021
- Posts
- 10
Hi, could you provide one or two examples how to write an item?
-
June 2nd, 2025, 18:12 #6
- Join Date
- Aug 2018
- Location
- Retired to the Philippines, but Native Floridian.
- Posts
- 46
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.
Clew • Army Vet • DM for Life
Homebrewer, worldbuilder, and coder of the old ways.
“If the adventure feels hollow, I fill it with fire.”
-
June 2nd, 2025, 19:16 #7
- Join Date
- Aug 2018
- Location
- Retired to the Philippines, but Native Floridian.
- Posts
- 46
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.
Clew • Army Vet • DM for Life
Homebrewer, worldbuilder, and coder of the old ways.
“If the adventure feels hollow, I fill it with fire.”
Thread Information
Users Browsing this Thread
There are currently 1 users browsing this thread. (0 members and 1 guests)
Bookmarks