Hashtags - raeleus/Hashtag-DnD GitHub Wiki
The following are the hashtags that players are allowed to use. Parameters listed inside of parentheses are optional.
Basic Hashtags
These hashtags do not require a character to be specified.
#roll
(advantage|disadvantage)
(dice_value)
Rolls a die/dice and shows the result. dice_value can be in the following formats 5d20 or d20 or 20. The parameters can be listed in any order.
#generatename
(male|female)
(fantasy|modern|scifi|nordic)
Synonyms: name, randomname, makename, createname
Retrieves a random name from a list of names in the specified gender and genre. The parameters can be listed in any order.
#shownotes
Synonyms: notes, viewnotes
Shows all the notes.
#note
(message)
Synonyms: takenote, setnote, createnote, remember
Adds the specified message as a note. If the message is not specified, the last action's text will be saved as a note. Keep in mind that player adventures have a limited amount of state storage (an unspecified amount) so avoid saving too many notes. Quotes are not necessary.
#clearnotes
Removes all notes.
#removenote
value
Synonyms: erasenote, deletenote, cancelnote
Removes the specified note as indicated by the number listed in #shownotes
. To delete multiple notes, type the numbers with spaces or commas between them. This is safer than calling #removenote
multiple times because the numbers shift as notes are deleted.
Characters
These hashtags require a character to be specified.
#setup
Synonyms: create, generate, start, begin, party, member, new
Launches the create character setup.
#bio
Synonyms: biography, summary, character, charactersheet, statsheet
Shows the character's abilities, skills, spells, inventory, and everything else about this character.
#renamecharacter
new_name
Synonyms: renameperson
Renames the character to the new name. All abilities, skills, inventory, etc. will remain the same. Quotes are not necessary.
#clonecharacter
new_name
Synonyms: clone, cloneperson, copycharacter, copyperson, duplicatecharacter, duplicateperson, dupecharacter, dupeperson
Copies the abilities, skills, inventory, etc. of the current character to a new character with the name new_name. Quotes are not necessary.
#setclass
class
Synonyms: class
Sets the class of the character for player reference. Quotes are not necessary.
#setsummary
summary
Synonyms: summary
Sets the summary of the character for player reference. Quotes are not necessary.
#sethealth
value
Sets the character's health to specified value. It's capped at the character's max health.
#heal
value
Synonyms: mend, restore
Increases the character's health by the specified value. It's capped at the character's max health.
#healparty
value
or dice_roll
Synonyms: healcharacters
Increases the health of all party characters' by the specified value or dice_roll.
#damage
value
or dice_roll
(enemy)
Synonyms: hurt, harm, injure
Decreases the enemy's health by the specified damage or dice_roll. If an enemy isn't specified, the character calling the command is damaged. Reaching 0 causes the character to become "unconscious". Quotes are not necessary.
#setac
value
Synonyms: setac, setarmorclass, ac, armorclass
Sets the armor class of the character. The default is 10
#rest
Synonyms: longrest, shortrest, sleep, nap
Sets all of the characters' health to their maximums. Use #shortrest
to only restore half health. This command increases the day counter and displays the number of days since your adventure began.
#showday
Synonyms: showdate, day, date
Shows the number of days since your adventure began.
#setday
Synonyms: setdate
Sets the number of days since your adventure began.
#setxp
value
Synonyms: setexperience, setexp, setexperiencepoints
Sets the character's experience to the specified value.
#addxp
(party)
value
Synonyms: addexperience, addexp, addexperiencepoints, experience, exp, gainxp, gainexperience, xp, experiencepoints
Increases the character's experience by the specified value. The player is notified if there is a level up. If the parameter party is specified, xp will be added to the entire party instead. Parameters can be listed in any order.
#setautoxp
value
Synonyms: autoxp
Automatically increases the experience of all party members when a #try
, #attack
, or #cast
is called. The amount of experience is scaled based on the difficulty class of the check with any check 20 or higher will result in the maximum specified by value. Set to 0 to disable.
#showautoxp
Shows the value of the auto xp.
#levelup
Synonyms: level
Increases the character's experience by the exact amount needed to reach the next level.
#setdefaultdifficulty
(difficulty_class or effortless|easy|medium|hard|impossible)
Synonyms: defaultdifficulty, setdefaultdc, defaultdc, setdefaultac, defaultac, setdifficulty, difficulty, dc
Sets the default difficulty for #check
, #try
, #attack
, and #cast
when a difficulty is not specified. The normal default is 10 (easy). If you do not pass any parameters, the default will be set to 10 (easy).
#showdefaultdifficulty
Synonyms: defaultdifficulty, setdefaultdc, defaultdc, setdefaultac, defaultac, setdifficulty, difficulty, dc
Shows the default difficulty for #check
, #try
, #attack
, and #cast
when a difficulty is not specified. The normal default is 10 (easy).
#showcharacters
Synonyms: showparty, showteam, characters, party, team
Lists all current characters and their classes/summaries.
#removecharacter
name
Synonyms: deletecharacter, erasecharacter
Removes the character that has the indicated name.
Character Checks
These hashtags require a character to be specified.
#check
(ability|skill)
(advantage|disadvantage)
(difficulty_class or effortless|easy|medium|hard|impossible)
Synonyms: checkstat, checkstatistic, checkattribute, checkability, checkskill, skillcheck, abilitycheck
Rolls a d20 and compares the result (modified by the character's ability/skill) to the specified difficulty. The parameters can be listed in any order.
#try
(ability|skill)
(advantage|disadvantage)
(difficulty_class or effortless|easy|medium|hard|impossible)
task
Synonyms: tryto, tries, triesto, attempt, attemptto, attemptsto, do
Attempts to do the task based on the character's ability/skill against the specified difficulty. The parameters can be listed in any order, except that the task needs to be last. Quotes are not necessary.
#attack
(ranged)
(advantage|disadvantage)
(ac or effortless|easy|medium|hard|impossible)
target
Synonyms: strike, ambush, assault, fireat, fireon
Attacks the specified target with a melee (the default) or ranged attack. The roll is compared against the specified AC which will determine if the attack succeeds or misses. If the AC is not specified, the default AC or the AC of the opponent in combat will be used. The parameters can be listed in any order, except the target must be listed last. Quotes are not necessary.
#cast
(advantage|disadvantage)
(difficulty_class or effortless|easy|medium|hard|impossible)
spell
(target)
Synonyms: castspell, castmagic, castincantation, castritual, castsspell, castsmagic, castsincantation, castsritual
Character will cast the indicated spell if the spell is in their spellbook. It will be a targeted spell if a target is indicated. The roll is modified by the spell casting ability of the character. You may type a phrase without quotes for spell such as "cast fire bolt at the giant chicken". If the difficulty is not specified, the default difficulty or the AC of the opponent in combat will be used. The parameters can be listed in any order, except the target must be listed last. Quotes are not necessary.
Abilities
These hashtags require a character to be specified.
#setability
ability
value
Synonyms: setstat, setstatistic, setattribute, changestat, changestatistic, changeattribute, changeability, updatestat, updatestatistic, updateattribute, updateability, stat, attribute, ability
Adds the ability to the character if necessary and sets it to the specified value. Quotes are required for abilities with spaces.
#showabilities
Synonyms: showstats, stats, viewstats, abilities, viewabilities, showstatistics, statistics, viewstatistics, showattributes, attributes, viewattributes
Shows the character's list of abilities.
#removeability
ability
Synonyms: removestat, deletestat, cancelstat, deleteability, cancelAbility, removestatistic, deletestatistic, cancelstatistic, removeattribute, deleteattribute, cancelattribute
Removes the ability from the character's list of abilities. Quotes are not necessary.
#clearabilities
Synonyms: clearstats, clearstatistics, clearattributes
Removes all abilities from the character.
#setspellability
ability
Synonyms: setspellstat, setspellstatistic, setspellcastingability, changespellstat, changespellstatistic, changespellability, changespellcastingability
Sets the ability that affects the modifier for #cast. Quotes are not necessary.
#setmeleeability
ability
Synonyms: setmeleestat, setmeleestatistic, changemeleestat, changemeleestatistic, changemeleeability
Sets the character's ability modifier that affects melee attacks. Quotes are not necessary.
#setrangedability
ability
Synonyms: setrangedstat, setrangedstatistic, changerangedstat, changerangedstatistic, changerangedability
Sets the character's ability modifier that affects ranged attacks. Quotes are not necessary.
Skills
#setskill
skill
(ability)
value
Synonyms: changeskill, updateskill, skill
Adds the skill to the character if necessary, and associates it with the specified ability and value. The ability is optional only if this is an existing skill. New skills need an ability specified.
#showskills
Synonyms: skills
Shows the character's list of skills
#removeskill
Synonyms: deleteskill, cancelskill
Removes the skill from the character's list of skills.
#clearskills
Removes all skills from the character.
Inventory
These hashtags require a character to be specified.
#take
(quantity)
item
Synonyms: steal, get, grab, receive, loot
Adds the specified quantity of item to the character's inventory. If a quantity is omitted, it's assumed to be 1. The words the, a, and an are ignored. Quotes are not necessary.
#buy
(buy_quantity)
buy_item
(sell_quantity)
sell_item
Synonyms: purchase, barter, trade, swap, exchange
Adds the specified buy_quantity of the buy_item to the character's inventory and also removes the sell_quantity of sell_item. If quantities are omitted, they are assumed to be 1. Quotes are necessary for items with spaces in the name. The words for, with, the, a, and an are ignored.
#sell
(sell_quantity)
sell_item
(buy_quantity)
buy_item
Just like #buy
, but with the parameters reversed. Adds the specified buy_quantity of the buy_item to the character's inventory and also removes the sell_quantity of sell_item. If quantities are omitted, they are assumed to be 1. The words for, with, the, a, and an are ignored. Quotes are necessary for items with spaces in the name.
#drop
(quantity or all|every)
item
Synonyms: remove, discard, leave, dispose, toss, throw, throwaway, trash, donate, eat, consume, use, drink, pay, lose
Removes the specified quantity of item from the character's inventory. If a quantity is omitted, it's assumed to be 1. The words the, a, and an are ignored. Quotes are not necessary.
#give
other_character
(quantity or all|every)
item
Synonyms: handover, hand, gift
Removes the quantity of item from the character's inventory and adds it to the other_character's inventory. If a quantity is omitted, it's assumed to be 1. The words the, a, and an are ignored. Quotes are not necessary for the item.
#renameitem
original_name
new_name
Synonyms: renameobject, renamegear, renameequipment
Renames the item indicated by original_name to the new_name. The quantity remains the same. Quotes are necessary for items with spaces in the name.
#inventory
Synonyms: inv, backpack, gear, showinv, showinventory, viewinventory, viewinv
Shows the items in the inventory of the character.
#clearinventory
Synonyms: clearinv, emptyinventory, emptybackpack, clearbackpack, emptygear, cleargear
Removes all items from the character's inventory.
Spells
These hashtags require a character to be specified.
#learnspell
spell
Synonyms: learnmagic, learnincantation, learnritual, memorizespell, memorizemagic, memorizeincantation, memorizeritual, learnsspell, learnsmagic, learnsincantation, learnsritual, memorizesspell, memorizesmagic, memorizesincantation, memorizesritual, learn
Adds the specified spell to the character's spellbook. Creates a story card if necessary. Quotes are not necessary.
#forgetSpell
spell
Synonyms: forgetmagic, forgetincantation, forgetritual, forgetsspell, forgetsmagic, forgetsincantation, forgetsritual, deletespell, deletemagic, deleteincantation, deleteritual, deletesspell, deletesmagic, deletesincantation, deletesritual, cancelspell, cancelmagic, cancelincantation, cancelritual, cancelsspell, cancelsmagic, cancelsincantation, cancelsritual, removespell, removemagic, removeincantation, removeritual, removesspell, removesmagic, removesincantation, removesritual, forget
Removes the specified spell from the character's spellbook. Quotes are not necessary.
#clearspells
Synonyms: clearmagic, clearincantations, clearrituals, forgetallspells, forgetallmagic, forgetallincantation, forgetallritual
Removes all spells from the character's spellbook.
#spellbook
Synonyms: spells, listspells, showspells, spelllist, spellcatalog, spellinventory
Shows the list of spells that the character has learned.
Combat
#setupenemy
Synonyms: createenemy
Follow prompts to create an enemy from a template or completely from scratch. It will be added to the existing encounter if there is one already specified.
#encounter
(funny|easy|medium|hard|boss|god or cr)
Synonyms: startencounter
Generate an encounter from the specified list. If a list is not specified, it will default to "easy" You can instead provide a number as a challenge rating which will scale encounters from the appropriate list and scale their difficulty."
#showenemies
Synonyms: enemies
Shows the list of current enemies
#addenemy
name
health
ac
hitModifier
damage
initiative
spells
Adds the specified enemy to the list of enemies. health, ac, hitModifier, damage, and initiative can be numbers or dice rolls such as 3d6+5. Type the name in quotes if the name contains a space. The rest of the parameters can be a list of spells. Each spell must be typed in quotes if it has a space. If the spell does damage, write the name and damage roll in the following format: "Ray of Frost5d10"
#removeenemy
name
or index
Removes the enemy as specified by the name or index. To delete multiple enemies, type the numbers with spaces or commas between them. This is safer than calling #removenote
multiple times because the numbers shift as enemies are deleted. Quotes are not necessary.
#initiative
Assigns initiative to all characters and enemies. This begins combat.
#turn
Synonyms: doturn, taketurn
Updates the turn to the next character in combat. If it is an enemy, the enemy will attack. If it's a player character, the system will allow the player to take their turn. If there are no enemies left or all the player characters are dead, combat ends.
#repeatturn
Synonyms: repeat
Repeats the turn. If it is currently an enemy's turn, it will attack or cast another spell again.
#block
Synonyms: parry, nullify, invalidate
Reverses the damage that has been inflicted in the last turn. This applies to damage on characters and enemies.
#flee
(difficulty_class or automatic|effortless|easy|medium|hard|impossible)
Synonyms: retreat, runaway, endcombat
Attempt to flee from combat. If the difficulty is not specified, the default difficulty will be used instead.
Locations
These hashtags do not require a character to be specified. It is assumed the entire party is moved from one location to the other.
#createlocation
[(x)
(y)
or (here|far)
or (distance)
] location_name
Synonyms: makelocation, generatelocation, addlocation, setlocation, createplace, makeplace, generateplace, addplace, setplace, createtown, maketown, generatetown, addtown, settown, createvillage, makevillage, generatevillage, addvillage, setvillage, createcity, makecity, generatecity, addcity, setcity, updatelocation, updateplace, updatetown, updatevillage, updatecity
Creates a location at the given coordinates. The coordinates must be integers. If the coordinates are not provided, they are randomized within a range of 10 units from the party's current location. You can also use "here" to indicate that the location is at party's coordinates. "far" indicates that the coordinates will be randomly generated 50-100 units away. You may also just specify a distance. Multiple locations may exist at the same coordinates. A story card is created for the location. Quotes are not necessary.
#goto
(x)
(y)
or (location_name)
or `(location_number)
Synonyms: gotolocation, golocation, movetolocation, traveltolocation, travellocation, gotoplace, goplace, movetoplace, traveltoplace, travelplace, gototown, gotown, movetotown, traveltotown, traveltown, gotovillage, govillage, movetovillage, traveltovillage, travelvillage, gotocity, gocity, movetocity, traveltocity, travelcity, go, moveto, move, travelto, travel
Makes the party travel to the location specified by the coordinates (as integers), location_name, or location_number. You must provide at least one of these. If the location does not exist, it is created at your current coordinates. If you only specify coordinates, you will go to the first location at those coordinates. Quotes are not necessary.
#goto
distance
location_name
Synonyms: gotolocation, golocation, movetolocation, traveltolocation, travellocation, gotoplace, goplace, movetoplace, traveltoplace, travelplace, gototown, gotown, movetotown, traveltotown, traveltown, gotovillage, govillage, movetovillage, traveltovillage, travelvillage, gotocity, gocity, movetocity, traveltocity, travelcity, go, moveto, move, travelto, travel
An alternative of the above. Travels the specified distance towards the location indicated by location name. Quotes are not necessary
#gonorth
(distance)
Synonyms: north, goup, up, n
The party travels north the given distance (an integer). If distance is not specified, it is assumed to be 1.
#gosouth
(distance)
Synonyms: south, godown, down, s
The party travels south the given distance (an integer). If distance is not specified, it is assumed to be 1.
#goeast
(distance)
Synonyms: east, goright, right, e
The party travels east the given distance (an integer). If distance is not specified, it is assumed to be 1.
#gowest
(distance)
Synonyms: west, goleft, left, w
The party travels west the given distance (an integer). If distance is not specified, it is assumed to be 1.
#getlocation
Synonyms: location, getcoordinates, coordinates, getcoords, coords, showlocation
Returns the coordinates that the party is at. It will also list a location if a location was specified when using #goto.
#showlocations
(sort)
Synonyms: showplaces, showtowns, showvillages, showcities, locations, places, towns, villages, cities
Shows a list of all discovered locations with their coordinates and their distance from the party's current location. If the parameter "sort" is added, the locations will be listed by their distance to the party. Note that the location numbers will only be displayed in the unsorted list.
#removelocation
location_name
or location_number
Synonyms: deletelocation, eraselocation, removeplace, deleteplace, eraseplace, removetown, deletetown, erasetown, removevillage, deletevillage, erasevillage, removecity, deletecity, erasecity
Removes the specified location by location_name or location_number as listed in #showlocations
. To delete multiple locations, type the numbers with spaces or commas between them. This is safer than calling #removenote multiple times because the numbers shift as locations are deleted. Quotes are not necessary.
#clearlocations
Synonyms: eraselocations, deletelocations, resetlocations
Deletes all discovered locations.
#map
Synonyms: showmap
Generates an 11x11 ASCII map of the surrounding locations centered at the party location. The @ symbol is the party location.
Stragedy Card Game
#basicdeck
Synonyms: stragedybasicdeck
The basic cards necessary to enjoy the Stragedy card game are added to the character's inventory.
#cardshop
Synonyms: stragedyshop, cardstore, stragedystore
This opens the stragedy card shop where characters can spend gold to purchase cards. The inventory is randomized based on the day.
#addcard
(card_name
or card_rarity
)
Adds the specified card or randomly generates a card and adds it to the character's inventory. Specifying a rarity (common, rare, epic, legendary) will choose a random card from those lists. Valid card names are a, ace, j, jack, q, queen, k, king, ?, joker, w, witch, p, priest, b, brigand, and any number 2-10.
#stragedy
(automatic|effortless|easy|medium|hard|impossible)
Synonyms: playgame, game, startgame, begingame, playcards, playstragedy, startstragedy, beginstragedy
Initiates a game of Stragedy, a card game played against an AI opponent. Specifying a difficulty (default is easy) grants the opponent a corresponding deck. See the guide here.
Danger Zone
These hashtags do not require a character to be specified.
#reset
Synonyms: cleandata, cleardata, resetdata, resetsettings, clearsettings, profile
Removes all characters, locations, and notes. Changes all settings to their defaults. Use with caution!
Other
These hashtags do not require a character to be specified.
#version
Synonyms: ver, showversion
Returns the current version of this scenario.
#help
The long ass help menu with all the hashtags. I am paid by lines of codes.