This is a companion for Alien RPG - Motion Tracker (https://foundryvtt.com/packages/motion_tracker/), an this module only passes additional information to that module.
It lets the Motion Tracker detect moving tokens on other Foundry Scenes that represent different levels of the same ship, station, or facility.
The module keeps the original Motion Tracker intact. It does not create extra tokens, move tokens, or permanently change either Scene.
What it does
Normally, the Motion Tracker checks only the Scene the user is currently viewing. This companion lets it also check other Scenes that you have linked to that Scene.
For example, if a ship has one Foundry Scene for its upper level and another Foundry Scene for its lower level, a character on either Scene can receive Motion Tracker contacts from both.
The tracker still behaves like the original Motion Tracker:
- Motionless and other ignored statuses still work.
- The original player-token filtering still works.
- The maximum tracker range still works.
- Contacts from another Scene look like ordinary contacts. Players are not told which Scene a contact is on.
- Several Scenes can be linked together, such as Scene A to Scene B and Scene B to Scene C.
Linking two scenes
- Configure the module from Game Settings
- Click Add Scene Link.
- Choose Scene A and Scene B.
- Enter Scene B elevation compared with Scene A. This is the real physical distance between the two levels. For example, enter `3` if Scene B is 3 meters above Scene A.
- Add a Matching Point. Click Mark Scene A and then click a recognizable location on Scene A. Next click Mark Scene B and click the matching physical location on Scene B. A ladder, lift, stairwell, or teleporter landing is a good matching point because it represents the same physical place on both maps.
- Save the Scene links.
How many matching points should I use?
Use the smallest number that makes the contacts line up correctly.
- No matching points: Use this only when both Scene maps are the same size and use exactly the same coordinates.
- One matching point: Usually enough when both maps face the same direction and use the same scale.
- Two matching points: Use this when one map is rotated or is a different size.
- Three matching points:Use this when the maps are stretched differently and two points are not enough.
If contacts appear mirrored, rotated, or shifted to the wrong place, add another matching point or mark the existing points again.
Contacts directly above or below
The Motion Tracker is a flat, two-dimensional display. A contact directly above or below the user has a distance, but no clear left/right direction on that display.
The setting If a contact is exactly above or below gives you two choices:
- Show it at a consistent direction on the tracker: The module chooses a repeatable direction for that contact. The blip stays in the same direction instead of jumping around, and the distance still includes the vertical separation.
- Keep the blip in the center: The contact remains in the middle of the tracker. In this special case, the original Motion Tracker's displayed distance cannot fully represent the vertical separation.
The first option is the default.
Troubleshooting
If a contact on another Scene does not appear, first confirm that the original Motion Tracker can detect contacts on the user's current Scene. Then check that both Scenes are selected in an enabled Scene link and that the matching points correspond to the same physical locations.
If a contact appears in the wrong direction, mark the matching points again. Matching Point 1 on Scene A must represent the same physical location as Matching Point 1 on Scene B, and so on.
If you use several linked Scenes, make sure the elevation values are consistent. For example, if Scene B is 3 meters above Scene A and Scene C is 3 meters above Scene B, enter those relationships the same way in both Scene links.