A list of commonly used one-liners/code snippets for use in the Draconic Scripting language.
- Get Combatants from Targets
- Roll a Skill Check
- Load SVAR and overwrite from CVAR/UVAR
- Search Through a List of Dictionaries
- Get a Subclass for a certain Class
- Change Die Size based on Level
- Simple Text Paginiation
- Detect if the User asks for Help
- Optional Arguments
If you'd like to contribute, open an issue with the one-liner you'd like to add, what it does, and some example use cases for it!
(not always one line)
This takes any targets made with -t
8000
and tries to convert them into combatants, and then stores them in a list called combatants.
{{c = combat()}}
{{targets = args.get('t') if args.get('t') else []}}
{{combatants = [c.get_combatant(t) for t in targets if c.get_combatant(t)] if c else []}}This takes any targets or groups made with -t and tries to convert them into combatants, and then stores them in a list called combatants.
Drac1 Version
#Basic Variables
{{parse,c = argparse(&ARGS&),combat()}}
#Creates a list of targets that have been grabbed by -t
{{t = parse.get('t')}}
#tlist creates a list of combatants, either in their own list from the group, or by themselves. Combatants is a placeholder for the next line.
{{tlist, combatants = [c.get_combatant(x) or c.get_group(x).combatants for x in t],[]}}
#This searches for all the elements that are not lists and adds them to combatants, then joins the combatant-group list to the combatants list, allowing for everything to be in one list for further parsing.
{{[combatants.append(x) if not typeof(x)=='SafeList' else combatants.extend(x) for x in tlist]}}Drac2 Version
<drac2>
#Basic Variables
parse, c = argparse(&ARGS&), combat()
#Creates a list of targets that have been grabbed by -t
targets = parse.get('t')
#Combatants is a placeholder for the next line.
combatants = []
#This is an if statement for targets that checks if an element in it is a combatant, and appends them to the combatants list, else it gets the list of combatants from the group and joins it to the combatants list, allowing for everything to be in one list for further parsing.
for x in targets:
if (combatant := combat().get_combatant(x) ):
combatants.append(combatant)
else:
combatants += combat().get_group(x).combatants
</drac2>from TheReverendB#1377 Robbe#7964
This creates a roll string based off of a skill and provided arguments (-b, adv/dis) along with grabbing some csettings like Reliable Talent and a Reroll number, if any.
!alias skillroll echo <drac2>
# assign variables
a,ch=argparse(&ARGS&), character()
# grab the first argument and match it to a skill or default to perception. Use `.replace()` to pull out any spaces and `.lower()` to make everything lowercase incase someone enters "SleighT of Hand". You can skip this line if you are only going to be using a specific skill, and enter the skill manually in the vroll(), or make your own list of skills to pull from.
skill = ([x for x,y in ch.skills if '&1&'.lower().replace(' ','') in x.lower()]+['perception'])[0]
# construct our skill roll, adding proficiency or expertise automatically via .d20(), rerolling 1s for Halfling Luck, applying Reliable Talent if proficient or expertise found in skill along with parsing for advantage/disadvantage and bonuses from our args.
# grab adv/dis from our parsed args and make it a boolean. adv=True, dis=False, neither is None.
adv = a.adv(boolwise=True)
# grab the reroll number if the character has the csetting reroll or default to None
reroll_number = ch.csettings.get("reroll", None)
# grab a minimum from our args like a standard !check, (-mc #) or set it to 10 if the character has the csetting 'talent' set to True and has proficiency or expertise in the chosen skill (but not JoAT).
minimum_check = a.last('mc', None, int) or (10 if ch.csettings.get("talent", False) and ch.skills[skill].prof>=1 else None)
# add bonuses, if any and add them to our roll. We can also parse our args for the commonly used 'guidance' snippet.
bonus = ("+"+a.join('b', '+', '') if a.get('b') else '') + ('+1d4' if a.get('guidance') else '')
# put all those arguments in the proper places in our d20() function, inside a vroll().
r = vroll(ch.skills[skill].d20(adv, reroll_number, minimum_check)+bonus)
# return our roll, replacing the oddly formatted skills with properly spaced plain text.
return f"Your {skill.replace('H', ' h').replace('O', ' o')} roll:\n{r}"
</drac2>This loads an SVAR as a dictionary from JSON and then tries to update the JSON using a CVAR/UVAR. Used for server settings with local overrides.
Replaceables:
varname- The variable you wish to store the C/U/SVAR in.CVAR_NAME- The name of the CVAR/UVAR.SVAR_NAME- The name of the SVAR.
{{varname = load_json(get_svar('SVAR_NAME', '{}')).update(load_json(get('CVAR_NAME', '{}')))}}This will search through a list of dictionaries to compare a value in the dictionary to a certain string.
To make it an exact search, replace in with ==. To make it case-sensitive, remove the two .lower()
Replaceables:
search_var- The variable that we are searching forsearch_key- The key in each dictionary we are looking at.search- The list we are looking through.out- The resulting intersection (List of dictionaries that match the search.)
{{out = [x for x in search if search_var.lower() in x["search_key"].lower()]}}from TheReverendB#1377
This will get the player's subclass for a certain class. Will only work if said player has setup their character with the !level alias. If the player does not have a subclass, it will be "", an empty string.
Replaceables:
sClass- The variable to store the subclass in.XLevel- The Class you want to use.ClericLevel,BardLevel, etc.
{{sClass=load_json(get("subclass", "{}")).get("XLevel", "")}}from TheReverendB#1377
This will create a dice string where the die string changes based on the character's level. The example shown below is for Monk's Martial Arts die.
Replaceables:
dice- The variable to store the dice string in.
{{L=level}}
{{dice = f"1d{4+2*((L>4)+(L>9)+(L>15))}"}}from Croebh#5603
This takes a string and splits it into a bunch of smaller strings so that it doesn't break fields.
Replaceables:
textList- Variable to store the list of strings in.1000- The maximum length for each string.text- The string that is split up.
{{textList = [text[i:i+1000] for i in range(0, len(text), 1000)]}}This checks if the user has asked for help by specifiying help or ? as an argument, or by specifying no arguments.
Replaceables:
args- Variable that has a list of arguments (usually called via&ARGS&)help- Variable to store the value of if the user needs help or not.
help = args[0].lower() in '?help' if args else TrueThis allows you to get arguments that can be optional. To add more arguments, put more variables on the left side, and increase the amount of "N/A", as well as change the 3 to however many arguments you have.
Replaceables:
"N/A"- What the variable should be if the user doesn't specify one. Possible option:Nonearg1- Variable for first argumentarg2- Variable for second argumentarg3- Variable for third argument
{{arg1, arg2, arg3 = (&ARGS& + ["N/A", "N/A", "N/A"])[:3]}}