<h2 id="overview">Overview</h2>

<p>The Adventure Document makes it easy to build Foundry-ready adventures and to backup your world data in its current state with just a couple of clicks. Adventures can contain all of the core Foundry types you're already familiar with like Actors, Scenes, Items and more in a single importable Document. This article will walk you through what the Adventure Document is and how to use the Adventure Builder and Importer.</p>

<p style="text-align: center;"><iframe allowfullscreen="" frameborder="0" height="315" src="https://www.youtube.com/embed/dGRAR1ZDDCM" title="YouTube video player" width="560"></iframe></p>

<h2 class="border" id="what-is-it">What is the Adventure Document?</h2>

<p>It's best to think of Adventure Documents as neatly organized bundles that can store some (or all) of Foundry's Document types exactly as you have them in your World. That means that you can store Actors, Items, Scenes, Roll Tables, Journal Entries, Cards, and Playlists and they'll all remain organized in the correct folder structure when they're imported later. All of their links will even continue to work! This makes distributing and importing pre-written adventures much easier than storing them all in separate Compendium Packs.</p>

<h2 class="border" id="importing">How do I Import From an Existing Adventure?</h2>

<p>An Adventure Document is always stored inside a Compendium Pack, so they can be found in the Compendium sidebar menu. When you double-click an Adventure Document inside a Compendium Pack, a special dialog displays allowing you to import content from this module.</p>

<p class="info note">Many modules distribute their content as Adventures. If you expect to see an Adventure but it is missing, you may first need to <a href="https://foundryvtt.com/article/modules/">enable the module</a> that contains that Adventure.</p>

<figure class="center">@Asset[696]

<figcaption>Using Foundry to Import Content From an Adventure.</figcaption>

<p>To import all the Adventure's content into your world, simply open the Compendium, double-click the Adventure document, and choose the type(s) of content to import and click the "Import Adventure" button at the bottom.</p>

<p class="note warning"><strong>IMPORTANT</strong>: If you re-import an Adventure, the previous versions of the content will be overwritten with the new versions. This can be desireable in some cases, such as when a module is updated, but be careful not to lose changes that you have made.</p>

<h2 class="border" id="how-to-create">How do I Build My Own Adventure?</h2>

<p>Before you can build any Adventures you'll need to have an Adventure Pack to hold them. Adventure Packs can be created as World or Module-level Packs just like other @Article[compendium]. Once you have an Adventure Pack ready just press the <span class="reference"> Create Adventure</span> button and the Adventure Builder will open.</p>

<p class="note info"><strong>Do you want to distribute your Adventure?</strong><br />It's important to know that your media files are not included in the Adventure and will still link to their source in your data folders. Therefore, if you want to include images, videos, audio, or other files you'll want to place those files in your Module's folder and then create your Scenes, Actors, etc. using those files. See "Asset Staging" in the @Article[packaging-guide] for more info on this.</p>

<h2 id="creating">Creating an Adventure</h2>

<figure class="right">@Image[429]

<figcaption>The Adventure Document's Summary Tab.</figcaption>

<p>Creating an Adventure is as simple as filling out a form with some important data.</p>

<figure class="right">@Image[430]

<figcaption>The Adventure Document's Contents Tab.</figcaption>

<li>Open the <span class="reference"><i class="fas fa-atlas"> </i> Compendium Tab</span> in the sidebar.</li>

<li>Open your Adventure Pack and click the <span class="reference"> Create Adventure</span> button.</li>

<li>The <span class="reference"> Summary Tab</span> contains the following fields:

<dt>Adventure Name</dt>

<dd>The name you'd like this Adventure to have, like "Demon Queen Awakens" or "Back Up - 2022/10/16".</dd>

<dt>Banner Image</dt>

<p>The path to a piece of artwork to use as a banner when someone is importing the Adventure.</p>

<dt>Banner Caption</dt>

<p>A caption that will appear underneath the banner image.</p>

<dt>Adventure Description</dt>

<dd>A short description of the Adventure, usually a few sentences of narrative text and a list of what the adventure contains.</dd>

<dt>Sort Order</dt>

<dd>When multiple Adventures are available within the same Pack, this number determines the order in which they are displayed.</dd>

<li>The <span class="reference"> Contents Tab</span> contains an area where you can drop Documents (like Actors, Items, Journals, etc.), or Folders of Documents, to add them to your Adventure. These Documents will keep their unique IDs, so that when they are imported later they will overwrite any existing copies with the same ID.</li>

<li>Once you have added everything you wish to add, at least for now, click <span class="reference"> Build Adventure</span> and Foundry will handle the rest!</li>

<p>Once you've added all of the content you wish to include in the Adventure, it is possible to distribute that Adventure Pack the same as an Add-on Module by following the @Article[packaging-guide], you can rebuild the Adventure. This will create a new Compendium Pack for each Folder in the Adventure, and will populate each Compendium Pack with the Documents that were included in the Adventure. This process is described in more detail below.</p>

<h2 id="rebuilding">Rebuilding an Adventure</h2>

<figure class="right">@Image[431]

<figcaption>Editing the Adventure Document's Contents.</figcaption>

<p>Once you have packed an Adventure you can still easily edit it, adding, removing or changing content as needed. In the event you want change an already built adventure, follow these steps:</p>

<li>Open your Adventure Pack, right-click on your Adventure and choose <span class="reference"> Rebuild Adventure</span>.</li>

<li>Edit your Adventure's <span class="reference"> Summary</span> or <span class="reference"> Contents</span> to reflect whatever changes you need. This is identical to the way you set it originally.</li>

<li>In the <span class="reference"> Contents Tab</span>, you will see a list of everything your adventure currently contains. This will provide a summary of change. Documents that have been removed from the adventure are marked in red, while newly added Documents in the adventure are marked in green. This allows you to more easily determine what the differences will be between the previous Adventure and your Rebuild. Ensure that there are no unexpected changes here before you rebuild!</li>

<li>Once you've made all of your changes simply click <span class="reference"> Build Adventure</span> again and it will overwrite your current Adventure Document with the new changes.</li>

<p class="note warning">Everything in an Adventure is replaced each time you rebuild it. That means, if you've made changes to any of the Documents in your world that are included in the Adventure they will overwrite the versions currently in the Adventure every time you press <span class="reference"> Build Adventure</span>. This <em>also</em> means if any Documents are missing in the World they will be removed from the Adventure.</p>

<h3 id="packaging">Packaging Your Adventure for Distribution.</h3>

<p>Adventures can be distributed in a module just like any other content by following the @Article[packaging-guide].</p>