Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Portrait Token Broadcast - CtrlAltDefeat

MINIFIED PRODUCTION BUILD

Overview

Portrait Token Broadcast is a lightweight Foundry VTT module that allows a Gamemaster to reveal selected Token or Tile artwork to connected players through a cinematic chat card and shared image popout.

Features

  • Broadcast selected Token artwork to connected players
  • Tile artwork fallback when no Token is selected
  • Tokens take priority when both a Token and Tile are selected
  • Cinematic parchment-style chat presentation
  • Character, actor, Token, or Tile name display
  • Creature size badge
  • Randomized visual accent effects
  • Animated aurora-style image border
  • Optional vignette effect
  • Shared image popout
  • Discord and Patreon chat-card controls
  • Discord and Patreon ImagePopout title-bar controls
  • Clean compendium Macro launcher
  • Public module broadcast API
  • Generic Foundry icons/svg/eye.svg Macro icon
  • Minified production JavaScript and stylesheet
  • GM-only execution by default
  • Foundry VTT v14 support

Installation

  1. Open Foundry Virtual Tabletop.
  2. Open Add-on Modules.
  3. Select Install Module.
  4. Paste the manifest URL into the Manifest URL field.
  5. Install the module.
  6. Enable Portrait Token Broadcast - CtrlAltDefeat in the desired world.
  7. Reload the world if Foundry requests it.

Manifest URL:

https://raw.githubusercontent.com/CtrlAltDefeatAM/Portrait-Token-Broadcast-CtrlAltDefeat/main/module.json

Manual installation

  1. Download portrait-token-broadcast-ctrlaltdefeat.zip from the latest GitHub release.
  2. Extract the archive contents into the Foundry user-data Modules directory.
  3. Confirm the resulting folder is named portrait-token-broadcast-ctrlaltdefeat.
  4. Restart Foundry if required.
  5. Enable the module in the desired world.

Using the Module

  1. Open the Compendium Packs sidebar.
  2. Open Portrait Token Broadcast.
  3. Import the Portrait Token Broadcast macro (Foundry icons/svg/eye.svg icon).
  4. Select a Token or Tile.
  5. Execute the macro.

Notes:

  • Tokens are prioritized when both a Token and Tile are selected.
  • The macro warns when nothing is selected.
  • The macro is GM-only by default.
  • The imported Macro is only a short launcher; the complete implementation runs from local module files.
  • The module does not download executable code when the Macro runs.

Clean Macro Launcher

The included compendium Macro contains a short readable launcher rather than the complete implementation. The launcher calls:

game.modules.get("portrait-token-broadcast-ctrlaltdefeat").api.broadcast();

Lightweight Runtime

Portrait Token Broadcast uses narrow Foundry render hooks and does not perform background polling, recurring canvas checks, or runtime code downloads. The module remains idle until the Macro is executed or a Portrait Token Broadcast popout requires its controls.

Minified Production Build

Portrait Token Broadcast distributes its complete runtime and broadcast implementation through minified .min.js production files, plus a minified module stylesheet for static chat-card and title-bar presentation. No source maps or unminified production implementation files are included in the release package.

Production files:

scripts/portrait-token-broadcast-runtime.min.js
scripts/portrait-token-broadcast-macro.min.js
styles/portrait-token-broadcast.min.css

Configuration

There is no graphical settings menu. Configuration values live in the PTB_CONFIG block inside scripts/portrait-token-broadcast-macro.min.js. Config key names are preserved during minification.

GM_ONLY

Controls whether only a GM may run the broadcast. Default: true.

SHOW_NAME_IN_CHAT

Controls whether the selected artwork name appears above the image. Default: true.

RANDOM_PRIMARY_COLOR

When true, parchment accent colors are chosen randomly on each run. Default: true.

SHOW_SIZE_BADGE

Controls whether the size badge appears. Default: true.

ENABLE_VIGNETTE

Controls whether the image vignette is applied. Default: true.

Compatibility

Foundry Virtual Tabletop v14.

License

This module is released under the MIT License. See LICENSE for the full text.

Support

Main Links

About

Foundry VTT v14 module for broadcasting selected Token or Tile artwork through cinematic chat cards and shared image popouts.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors