Register

GM Tools: Lore Reference Board

An Add-on Module for Foundry Virtual Tabletop

Author: Elemor Project: Source Foundry Version 12 (Verified 12) Last Updated 3 days ago

This package contains art, text, or software code produced using generative AI.

This is primarily coded and managed by myself. I utilized AI to help troubleshoot unknowns based on my knowledge gaps.

A system agnostic Foundry VTT module built for GMs who want an organized reference board that stored all your information as well as image references of your favorite art. Keep your maps, image references,, documents, and world documents organized and accessible in one window that stays consistent no matter which scene or scenario you're running.


History / Reasoning

I run fairly complex campaigns. Between session prep I found myself constantly flipping between file explorer windows, journal entries, actor sheets, roll tables, and reference PDFs while trying to run encounters or narrate moments. There was no good way to have everything visible and ready in one place without leaving Foundry or opening ten separate applications/windows.

The Lore Reference Board started as a way to keep a campaign map open with clickable pins tied to images and journal entries. It grew from there into something that covers most of what I needed: a window where I can pin notes to a map, see the images I have related to that area, keep a full-width document open, or build a dashboard of anything I would need for the games.

All data is stored world-scoped (not tied to any scene) so the board is always where you left it, regardless of which scene you or your players are viewing.


Tab Types

The board supports three types of tabs. You can have as many tabs as you need and mix types freely.

Image Tabs

image

A full-view image viewer (mostly for maps of any kind, but can be any image you want to put references on) with placeable pins. The image/map supports pan and zoom via mouse wheel and drag. Each pin can be:

Clicking a pin opens a preview dialog to help you describe things. If a journal is linked, it renders the journal content on this screen with multi-page navigation. The preview window also allows you to add additional Journals/Lore to the image, copy the image location to clipboard to be used elsewhere, create this image as a token, and/or create it as a scene.
image

image

Document Tabs

A full-pane document viewer. Drop or browse for any of the following and it renders directly in the tab:

The document stays loaded in the tab. You can unlink and swap to a different document at any time using the tab's header bar.

Reference Tabs

image

A 4-column grid dashboard. Each cell links to a Foundry document or embeds a file. Cells can span multiple columns and rows. The grid scrolls and expands vertically as you add more content. To support system agnostic settings, I had to cut some visual functionality, but still act as a quick load dashboard.

Supported document types per cell:

Type What it does in the grid
Actor Card with portrait (when tall enough) and Open Sheet button
Item Card with portrait and Open Sheet button
JournalEntry Inline scrollable content with multi-page navigation and Open button
Macro Card with Execute button
Playlist Card with Play/Stop controls
RollTable Inline table of all results with a Roll button that marks drawn entries
Scene Card with Activate Scene button
Cards Card with Shuffle and Deal buttons
PDF file Embedded PDF filling the cell
TXT file Preformatted text content
Markdown file Rendered Markdown HTML

Each cell has a small pencil button in the header that opens the edit dialog. You can re-link it to a different document, swap to a file, or resize the cell without deleting and re-adding it.

Cell Placement Picker

When you add or edit a cell, a visual grid picker shows the current layout and lets you draw a rectangle for where the cell should go. Click once to set the start corner, hover to preview the selection, click again to confirm. Occupied cells are shown with a striped overlay and cannot be selected. Invalid overlapping selections turn red. You can also (while editing) change the dimensions of existing cells with the pencil icon in the header.


Screenshots

image

image

image

 


Installation

Method 1: Manifest URL

In Foundry's module manager, paste the manifest URL:

https://github.com/ElemorSeru/lore-reference-board/releases/latest/download/module.json
 

Method 2: Manual

Download the latest release zip, extract it into your Data/modules/ directory, and restart Foundry.


Compatibility

   
Foundry VTT v12  (v13+ Coming Soon)
Game Systems System-agnostic (no system dependency)

The module is system-agnostic. It does not read or write any game system data and works with any system installed in Foundry (that I've tested anyway).


Data Storage

All board data is stored in world-scoped game settings, not scene flags. This means:

You can export and import the full board state (tabs, pins, cell links) from the module settings panel. This is useful for backups or moving a board between worlds. Just keep in mind that links are created via reference, so if the folder structure/names differ, it wont load those things.


Languages

The module ships with translations for:

Categories

Available Versions

  1. Version 1.0

    3 days ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes