1. Install and enable Show of Hands in your world.
2. Open Configure Settings > Module Settings > Show of Hands.
3. Set Middle-Mouse Actions to Click + Drag for both single-token targeting and marquee selection.
4. Open Cursor Settings to choose cursor images, hotspots, cursor sizes, and shared overlay name placement.
5. Set Cursor Sharing Mode to decide whether you share your cursor, receive only, or stay private.

Middle-Mouse Targeting

Target tokens with the mousewheel button instead of swapping to the targeting tool.

• Middle-click a token to target it.
• Shift + Middle-click a token to add it to your existing targets.
• Middle-click empty canvas to clear your current targets when that setting is enabled.
• Shift + Middle-click empty canvas keeps existing targets.
• Works like pressing T, but without interrupting your active tool.

Marquee Box Select

Hold the middle mouse button and drag to target several tokens at once.

• Middle-click + drag draws a selection rectangle on the canvas.
• Shift + drag adds selected tokens to your current targets.
• Dragging over empty space without Shift clears targets.
• Optional token filters can limit marquee selection to hostile, neutral, friendly, or non-friendly tokens.
• Optional level filtering can limit marquee targeting to the currently viewed Scene Level when Foundry exposes one.
• GMs and co-GMs can target all tokens, including hidden ones.
• Players can only target tokens visible to them.

Custom Cursors

Replace Foundry's default browser cursor with your own image for each cursor state.

Per-state customization includes FilePicker-backed image paths, click hotspot position, rotation from 0-359 degrees, width and height controls, aspect-ratio locking, state enablement, live preview, native fallback previews, and profile copy/reset controls. Hotspot sliders use the loaded source image's pixel dimensions, then scale that point with the image into the browser's 128px cursor limit. Show of Hands ships without cursor artwork; leave an image path empty to use Foundry's native cursor for that state.

Multiplayer Cursor Sharing

See other players' cursors on the canvas in real time. Each shared cursor appears as either the player's synced custom cursor image or a colored arrow fallback using that player's Foundry color.

• Cursor positions update about 30 times a second, with smoothing so remote motion stays readable.
• Custom cursor images are shared between players.
• Cursor size stays the same at any canvas zoom.
• Shared Cursor Size controls the final on-screen size for remote cursors.
• Only cursors from players on the same scene are shown.
• Cursor images refresh when sharing is turned on after other players have already connected.
• Cursor Sharing Mode can share your cursor, receive only, or fully hide your cursor from others.
• Sharing respects Foundry's core Display Mouse Cursor permission.
• Per-player visibility controls can hide specific shared cursors locally.
• Shared cursors auto-fade after 5 seconds of inactivity unless fade is disabled in advanced settings.

Shared Cursor Name Labels

Place a player name label next to each shared cursor. The module overlay label is separate from Foundry's built-in cursor name. You can use preset positions or drag the label into a custom position in the Default tab of the Cursor Settings preview. Per-user positioning is synced to other clients.

When Show Shared Cursor Names (Overlay) is enabled, the module hides Foundry's default white cursor name only for peers who have an active Show of Hands overlay, while preserving the native color dot when applicable. Native-only and Receive Only peers keep their Foundry name, so nobody shows up with two labels or an anonymous dot.

Built-In Foundry Cursor Elements

Control Foundry's native cursor dot and name independently from the module overlay.

More Details

game.settings.get("show-of-hands", "settings-version")
game.settings.get("show-of-hands", "middle-mouse-actions")
game.settings.get("show-of-hands", "cursor-sharing-mode")
game.user.getFlag("show-of-hands", "cursorConfig")
game.activeTool
document.getElementById("board")?.classList.toString()

game.modules.get("show-of-hands").api.getDebugState()
ShowOfHands.getDebugState()

1. Foundry -> Add-on Modules -> Install Module.
2. Search for "Show of Hands", or paste this manifest URL:

https://github.com/GnollStack/Show-Of-Hands/releases/latest/download/module.json

Important: show-of-hands and the legacy target-the-beastie are distinct Foundry packages. Install Show of Hands, disable the legacy module, and never enable both together. On first load, Show of Hands imports compatible legacy settings and the local user's cursor profile. Verify the migrated profile before uninstalling the legacy package.

3. Enable the module in your world.
4. Configure it under Module Settings > Show of Hands.

Module version: 14.2.2

Foundry VTT: v14 required; verified on 14.367.

Game systems: works in any system; tested in dnd5e 5.3.3. Targeting, cursor styling, and cursor sharing work at the canvas and UI level and don't use dnd5e data.

Browsers: cursor customization relies on browser cursor image support. Keep cursor images at 128x128 or smaller for best compatibility.

Access:

const api = game.modules.get("show-of-hands").api;

Show of Hands' public API is small and support-oriented.

api.getDebugState()
api.refreshSharedCursorImage()
api.syncHiddenRemoteCursors()

ShowOfHands.getDebugState()

api.diagnostics.actions.getStatus()
api.diagnostics.actions.validateSettings()
api.diagnostics.actions.validateAssets()
api.diagnostics.actions.validateV14Runtime()
api.diagnostics.actions.collectClientDiagnostics()
api.diagnostics.actions.runSmokeTests()
api.diagnostics.actions.validateCursorConfig()
api.diagnostics.actions.validateCursorAssets()
api.diagnostics.actions.openWindow({ window: "cursor" })
api.diagnostics.actions.refreshClient({ delayMs: 250 })

api.diagnostics.actions.runAutomation({ confirmMutation: true })
api.diagnostics.actions.cleanupFixtures({ confirmMutation: true })

Example macros

Copy a compact debug snapshot to the console.

console.log(game.modules.get("show-of-hands").api.getDebugState());

Refresh the shared cursor image after changing a cursor asset.

game.modules.get("show-of-hands").api.refreshSharedCursorImage();

Open the cursor configuration window through diagnostics. Requires the diagnostics gates to be enabled.

game.modules.get("show-of-hands").api.diagnostics.actions.openWindow({ window: "cursor" });

A Bazaar Patron membership includes:

• Every Bakshi's Bazaar premium module while your membership is active, including ongoing updates and new modules as they're added.
• Patron-only channels in the Bakshi's Bazaar Discord.
• Priority module support.
• A direct place to share feedback and feature suggestions. Suggestions are welcome and taken seriously, but development priorities remain at my discretion.

Everyone is welcome in the Bakshi's Bazaar Discord: the public channels cover release announcements, questions, and feature ideas, and patrons also get the patron-only channels and priority support. Bug reports for Show of Hands still go to GitHub issues, as described under Community.

• Report bugs - open an issue with your Foundry version, module version, steps to reproduce, console logs, and screenshots or short clips when useful.
• Ask on Discord - anyone can ask questions in the public channels of the Bakshi's Bazaar Discord. Bazaar Patrons get priority support in the patron-only channels.
• Request features - tell me what happened at your table and what you wish the module could do.
• Star the repo - if the module is useful at your table, a star helps other GMs find it.
• Watch releases - follow the repo for updates, compatibility notes, and new feature releases.

Bug reports, feature ideas, reproduction notes, documentation fixes, and localization ideas are welcome.

I am not generally accepting unsolicited code PRs for features, refactors, architecture, or behavior changes. This is still my module and my codebase; I will decide how features are designed and implemented unless I explicitly say otherwise.

• Bug reports - include Foundry version, module version, a console log, and the steps to reproduce. Screenshots or short clips help a lot.
• Feature requests - tell me what happened at your table and what you wish the module could do.
• Pull requests - please do not open code PRs unless I ask for one. Open an issue with the idea instead.
• Code ownership - core implementation, architecture, and release decisions remain with me unless stated otherwise.
• Translations and docs - typo fixes, wording suggestions, and localization ideas are welcome by issue first. I do not have a public translation setup yet, so I will fold useful wording in myself.

I may adapt, decline, or implement submitted ideas. Any accepted contribution or submitted project material may be released under the same EULA as the rest of the module.

This module is developed and maintained with the help of AI-assisted tools for coding, debugging, and testing.

I care about the quality, behavior, performance, security, and long-term maintainability of this module, and I take full responsibility for what ships. AI assistance does not replace review, testing, debugging, or security and design judgment.

AI is used here as a tool under my direction to make Foundry better and allow for long term mod support while still having a life outside of building and maintaining my free and premium modules.

If you are uncomfortable using software developed with AI-assisted tools, this module is not for you.

Proprietary EULA

This module is licensed under the GnollStack Proprietary EULA. It is Free for Personal Use, meaning you can use it in your home games, stream it, or modify it for your own table without restriction.

However, Commercial Redistribution is Strictly Prohibited. You may NOT sell this module, bundle it within paid content such as Patreon maps or adventures, or host it as a commercial service without prior written consent.

Commercial Licensing

I am open to partnerships. If you are a map maker, adventure writer, or developer who wishes to use this module commercially, please contact me. Commercial licenses are available for:

• Bundling this module with paid VTT content.
• Official integration into commercial systems.
• Custom feature development for your specific product.

Contact

For licensing inquiries or permission slips:

• Discord: GnollStack (Preferred)
• Email: [email protected]
• Please do not open GitHub Issues for commercial licensing discussions. But feel free to contact me via Discord or Email.