This script allows you to set tokens to carry each other, either as a character holding an item, or as a mount carrying a rider. The carried token will always set its position to that of the carrying token. When you move the carrier around, the carried token will follow.
When this script is installed, it creates a CarryTokensMenu macro which displays a menu for this script in the VTT's chat. This menu has the following commands:
This command allows you to have a token carry another above it on the Z-axis. This is most helpful when you need a large token such as a mount to carry a smaller token such as a rider.
To use this, first select the carrier token and then click the Carry Above command. When prompted, click on the token you want to carry.
This command allows you to have a token carry another below it on the Z-axis. This is most helpful when you need a token to carry a token of the same size or smaller, for example when you want a character to carry an item such as a torch.
To use this, first select the carrier token and then click the Carry Below command. When prompted, click on the token you want to carry.
This command makes a token drop another token it is carrying.
To use this, select the carrier token and then click the Drop by Name command. When prompted, enter the name of the token you want to drop.
You can also cause a token to stop being carried by moving it away from the token carrying it.
This command makes a token drop all other tokens it is carrying.
To use this, select the carrier token and then click the Drop All command.
My scripts are provided 'as-is', without warranty of any kind, expressed or implied.
That said, if you experience any issues while using this script, need help using it, or if you have a neat suggestion for a new feature, please shoot me a PM: https://app.roll20.net/users/46544/ada-l
When messaging me about an issue, please be sure to include any error messages that appear in your API Console Log, any configurations you've got set up for the script in the VTT, and any options you've got set up for the script on your game's API Scripts page. The more information you provide me, the better the chances I'll be able to help.
If you would like to show your appreciation and support for the work I do in writing, updating, maintaining, and providing tech support my API scripts, please consider buying one of my art packs from the Roll20 marketplace:
https://marketplace.roll20.net/browse/publisher/165/ada-lindberg