Cinematic Bars

Black letterbox bars slide in at the top and bottom of the screen to mark a dramatic moment: a reveal, a boss entrance, a cutscene. Trigger them from a macro, for yourself or for the whole table.

A fork of Aeris Cinematic Bars by Robin Chand, rewritten in plain JavaScript.

Features

• Bars slide in and out again after a delay. They cover the canvas but not the sidebar, controls or windows, and never block clicks.
• Show them on your screen only or on everyone's.
• Each player can turn them off for themselves.

Settings

Setting	Scope	Description	Default
Cinematic Bars	Client	Show the bars on this client	On
Cinematic Bar Hide Delay	World	Seconds the bars stay up when no duration is given (2–6)	3

Macro API

Durations are in milliseconds.

cinematicBars.beginCinematic();                // this client, for the Hide Delay
cinematicBars.beginCinematic(5000);            // this client, 5 seconds
cinematicBars.beginCinematicForEveryone(8000); // everyone
cinematicBars.endCinematic();                  // hide now, this client
cinematicBars.endCinematicForEveryone();       // hide now, everyone

Requirements

• Foundry VTT v13+ (verified on v14)
• socketlib

Installation

In Foundry's Add-on Modules tab, choose Install Module and paste this manifest URL:

https://someto.de/flaig/cinematic-bars/releases/download/latest/module.json

This is a personal project and stays at 0.x: expect breaking changes between versions.

AI disclosure

The changes in this fork were made by AI with the help of human ideas.

License

MIT