SwapTokenPositions version 1.0.0 is a Roll20 Mod (API script) that allows GMs and players to quickly swap the positions of two selected tokens on the same page. It features customizable animation effects, persistent global settings, and clear chat feedback.

Discussions on the additions, changes and fixes can be found on the Roll20 forums: https://app.roll20.net/forum/post/12727681/new-swaptokenpositions.

Change Log

Added

  • Arcane-themed styled messaging for whispers and announcements.
  • Persistent state management for GM settings (saves between sessions).
  • One-time override support for duration, animation mode, and FX types.
  • New --install-macro command to automatically create a “SwapTokens” macro.
  • “Beams” and “transport” animation modes with customizable beam FX.
  • “Transport” animation mode for immediate magical relocation.
  • New none option for beam and burst FX to allow for silent, instantaneous swaps.
  • Strict selection validation with clear feedback on required token counts.
  • Silent management commands (Help/Settings) that don’t require token selection.
  • Improved whisper delivery using reliable player display name resolution.

Introduction Video

You can view the introduction video on YouTube: https://youtu.be/hjQWF3KYuow.

Where to install the mod from?

Music in the video is “Fantasy” from alexshulgin and licensed via Envato.