Items & Recipes
Work in Progress
This documentation is still being expanded and refined. Features, screenshots, and descriptions may change until Talescape's public release. If something is unclear or you need help, please ask on the official Talescape Discord. We're happy to clarify or update pages as needed.
Items represent physical objects that players can collect, store in their inventory, inspect, or combine. They allow stories to include inventory systems, crafting mechanics, and item-based puzzles.
Recipes define how multiple items can be combined to create a new one.
Together, items and recipes enable interactive mechanics such as crafting, survival systems, puzzle solving, and branching narrative interactions.
1. Items Overview
The Items section lists all objects available in your story. Each item represents something the player can acquire, use, or interact with during gameplay.
Common examples include:
- Key objects such as keys, maps, or access cards
- Materials used for crafting or puzzles
- Tools required to progress through scenes
- Food, ingredients, or survival resources
Items appear in the player's inventory when they are granted through actions in your story.
2. Creating an Item
To create a new item, open the Items panel and click Add Item.
Each item includes the following properties:
- Name: The display name shown to the player.
- Description (optional): A short text describing the item. This text is used when the player inspects the item.
- Show in Inventory: Determines whether the item is visible in the player's inventory. This can be disabled for hidden items used only for internal logic.
- Icon: The image representing the item in the inventory. Icons should be clear and easily recognizable, since they help players quickly understand what they are carrying.
- Can be inspected: Allows the player to examine the item in more detail. When enabled, the description becomes visible during inspection.
Items can be edited or removed at any time. Any changes are automatically reflected wherever the item is referenced.
3. Inventory Behavior
During gameplay, items are automatically added or removed through story logic.
Typical actions include:
- Give Item – adds an item to the player's inventory
- Remove Item – removes an item from the inventory
- Craft Item – combines ingredients into a new item
During testing, all defined items are visible in the Inventory section of the Debug Menu, where you can:
- add or remove items manually
- adjust quantities
- test crafting recipes or item conditions
This makes it easier to verify puzzle logic and inventory behavior.
4. Crafting Recipes
Recipes define how items can be combined to produce another item.
Each recipe contains two parts:
Result
The item that will be created after crafting.
Ingredients
The list of items required to craft the result.
Example:
Result
Herbal Noodle Bowl
Ingredients
Basil + Eggplant + Pasta
When all ingredients are present, the recipe can be crafted. The ingredients are then consumed and replaced by the resulting item.
Recipes can represent simple combinations or more complex multi ingredient crafting systems.
5. Using Items in Stories
Items integrate with multiple systems inside Talescape.
Actions
- Give item
- Remove item
- Craft item
Conditions
- Check if the player owns a specific item
- Check if the player owns a certain amount
Triggers
- React when an item is collected
- React when an item is used or crafted
This allows stories to implement mechanics such as:
- unlocking areas when a key item is present
- consuming ingredients to craft tools
- enabling alternate dialogue when the player carries certain objects
6. Best Practices
Use clear icons so players can immediately recognize items in the inventory.
Keep item names consistent with the tone and setting of your story.
Avoid unnecessary items. Every item should serve a clear narrative or gameplay purpose.
Combine crafting with story logic. For example, characters might react differently once the player crafts a certain tool.
Well designed item systems add a tactile dimension to interactive storytelling, allowing players to experiment, discover solutions, and influence the outcome of the story.