Bump Update v0.2.25 -- Added several command line parameters, including --ids to specify tokens to manipulate. Added an API Interface for other scripts. New arguments: --slave -- Acts like !bump-slave below. --push -- When used with --slave , if the selected token is on the Objects Layer, it will be pushed to the GM Layer. --unslave -- Acts like !bump-slave below. --ids <token_id> [<token_id> ...] -- Optional list of ids to perform the operation on. Useful for scripting events what reveal a whole swath of tokens. API Interface To require Bump for your script, add "Bump" to the "dependencies" property of your script.json : "dependencies": ["Bump"]
Function Reference Bump.Bump(ids) Toggle the layer for each token represented by the ids in the array ids . Tokens not already slaved in Bump will be ignored. The array is not checked for duplicates. Bump.Slave(ids,push=false) Adds each token represented by the ids in the array ids to Bump. If push is true, tokens on the objects layer will be pushed to the GM layer when slaved. Bump.Unslave(ids) Removes each token represented by the ids in the array ids from Bump. Update v0.2.24 -- Added support for UDL, including night vision and other factors ( Thanks Craig M. ) Update v0.2.21 -- Added LDL Light Multiplier to copied attributes of the master token. (Thanks Craig M. ) Update v0.2.18 -- Added auto unslave and no bars to the configuration. Added Help: Bump handout. (Thanks Tod L. , Carl H. , Joe ) Turning on Auto Unslave in the configuration will cause the slave token (often seen as a green aura) to be removed when you make a token visible by putting it on the TokenLayer. When paired with Auto Slave, this lets you stay pretty much only on the Token Layer and still control all your things. Turning on No Bars on Slave in the configuration will cause the Slave token to only mirror the current value in each bar, excluding the max value and not linking to the attribute. This lets you still adjust the values, but doesn't give you double bars, which is especially nice if you're using an alternate bar position/configuration (which the API currently has no access to). There is now a Help: Bump handout created and maintained with the current help for the script. (see latest TokenMod update for details on how that works). Update v0.2.17 -- Added the ability unslave tokens with the !bump-unslave command. (Thanks GenKitty!) Update v0.2.16 -- Will now force visibility of bars and auras off for players on each change to a token (master or slave). (Thanks Joe !) Update v0.2.14 -- Fixed bug where names get turned on for slave tokens always. Now the slave token does not get a name if it's a GM only token, and only gets a name for player tokens if the master player token has its name turned on. (Thanks Jay R. !) Update v0.2.13 -- Added support for players to Bump their tokens and see the invisible colored square to move around the map. Bumped player tokens won't be visible to players that can't control them (unless that rogue left his torch burning!). Additionally, you can not set Status Markers on the slave token for a bumped token. Setting a status that is on the master token will remove it, setting one that isn't will add it, and setting a status with a number will add that number to the status on the master. Status Markers are then cleared from the slave to preserve their invisibility. (Thanks Refugee !) Update v0.2.12 -- Fixed issue that prevented Bump from starting up. Update v0.2.7 -- Reverted a change to push the left margin of help into the space under chat avatars. Disabling chat avatars was truncating the help display down the left side. Also removed an unnecessary warning about !bump'ing a token that didn't have a slave. (Thanks Three of Swords !) Update v0.2.6 -- Bump will now automatically repair and cleanup any broken associations with master and slave tokens on startup. Additionally, I have cleaned up a few crash bugs with missing objects. Finally, the help and configuration UI is updated and more thoroughly documented. Features Slave Token Aura -- The created Slave Token is invisible to the players, but also serves a useful purpose of reminding you which tokens support Bump and where they are. Created slave tokens have an aura visible to the GM only. They have one color when Master Token is visible to players (defaults to green) and another when the Master Token is invisible to players (defaults to purple). Mirrored Operations -- Moving, Rotating, Scaling, Flipping, Renaming, Tinting, and Last Move are all mirrored between Master and Slave! Mirrored Bubbles -- Whatever you have the Master Bars set to, the Slave Bars mirror. Change one, it changes the other. Got some invisible monsters in an AoE? No problem. This includes Bars that are linked to a character sheet, which brings me to... Mirrored Represents -- Need to do a save or make a skill check? Slave Tokens have the same Represents as their Master, so they have the same Token Action bar and shift double clicking brings up the character sheet! Commands: !bump -- Swaps places between a token and it's counterpart if it has been added to Bump. If Auto Slave is on, it will add the token to Bump if it isn't already in it. If Auto Push is on, it will also push it to the GM Layer if it is on the Objects layer. !bump-slave -- Puts the selected token in Bump if it isn't there already. If Auto Push is on, it will also move the token to the GM Layer if it is on the Objects layer. --push -- The optional --push argument to !bump-slave causes the token to also be pushed to the GM Layer as if Auto Push was on. Configuration Settings: GM Layer (Visible) Color -- Sets the color that a slave token shows when the associated master token is visible to players. The slave token will be on the GM Layer and the master token will be visible to players on the Objects Layer. Click the button showing the color to be prompted to enter a new color in HTML color format. Show's a checkerboard for transparent. Objects Layer (Invisible) Color -- Sets the color that a slave token shows when the associated master token is invisible to players. The slave token will be on the Objects Layer and the master token will be hidden from players on the GM Layer. Click the button showing the color to be prompted to enter a new color in HTML color format. Show's a checkerboard for transparent. Auto Push -- Causes adding a token to Bump to also automatically push it to the GM Layer if it isn't already there. [Default: Off] Auto Slave -- Causes using the !bump command on a token that isn't in Bump to add that token to Bump. Auto Push applies to this addition. [Default: Off] Previous Release Notes: <a href="https://app.roll20.net/forum/permalink/8584976/" rel="nofollow">https://app.roll20.net/forum/permalink/8584976/</a> Git: <a href="https://github.com/shdwjk/Roll20API/blob/master/Bu" rel="nofollow">https://github.com/shdwjk/Roll20API/blob/master/Bu</a>... Support my work on If you use my scripts, want to contribute, and have the spare bucks to do so , go right ahead. However, please don't feel like you must contribute just to use them! I'd much rather have happy Roll20 users armed with my scripts than people not using them out of some sense of shame. Use them and be happy, completely guilt-free! Disclaimer: This Patreon campaign is not affiliated with Roll20; as such, contributions are voluntary and Roll20 cannot provide support or refunds for contributions.