Item creation
Create custom items, use the full editor, generate with AI, and publish to the marketplace.
Last updated: October 25, 2026
Overview
Create an item template by hand from My Content > Items, use Quick Create in an Item Picker, generate a draft from a description, or fork a public marketplace item and customize it. Templates are reusable definitions. Adding one to an inventory creates an item instance, which you can then adjust there.
New to ScryRPG?
Start with the Quick Start guide first. This guide assumes you have an account and at least one character.
Quick Create
Quick Create is a short form inside the Item Picker. It saves a template and can add it to the current inventory, shop, or loot context when that picker supports adding items.
Web
- Open an inventory or another page with an Item Picker, then open the picker with its add-items control.
- Choose Quick Create Item at the bottom of the picker.
- Fill in the fields:
| Field | Required | Description |
|---|---|---|
| Name | Yes | The item name. |
| Description | No | A short description. |
| System | No | Defaults to the picker or app’s default game system. |
| Type | No | Defaults to Gear when available. |
| Rarity | No | Defaults to Common; change it using the available options. |
| Base Value | No | A non-negative value in the selected system’s currency. |
| Weight (lb) | No | A non-negative weight in pounds. |
- Choose Create & Add to save the template and add an instance to the current context, or Create Only to save the template without adding it there.
Quick Create saves the template as Unlisted. You can find and edit it later in My Content > Items. For fields such as tags, visibility, art, and system-specific encumbrance, use the full editor.
Discord
/add item:Flaming LongswordThe command searches for matching items. If no marketplace match is found, choose Create Custom and complete the form. The bot creates the custom item after you submit it.
Tip
Use Create Only when you want a reusable template without adding an instance to the current inventory or workspace.
Full Item Editor
Open My Content > Items and choose Create New to make a template by hand. You can also choose Open full editor at the bottom of Quick Create.
All Fields
| Field | Description |
|---|---|
| Name | Required item name, up to 200 characters. |
| Description | Optional flavor text, lore, or mechanics, up to 5,000 characters. |
| Game System | Choose D&D 5e, Pathfinder 2e, Draw Steel, or Daggerheart. |
| Visibility | Private, Unlisted, or Public. New templates default to Private. |
| Rarity | Optional rarity, or None. |
| Primary type | Main classification used for browse and search. |
| Additional tags | At least one non-rarity tag is required. Add tags for theme, use, or mechanics. |
| Weight (lb) | Non-negative weight for systems using weight, including D&D 5e and Daggerheart. |
| Bulk Category | Pathfinder 2e uses Negligible, Light, or a value from 1 to 99 instead of weight. |
| Encumbrance | Draw Steel has an optional abstract encumbrance field instead of weight. |
| Base Value | Non-negative value in the selected system’s currency. |
| Stack size | Optional inventory stack cap. One is the default; blank or zero means unlimited. |
| Image | Upload an image, choose one from your image library, or create one in the image field. The app resolves which saved image to display. |
The Advanced section contains Stack size and Visibility. The Image field and item properties are alongside the main form; the visible weight or encumbrance field depends on the selected system.
Writing Good Descriptions
Include both what the item looks and feels like and what it does in game terms. Keep rules and mechanics clear enough for someone else to use the item.
Tags
Choose a Primary type and add Additional tags in the editor. Tags help players find items by theme, use, or mechanics. The form requires at least one non-rarity tag; rarity belongs in the Rarity field.
| Tag Category | Examples |
|---|---|
| Type | weapon, armor, consumable, currency |
| Subtype | sword, potion, ring, shield |
| Theme | fire, undead, nature, mechanical |
| Source | homebrew, SRD, campaign-specific |
Stack Size
Stack size is an optional cap used when a party has Enforce Item Stack Caps enabled. Leave it at the default of one for non-stackable equipment, or set a larger value for items that can stack. Leave it blank or set it to zero for unlimited stacks. The party rule is off by default for new parties.
Visibility
| Setting | Who Can See | When to Use |
|---|---|---|
| Private | You | Keep a work in progress private. |
| Unlisted | Anyone with the direct link | Share with someone without listing the template in marketplace browsing. |
| Public | Everyone | Make the item available in marketplace browsing. |
You can change a template’s visibility in the editor. Forks are separate copies, so changes to your template do not update them.
AI Item Generation
The Create Item page includes an optional generation panel. Describe an item to get a draft with fields such as its name, description, system, rarity, and tags filled in. Review and edit the draft in the form before saving it as a template.
Web: Create Item
- Open My Content > Items and choose Create New.
- Expand Describe it and generate with AI above the item form.
- Choose a Game System and enter a description.
- Choose Generate Preview. Review the preview, then apply it to the form, revise fields, and save with Save AI Item. You can regenerate or discard the preview before applying it.
The generation panel is optional. You can create the item manually in the form without using it. An applied generated draft defaults to Private and is marked as AI-generated content. You can edit its fields before saving and later in the editor.
The Create Item page and your plan page show your monthly AI usage as a percentage. Usage resets monthly on every plan.
Example descriptions:
- “A cursed ring that makes you speak in rhymes”
- “A clockwork crossbow that fires bolts of lightning”
- “A healing potion brewed from mushrooms found in the Underdark”
Discord: /generate
/generate description:A magical sword that glows when orcs are near
/generate description:Potion of fire breathing system:dnd5eParameters:
| Parameter | Required | Description |
|---|---|---|
description | Yes | Natural-language item description, up to 500 characters. |
system | No | D&D 5e, Pathfinder 2e, Draw Steel, Daggerheart, or Other. Defaults to the party or your preference. |
system_name | No | Custom system name when system is Other, up to 50 characters. |
The bot shows the generated item with Add Manually, Show, Generate Another, and View on Web buttons. Generation uses your monthly AI usage allowance.
Generation Limits
AI generation counts toward your monthly AI usage allowance. The app shows usage as a percentage and sends heads-ups at 50%, 75%, and 90%. Usage resets monthly, including on annual plans. Imports also count toward this allowance; large imports show an estimate first. See the Import Guide for import details.
Generated Content
Generated item content is marked as generated content. You can review and edit the draft before saving it.
Import Items from a File
You can import items from supported files and review the extracted items before committing them to your collection. Imported items use the same monthly AI usage allowance as generation, and a large import shows an estimate first. Imports have their own pages, where you can review them. A party GM can open, undo, or keep a member’s import.
See the Import Guide for supported file types and the walkthrough.
Ask Your Familiar to Create Items
You can ask your familiar to draft items from conversation. Free rein is on by default, so the familiar can handle routine work without stopping for approval. It asks first before a large change, deleting or revealing something, changing permissions or membership, affecting another player’s character or inventory, or using another player’s monthly allowance. You can turn free rein off in settings. A failed change rolls back entirely.
Every plan includes monthly AI usage for your familiar, imports and art. Paid plans include more, and it resets each month. Your monthly AI usage allowance applies to familiar use. You can use the familiar on its private page or in a shared party room. See the AI Assistant Guide for its capabilities and settings.
Forking Marketplace Items
Use a public marketplace item as a starting point for your own version.
- Browse the Marketplace and open an item detail page.
- Choose Fork.
- The app creates a copy in your collection and opens it in the editor.
- Change the fields and save your version.
Your edits apply to your copy. The item detail page shows its ancestry when it was forked from another template.
Fork Before You Build
Search marketplace items before making a template from scratch. A public item may give you a useful starting point to customize.
Publishing to the Marketplace
Set your template’s visibility to Public to make it available in marketplace browsing.
How to Publish
- Open your item from My Content > Items and choose the edit control.
- Open Advanced and set Visibility to Public.
- Check the Game System, primary type, tags, and item details.
- Save the template.
Public templates can appear in marketplace search and browse results. You can return to the editor to change the template later. Other users can fork public templates into their own copies.
Quality Tips
Clear descriptions, correct system and item details, useful tags, and an image help people understand and find your item. Use the system fields that apply to the item and keep mechanics readable.
Warning
Other users can fork public items. A fork is a separate copy, so later edits to your template do not change their copy.
System-Specific Items
The item editor changes the encumbrance field for the selected system. Other item fields, such as name, description, tags, rarity, and base value, are available across systems.
D&D 5e
D&D 5e items use Weight (lb) and Base Value. Weight and value must be non-negative. Currency formatting follows the selected system and your preferences.
Pathfinder 2e
Pathfinder 2e uses Bulk Category instead of weight. Choose Negligible, Light, a value from 1 to 99, or None. The editor does not automatically convert weight to bulk when you change systems, so set the bulk value that fits the item.
Draw Steel
Draw Steel uses an optional Encumbrance field instead of pounds. Leave it as None when you do not want to set an encumbrance value.
Discord Commands Reference
| Command | What It Does |
|---|---|
/add item:Longsword | Search for a matching item to add to inventory. |
/add item:Longsword quantity:5 | Add multiple copies when the command’s quantity option is available. |
/add item:Longsword system:dnd5e | Search with a game-system filter when available in the command. |
/add item:My Custom Sword | Offers Create Custom if no match is found. |
/generate description:A cursed ring | Generate an item from a description. |
/generate description:Fire sword system:dnd5e | Generate an item for a selected system. |
Common Questions
Can I edit an item after creating it? Yes. Open My Content > Items, select your template, and edit it. Inventory instances are separate from the template.
Can I edit generated items? Yes. Review and edit generated fields in the form before saving, or edit the saved template later.
What happens to items in inventories when I edit the template? Inventory instances are separate from their templates. Editing a template does not update existing instances.
How do I add an image to my item? Use the Image field in the full editor. It supports uploading an image, choosing one from your image library, or creating an image. The app resolves which saved image to show.
Can I use Quick Create without being in a party? Quick Create is inside the Item Picker, which appears in inventory and other item-adding contexts. You can create a template from My Content > Items > Create New without opening a party inventory.
Is there a limit on how many items I can create? You can create item templates by hand. AI generation and imports count toward your monthly AI usage allowance.
What’s Next?
- Inventory Guide: Managing containers and organizing gear
- Marketplace: Browse and share community content
- Shops Guide: Deploy shops for your party
- Encumbrance Systems: Weight, slots, and bulk
- Discord Bot Guide: Full command reference