Register

Metamorph

An Add-on Module for Foundry Virtual Tabletop

Author: Gus77 Project: Source Foundry Versions 13+ (Verified 14) Last Updated 2 hours, 14 minutes ago

This module is free. Wanna do a cool thing?

ko-fi


Foundry v13 Foundry v14

Metamorph

Swap between sheets and tokens: any actor can have multiple forms. This module is a must for boss phases, polymorph spells, lycanthropes, shapeshifters, doppelgangers... System agnostic.

It's not just a change in the appearance, its a complete new character sheet each time, with their own data and abilities. You can share the health between them or make them completely independent.


What It Does

Groups two or more actors into a form group. A HUD button lets you instantly swap a token on the canvas to any form in the group. The token's appearance (portrait, size, bars, light, vision) updates from the target actor's prototype token. HP can optionally carry over between forms.


Setup

Screenshot from 2026-06-05 17-51-37

  1. Install the module and enable it in your world.
  2. Open the Actors sidebar, right-click any actor, and choose Metamorph: Manage Forms.
  3. Add the other actors that represent alternate forms of this character.
  4. Mark one as the main form and set an HP transfer mode (see below).
  5. Click Save.

Swapping Forms

Select a token on the canvas and open its HUD. Click the masks icon to open the form picker. Click any portrait to swap to that form.

image

The token keeps its position, rotation, and elevation. Everything else (name, image, size, vision, light, bars) is replaced by the target actor's prototype token settings.


HP Transfer Modes

Set per group in the group manager:

Mode Behavior
Independent Each form keeps its own HP. No transfer.
Absolute Current HP carries over as-is (clamped to the new form's max).
Percent Current HP percentage is preserved (e.g. 50% → 50% of new max).

Installation

Search for metamorph in Addon Modules OR

Paste this manifest URL into Foundry's module installer:

https://github.com/mordachai/metamorph/releases/download/v1.0.1/module.json

Categories

Available Versions

  1. Version 1.0.1

    2 hours, 14 minutes ago
    Foundry Version 13+ (Verified 14) Manifest URL Read Notes