Roll20 uses cookies to improve your experience on our site. Cookies enable you to enjoy certain features, social sharing functionality, and tailor message and display ads to your interests on our site and others. They also help us understand how our site is being used. By continuing to use our site, you consent to our use of cookies. Update your cookie preferences .
×
Create a free account

[Script] Ping Buddy now in One Click!

1690826324
keithcurtis
Forum Champion
Marketplace Creator
API Scripter
PingBuddy Ping Buddy is a utility script that provide s number of ping-related functions. Here is a  Video Demo . The video shows all functions except the ability to have  token focus ping only the owner of the token. That is detailed below. All functions are either accessed by chat commands, or automatically through keywords in token names or tooltip fields. Note that "Focus Ping" is the new terminology for what used to be called a "Ping Pull"—pulling one or more players to an area of a map. Ping Buddy is available fro One Click install. Follow a Party Token If you create a token and name it "Party", or set the tooltip to the word "Party", the screen will focus ping to the token whenever it is moved. This allows you to guide players around the map or across an overland map. This is done without the distracting circle animation. I developed this when trying to take players from one area of a city map to the next, while allowing them to keep their bearings. The constant animation and the need to click, drag, release, shift click and hold was tedious and messy. The circle animation is removed by temporarily setting the GM's player color to transparent, and then reverting it. It is possible if you make too many rapid movements in succession, it won't revert the color before running again and stick the GM color on transparent. If this happens, just re-assign the GM player color manually. If you set the "Party" token to be an invisible token (marking it with an aura only you can see), it allows you to center the player view to any area of the map without animation. If two or more party tokens are on the same page, the screen will focus ping only to the one that was last moved. Another use would be a board or wargame where you want to call attention to the last piece moved. Just make sure "Party" is in the nameplate or the Tooltip. More behaviors are explained below. Tooltip Codes Instead of naming the token "Party", you can set the token's tooltip to the word "Party" for the same behavior, and name the token as you will. There are four codes currently: Party : Behavior is same as naming the token "Party". All players will follow the token without animation. Ping :  Behavior is same as naming the token "Party", but all players will follow the token  with  animation. Pingme : Token will focus ping only the controller. They will see animation, but no one else will be affected. Pingmesilent :  Token will focus ping only the controller. They will  not  see animation, and no one else will be affected. This will only work if the player is on the page with the player flag. Capitalization does not matter. Pull Players to the Start of a Page Whenever the player flag is moved to a page, all players on that page will immediately be focus pinged to the "Party" token. The token may be moved to the gm layer if you wish, and players will be pulled to that part of the map. This is useful for encounter maps that don't start in the upper left corner. This part of the code is taken almost in entirety from a script by Nick Olivo (link below*). His code is much cleaner and nicer than mine. Thank you, Nick!  Find a Token  Find my token If a player types  !pingme  into chat, the screen will focus ping to the first token it finds that they control. If they control no tokens on the screen, the script will inform you. This is useful for large maps, or if a player loses track of their token in Dynamic Lighting or Fog of War. Find token by name If you type a name after  !pingme , separated by a space, the script  will find the first occurrence on the page of a token with that name. Ex. !pingme Bob Will focus ping the first token it finds named "Bob". Spaces and capitalization count. Pingme commands will only work if the player is on the page with the player flag. All of these functions are demoed in the video except the pingme tooltip codes, which were added later. *Thanks to Nick Olivo for most of the code on the page start function. His script can be found in its original form  here .
Thanks Kiethcurtis, I like this Mod script, especially on larger maps where players sometimes wander away. Question, I would like to create a macro that players can use to ping pull to their token without pulling the other players. Is this possible? I have tried putting Pingmesilent and Pingmesilent: in the players token tool tip bet it still pulls everyone when they run a macro that says !pingme or !pingme name . I don't like that when I am in the middle of looking at something and am unexpectedly and suddenly pulled away. Am I missing something here?
1691060288
keithcurtis
Forum Champion
Marketplace Creator
API Scripter
I'll double check when I get the chance (I am at Gen Con right now), but is there only one listed controller on those tokens?
keithcurtis, Yes, only one listed controller.
This is AMAZING! Is there a way to change the color of the animation? Right now, I have yellow.
1691193109
keithcurtis
Forum Champion
Marketplace Creator
API Scripter
Gallaher said: This is AMAZING! Is there a way to change the color of the animation? Right now, I have yellow. The API sends the ping and is treated like a player. API color is always yellow. I can specify a different user ID, but the script would need to know whose user ID to use. I handle the invisible ping by using the GM ID and temporarily setting that color to transparent. How do you envision the ping color being set, and in what use cases do you want to change it?
Oooooooh .... that makes sense. I thought it could be adjustable like the Radar script, where you can change the color of the waves. It's perfect as is, truly.