World & Campaign Builder
A Foundry VTT module for worldbuilding and campaign management
View the Project on GitHub dovrosenberg/fvtt-campaign-builder
The Directory Sidebar
The directory sidebar is a panel on the right side of the Campaign Builder window that displays tree views of all your worlds, campaigns, and everything in them.
The sidebar can be dragged to make it wider or narrower. You can also click the tab to make it close/open completely.
By default, the sidebar is open whenever you open the Campaign Builder window. There is a module setting to change this behavior to instead start collapsed.
The world directory (aka the entry directory)
The top half of the directory sidebar is the World directory. Also known as the Entry directory, this is where you can find all of entries (Character, Locations, and Organizations) of your worlds.
Each world has a header, and you click the World name to make it the active world. In the image above, Mallindor has been selected as the active World. The active world is also shown in the the main window title bar.
By default, the World is organized by Topic. Each Topic is a folder, clicking the folder will expand/collapse its contents. Clicking an Entry will select it as the active Entry [TODO: link to Entry.md] in the main panel to the left. The currently visible entry is bolded in the sidebar. Within each Topic, the Entries are sorted alphabetically.
You create new worlds by clicking the “New World” button at the top of the sidebar:
The button next to the “New World” button collapses the entire sidebar.
Hierarchies
You can create Hierarchies within Locations and Organizations to represent how they are related. For example, you might put the Entries for towns inside the region they are in. Hierarchies can have as many levels as you want. In addition to making it faster to find related things, Hierarchies are used in Search [TODO: Link] and to improve AI generation [Advanced Feature]. You can see hierarchies illustrated in the sidebar above.
You can create and adjust Hierarchies in two ways:
- Dragging entries within the sidebar. By dragging an Entry onto another, the dragged Entry will become a child of the target.
- Using the Parent field in the Entry editor. Simply choose the parent you want (or set it to blank to make the Entry a top-level one).
Context menus
Right clicking on items in the Entry tree provides additional options depending on the item type:
- Worlds - Delete World, Create campaign
- Topics - Create a new Entry in that Topic, Generate a new Entry [Advanced Feature]
- Entries - Delete Entry
Group by type
Using the “Group tree by type” checkbox at the top of the sidebar, you can choose to organize the entries by Type instead of Topic. This will eliminate the Hierarchy representation and instead show all of the Entries grouped by their Types. Entries without a Type will not be shown.
Filtering
Typing text in the “Filter” box at the top of the sidebar filters the Entry tree to only show:
- All entries whose names contain the filter string
- All types that contain the filter string (when in “Group tree by type” mode)
- Any ancestors of those Entries (to show where they are in the Hierarchy)
The campaign directory
The bottom half of the directory sidebar is the campaign directory. This shows all of the campaigns for the currently active world. If you want to see campaigns for a different world, you need to change the world first.
[TODO: flesh this out]
Context menus
Right clicking on items in the Campaign tree provides additional options depending on the item type:
- World folder - Create campaign
- Campaign - Create a session, Delete the Campaign
- Session - Delete Session