No problem. =D 1. The on does mean all players see light (You can actually use any of: '1','on','yes','true','sure','yup','-' for on, or anything else for off.). 2. Ok, a short API lesson then: Evaluation of Commands. When you type a command in chat, it goes through several stage (conceptually certainly, but if you think of the this way, it will help you understand), here they are: You type in the command and hit enter Everything in a @{...} or ?{...} gets evaluated. This means that either the @{...} is replaced by the attribute/target/selected value, or you are prompted for a value and the ?{...} is replaced with what you provide. Inline Rolls are evaluated, so all the [[...]] things that were typed are replaced with the results (conceptually) The message is sent to the API So, for example if you type in " !foo [[3+2d6+@{foo|hp}]] ", the API will see this as (roughly) " !foo 24 ". So, with that understanding, the API sees 2 and 3 in my examples above as the same thing. The only difference is where the arguments come from in steps 1 & 2 in the Evaluation of Commands . Also, the ?{target|...} syntax: @{target| <stuff> } will prompt you for a token to get <stuff> from. <stuff> can take two forms. It can either be an attribute (or pseudo-attribute) like bar1 or token_id , or it can be a label followed by an attribute: @{target|The token who you want to adjust|token_id} This will pop up the select box prompting you to select a token and display the message "The token who you want to adjust", then during step 2 above it will be replaced by the token's token_id. Additionally, if you use the same label multiple times, it will only be asked once and then used in all of the commands of a single macro/chat message: !cmd1 @{target|Foo|token_id}
1cmd2 @{target|Foo|token_id} This will only ask you once to select something. That's the reason the labels in the above are "Token 1", "Token 2" etc. Ok.. hopefully that actually added to your understanding... =D So, to your question: You can blend all 3 of my examples above happily. With a token selected, you can do: !torch 5 5 on -Jb8EyJkOiE9DRuWClpf @{target|Token 1|token_id} This will set the radius to 5 for the selected token, the token with token_id -Jb8EyJkOiE9DRuWClpf, and the token you select when prompted by the @{target|Token 1|token_id}. You have some options about what you want to do. If it's pretty easy for you to select (and you can select as many as you want) tokens, using example 1 will be pretty easy. If you want to be able to do several at once but don't want to select them first (maybe you only want to use the mouse and don't want to have to hold shift or whatever) you can use example 3. If you wanted to create a reset macro that always set your players tokens to 30' light, 15' dim, you could find their token_ids (just write @{target|token_id} in the chat and you'll have them), and write a macro with the syntax in example 2. Caveat though, token_ids are specific to individual tokens on a particular page. If a character has multiple tokens (say, across multiple pages), each one has it's own token ID, so this is really only useful in limited circumstances. Hopefully that clears it up... I'm a bit wordy.. sorry! =D
