Vehicle - A script for handling vehicles and mounts Moving a group of tokens that are all standing on a boat, a wagon or a giant eagle has always been fiddly in Roll20. You either select everyone and hope nobody gets left behind, or move them one at a time. Vehicle handles this. It will be available through One-Click shortly. [ Demo video ] [ Code - Until One click merge ] What it does You mark a token as a vehicle. From then on, whenever it is moved or turned, every token on it is carried along and keeps its place on board. If the vehicle turns, the passengers swing around with it, and they can also turn to keep their facing. That is a setting for each vehicle, since top-down art usually wants it and portrait art usually doesn't. Passengers can still move on their own, and moving a passenger never moves the vehicle. If someone jumps overboard or dismounts, they just drag their token off, and they are no longer carried. Vehicles are kept behind other tokens so the passengers stay visible on top. Setting up a vehicle or mount Select the token, type !vehicle for the menu, and click Define. That's all most vehicles need. A token counts as aboard if at least half of it is over the vehicle. You can change that amount for each vehicle. A lot of vehicle art has empty space around the edges, for shadows or so it fits the grid. To tell the script where the passengers actually stand, draw a rectangle over that part of the vehicle on the token layer, select the vehicle and the rectangle together, and click Set area. The rectangle is removed afterward. Show area draws a temporary yellow outline so you can check it. !vehicle --list shows every vehicle on the page with its picture and settings, and you can change them from there. Click a vehicle's picture to pull everyone's view to it, or its name to pull only your own. Things to know
Passengers move when the vehicle is dropped, not while it is being dragged.
Undo on a vehicle move puts the vehicle back but not the passengers.
Only tokens on the token layer are carried, and a vehicle on another vehicle is not carried.
The vehicle settings live in a short tag in the token's tooltip, so a copied vehicle keeps them. Players will see the tag if the tooltip is shown to them.
Setup commands are GM only. Anyone who can move a vehicle can move its passengers.
Written for the current Roll20 tabletop (Jumpgate).
As always, if something behaves oddly, tell me what you did and what happened, and I'll take a look. Many of my scripts are posted early on my Patreon
