Register

Maleficar Manoeuvres

An Add-on Module for Foundry Virtual Tabletop

Author: stonedtroll Project Source Foundry Versions 13+ (Verified 13.347) Last Updated 1 month, 3 weeks ago

A movement and positioning system for Foundry VTT that enhances tactical gameplay with collision detection, snapping, and visual feedback.

To follow the module’s development, you can read the series here: https://hashnode.stonedtroll.com/series/maleficar-manoeuvres

Here Be Dragons

“I endeavoured to turn the ocean to steam by my will alone—only to find its waves dragging me down into oblivion.”

  • Only compatible with gridless scenes.
  • Limited testing performed.
  • Slightly over-engineered.
  • Cartful of technical debt. Features > technical debt repayment

Features

Movement System

  • Collision Detection: 3D collision detection.
    • Accommodates tokens marked as non‑blocking (like swarms).
  • Snap-to-Position: Positioning that snaps tokens to valid locations when movement is blocked.
  • Elevation Support: 3D movement with height-based collision detection.
  • Respects Disposition:
    • Allows movement through tokens of the same or neutral disposition.
    • Never permits a token to end its move overlapping another token, regardless of disposition.
  • Unconstrained Movement: When the unconstrained movement toggle is active, tokens may move through and occupy spaces containing obstacles, ignoring normal collision checks.

Visual Feedback

  • Facing Arcs: Display token facing direction and field of view.
  • Token Boundaries: Visual representation of token collision boundaries.
  • Obstacle Indicator: While dragging, highlight the first token that would obstruct movement in real time.

Obstacle Indicator

  • Actor Info: Displays each actor’s movement speed, providing at‑a‑glance speed information during play.
    • Highlight label indicating active movement mode
    • Displays the effective and total range of the actor’s currently equipped weapon.
      • The effective range is highlighted in crimson for quick recognition.
      • If the effective and total ranges are identical, only the effective range is shown.
      • Supported: D&D 5E
      • Future Support: Additional game systems will be added based on community interest.
  • Rangefinder: Dynamically display 3D, edge‑to‑edge distances using spatial volume between selected tokens and other tokens on the canvas, updating in real time to help players gauge movement, weapon and spell ranges.
    • Visually distinguishes when a token falls within the source token weapon’s effective range or overall range.
  • Cover: Calculates the amount of cover for all visible tokens from the perspective of the currently controlled token.

Range Finder

When a token is being dragged, its boundary is attached to the preview token.

Configuration

  • Token Height: Can now be set per‑token or globally in the module settings. If a token’s height is left blank, the default value is used with multipliers based on creature size and type. This height is factored into rangefinding, cover determination, and collision detection.
  • Keybinding: The Toggle Overlay action now uses Foundry’s keybinding system.
  • Melee Weapon Range Override: Overrides a weapon’s default range when it exactly equals the grid scale distance. Since distance is measured edge‑to‑edge, set this to 0 to require tokens to touch for melee attacks.
  • Movement Validation: Enable collision detection and movement validation. When disabled, tokens can move freely through obstacles.

Usage

  • Hold 'm' to display token boundaries, range, cover, and facing arcs.
  • The facing-arc colour indicates each token’s disposition.
  • Selecting a token changes its facing-arc to your user colour.
  • By default, selection and hover borders are turned off, but you can enable them again in the Settings menu.

Suggested Module

Attribution

Categories

Available Versions

  1. Version 1.18.0

    1 month, 3 weeks ago
    Foundry Version 13 - 13 (Verified 13.347) Manifest URL Read Notes
  2. Version 1.17.0

    1 month, 3 weeks ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  3. Version 1.16.2

    1 month, 4 weeks ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  4. Version 1.16.1

    2 months ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  5. Version 1.16.0

    2 months ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  6. Version 1.15.1

    2 months, 1 week ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  7. Version 1.15.0

    2 months, 1 week ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  8. Version 1.14.0

    2 months, 1 week ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  9. Version 1.13.0

    2 months, 1 week ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  10. Version 1.12.1

    2 months, 1 week ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  11. Version 1.12.0

    2 months, 1 week ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  12. Version 1.11.0

    2 months, 1 week ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  13. Version 1.10.0

    2 months, 1 week ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  14. Version 1.9.1

    2 months, 1 week ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  15. Version 1.9.0

    2 months, 1 week ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  16. Version 1.8.0

    2 months, 2 weeks ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  17. Version 1.7.0

    2 months, 2 weeks ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  18. Version 1.6.0

    2 months, 2 weeks ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  19. Version 1.5.1

    2 months, 2 weeks ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  20. Version 1.5.0

    2 months, 2 weeks ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  21. Version 1.4.0

    2 months, 3 weeks ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  22. Version 1.3.0

    2 months, 3 weeks ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  23. Version 1.2.0

    2 months, 3 weeks ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  24. Version 1.1.0

    2 months, 4 weeks ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes
  25. Version 1.0.0

    3 months ago
    Foundry Version 13 - 13 (Verified 13.346) Manifest URL Read Notes