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

On the fence about subscribing for API access. Can this list of "mods" be achieved with it?

1763460153

Edited 1763460484
I am considering a Pro Subscription in order to have access to the Modding API, but I am both intimidated by the prospect of learning how to do it, and also unsure on the whole if it can even do what I would like to achieve with it I would like to use these tools in helping to run a campaign inspired by Pokemon Mystery Dungeon, and a lot of the randomly generated dungeon crawling would be significantly easier and I could automate certain aspects of it. I think my list of priorities are as follows: -When a player token passes over a specific tile, such as invisible tokens designating where a room is considered "entered", other tokens go from the GM layer to the Tokens layer. For example, items and enemies and stuff like that inside of a room become visible -When a player token moves over a token meant to represent an item, the item token is deleted and a message is sent in chat -When a player token passes over a token acting as an invisible trap on the floor, the trap becomes visible (going from the GM layer to the Token layer) and displays a message in chat -Under certain circumstances, if players are moving with arrow keys and have their token selected, deselect their token to give them pause -When a player is moving their token with the arrow keys, the camera moves an appropriate amount in order to follow their token Sorry if this is a lot to ask about all at once. But if some of, all of, or none of these are possible I would love to know before I commit to anything. Thank you so much!
1763478825
keithcurtis
Forum Champion
Marketplace Creator
API Scripter
Hi DakotaSpine! Let's look at these one at a time: -When a player token passes over a specific tile, such as invisible tokens designating where a room is considered "entered", other tokens go from the GM layer to the Tokens layer. For example, items and enemies and stuff like that inside of a room become visible This can be done without mods by using the foreground layer and conditional fading. -When a player token moves over a token meant to represent an item, the item token is deleted and a message is sent in chat -When a player token passes over a token acting as an invisible trap on the floor, the trap becomes visible (going from the GM layer to the Token layer) and displays a message in chat I think this could be done with "It's a Trap" mod, possibly in conjunction with the Foreground Layer -Under certain circumstances, if players are moving with arrow keys and have their token selected, deselect their token to give them pause Could sort of be done. The API can't select or deselect a token, but one could change the layer the token is on to the map layer temporarily, which would do the same thing, more or less. -When a player is moving their token with the arrow keys, the camera moves an appropriate amount in order to follow their token The Ping Buddy mod can do this. In short, it looks like most of your mods needs are "make something happen when a token reaches this spot". I think this is what It's a Trap does. It is also probably that ScriptCards has similar capability.
This is awesome news! I super appreciate all of this :) Another thing i'd like to ask about if I may while I have the time; if and when my subscription runs out, will my modded scripts cease to function? Or will existing ones still function, potentially letting me keep them as tools I can copy over to new dungeons?
If you do not have a Pro or Elite subscription, then using any API commands (ones that start with an !) will not work. Starting a chat message with a ! means that it gets sent to the Mod/API script server for processing there, but with a Free or Plus subscription you don't have that access so nothing happens. Any scripts that run in the background to change a token based on movement will not work either. However, if you used a script to do something 'permanent', like creating/updating a character sheet, adjusting token settings, creating dynamic lighting lines, etc. then those changes will remain in place. You just won't have the ability to use a Mod script to change them while you're not an active Pro/Elite subscriber. It's a similar question to using Dynamic Lighting. If you have a paid subscription and using Dynamic Lighting features, and then decide to downgrade to a Free account, all of the Dynamic Lighting features (DL lines, light & vision settings, etc.) you set up will still 'be there', but they are simply hidden from access. and unusable while you have a free account. If you later resubscribe, all of the lines are still in place and you can start using them again, and you wouldn't have to set everything up again.
So from what I am understanding, if I were to implement any mods that caused tokens to interact with each other for example, they would no longer work if my subscription expires?
DakotaSpine said: So from what I am understanding, if I were to implement any mods that caused tokens to interact with each other for example, they would no longer work if my subscription expires? Correct.
1763508604
keithcurtis
Forum Champion
Marketplace Creator
API Scripter
Scripts are active bits of code that run alongside your game in their own sandbox. They provide functionality to your game, but they don't change the game itself.  Think of the API as inviting a helpful invisible player who does all your drudge work for you. You can teach him to do all kinds of cool stuff, or hand him instructions that tell him how to do it himself. As soon as your subscription runs out, he goes on vacation on a tropical island, and no one is there to do his job. But he keeps all his skills and tools with him, and when you invite him back, he'll be back at his desk as if he never left.
1763511339
Andrew R.
Pro
Sheet Author
IMHO the best thing about a Pro subscription is Transmogrifier. Mods are close behind, then Storage Quota. ;)
Gotcha. That's a pretty good analogy for clearing things up, thank you for letting me know
1763512610
keithcurtis
Forum Champion
Marketplace Creator
API Scripter
DakotaSpine said: That's a pretty good analogy for clearing things up,.. I was unreasonably pleased with it. :D
Scriptcards can definitely do a lot of heavy lifting and Graitas3k has recently released a load of cool stuff achievable via triggers such as spawning in ambushes, traps ( I am convert from It's a Trap to this, YMMV), audio on reaching a spot, text on reaching a spot, teleports...and Kurt, author of Scriptcards,  also has Encounter Helper, which is so, so helpful in setting up encounters ahead of time if you don't use Gravitas3k's method. Scriptcards Discord server is where to find an immense amount of support, I could never go without SC now, totally recommend