Watch
1
0
Fork
You've already forked gridlessqol
0
No description
  • JavaScript 100%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-21 18:21:55 +02:00
docs Initial release 0.1.0 2026-10-02 16:38:11 +02:00
lang Release 0.4.0: per-token collision shapes 2026-10-21 18:21:55 +02:00
scripts Release 0.4.0: per-token collision shapes 2026-10-21 18:21:55 +02:00
.gitignore Initial release 0.1.0 2026-10-02 16:38:11 +02:00
LICENSE Initial release 0.1.0 2026-10-02 16:38:11 +02:00
module.json Release 0.4.0: per-token collision shapes 2026-10-21 18:21:55 +02:00
README.md Release 0.4.0: per-token collision shapes 2026-10-21 18:21:55 +02:00

GridlessQoL

Quality-of-life improvements for gridless maps: tokens stop cleanly at walls and other tokens, and dead tokens move to the back.

Tokens moving on a gridless map

Click the preview for the full-quality video.

Features

  • Walls stop the whole token: a moving token stops where the edge of its shape (rectangle or circle) reaches a wall, not only its center, and the drag ruler shows where it will stop. By default collision follows each token's own v14 shape; Rectangle and Circle remain overrides.
  • No stacking: a token can't end its move on top of another token; it stops just before it. Round and square tokens collide correctly with each other, including at corners. Passing by is fine, and tokens moved together don't block each other. Tokens you can't see aren't shown on the drag ruler, but the move still stops before them.
  • Tokens block the path (optional): turn on Tokens Block the Path and a token stops at the first token in its way instead of passing through. Hold P while dropping to pass through tokens for that move (walls still stop it). The key can be changed in Configure Controls under Pass Through Tokens.
  • Landing marker: while dragging, a marker in the moving token's collision shape shows where it will land.
  • Forced moves are left alone: unconstrained movement, the Displace action, teleports and scripted moves that ignore walls aren't adjusted. Hold Shift while dropping to skip collision once.
  • Dead tokens don't block: tokens with listed statuses (e.g. dead) can be walked over.
  • Round tokens: new tokens on gridless scenes get a round shape instead of the default rectangle, however they're created.
  • Dead to the back: tokens with a dead status are drawn behind the others and get their previous order back when revived. The GM's client makes the change, so a GM needs to be connected.

Settings

Grouped under headings in Configure Settings; settings that depend on another are indented under it and only shown while it's on. Both v14 ellipse variants count as circles on gridless maps; other token shapes use rectangles.

Group Setting Scope Default
Token collision Wall Collision Snapping World On
Tokens Block the Path World Off
Token Collision Shape World From token shape
Circle Collision Buffer (when circles can be used) World 0.25
Ignored Status Effects World dead
Snap indicator Show Snap Indicator / Color / Opacity Client On / white / 0.3
Token tweaks Auto Token Shape on Gridless Maps World On
Dead Tokens Send to Back World On
Dead Status Effect Names World dead

Keybinding: Pass Through Tokens, default P.

Requirements

  • Foundry VTT v14

Installation

In Foundry's Add-on Modules tab, choose Install Module and paste this manifest URL:

https://someto.de/flaig/gridlessqol/releases/download/latest/module.json

This is a personal project and stays at 0.x: expect breaking changes between versions.

AI disclosure

This module was created by AI with the help of human ideas.

License

MIT