Manual · Content and homebrew

Field reference

Every raw 5eTools field the importer reads, one table per entry type, generated from the importer itself.

name, source and page become the card's source line; entries becomes its text. The arrays map in a fixed order (items first, features before their class, classes before subclasses, spells before subclasses) so a later type can name an earlier one in the same file.

Items (item, baseitem)

Field in your fileWhat the sheet does with it
type, weaponCategory, dmg1, dmg2, dmgType, property, mastery — type a weapon, with its dice and propertiesAn attack row: the right ability, proficiency if you have the category, the damage die and type, the versatile die, and the 2024 mastery property.
ac, strength, stealth — type an armorArmor Class computed with the light/medium/heavy Dexterity cap, the Strength requirement, and disadvantage on Stealth while it is worn.
baseItemInherits the base weapon’s or armor’s stats, so a Longsword +1 only has to say what changes.
weight, valueCarried weight and coin in the inventory.
rarity, reqAttuneEvery effect on the item applies only while it is equipped and, if attunement is required, attuned; it takes one of your attunement slots.
bonusAc, bonusWeapon, bonusWeaponAttack, bonusWeaponDamage, bonusSpellAttack, bonusSpellSaveDc, bonusSavingThrowThe +N on that exact number, labelled with the item’s name wherever it shows.
bonusAbilityCheck, bonusProficiencyBonusReported in the preview, not mapped by the item importer. The sheet itself can take a bonus to a whole family of ability checks (modifies with an ability_checks target, in a _sheetling block); a bonus to the proficiency bonus has no target anywhere.
charges, recharge, rechargeAmountA charge counter on the item with its reset: dawn, a short rest or a long rest. Any other trigger leaves the counter manual, with a row saying so.
resist, conditionImmuneDamage resistance and condition immunity while equipped.
immune, vulnerableReported in the preview, not mapped by the item importer. Damage immunity exists on the sheet (grants_damage_immunity, in a _sheetling block); vulnerability has no effect kind.
ability, static, choose — static, or a plain addstatic raises the score to that value if it is lower (the gauntlets shape); a plain add raises it by that much. Both hold only while the item is worn. A choose is reported, not mapped.
modifySpeed, bonus, multiply, equal — static, bonus, equalWalking speed set or raised; a mode equal to walking speed. A multiply is reported, not mapped.
attachedSpells, resourceNameThe item’s spells as innate casts with their own uses per rest or per day. A cast that spends the item’s charges (resourceName) is offered only when the charge tracker exists.
uid, note, other, miscTags, entriesThe card’s text and its bookkeeping; nothing derives from these.

Classes (class, classFeature)

Field in your fileWhat the sheet does with it
hd, facesThe hit die: hit points at level 1 and on every level-up, and the Hit Dice you spend on a short rest.
proficiencySaving-throw proficiencies.
startingProficiencies, armor, weapons, tools, toolProficiencies, anyArtisansTool, skills, choose, from, count, full, optional — armor, weapons, tools, skillsProficiencies on the sheet; the skill choose is a wizard pick with that count; anyArtisansTool is a pick from the seventeen artisan’s tools. A full name (“martial weapons”) grants the family; optional proficiencies are printed, not granted.
startingEquipment, defaultData, default, goldAlternative, item, quantity, equipmentType, equipmentTypes, value, special, _, a, A — defaultData, with its _/a/A option listsThe starting kit lands in the inventory at creation, the first option of each choice. The gold-instead-of-kit option (goldAlternative) is not modelled and is reported.
classFeatures, classFeature, className, classSource, level, entries, gainSubclassFeature — one classFeature per levelA feature card that arrives at its level on level-up. An Ability Score Improvement entry does not become a card; it becomes the level at which level-up asks for an ASI or a feat. gainSubclassFeature marks the levels the subclass adds its own.
classTableGroups, title, colLabels, rowsSpellProgression, rows, spellcastingAbility, casterProgression, cantripProgression, preparedSpells, preparedSpellsProgression, spellsKnownProgression, spellsKnownProgressionFixed, spellsKnownProgressionFixedAllowLowerLevel, spellsKnownProgressionFixedByLevel — the slot table (rowsSpellProgression) with the caster fieldsSpell slots per level, cantrips known, how many spells you may prepare or know, and the ability behind your spell attack and save DC. The Prepare dialog counts against these. A plain rows table (Rages, Sneak Attack dice) is printed on the class card, not derived.
optionalfeatureProgression, featureType, progression, requiredA pick group (the invocation or metamagic shape) with the number known per level. Its options are the file’s optionalfeature entries carrying the same featureType.
resources — on a featureReported in the preview, not mapped. Declare the tracker in a _sheetling block instead.
consumes — on a featureThe feature gets a button that spends one use of the pool it names (amount for more). The pool is found by name, in your file first, then in the rules. A pool nothing declares makes no button, and the preview says so.

Subclasses (subclass, subclassFeature)

Field in your fileWhat the sheet does with it
className, classSource, shortNameWhich class the subclass belongs to. A shipped class by name (Fighter) or a class in the same file; the subclass is then offered at that class’s subclass level.
subclassFeatures, subclassShortName, subclassSource, level, entries — one subclassFeature per levelA feature card at its level. A container that lists refSubclassFeature entries shows once and grants the nested features beneath it.
additionalSpells — under preparedAlways-prepared spells (the domain-spell shape) that never count against your prepared total. Under expanded: spells added to the list you may prepare from, not handed to you.
optionalfeatureProgression, featureType, progression, requiredThe subclass’s own pick group, same as a class’s.
isClassFeatureVariant — on a subclassFeatureAn optional feature that replaces another one the subclass lists (Blessed Strikes for Divine Strike). The pair becomes a one-pick choice instead of two grants; the replaced feature is read from the “replaces the … feature” line.
consumes — on a featureA Channel Divinity option and the like: the feature gets a button that spends one use of the pool it names (amount for more). The pool is found by name, in your file first, then in the rules. A pool nothing declares makes no button, and the preview says so.
spellcastingAbility, casterProgression, cantripProgression, spellsKnownProgression, preparedSpellsProgression, preparedSpellsChange, subclassTableGroupsSpellcasting on a subclass of a non-caster (the third-caster shape) with its own slot table. Which class’s spell list it draws from is the one thing the format has no field for; _sheetling.spellcasting.spellListOf names it.

Spells (spell)

Field in your fileWhat the sheet does with it
level, school, time, number, unit, range, distance, type, amount, components, v, s, m, text, durationThe card and the Prepare dialog, with the level deciding which slot casts it.
concentration — on a durationCasting it while you already concentrate opens the keep-or-drop prompt, and the sheet tracks what you are concentrating on.
meta, ritual — meta.ritualOffered as a ritual cast that spends no slot.
classes, fromClassListWhich class’s Prepare dialog offers it. A spell on no list is only reachable through a pick or a grant.
spellAttackAn attack-roll button using your spell attack bonus.
savingThrowThe save and your DC on the card. Text that describes a save without this field is reported, and no save is mapped.
entries, items, entry, damageInflict — the damage dice in entries, with damageInflictA damage roll of that type.
entriesHigherLevelThe extra dice when you cast it from a higher slot; the cast card asks which slot.
scalingLevelDice, scalingCantrip scaling by character level.
miscTags — containing HLA heal roll instead of a damage roll.

Species (race, subrace)

Field in your fileWhat the sheet does with it
speed, walk, fly, swim, climb, burrow — a number, or { walk, fly, swim, climb, burrow }Walking speed on the sheet; each other mode listed beside it as its own speed.
sizeSize on the sheet.
ability, choose, from, amount, count — fixed, or choose with from/amount/countFixed increases are applied to the scores. A choose becomes a pick in the creation wizard, offered from exactly that list.
darkvisionDarkvision with that range in the senses row.
resistDamage resistance, shown on the sheet and applied when you take that damage type.
skillProficiencies, weaponProficiencies, armorProficiencies, toolProficienciesProficiencies on the sheet, so the bonus lands on the right rolls. A choose becomes a wizard pick with that budget.
languageProficienciesLanguages on the sheet.
additionalSpellsInnate spells with their own uses and reset: see the shared additionalSpells table.
feats, any, anyFromCategory, category — { any: 1 }, or anyFromCategoryA feat pick in the creation wizard, from every feat of that kind you have loaded. A feat with its own ability increase asks for it on the sheet.
entries, _sheetling — each named blockOne feature card per trait, with the trait’s text. A _sheetling block on a trait gives it a mechanic.
overwrite — a subrace naming its parent raceMerged over the parent: single values (speed, size, Darkvision) take the subrace’s, lists (abilities, resistances, proficiencies, spells, traits) add up; overwrite names the lists that replace instead. The base species imports too, so a “no subrace” pick stays available.

Feats (feat)

Field in your fileWhat the sheet does with it
ability, choose, from, amount, count — fixed or chooseThe increase is applied; a choose is asked when the feat is picked.
category — O, when a background in the same file grants the featAn Origin feat, granted by that background at creation. Every other feat is a General feat, offered at the level-4 pick.
prerequisite, level, armor — level, ability, proficiency: [{ armor }]Enforced in the picker: the feat is not offered until you qualify. Armor means training with that armor, as the armor feats ask.
race, proficiency, spellcasting, feat, other — the other prerequisite keysPrinted on the card, not enforced (a weapon proficiency included). The block’s prerequisite can enforce spellcasting.
skillProficiencies, toolProficiencies, savingThrowProficiencies, expertise, anyProficientSkillProficiencies and expertise; a choose is a pick.
languageProficiencies, any, anyStandard — a fixed language, or anyA fixed language is granted. any (Linguist’s three) is a language pick, asked on the sheet if the feat came after creation.
weaponProficiencies, fromFilter — fixed, or choose with fromFilterFixed weapons are granted. A choose (Weapon Master’s four) is a weapon pick from the weapon class the filter names, asked on the sheet.
senses, resistDarkvision and the like; damage resistance.
additionalSpellsThe Magic Initiate shape: picks from a filtered pool, with their uses (the shared table).
repeatableThe picker allows the feat more than once.
optionalfeatureProgression, featureType, progression — { "*": 2 }Picks the feat grants from another list: Martial Adept takes two maneuvers from the Battle Master’s. The sheet asks for them once you hold the feat.
entriesThe card’s text.

Backgrounds (background)

Field in your fileWhat the sheet does with it
skillProficiencies, toolProficiencies, languageProficienciesProficiencies and languages; a choose is a wizard pick.
startingEquipment, _, a, A, item, quantity, equipmentType, equipmentTypes, value, specialThe kit lands in the inventory at creation.
ability, choose, weighted, from — ability.choose.weighted.fromThe 2024-style ability increase choice in the wizard, from those abilities. A fixed increase has no field on a background and is reported.
featsThe Origin feat the background grants, when it names a shipped feat or one in the same file.
additionalSpellsAs everywhere else: the shared table.
entriesThe card’s text.

Optional features (optionalfeature)

Field in your fileWhat the sheet does with it
featureType — EI, MM, FS:F, FS:P, FS:RJoins the shipped pool: a homebrew Eldritch Invocation, Metamagic option or Fighting Style is offered by the shipped Warlock, Sorcerer, Fighter, Paladin or Ranger in their own picker, beside the SRD options. A code your own class or subclass declares in its optionalfeatureProgression joins that group instead. Any other code is a plain feature card, with a row in the preview saying no group took it.
prerequisite, level, class, ability, pact, patron, spell, feature, item, otherSummary, entry, otherPrinted on the card. A _sheetling.prerequisite makes a level, an ability score or “has spellcasting” a real gate in the picker.
additionalSpellsSpells the option grants: the shared additionalSpells table.
consumesA manoeuvre and the like: the feature gets a button that spends one use of the pool it names (amount for more). The pool is found by name, in your file first, then in the rules. A pool nothing declares makes no button, and the preview says so.
entriesThe card’s text.

Conditions (condition)

Field in your fileWhat the sheet does with it
entries — a condition’s name and entriesJoins the condition list: the picker on the sheet offers it beside the SRD conditions, and it opens to its text. A homebrew condition imposes nothing on rolls unless a _sheetling block says what.

Creatures (monster)

Field in your fileWhat the sheet does with it
summonedBySpell, _versions, _mod, mode, names, renames, rename, with, replace, items — summonedBySpell, with _versionsWhen the spell is in the same file, the creature becomes that spell’s companion card. You pick a form and a slot, and its Armor Class, hit points and attacks follow the slot. A creature whose numbers cannot be read is left as a plain stat block, and the preview says why.
size, type, tags, swarmSize, alignment, ac, hp, average, formula, special, speed, walk, fly, swim, climb, burrow, number, condition, str, dex, con, int, wis, cha, save, skill, senses, passive, languages, cr, initiativeA stat block in the compendium and in the DM’s bestiary: the creature can be seated in an encounter with its hit points and its saves. A Beast of a legal challenge rating is a Wild Shape form the Druid can take.
resist, immune, vulnerable, conditionImmuneThe stat block’s defences, shown on the creature’s card.
trait, action, bonus, reaction, legendary, legendaryActions, legendaryActionsLair, legendaryHeaderThe creature’s features and actions as text on its card, in the encounter’s creature panel.
spellcasting, headerEntries, will, daily, spells, abilityThe creature’s spellcasting block as text with its spell names; the DM reads it, the sheet does not cast for it.
entries, fluffDescription and lore on the card.

The shared additionalSpells block

Field in your fileWhat the sheet does with it
_ — a level key: "1", "3", "_"The spells inside arrive at that character level; "_" means from the start.
innate, will, rest, daily, ritual — innate, with will, rest, daily or ritualCast without a slot: at will, or with a tracker of that many uses that resets on the rest or the day the key names; ritual means ritual-only.
known, preparedA spell you always have prepared, cast with your slots.
expandedAdded to the list you may prepare from.
choose, from, count, all — a filter such as level=1|class=Wizard, or the Ritual or attack-roll tagA pick on the sheet, offered from exactly that pool. A filter key the importer does not know drops the pick with a row rather than offering the whole list.
abilityThe casting ability for innate spells. choose leaves it to the character’s own innate-ability choice; a prepared spell always uses the class’s ability.
resourceName, resource, limitedSpends from a tracker the same file declares by that name. Without one, the spell is dropped with a row: never offered free.
pb, pbe, halfPb, halfPbe, mod — a use count written as a formulaUses equal to your proficiency bonus (pb), or half of it, or an ability modifier (mod); the e variants add one.

What the importer declines

Raw typeWhy
variantruleA rule variant is a page of text with no home on a character sheet. Put a table rule in House rules instead, where it is a labelled toggle.
tableA free-standing table has nothing to attach to. Tables inside a feature’s entries still render on its card.