Installation

Get Simple Quest Forge set up in your Unity project. The entire process takes under a minute.

Prerequisites

Unity 2021.3 LTS or newer (any render pipeline)
Basic familiarity with the Unity Editor and ScriptableObjects
TextMeshPro package (included by default in Unity — required only for the demo scene)

Import from Unity Asset Store

1 Open Package Manager
In Unity, go to Window → Package Manager

2 Find Simple Quest Forge
Switch to My Assets in the dropdown at the top-left of the Package Manager window. Search for "Simple Quest Forge" and click Import. If prompted, import all files.

3 Verify Installation
Check that the menu items appear: Window → Simple Quest Forge. You should see the three wizard entries (Quest Forge, Quest Chain Forge, Procedural Quest Forge) plus utility windows.

That's it! No additional setup is required. Simple Quest Forge is ready to use immediately after import. No assembly definition changes, no scripting defines, no configuration files.

Folder Structure

After importing, your project will contain the following structure. The Runtime/ folder contains types that are available in your game builds. The Editor/ folder contains wizard tools that only run in the Unity Editor.

Assets/ └─ SimpleQuestForge/ ├─ Runtime/ (12 files) │ ├─ SimpleQuestDefinition.cs Quest + Objective + Reward + Prerequisite structs │ ├─ ISimpleQuestDataSource.cs Interface for generated quest databases │ ├─ SimpleQuestEnums.cs SimpleQuestComparison enum │ ├─ SimpleQuestHelper.cs Static utility (prereqs, rewards, queries) │ ├─ SimpleQuestTracker.cs MonoBehaviour for quest state tracking │ ├─ SimpleQuestChainDefinition.cs Chain + Step structs │ ├─ ISimpleQuestChainDataSource.cs Interface for generated chain databases │ ├─ SimpleQuestChainTracker.cs MonoBehaviour for chain progression │ ├─ SimpleProceduralQuest.cs Procedural template + Variable structs │ ├─ ISimpleProceduralQuestDataSource.cs Interface for generated template databases │ ├─ SimpleProceduralQuestGenerator.cs Static generator for runtime quest creation │ └─ Demo/ │ └─ QuestDemo.cs MonoBehaviour for the interactive demo scene ├─ Editor/ (51 files) │ ├─ DocumentationOpener.cs Opens docs in browser │ ├─ Wizards/ │ │ ├─ QuestDataWizard.cs Quest Forge window │ │ ├─ QuestChainDataWizard.cs Quest Chain Forge window │ │ ├─ ProceduralQuestDataWizard.cs Procedural Quest Forge window │ │ ├─ QuestBrowserWindow.cs Multi-database quest browser │ │ ├─ QuestDependencyWindow.cs Prerequisite dependency visualizer │ │ ├─ BatchIconAssignmentWindow.cs Batch sprite-to-code icon matching │ │ ├─ DatabaseExportWindow.cs Export database as clean JSON │ │ ├─ SEFBridge.cs, SIFBridge.cs, SAFBridge.cs, SDFBridge.cs │ │ ├─ Steps/ 6 files (Quest Forge wizard steps + editor generator) │ │ ├─ QuestChainSteps/ 6 files (Quest Chain wizard steps + editor generator) │ │ ├─ ProceduralQuestSteps/ 6 files (Procedural Quest wizard steps + editor generator) │ │ └─ Templates/ 13 files (registry + 6 quest + 6 procedural templates) │ └─ Demo/ │ └─ QuestDemoGenerator.cs Generates the demo UI canvas └─ Documentation/ └─ (you are here)

After installation, these menu items are available under Window → Simple Quest Forge:

Menu Item	Priority	Purpose
`Quest Forge Wizard`	100	Create quest databases with two-level dynamic properties, objectives, rewards, and prerequisites. This is the foundation wizard — start here.
`Quest Chain Forge Wizard`	101	Create quest chain databases that group quests into ordered storylines with branching paths. Requires a generated Quest Forge database to link.
`Procedural Quest Forge Wizard`	102	Create procedural quest template databases with variables, objective templates, and reward templates for unlimited runtime quest generation.
`Export Database`	200	Export any generated database (Quest, Quest Chain, or Procedural Quest) as clean JSON data. Useful for sharing data with AI or for backup purposes.
`Quest Browser`	200	Browse and search across all generated quest databases. Useful for reviewing large databases and finding specific quests by name, code, or category.
`Batch Icon Assignment`	201	Scan a sprite folder and auto-match sprites to quest/chain/template codes by normalized filename. Preview matches and apply all icon assignments in one click.
`Quest Dependencies`	201	Visualize prerequisite relationships between quests. Shows dependency chains and helps identify circular references or orphaned prerequisites.
`Generate Quest Demo`	202	Generate an interactive demo scene showcasing all quest features at runtime with 5 tabs (Quests, Chains, Procedural, Tracker, Helper).
`Documentation`	300	Open the offline HTML documentation in your default browser.

Optional Integrations

Simple Quest Forge integrates with three optional companion packages. All integrations are fully automatic — just import both packages into the same project and the features appear instantly. You can add or remove companion packages at any time with zero compilation errors.

Simple Enemy Forge (SEF)

When SEF is installed, Quest Forge gains enemy code dropdowns for kill objectives, faction code dropdowns for reputation rewards, and squad code dropdowns for group objectives. Link your SEF-generated enemy/faction databases in Step 1 of the Quest Forge wizard to enable the smart target code picker — a categorized dropdown menu that appears next to every targetCode field in Step 3.

Simple Item Forge (SIF)

When SIF is installed, Quest Forge gains item code dropdowns for collect objectives and item rewards, plus loot table code dropdowns for loot-based rewards. A loot table section also appears on each quest for linking quest rewards to SIF loot tables. Link your SIF-generated item and loot databases in Step 1.

Simple Attribute Forge (SAF)

When SAF is installed, Quest Forge gains attribute name dropdowns for prerequisite conditions (e.g., "Requires STR >= 20") and reward targets (e.g., "Grant +10 STR"). A Modifiers section also appears on each quest with ObjectField slots for dragging in SAF modifier ScriptableObject assets as quest rewards (e.g., a permanent stat buff). SAF uses a dual-assembly bridge — it detects both the attribute system and the modifier system independently.

See the Integration page for full details on how bridges work, the detection lifecycle, what happens when packages are installed or removed, and how to link databases in each wizard.

Next Steps

You're all set! Head to the Quick Start Guide to create your first quest database in under 5 minutes. Or if you want to dive deep into a specific wizard, jump directly to Quest Forge, Quest Chain Forge, or Procedural Quest Forge.

Simple Quest Forge