fvtt-easy-phasey
Foundry VTT module to support phased maps
Easy Phasey allows you to quickly setup phased maps in Foundry - maps that change over the course of the battle. Why not just use different scenes? Because switching scenes requires you to then reset a bunch of other things like tokens, fog of war, etc. This module handles all that for you.
You just create a folder with the scenes you want to use for the phases, and then use the module to setup the order. You can then move through the scenes (forward and back) with the click of a button. Easy Phasey.
Why phased maps? If you're reading this you probably already know, but there are a variety of use cases for phased maps:
- Battles that change over time to put pressure on the characters (rising water, lava changing patterns, walls closing in)
- Transition a map between times of day, weather, etc.
- Easily time when and where new actors should appear
- Probably others I can't think of at the moment
Use of AI
Claude is being used to support this module. This allows me to keep it up to date with Foundry releases, as well as stay top of security updates for open source packages that are used. Otherwise, I would probably have to discontinue support for the module due to lack of time.
Current features
- Select any folder of scenes to use for the phases
- Choose the order the phases should appear, and mark scenes to skip
- Track the chosen phases/order as well as the current phase you're in for each folder (i.e. you can have multiple phased scenes in various parts of their progression at once)
- Choose to ignore stray tokens in the phases as you progress or to merge them in --- this lets you use phases to automatically add additional actors when they come up
- Support for Levels (but NOTE! levels need to line up across all of the phase scenes to work properly)
Usage
Create a scene folder with the set of scenes you want to transition between.
After installing the module, you should see in your left controls the easy phasey control:
Then click the config button:
And you should get the folder selector box:
Pick the folder with your scenes in it and then configure the order:
When you hit "save and activate" it should immediately activate the 1st scene, and the easy phasey menu controls should change to the back/forward buttons:
Just use those buttons to move between scenes.
By default, all tokens stay in the same place they were when moving between scenes. If the "merge tokens" button is checked, then any tokens saved on the scene you are moving to are retained, resulting in both the tokens from the prior scene and the new one being present. This is helpful, for example, if you want to pre-place some NPCs/enemies in one of the transitions and have them appear automatically.
Other ways to change phase
Keyboard shortcuts
There are keyboard shortcuts available to move between phases. By default:
- Shift + Control + ] - move to the previous phase
- Shift + Control + ] - move to the next phase
Macros
You can also use the advancePhase() api call to change the phase:
await game.modules.get('fvtt-easy-phasey')?.api?.advancePhase(1);
The argument is the number of steps to advance (negative to go backwards).
Issues?
If you believe you found a bug or would like to post a feature request, head over to the module's Github repo and open a new issue.
Languages
Per Foundry's AI policy, non-English translations have been removed (they were AI-generated). If you would like a language and are willing to provide translations, let me know. PRs also welcome.
Support
I'm happy to do this for free, as I primarily work on things I like to use myself. But if you'd like to buy me a root beer, I love knowing that people are using my projects and like them enough to make the effort. It's really appreciated!
Copyright and usage
THIS ENTIRE REPOSITORY IS COVERED BY THIS LICENSE AND COPYRIGHT NOTICE
Copyright 2026 Dov Rosenberg
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.