#Storyframe
1 messages · Page 1 of 1 (latest)
This looks interesting. But I am getting an error trying to install.
at Module.installPackage (file:///home/foundry/foundry-13/resources/app/dist/packages/views.mjs:1:3032)
at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
at async SetupView.handlePost (file:///home/foundry/foundry-13/resources/app/dist/server/views/setup.mjs:1:2474)```
Oops I will fix it soon
fixed in 1.0.2
@meager canyon let me know if not fixed yet
[storyframe] Metadata validation failed for module "storyframe": The file "storyframe.mjs" included by module storyframe does not exist
I'll try restarting the server just in case there's a cache issue
The error persists even after wiping the storyframe module directory and restarting the server
was finally able to fix it, was an issue with the workflow in GitHub, try now
@meager canyon decided to change the function of the module a bit, removing the dedicated reader nad just using the regular journal with the added fntionality of the gm sidebar
[1.1.0] - 2026-02-01
Added
Journal Content Integration
- Journal Images Gallery - All images in journal automatically appear in NPC panel
- Grid layout with compact square thumbnails (50px)
- Click to add image as NPC speaker with custom name prompt
- Right-click to view full-screen
- Filters out images already used as speakers
- Journal Actors Gallery - Actor references (@Actor[id]{name}) auto-detected
- Parsed from Foundry content links in journal pages
- Grid layout matching image gallery style
- Click to add actor as NPC speaker instantly
- Right-click to view actor portrait full-screen
- Filters out actors already added as speakers, loot actors, and hazards
Skill Check Enhancements
- Secret Rolls - New checkbox in DC controls for GM-only rolls (blind mode)
- System-Specific Skill Menus - Three-dots and gear menus now show correct skills per system
- D&D 5e Inline Checks - Auto-detects
[[/check skill dc=15]] and [[/save ability dc=12]] syntax
UI Enhancements
- PC hover border - PCs now show accent border on hover for better interactivity
- Compact galleries - Journal images/actors use 50px grid for more items per row
- Cleaner UI - Removed + icons from journal images for simpler appearance
- DC dropdown fix - Click events no longer auto-close dropdowns
Changed
- Major Refactor: System-specific implementations
- Created
GMSidebarAppBase abstract class with common functionality - Created
GMSidebarAppPF2e subclass for PF2e-specific features - Created
GMSidebarAppDND5e subclass for D&D 5e-specific features - Moved skill mapping to
SystemAdapter module
- Created
- Journal-sourced NPCs now integrated directly into sidebar workflow
- NPC panel structure reorganized with journal content sections
- Full D&D 5e Support - Sidebar now works with D&D 5e journal sheets (JournalEntrySheet5e)
- System-Specific Defaults - Quick skill buttons default to appropriate skills per system
- NPC section sizing - Now sizes to content (max 60vh) instead of filling viewport
- Player viewer control - Right-click TV icon closes viewers for all players
Fixed
- D&D 5e check detection now parses
<span class="roll-link-group"> correctly - D&D 5e rolls now evaluate success/failure with
config.target DC - D&D 5e actor links (@UUID format) now detected in journal
- ApplicationV2 element handling for both PF2e and D&D 5e journal sheets
- jQuery object unwrapping for proper DOM access
- Journal actor filtering now correctly uses UUID comparison
Removed
- Debug console.log statements throughout codebase
- Hardcoded system-specific logic from base class
released 1.3.0
[1.3.0] - 2026-02-01
Added
Multi-Option Challenge System
- Present Challenge - GM broadcasts multi-option skill challenges to all players
- Proper ApplicationV2 dialog class with dedicated template and CSS
- Card-based builder with name, optional image, and multiple options
- Scrollable dialog for long challenges (max-height: 90vh)
- Each option: description + multiple skill-DC pairs
- Each skill can have different DC (e.g., "Crafting DC 15 OR Diplomacy DC 17")
- Lore skills support - All lore skills from participants available in dropdown
- Skill actions (PF2e) - Optional action dropdown per skill (e.g., "Demoralize")
- Add/remove skills within each option
- Add/remove option cards
- Visible to ALL players (no participant selection needed)
- Players self-select which option to attempt
- Respects system DC visibility settings (hides DCs if metagame setting off)
- Options remain available after use (no auto-removal)
- Challenge Library - Save and reuse prepared challenges
- Proper ApplicationV2 dialog class with dedicated template and CSS
- Folder icon button in PCs section (always available)
- Beautiful card layout showing challenge name and options preview
- "Present to All Players" button per challenge
- Delete button with confirmation
- "Save to library" checkbox in builder dialog
- Challenges stored per-world, templates reusable across scenes
- Player Challenge UI - Players see challenge in rolls sidebar
- Challenge name and optional image
- Each option shows as card with description
- Click any skill button to immediately roll with its DC
- DC badge shows if system allows
- Direct roll execution with DC pre-filled
- Styled Dialog - Custom StoryFrame button styling throughout
- Gradient buttons with hover/active effects
- Color-coded actions (blue=add, red=remove, green=submit)
- Box shadows and lift animations
- Clear Challenge - GM can manually clear active challenge (click indicator)
Everything installs. Will actually play with it sooner or later
1.4.0 released with major design and QoL
1.5.1 added keybind for roll requester from journal selected text, 1.6.0 will add speaker wheel and scenes
[1.7.4] - 2026-02-09
Changed
Smart Player Window Management
-
Viewer Auto-Open - Opens only when speakers are added (shows NPCs)
- No longer opens for rolls/challenges without speakers
- Closes automatically when all speakers removed
- Players can manually open if speakers exist
-
Sidebar Auto-Open - Opens independently when rolls/challenges added
- Auto-opens for pending rolls or active challenges
- Stays open when viewer closes if content remains
- Independent from viewer lifecycle
-
Selective Opening - Only opens for players with relevant content
- Auto-opens only for players who have rolls/challenges targeted to them
- Other players don't see auto-opening unless they have content
- Manual open shows notification if no content
-
GM Controls Split - Separate buttons for viewer and sidebar
- NPCs tab: "Open viewer on players" button (TV icon)
- PCs tab: "Open sidebars on players" button (sidebar icon)
- Both support right-click to close
[1.7.5] - 2026-02-11
Added
- Skill & Category Reordering - Drag-and-drop reordering in GM sidebar
- Drag skill buttons to reorder within categories
- Drag category labels to reorder categories
- Custom order persisted to world settings
- Fast animations with smooth transitions
Fixed
-
Category Order Persistence - Category order now properly persists when sidebar reopens
- Applied saved category order to template rendering
- Custom ordering now respected on every sidebar render
-
Player Challenge Selection - Fixed "Challenge no longer active" error when players select challenge options
- Updated player-viewer to use new multi-challenge system (activeChallenges array)
- Challenge buttons now properly lookup challenge by ID
-
GM Sidebar Independence - GM sidebar no longer requires journal tab to be open
- Added token control button to open/close sidebar independently
- Sidebar works in standalone mode or attached to journals (drawer mode)
- Made sidebar resizable and minimizable in standalone mode
- Updated keybinding warnings for clearer instructions
-
Standalone Mode Stability - Fixed errors when GM sidebar opens without parent journal
- Added null checks for element cleanup in close handler
- Fixed journal content extraction to handle missing parent interface
- Prevented errors when toggling sidebar in standalone mode
[1.8.0] - 2026-02-18
Added
-
Action/variant batch highlighting - Action menu items and variant popup items show gold highlight when batched; re-opening popup pre-marks already-batched items
-
Roll Requester send button disabled when no participant selected; enables on first selection
-
Ctrl/Cmd+click intercepts any chat post - Holding Ctrl/Cmd while clicking any "post to chat" button opens Roll Requester instead of posting directly
-
Batch skill actions & variants - Shift+click actions in the skill actions menu or variants in the variant popup to add them to the batch queue
-
Per-check DC capture - Each item shift-clicked into a batch captures the current DC and secret toggle at that moment; different checks in the same batch can now have different DCs
Changed
-
All skills shown by default - Removed "configure quick skills" button; all system skills now always visible in the PCs tab skill grid
-
Allow Only One moved to Roll Requester - Removed the toggle from the sidebar controls bar; use the checkbox in the Roll Requester dialog instead
-
Per-check secret capture - Secret toggle state captured at shift-click time per batch item; dialog also shows correct per-check secret badge
-
Journal skill shift-click toggle - Shift-clicking a journal skill button when all its checks are already batched now removes them (full toggle)
-
PCs tab simplified - Removed participant selection; skill/save buttons now open Roll Requester directly with all player-owned PCs (or PF2e party members), no pre-selection needed
-
DC preset popup - Now renders as a body-level fixed popup, no longer clipped by the journal window
-
PF2e party members in Roll Requester - Roll Requester uses PF2e party actor members when a party exists, falls back to all player-owned characters
-
PF2e inline check Cmd+Click - Cmd/Ctrl+click on an inline check repost button opens Roll Requester without posting to chat
-
Challenge option names - Player sidebar now shows option names above skill buttons
It would help me a lot if you had a "showcase video" of your module, or something similar.
Are you planning on do that on the foreseeable future?
I can do one sure
Does it need to be a commentary video or just show how things work?
Just showing things working would be enough, I think. But I would never try to stop you on comment about a thing you created yourself.
I'm specifically trying to use it with PF2e.
OK, I'll make it today
I'm also using it for pf2e
@fading sigil https://youtu.be/1Fl6yN63Oho
Unscripted showcase of my storyframe module.
Things i forgot to mention in the video:
You can reorder skills and skill categories if you hold the handle(label) and drag over where you want to replace it.
For any questions you can raech out on Discord: RoiLeaf
Or on the Github page of the module: https://github.com/roi007leaf/storyframe/
That was really helpful. Thank you a lot. Now everything makes sense.