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

API for Posting Room Descriptions on Token Movement

Hi all, I’m looking for an API/mod that can automatically post room descriptions to chat when players’ tokens move into or near certain areas on the map. I’ve experimented with It’s a Trap! — it sort of works, but I’m running into issues using it just for descriptive text rather than traps. I’ve also seen suggestions about adapting trap/teleport scripts or using proximity-based scripts (like WorldMapDiscovery ), but I’m not sure which direction is best. Ideally, I’d like something that: Detects when a token crosses into a defined area. Posts a preset description to chat (once per entry, ideally without spamming). Lets me set up multiple areas with different text. Is It’s a Trap! the right tool for this, or is there a script better suited to handling descriptive triggers? Thanks!
So I'm actually working on something that does this using ScriptCards triggers. Some folks in the ScriptCards discord have tested it and I'm working on incorporating their feedback to make it better. Here is a link to it. There is a utility scriptcard to create and manage things and change configuration and the ScriptCard trigger itself. If you want to test it out, I'm looking for any suggestions or improvements. I have a number of improvements already listed on Github  and you can provide any feedback you have there, in this thread, or on the ScriptCards discord. The system right now supports teleporting, ambushes, playing an audio track, sending a description to chat, whispering a description to the GM, whispering a description to the triggering player, or triggering a custom ability. It does only work on pages with square grids right now, so no hex support.
Thanks, I will have a look
1758343466

Edited 1758343583
I have used It's a Trap to do that function for awhile but ended up using token markers on the map now. example so ignore the yellow/black - that is my teleporter pad but the Eye icon is for the players to interact with I have several different types of icons basically it's this Camera = Room Description. The moment you enter a room and see that icon, you can interact with it immediately. This uses the "Reporter API" and it will message the room description to the individual only. The eyeball = is a more detail version of the Camera. This will be specific details of what's in the room, on the desk, paper notes, etc This requires my players to be NEXT to the icon to interact with it and it will send them a private message The Fingerprint - also requires the players to be next to the icon to interact with it. It has 2 parts 1 - It has a Tooltip that you can hover your mouse cursor to see what the object is. If you want to know more about it, be next to the icon and interact with it, it will then go into detail and usually have some type of knowledge check. "You see a statue of a human sitting down with several birds around him" -- tooltip "this is the statue of a human form Bahamut - Roll me a religion check to see if you know more" when they click on the button I also have another Icon, the letter I This is a unique one in which, it reports the message for the entire party instead of privately. This is mostly lore/fluff or large areas descriptors. Everyone walks into a cave - you will see this icon, one person can click on it and it will reveal the entire cave descriptor. Height, smell, sound, etc and specific areas I will use the eye version.  -------------- but you have to teach and let the players know when they are able to interact with. They must be next to it. Just because you entered a room, the table is still 30ft away from you. You dont know whats on top of the table or in the drawers until you're next to it, then you can interact with the icon to learn more.