Feature:Importing:Adventure

From 5etools Community Wiki
Jump to: navigation, search

framless
v1.14.1

PlutoniumImportAdventure.gif

Importing (Adventure)

BothDMnPC.png
This the subsection from the general feature Importing Content.
Adventures are a collection of Journal/Notes; Monsters; Items; Rollable Tables - but not whole scenes and their dynamic lighting/sounds/tokens and their locations.
if you're attempting to Import a Adventure's maps (with all the walls/lighting/tokens), in Foundry, that's called a WORLD. Importing a world is discussed here


Instructions (How to use it)

PlutoniumButtons.PNG
  • From the Tabletop you'll want to make sure you are in one of the following:
Actors
Items
Journal Entries
Tables
This will bring up the Import Wizard


PlutoniumImportWizard.PNG

1. Choose Importer

Pick the type of content you want to import. (In this case )

2. Choose Source

Select the source of the content you want to import. They are coded by these symbols:
D&D Raw Icon.png - WoTC content; Core Rules; Supplements; Unearthed Arcana; Official AL (Extra Life) content; or from Offical WoTC Stream
ActorIcon.png - These are the custom solutions; a specific direct link URL; or local compatible JSON file.
BrewMugIcon.png - Homebrew content maintained at the Homebrew Repository
There can be a lot of content there, so there is a copy of the Filter system to help find a source. You can use Rivet to bypass some of this

3 Options

There are two methods by which importing adventures occurs.
Configure and Import
This system is used to pull from 5eTool's data; bringing in the Journal; Actors; Items; and tables - but not scenes/macros/playlists or the like (yet)
If you chose the "ActorIcon.png Custom URL" option as a source, here's where you would link the file you want to import from.
Keep Window Open - Can be toggled to choose if the Wizard stays open once you open the importer proper;
Folder Path: - Determines the folder in which the content will end up in. By default it will create a folder, but you can change its name, add deeper folderization, or choose an existing folder.


The various Categories within the Adventure are listed.
Where you can Modify options on what gets imported; and where those will be placed.
An example Import Window; Content Categories will change based off the Adventure being imported.



or

Worlds/Modules
This is used to either import a world or module. (defined on the window)
Chose one of these


Click Import to begin the importing.

Feature Support


Known Issues/Limitations

There are no notifications for when it completes

Currently there is not a a notification system for completion, there are two methods for addressing this as a workaround:
  1. Wait.
  2. Install via the Setup and Configuration Screen through Manifest URL (yes, this works for Modules and Worlds)


In the case of waiting, that will vary as the file size you're pulling and the speed of your connection differ between people. But give it at least 5 minutes and not more than 30.
Because you're already in a game you have to reload the module index - this can be done by refreshing, exiting and re-entering (after the waiting time); it will then be listed (hopefully) under modules, which you'll have to enable.



FAQ

Can I import Adventures?

Yes. Now you can. Both as just the journal content; monsters; items; tables; AND as whole Worlds or Modules to use selective elements within another active campaign.


How do I import adventures

See The Import Adventures Feature page.


I get an error when I'm importing, what do I do?

Report it. (But make sure you're being EXHAUSTIVELY DETAILED about such.)
EXAMPLE FROM
Name of the Adventure:
Type of the Import: (as world / as module / from ManifestURL / Manual installation)
Steps: <list the steps>
Error: <copy of all errors (see console)>


How do I import a full adventure with maps/scenes/tokens etc?!

That's called a WORLD in Foundry. You would import the world for that adventure.


What worlds can I import? (sotto voce:smartass)

Check here

And HOW DO I IMPORT THEM?

You follow the instructions here


I get an error when I'm importing a world or module, what can I do to fix it?

That does happen for a few, sorry. If you're one of the few with the problem. That's unfortunate. Seems to be related to certain ISPs.
You report the specifics around your error(s) and hopefully a pattern will emerge so you can use it in the future. But for now, you cannot.
or.... I guess you could try the manifest URL for the world/module from the https://foundry.5e.tools/index.html site


How do I update or upgrade my world to the current version

Take notes about the party's specific current location, on their current scene. What their stats, HP, Experience and attributes are.

(take a screen shot if needed)

Make a backup of the actors and any scenes; actors; tables; macros and items you added.
Check the backup to make sure its a viable copy.
Go into the User directory for the FoundryVTT; into the ./Data/Worlds/<world_abbreviation*>/Data directory and make a copy of (if they are there) combat.db; users.db; fog.db; chat.db; sessions.db; macro.db;
Install the update (this will overwrite your world - this SHOULDN'T replace or overwrite the Chat; Users data; Session logs; and Fog of war/explored regions - but it might, (hence that last backup) [NOTE THAT FOR 0.7.5+ core updating will erase your fog of war, and restoring that file will not restore that, 0.7.5+ is a breaking change for prior fog of war)
Restore the actors, journal; items; tables; macros; scenes you added to the world.
Test the world
Replace the character tokens to where they were before. Modifying other actor tokens that were already defeated; fled or were injured.

(if Chat; Users data; Session logs; and Fog of war/explored regions were not maintained - report that, and restore your copies of such back into the directory.)


YOU'RE DONE
NOTE: The following worlds have changed their internal names, so when you "update" them, you'll be making a NEW world/module.
Current Name (prior name)
humblewood (aitw)
saf (tsocr)
stss (hftt) 
ootw (oow)
tfyp-atg (tftyp-atg )
tfyp-dit (tftyp-dit )
tfyp-tfof (tftyp-tfof)
tfyp-thsot (tftyp-thsot)
tfyp-toh (tftyp-toh )
tfyp-tsc (tftyp-tsc)
tfyp-wpm (tftyp-wpm )


How to I update my world myself to avoid all that?

Follow the conversion guide's steps for updating that world's level of function.
Best Practices

None as yet (Do you have any suggestions?)
Homebrew



Related Features



Did that answer your question(s)?

If not please check the under Support; Troubleshooting or the Known Issues page for further guidance, or go to the Discord community and leave a comment in the issues channel.

If you enjoy the project, please follow this link to see how you can contribute and help make it even better.