Hello! This is the guide document for the TUS Virtual Character Sheet. This app was designed as a way to store and edit Tabletop RPG Characters. At the moment, it only supports Dungeons and Dragons Fifth Edition, but if I ever have the time, I may add other systems! (Or I might add mobile support) (Or multilingual support maybe?)
I've been wanting to make one of these apps for several years now, primarily out of dissatisfaction with how other similar apps functioned. I don't like websites that force me to make accounts, or that have overcomplicated pages with gratuitous loading times, or that keep asking me to buy their things.
So I made my own app. I hope it stands up to the others, even though I'm just one person building this in my spare time.
Here's some notes on the more obscure parts of the app.
Characters can be in two states at any given time: Locked, and Unlocked. Characters will be unlocked when you first create them, but will otherwise default to being locked.
While a character is locked, none of their permanent details can really be changed; they can gain XP, they can heal or take damage, their inventory can change, and they can expend hit dice, features, and spell slots, but that's about it.
While a character is unlocked, all of their details are subject to change. Use this when first creating your character or leveling them up. Otherwise, keep your characters locked so you don't accidentally misclick and change things about them.
You can export your characters to text and save them in a file or note if you want to. Do this by clicking the 'Export' button while you have a character loaded.
You can then import this character back into the program (even on a different device!) by clicking the import button on the main menu, and then pasting the text.
This app comes with a built-in dice roller (which you'll find in the bottom left), which you're free to use to whatever extent you wish to.
You can type roll commands into the 'Type Roll Here...' box. These might be 1d6 or 2d10+strength or something more complicated like (str)d6>1dl (I promise this makes sense if you know what all the letters mean). So long as your command is valid (details on what you can do below), the roll should appear in the box above.
This process can be automated. You can add Macros to your items, features, and spells, allowing you to make those rolls at the click of a button (In the case of spells and features that have a certain number of uses, this will also deduct 1 from the appropriate spell slot or use tracker).
In fact, macros already exist for your ability scores and skills. Simply click them to make a skill check.
Finally, there will be a macro for whatever type(s) of hit dice your character has. These macros not only roll one of your hit dice, but will also restore that many hit points to your character automatically.
The most basic operations the dice roller supports are + and -. You can put these between numbers or dice or variables. To indicate which of these operations should go first, use brackets.
You can use any ability score name (or its 3-letter abbreviation) to represent your modifier in that skill (so 1d20+str will roll a d20 and add your strength modifier).
Furthermore, you can use any skill name, or the keywords proficiency (or prof) or spellcasting (or spell), to represent the skill's modifier, your proficiency bonus, or your spellcasting modifier, respectively.
If two skills have the same name (like, how all saving throws are just put under the name save), you can prefix the skill's name with the name of its associated ability score (so, investigation becomes intelligence|investigation, and to get your con save modifier, you'd type constitution|save or con|save.
You can roll as many dice as you would like at a time, by simply changing the number before the d (so, to roll three six-sided dice, type 3d6, and to roll a single d20, type 1d20, or just d20). If you would like to roll a number of dice equivalent to some other expression or value, like your strength modifier, you'll either need to place a space between the amount and the type (like str d6) or put brackets around the amount (like (str)d6).
You can further customize dice rolls by adding in modifiers after the roll, such as 4d6>1 (4d6, reroll 1s), or 3d20dl2 (3d20, drop the lowest 2). Possible modifiers are:
> will reroll any dice less than or equal to the value n, until all dice are above n.< does the above in reverse, ie. it forces all dice to be below n.dl will roll all dice, and then get rid of the lowest n of them. You can leave out the number to just drop a single die.dh will get rid of the highest n of themkl will roll all dice, and then keep only the lowest n of them. You can leave out the number to just keep the single highest die.kh will keep only the highest n of them.Modifiers apply in the order they are typed. If they ever force something that is impossible (like dropping more dice than currently remain), then the command will be considered invalid, and nothing will happen when you type it in.
You can make multiple rolls in a single command by seperating them by the keyword and, so if you want to make a rapier attack and roll both to hit and for damage at once, you might type 1d20+dex+prof and 1d8+dex. Finally, you can add names to your rolls using double quotes, like 1d20+dex+prof "To Hit" and 1d8+dex "Piercing Damage"