The Visage Editor

The Visage Editor is where you build your Visages. Whether you are creating a look for one character (a Local Visage) or an effect for the whole world (a Global Visage), the editor works the same way and gives you full control over every cosmetic part of the token.

The Visage Editor is themed gold when you are editing a Local Visage and blue when you are editing a Global Visage.

The Interface Layout

The Visage Editor has four areas:

• The header across the top, for the Visage's label, view, sharing and mode.
• The workstation in the middle, made of three panels:
  • the Layers list on the left, showing everything the Visage contains,
  • the live preview stage in the centre,
  • the settings of the selected layer on the right.
• The footer along the bottom, for the category, tags, reset and save buttons.

The Header

• Label: The name of the Visage (for example "Wolf Form" or "Invisibility"). It helps you find the Visage in the Visage Library and the Selector HUD; it is not applied to the token. New Visages are called "New Visage" until you rename them.

• View: Switches the workstation between Design (building how the Visage looks) and Automation (setting up when it applies itself). See Automation.

• Sharing:

  • In the Global Visage Editor you can make the Visage Private (the default) or Public. Public Global Visages appear in players' Selector HUDs, so they can apply them to their own tokens.
  • In the Local Visage Editor, GMs can set the Visage to Visible, Locked or Hidden.

    • Visible Visages can be seen and edited by the owning player (the default).

    • Locked Visages can be seen by the owning player but not edited.

    • Hidden Visages cannot be seen by the owning player unless the GM has applied them to their token.

      Note: When a Hidden Visage is applied, it shows in the player's Selector HUD as "GM Applied Identity" or "GM Applied Overlay". Players cannot remove Hidden Visages applied by the GM.

• Mode: Whether the Visage is applied as an Identity or as an Overlay. New Local Visages start as Identities and new Global Visages start as Overlays.

The Layers List

The Layers list shows everything the Visage contains, in the order it is drawn on the canvas:

• Above Token: Visual effects drawn on top of the token.
• Token: The token itself, made of three layers:
  • Token Appearance (image, size, disposition and so on). See Appearance.
  • Dynamic Ring.
  • Light Source.
• Below Token: Visual effects drawn underneath the token.
• Audio: Sound effects.
• Not shown in preview: TokenMagic filters and macros. These run when the Visage is applied to a token, but cannot be shown on the preview stage.

Click a layer to see its settings in the right-hand panel. Each layer shows a short summary under its name (for example the radii of the light, or how many Token Appearance properties are changed).

• Adding layers: Click the + button at the top of the list and choose Visual effect, Audio effect, TokenMagic filter or Macro. Visual effects need the Sequencer module, and filters need the Token Magic FX module. You can also drag a macro from Foundry's sidebar and drop it anywhere on the editor.
• Switching layers on and off: Click the eye on a layer to switch it on or off. The Dynamic Ring and Light Source are always in the list and start switched off; switch them on to use them. Every switched-off layer keeps its settings and is saved with the Visage, but has no effect until you switch it on again. This lets you keep variations of an effect ready without deleting them.
• Reordering: Drag effects to change their order within their group. To move a visual effect between Above Token and Below Token, change its Layer Priority setting.
• Timeline: The Timeline button at the top of the list opens the Effect Timeline, where you can drag the start time of each effect. See Effects.

The Live Preview Stage

The stage shows an approximation of how your token will look with this Visage applied, including its ring, light and visual effects. If the Visage does not set an image, the stage shows the Visage icon instead, so you can still see the effect of scale, size or opacity changes.

• Pan and zoom: Drag the stage to pan and scroll to zoom. The buttons that appear when you hover over the stage let you zoom in and out, reset the view, show a grid (showing the token's size in grid units) and replay the effects.
• Applied values: A small panel in the bottom-left corner of the stage lists the values that cannot be seen in the preview: scale, XYZ dimensions, rotation lock, wildcard, disposition and mirroring (one row for each axis). Values the Visage does not change are faded.

The Settings Panel

The right-hand panel shows the settings of the selected layer. In every layer, settings follow the same pattern: tick the checkbox next to a setting to make the Visage change it, then choose its value. Anything left unticked is not changed by the Visage, so the token keeps whatever it already has (from its own settings or from other Visages applied to it).

• Sections: Settings are grouped into sections you can collapse by clicking their heading. A collapsed Token Appearance section shows how many properties it changes and lists their values, so collapsing every section (with the button in the panel's header) gives you a quick overview of the Visage.
• Copy from token: Token Appearance, the Dynamic Ring and the Light Source each have a copy button in their header, and each Token Appearance section has one in its heading. It fills that layer or section with the token's settings as it looks right now (including any Visages already applied to it).
  • In the Local Visage Editor it copies from the Visage's own token.
  • In the Global Visage Editor it copies from the token selected on the canvas, so it is only available while exactly one token is selected. You can change your selection between copies to take each section from a different token.
  • Copying the ring or light does not switch it on.
• Clear: Next to each copy button is a clear button. It unticks every setting in that section (or in all of Token Appearance), or resets the Dynamic Ring or Light Source and switches it off.

Tip: New Visages start with nothing ticked, so they only change what you choose. This keeps them working as the token changes: a Visage that sets only a new image will still use the token's current size, ring and light. Use the copy buttons when you do want to start from the token's current look.

The Footer

• Category: Groups Visages in the Library (for example "Dispositions", "Outfits" or "Conditions"). Type anything, or pick an existing category from the list that appears as you type.
• Tags: Searchable keywords that help you find the Visage later (for example "Beast", "Fire" or "Illusion"). Press Enter or a comma to finish a tag and start the next one. Existing tags are suggested as you type.
• Reset All Settings: Clears every Token Appearance setting, switches off and resets the Dynamic Ring and Light Source, and removes every effect. The label, category, tags, sharing, mode and automation are kept. You are asked to confirm first, and nothing is saved until you press Save.
• Save: Saves the Visage and closes the editor. The button lights up as soon as you have unsaved changes.

Further Reading

• Appearance: The Token Appearance settings (image, size, disposition and so on).
• Effects: The Dynamic Ring, Light Source, visual and audio effects, TokenMagic filters, macros and the Timeline.
• Automation: Rules that apply and remove the Visage automatically.