[#6923] Add system-specific adventure importer dialog with actions#6946
Open
[#6923] Add system-specific adventure importer dialog with actions#6946
Conversation
Adds a new Adventure Importer sheet that follows the dnd5e design
style. Following the example of core with its V2 importer, this
sheet is not made default and instead must be opted into on a
per-adventure basis.
The new sheet includes support for pre- and post-import actions
which are presented as checkboxes on the importer sheet to give
control to users. There are three actions initially provided by
the system: "Activate Scene", "Display Journal", and "Customize
World", but modules can add their own actions.
Each adventure can use flags to define which of the actions is run
when that adventure is imported and customize their behavior.
There is also a new `AdventureRegistry` that allows defining
actions for a single adventure or for all adventures in a module.
Actions added through the registry can support custom handlers
without having to add to the global configuraiton.
```javascript
// These actions will be run across all adventures in the module
dnd5e.registry.adventures.setModule("dnd-adventures-faerun", {
importActions: ["activateScene", "displayJournal"]
});
// This specific adventure has a different set of actions
dnd5e.registry.adventures.setAdventure("Compendium.dnd-adventures-faerun.adventures.Adventure.OJuc9WnDJDAETIFr", {
importActions: [{ id: "displayJournal", journalId: "x0TaNijLJkanmufc" }]
});
```
The system also contains a dialog that presents actions available
after using quickstart to load the adventure. By adding a separate
quickstart handler actions can opt in to support on quickstarted
adventures. These actions are passed all of the adventures that
have that action and their configs so they can optimize if more
than one adventure is quickstarted.
arbron
added a commit
that referenced
this pull request
Apr 17, 2026
Adds a new window that pops up when the system is first launched to
provide some first run improvements to users. This window displays
a welcome message & several links to documentation & support pages.
Beneath that are some important settings that are useful to get set
immediately including rules version, calendar, bastion, and whether
the metric system is used. Any changes to these settings are saved
when the window is closed and a reload will be prompted if needed.
The second tab contains a list of all of the first-party modules
offered for the system. These modules can be easily enabled from
this screen and any selected modules will be enabled when the app
is closed.
The list of modules is contained in a JSON file included with the
system, but it will also check the copy of that file on the
`publish-wiki` branch of the GitHub. This should allow the system
to add new modules to this listing without requiring a new system
version.
### Todo
- [ ] Write welcome dialog & links
- [ ] Modify compendium browser filters to match selected rules
and enabled modules
- [ ] Integrate with adventure quickstart dialog #6946
Closes #6922
arbron
added a commit
that referenced
this pull request
Apr 17, 2026
Adds a new window that pops up when the system is first launched to
provide some first run improvements to users. This window displays
a welcome message & several links to documentation & support pages.
Beneath that are some important settings that are useful to get set
immediately including rules version, calendar, bastion, and whether
the metric system is used. Any changes to these settings are saved
when the window is closed and a reload will be prompted if needed.
The second tab contains a list of all of the first-party modules
offered for the system. These modules can be easily enabled from
this screen and any selected modules will be enabled when the app
is closed.
The list of modules is contained in a JSON file included with the
system, but it will also check the copy of that file on the
`publish-wiki` branch of the GitHub. This should allow the system
to add new modules to this listing without requiring a new system
version.
### Todo
- [ ] Write welcome dialog & links
- [ ] Modify compendium browser filters to match selected rules
and enabled modules
- [ ] Integrate with adventure quickstart dialog #6946
Closes #6922
arbron
added a commit
that referenced
this pull request
Apr 17, 2026
Adds a new window that pops up when the system is first launched to
provide some first run improvements to users. This window displays
a welcome message & several links to documentation & support pages.
Beneath that are some important settings that are useful to get set
immediately including rules version, calendar, bastion, and whether
the metric system is used. Any changes to these settings are saved
when the window is closed and a reload will be prompted if needed.
The second tab contains a list of all of the first-party modules
offered for the system. These modules can be easily enabled from
this screen and any selected modules will be enabled when the app
is closed.
The list of modules is contained in a JSON file included with the
system, but it will also check the copy of that file on the
`publish-wiki` branch of the GitHub. This should allow the system
to add new modules to this listing without requiring a new system
version.
### Todo
- [ ] Write welcome dialog & links
- [ ] Modify compendium browser filters to match selected rules
and enabled modules
- [ ] Integrate with adventure quickstart dialog #6946
Closes #6922
3 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a new Adventure Importer sheet that follows the dnd5e design style. Following the example of core with its V2 importer, this sheet is not made default and instead must be opted into on a per-adventure basis.
The new sheet includes support for pre- and post-import actions which are presented as checkboxes on the importer sheet to give control to users. There are three actions initially provided by the system: "Activate Scene", "Display Journal", and "Customize World", but modules can add their own actions.
Each adventure can use flags to define which of the actions is run when that adventure is imported and customize their behavior. There is also a new
AdventureRegistrythat allows defining actions for a single adventure or for all adventures in a module. Actions added through the registry can support custom handlers without having to add to the global configuraiton.The system also contains a dialog that presents actions available after using quickstart to load the adventure. By adding a separate quickstart handler actions can opt in to support on quickstarted adventures. These actions are passed all of the adventures that have that action and their configs so they can optimize if more than one adventure is quickstarted.