Window Taskbar and Window Buttons: Minimize and Pin floating Windows to a top or bottom taskbar. Updated for Foundry VTT v13+.
Dock a fixed taskbar above or below the Foundry canvas. It nudges the UI and canvas resizes correctly.
- Taskbar appearance is configurable, including taskbar background color and taskbar scrollbar color.
Taskbar buttons are sorted (pinned first, then type, then title), show a tooltip with the full title, and support hover preview. When there are too many buttons, the taskbar button strip scrolls horizontally and shows a thin scrollbar.
Header buttons (and the taskbar right-click menu) let you minimize a sheet instantly to a taskbar button, resize it to a configurable maximum size (default 60% × 80% of the canvas area), or snap it back to its configured default dimensions. Each button can be individually shown or hidden in module settings.
The first time any sheet type opens in a world, WCN automatically captures its rendered dimensions as the learned default for that class. This is per-world and stored in world settings, so each world has its own table — useful for systems like D&D 5e that include non-standard sheet types (Group Sheet, Vehicle Sheet, etc.) with different natural proportions.
- Automatic capture: No setup required. Open any sheet once and WCN records its width and height. GM permission is required to save.
- View / Edit / Clear: GMs can open the Learned Sheet Defaults dialog directly from Module Settings (under the Default Size Button toggle). The dialog lists every captured class with its recorded size, an Edit button to override individual entries, and a Clear All button to start fresh.
- Fallback: If no default has been recorded yet and the Default Size button is clicked, WCN shows a notification advising the user to open a sheet of that type once to capture it.
Right-clicking any taskbar button opens a context menu with: Restore, Maximize, Default Size, Pin/Unpin, and Close.
An optional setting stops the taskbar at the sidebar's left edge so it never overlaps the chat or notifications column. The boundary tracks sidebar resize and collapse automatically.
Pin a sheet so it stays available on the taskbar and can optionally be restored across sessions.
- Pinned sheet header appearance is configurable, including header overlay color that also affects the taskbar button color.
Hover your mouse over a minimized window tab for a quick view of the sheet without reopening it.
When enabled, pinned sheets are remembered by Document UUID and restored on next load.
The taskbar can be set to Canvas width or Full width depending on your preference. Some Game Systems may alter the sidebar in ways that alter the Window Controls Next taskbar, setting Taskbar Width to Canvas should help.
Standalone AppV2 windows (those not backed by a Foundry Document) are not managed by WCN by default. Module developers can opt their applications in by calling WindowControls.registerApp() inside a window-controls-next.ready hook callback.
Generic pattern — register your app class at top level in your module's entry file:
Hooks.once('window-controls-next.ready', () => {
const WCN = game.modules.get('window-controls-next')?.api;
if (WCN) WCN.registerApp(YourAppClass);
});The ?.api guard is recommended so your module won't error if WCN is not installed.
Real-world example — The About Time Next module includes an ATEventManagerAppV2 window that has no document backing. To have WCN manage it (taskbar, pin, minimize) register its ATEventManagerAppV2 window in main.js:
// At top level alongside the other Hooks registrations:
Hooks.once('window-controls-next.ready', () => {
const WCN = game.modules.get('window-controls-next')?.api;
if (WCN) WCN.registerApp(ATEventManagerAppV2);
});Once registered, WCN will apply the minimize button, pin button, taskbar button, and remembered pin state to any open or future instance of that class. WCN also performs a one-time sweep of all currently-open windows immediately after firing the hook, so windows that opened before WCN's ready callback ran are not missed.
- Original module concept and early implementations: JeansenVaars
- Community maintenance and prior v12-era fork work: saif-ellafi
- Current v13+ modernization, taskbar workflow, and ongoing maintenance: paulcheeba
- This module is part of the OverEngineeredVTT Suite and Requires the installation of the lightweight OEV Suite Monitor, a master module that tracks OEV module versions for you and lets you know when updates or new modules are available.