Register

☯ Wheel Of Destiny

An Add-on Module for Foundry Virtual Tabletop

Author: Mestre Digital Project: Source Foundry Version 14 (Verified 14) Last Updated 1 hour, 40 minutes ago

☯ Wheel of Destiny

Let fate pick the victim.

Something bad is about to happen to someone in the room. But you don't want to be the one who chose. Let the Wheel of Destiny spin. It wasn't your fault — it was the damn computer.

One click, and the module randomly picks a token: it glows on the canvas, the wheel spins, a sound plays, and the chosen one is revealed to the whole table.

The Wheel of Destiny hopping from token to token before locking onto the chosen one

Buy Me a Coffee More Modules

✨ What It Does

The wheel stops, the winner gets targeted, and the verdict lands in chat — with the full list of who was in the draw, if you want it:

The chosen token targeted on the canvas, with the result announced in chat

🚀 How To Use

Three ways to spin:

Who gets drawn?

What you do Who's in the draw
You select two or more tokens first Only the tokens you selected
You select nothing, or just one (GM) Whoever you pick in the Choose Tokens window
You're a player Only the tokens you have targeted

🎛️ The Choose Tokens window

Start a draw without staging a selection and this opens, listing every token in the scene with its art, name, actor type, disposition, and the player linked to it.

The filters are how you build the draw. It opens with the whole scene in, and narrowing a filter drops whatever no longer matches — click Hostile and every non-hostile leaves the draw. Four filters, all read from the current scene:

Filter What it does
Actor Type Built from the types actually in the scene, so your system's own types show up with a count each
Disposition Friendly, Neutral, Hostile, Secret
Player Link Whether the token's actor belongs to a Foundry user
Visibility Visible or hidden tokens

Need an exception? Untick any token by hand. All and None work on what's currently shown, Reset puts every filter back, and Draw spins with whatever's left.

⚙️ Settings

The module settings tab: three menu buttons plus Target the Selected Token

One setting sits right in the main module tab, because it's the one you'll actually change mid-game:

Everything else lives behind three tidy buttons:

🧙 Macros & API

You can trigger the Wheel of Destiny from a macro or from another module:

Spin the wheel — exactly like clicking the button.

WoD.randomToken();
 

Open the token picker, then spin with whatever you choose. GM only.

WoD.openTokenPicker();
 

Spin using your own list of tokens. Runs the full show (animation, sound, chat, reveal) and returns the winner.

const mySelectedToken = await WoD.randomToken(myTokenList);
 

Just pick one, no bells and whistles. Returns a token from your list and nothing else happens.

const mySelectedToken = WoD.selectRandomToken(myTokenList);
 

Ask for a list of tokens without spinning. Opens the picker and hands back what you chose, or null if you closed it. GM only.

const myTokenList = await WoD.promptForTokens();
 

⚠️ Coming from an older version?

  • v0.4.3 removed the auto-select mode. WoD.customAutoSelectDialog() is gone — use WoD.openTokenPicker()WoD.randomToken() also lost its second argument: WoD.randomToken([], 'pcs') no longer filters, and the 'pcs' is ignored. Pass your own token list instead, or use the picker's filters.
  • v0.4.0 moved the API from game.wod to the global WoD. Old macros using game.wod.randomToken() need to be updated to WoD.randomToken().

Categories

Available Versions

  1. Version 0.4.3

    1 hour, 40 minutes ago
    Foundry Version 14 - 14 (Verified 14) Manifest URL Read Notes