Zoom/Pan Options

Latest version1.14.1
Minimum Core11
Compatible Core11
Last updated2 weeks ago
Created3 years ago
Languages English
Systems All systems
Dependencies libWrapper
Project source Project URL
Report bugs Bug tracker URL
Read-me Readme URL
Changelog Changelog URL
License License URL

Zoom/Pan Options

FoundryVTT module to change zooming and panning through the mouse or a touchpad. It has several settings, which can be toggled individually and stored locally (per client).

Zoom around cursor

  • When zooming in and out, the camera will stay focused on the cursor, like in many other applications.
  • This does not affect PageUp, PageDown, or Numpad +/-. Those will still zoom into or out of the center of the screen.

Middle-mouse to pan

  • Holding the middle mouse button and dragging around will pan around the map, just like the right mouse button, instead of showing the "auto scroll" icon (which is useless in Foundry).
  • This will mimic the default right-mouse panning, though it will ignore tokens, tiles, etc (instead of selecting them).

Minimum/Maximum Zoom Override

  • Override for the minimum and maximum zoom scale limits. 10 is the Foundry default - you can't zoom in to get a bigger than a x10 scale closeup, or zoom out to get a smaller than a x0.1 "wide shot" of the scene. For example, if you change this to 20, you'll be able to zoom in twice as close and zoom out twice as far.

Drag resistance mode

Foundry Default

  • This is the minimum distance you need to move your cursor for a mouse drag event to be triggered. When it's too high you'll feel a dead zone when making small mouse drags (e.g. short pans, small drawings). Recommended setting: "Scaling", which scales to be about the visual size of a tool button
  • Foundry Default is ~25 constantly (25% of grid size), which can feel bad, particularly when zoomed in


  • 0.1 constantly, very responsive to pan/draw motions but makes it hard to ping (long press)

Scaling (default)

  • Scales to always be about 1% of screen width

Pan/Zoom Mode:

"Mouse" mode

  • Same as the Foundry behavior

"Touchpad" mode

  • Pan with two-finger drag on the touchpad.
  • Zoom with two-finger pinch or Ctrl+scroll.
  • Rotate with Shift+scroll and Ctrl+Shift+scroll. (Note: if you're using a touchpad and you want to rotate a token, I recommend the Alternative Rotation module - shift-dragging a token is easier than trying to accurately scroll the right amount/speed)
  • (Ctrl can be replaced with Cmd (mac) or WinKey (windows), as usual in Foundry)

"Alternative" mode

  • Pan with touchpad, or with mouse: vertical mouse scroll will pan up and down, and horizontal mouse scroll will pan left and right.
  • Zoom with two-finger pinch or Ctrl+scroll.
  • Rotate with Alt+Shift+scroll and Alt+Ctrl+scroll.
  • (Ctrl can be replaced with Cmd (mac) or WinKey (windows), as usual in Foundry)

Auto-detect touchpad (BUGGY)

  • Will auto-detect touchpad movements (any "scroll" event that includes both vertical and horizontal components), and treat them as if the "Touchpad" or "Alternative" mode is active.
  • This feature is buggy, which is why it defaults to false.  If you can improve it with a PR, please do!

Pan speed multiplier

  • Only used in touchpad and alternative modes. Multiplies pan speed. Defaults to 1, which should be close to the pan speed when right-click-dragging the canvas.

Zoom speed multiplier

  • Useful if your zoom is too sensitive, or not sensitive enough.
  • Set to 0 for default Foundry behavior (5% zoom per mouse tick, always).
  • Set to 1 for zooming based on scroll delta, which should be similar to default zoom for most common mouse types.
  • Set to 0.1 for slower zooming, or 10 for faster zooming.
  • Technically you can give this a negative value to flip your zoom directions, if you're an oddball.

Invert vertical scroll

  • Only used in touchpad and alternative modes. If set to true, you will scroll up when dragging/scrolling down.


Notify of
Inline Feedbacks
View all comments
Would love your thoughts, please comment.x