Macros

[AndrewD2]

Is there any list of all the built in macros, what they do and their timings?

 

[Aaron]

There isn't a timing for macros, they execute at whatever phase and priority the eval script they are used in has.

We don't have a comprehensive list (I think the tutorials go over a few), though I could make a list of the most common ones if you like.

 

[AndrewD2]

I'm basically trying to not have to go through the entire messageboard, tutorials, updates and such to find all the macros and what they do.

I figure something like this would also be a great resource for all the data set makers.

 

[Mathias]

If there are any macros you think we need to add to the "Reference Information" page in the documentation, please tell us which ones they are. That way, we don't have to answer this every few months for each new person - they're all already in our documentation.

 

[AndrewD2]

Alright, there appear to be 18 macros in the "Reference Information"

#applybonus[type, pick, bonus]
#applydr[type, bonus]
#applypenalty[type, pick, bonus]
#applyresist[type, bonus]
#applysr[bonus]
#applyvalue[type, bonus]
#competencebonus[pick, bonus]
#dc[ability_id]
#duration[ability_id]
#enhancementbonus[pick, bonus]
#hasability[ability_id]
#hasfeat[feat_id]
#makeclassskill[skill_id]
#skillranks[skill_id]
#totallevelcount[]
#trkmax[tracker_id]
#value[ability_id]
#value2[ability_id]

And then there another 18 I found in the FAQ file (The one with all the changes listed) that are not in the other section.

#attrbonus1[XXXX]
#attrvalue[]
#CPA[Id]
#extracrit[target weapon,damage text,source's name]
#extradamage[target weapon,damage text,source's name]
#Fame[Id]
#featlevelcount[]
#hasdeity[]
#hasrace[]
#hassubtype[]
#hastrait[Id]
#hastype[]
#hasvanity[Id]
#makespecskill[Id]
#PP[Id]
#situational[chosen save,bonus text,source's name]
#specvalue[XXX]
#TPA[ID]

Having those ones listed with their parameters would be nice. I'm not sure if there are more than those 36.

 

[AndrewD2]

Also while I'm at this is there any list of the predefined procedures and what they do?

 

[Aaron]

Here's a few more.

#levelcount[]
#attrbonus[]
#appenddesc[]
#value3[]
#value4[]

#skillbonus[]
#skillinnate[]
#hascondition[]
#hasarchetype[]
#hasvanity[]

Procedures are not listed anywhere users have access to, is there one in particular you're interested in?

 

[AndrewD2]

Aaron,

There is nothing in particular I'm interested in except everything. I'm the one that is doing the HL files for Rite Publishing and I want to make sure I have everything as correct and as efficient as possible.

I'm working up a reference guide and the more I can put in it the better it will be.

 

[Aaron]

I'm not comfortable dumping all our procedures on the boards, if you're working for one of our partners I'll talk with the bosses and see if it's alright to share in an e-mail or PM or something. Keep in mind that procedures do change from time to time.

 

[Mathias]

Procedures are so specific to where they're used that if you don't see them in context, you won't be able to re-use them in your own work.

So if you're looking for something existing that works like what you're trying to accomplish, and you see a procedure, you can use that procedure to do the same thing, but I don't see the use of listing them all out.

 

[AndrewD2]

Okeydokey. Thanks

 

[AndrewD2]

I see a couple of macros (#competencebonus and #applybonus) that basically have overlapping function. Is there a preferred way to go?

 

[Aaron]

No preference from me, whichever works.