dndpaste.

Format guide

A dndpaste is a character build written as plain text. Each line records a choice the player made. This page shows how the lines fit together, with one example build. The specification has the full rules. Where this page and the specification differ, the specification is correct.

The example

Vesk is a level 5 character: one level in Fighter, then four in Warlock. To start your own, open New build and use Start a build. It writes the lines your classes need, ready for you to fill in.

Vesk
Rules: 2024
Scores: STR 15/DEX 10/CON 13/INT 8/WIS 10/CHA 15
Classes: Fighter 1 / Warlock 4
Species: Tiefling|XPHB [Infernal; CHA]
Background: Soldier|XPHB
Scores: +2 STR, +1 CON
Tools: Dice Set
L1 Fighter
Skills: Perception, Survival
Feat (Fighting Style): Defense
Masteries: Greatsword, Javelin, Longsword
Gear: A
L2 Warlock
Options: Pact of the Blade
Cantrips: Eldritch Blast, Minor Illusion
Spells: Armor of Agathys, Hex
L3 Warlock
Options: Agonizing Blast [Eldritch Blast], Devil's Sight
Spells: Hellish Rebuke
L4 Warlock
Subclass: Fiend Patron
Spells: Misty Step
L5 Warlock
Feat: Ability Score Improvement [+2 CHA]
Cantrips: Mage Hand
Spells: Hold Person
Gear: Cloak of Protection
Vesk
Rules: 2024
Scores: STR 15/DEX 10/CON 13/INT 8/WIS 10/CHA 15
Classes: Fighter 1 / Warlock 4

The first line is the build's name. It is optional, and it cannot contain a colon.

Every other line is a key line: a key, a colon, a space and a value. The key lines before the first block are the header. In this build they give the edition, the base ability scores and the classes.

The six base scores are in STR/DEX/CON/INT/WIS/CHA order. They are the scores before any increase from a species, a background or a feat. A final score such as INT 20 is not a base score: write the base and the increases, or put the final score in a Note. If you know only some of the base scores, name each one: STR 15/CON 13 or STR 15, CON 13. Classes gives each class with its levels, in the order the character took them.

A choice in the header, such as Feat: Alert, is not tied to a level. The text does not say at which level the player made it. A header choice belongs to the whole build. In a level block, a choice belongs to that level's class.

Species: and Background: come last in the header, because each one opens a block. A header key written under them ends up in their block. The editor offers to move it above Species:, and Tidy moves it.

Species and background blocks

Species: Tiefling|XPHB [Infernal; CHA]
Background: Soldier|XPHB
Scores: +2 STR, +1 CON
Tools: Dice Set

Species: and Background: each open a block. The lines under the key, up to the next block, are the choices that the species or background asks for. Here the soldier has score increases and a gaming set.

A species with lineages takes its lineage in brackets on the Species line. An elf has a lineage, a tiefling a legacy, a dragonborn an ancestry. When the lineage asks for a spellcasting ability, the ability comes next, after a semicolon: Species: Tiefling|XPHB [Infernal; CHA]. A 2014 subrace goes the same way: Species: Elf|PHB [Wood]. In a feat's brackets, the ability comes first: Fey Pact|HB [CHA].

A Scores line with a plus sign is an increase, not a base score.

An official background lists only the choices it asks for, as this one does. A custom or homebrew background lists everything it gives. Both blocks come before the first level block.

Level blocks

L1 Fighter
Skills: Perception, Survival
Feat (Fighting Style): Defense
Masteries: Greatsword, Javelin, Longsword
Gear: A
L2 Warlock
Options: Pact of the Blade
Cantrips: Eldritch Blast, Minor Illusion
Spells: Armor of Agathys, Hex
L3 Warlock
Options: Agonizing Blast [Eldritch Blast], Devil's Sight
Spells: Hellish Rebuke
L4 Warlock
Subclass: Fiend Patron
Spells: Misty Step
L5 Warlock
Feat: Ability Score Improvement [+2 CHA]
Cantrips: Mage Hand
Spells: Hold Person
Gear: Cloak of Protection

L1 Fighter opens the block for character level 1, taken in Fighter. Its lines are the choices made at that level. L2 Warlock is the first level in Warlock. Level blocks go up in order, and each one names its class, so the text shows where each class starts. A level with no choices needs no block.

Feat (Fighting Style): Defense names the slot that the feat fills, in parentheses after the key. Options lists optional features, here the warlock's invocations. At level 5 the ability score improvement is a feat: Ability Score Improvement [+2 CHA].

A Subclass line goes in the level block where the class gains its subclass, or in the header when the build has no level blocks or has not reached that level yet. Write the subclass's name, its short name, or the short name before the class: Subclass: Diviner Wizard.

In a level block, a minus sign before a name removes it from the build at that level. Spells: -Hex, Hold Person drops Hex and adds Hold Person.

A class feature that asks for a choice goes on a Feature line, with the choice in brackets: Feature: Hunter's Prey [Colossus Slayer]. An artificer's plans go the same way: Feature: Replicate Magic Item [Bag of Holding]. Plans are not infusions. Infusions holds the infusions of the 2014 artificer.

A familiar, a steed, a summoned creature or a pact weapon can name its form in brackets: Invocations: Pact of the Chain [Imp], Pact of the Blade [Glaive], Spells: Find Familiar [Owl], Summon Fey [Fuming]. The brackets are optional.

Leaving a class and coming back

Classes: Paladin 9 / Rogue 1
L9 Rogue
L10 Paladin

This paladin takes Rogue at level 9 and returns to Paladin at level 10. Classes gives the totals, and a level header marks each change of class. A level block with no lines is enough to mark one.

What the build gets anyway

A dndpaste records choices. A feature or spell that the build gets without a choice is not written: a domain's always-prepared spells, a subclass feature, a species trait. To point out one that the build relies on, write it in the level block where it arrives: Feature: Portent at the level the Diviner gets it, or Prepared: Bless for a Life cleric. It is a highlight, not a choice.

Names, sources and details

A value gives names only. It never copies rules text.

  • Tiefling|XPHB: a name, then | and the short code of the book it comes from, such as PHB, XPHB and TCE (all book codes). The code is optional. Without one, the name means its newest printing in the edition of Rules:, or in either edition when there is no Rules:. A core book comes before a setting book.
  • Magic Initiate [WIS; Druid; Guidance, Shillelagh; Goodberry]: the choices that a feat or feature asks for go in brackets. A semicolon separates one choice from the next. A comma separates the names inside one choice. Each key has a fixed order for these choices (specification, section 5.3).
  • "Bag of Tricks, Gray": a name that contains a comma, a semicolon, a colon or a bracket goes in double quotes.
  • Arrows (20) x2: a quantity of 2 or more, on Gear only. Write Shortsword x2, not the name twice. Brackets on gear hold a choice the item asks for, not a note: Headband of Intellect needs nothing after it.
  • Arrows (20): parentheses in a name are part of the name. A species' lineage is not part of its name: write Human|ERLW [Mark of Making], not Human (Mark of Making). Under 2014 rules this dragonmark is a human's lineage. Under 2024 rules it is a feat: Feat (Dragonmark): Mark of Making|EFA. Parentheses after a key are different: they name a slot, such as Feat (Origin).

Unearthed Arcana and homebrew

Any name can come from Unearthed Arcana or from homebrew, and the build still saves.

  • Unearthed Arcana: always write its code, such as Psion|XUA2025Psion. The book codes page lists the codes.
  • Homebrew: write the code its file gives, or |HB if it has none: Feat: Fey Pact|HB [CHA]. A name with no code works too.
  • A homebrew background lists everything it gives in its block, so the build is complete without the homebrew file.

Optional features have a key for each known family: Masteries, Invocations, Metamagic, Maneuvers, Infusions, Arcane Shots, Runes, Disciplines, Pact Boon. A family from another book goes in Options, with its name in parentheses: Options (Psionic Discipline): Telekinetic Propel.

Short builds

No key is required. Classes: Warlock alone is a valid build. Write what you know and leave out the rest. The site saves a build when it has at least one line besides the name.

A note for people goes on a Note line, in any block: Note: Eldritch Knight at level 3, or Sharpshooter in version B. A block takes one Note line, so a second thought goes on the same line. A note is not part of the build.

A key with no value, such as Spells:, means not chosen yet. The editor shows the warning W004, the site saves the build, and Tidy keeps the line as a reminder.

In a level block, the editor also shows a small count after lines such as Spells. A count of 2/4 means two picks of the four that the class gets at that level. The count is a note in the editor. It is not part of the build.

Canonical form and Tidy

Each build has one canonical form. Keys follow the order of the key table, one blank line comes before each block, and each key has the spelling in the table. Classes gives one total for each class. In a build with level blocks, a level header marks each change of class.

Tidy, in the editor's toolbar, rewrites the text in canonical form. It changes the layout, not the choices. Tidy also fixes the errors it can fix without a guess: it moves a header key out of a block, joins two lines of the same key with commas, and puts / between classes. It keeps any other line with an error as you wrote it. A badge on the Tidy button counts its changes. Click the badge to see them, and click a change to leave it out. Undo takes back a whole Tidy. The /<id>/canon address of a saved build gives the same text.

Keys

These are all the keys, in canonical order. Keys are not case-sensitive. A key that starts with X- is an extension for apps: the site keeps it and shows the warning W001.

Some keys were renamed in version 0.8 of the format. The old keys still work until version 1: ASI, Ability, Fighting Style, Equipment and Items. The editor shows the warning W005, and Tidy writes the new form.

KeyGoes inHolds
PasteHeaderThe version of the format. Leave it out for version 1.Value: a whole number
ProducerHeaderThe app and version that wrote the text.Value: one line of text
RulesHeaderThe edition for names that have no book code.Value: 2014 or 2024
ScoresHeader, Species, Background, LevelWithout a plus sign, the base ability scores, in the header only. To say how you made them, put the method in parentheses after the key: Scores (standard array), Scores (point buy) or Scores (custom). With a plus sign, an increase: in the species or background block, at a level, or in the header.Value: each ability and its score, STR 15/DEX 10/CON 13/INT 8/WIS 10/CHA 15, or only the known ones, DEX 15/CON 13, or an increase, +2 CHA
ClassesHeaderEach class and its levels.Value: Fighter 1 / Warlock 4, in the order taken
HPHeader, LevelHow the build gains hit points.Value: Fixed or Rolled, and in a level block also the number rolled
SpeciesHeader, opens a blockThe species, with its lineage in brackets and the lineage's spellcasting ability after it. Its other choices follow in its block.Value: one name
BackgroundHeader, opens a blockThe background. Its choices follow in its block.Value: one name
SubclassHeader, LevelThe subclass.Value: a list of names, or one name in a level block
SkillsHeader, Species, Background, LevelSkill proficiencies chosen.Value: a list of names, separated by commas
ToolsHeader, Species, Background, LevelTool proficiencies chosen.Value: a list of names, separated by commas
LanguagesHeader, Species, Background, LevelLanguages chosen.Value: a list of names, separated by commas
ExpertiseHeader, LevelSkills chosen for expertise.Value: a list of names, separated by commas
FeatHeader, Species, Background, LevelFeats, with their choices in brackets. An ability score improvement is the feat Ability Score Improvement. To name the slot that a feat fills, put it in parentheses after the key: Feat (Fighting Style), Feat (Origin).Value: a list of names, separated by commas
MasteriesHeader, LevelWeapon masteries.Value: a list of names, separated by commas
InvocationsHeader, LevelEldritch invocations.Value: a list of names, separated by commas
MetamagicHeader, LevelMetamagic options.Value: a list of names, separated by commas
ManeuversHeader, LevelBattle Master maneuvers.Value: a list of names, separated by commas
InfusionsHeader, LevelArtificer infusions.Value: a list of names, separated by commas
Arcane ShotsHeader, LevelArcane Archer shots.Value: a list of names, separated by commas
RunesHeader, LevelRune Knight runes.Value: a list of names, separated by commas
DisciplinesHeader, LevelElemental disciplines.Value: a list of names, separated by commas
Pact BoonHeader, LevelThe pact boon, under 2014 rules. Under 2024 rules a pact is an invocation.Value: a list of names, separated by commas
OptionsHeader, LevelOptional features of any family. A family with no key of its own goes in parentheses after the key: Options (Soul Techniques).Value: a list of names, separated by commas
FeatureHeader, Species, Background, LevelA named feature and its choices, or an optional class feature taken.Value: a list of names, separated by commas
CantripsHeader, Species, Background, LevelCantrips chosen.Value: a list of names, separated by commas
SpellsHeader, Species, Background, LevelSpells added to the build at that level. To cap the spell level the line picks from, put it in parentheses after the key: Spells (3rd).Value: a list of names, separated by commas
PreparedHeader, LevelThe spells prepared by default, for a caster who knows more spells than it prepares.Value: a list of names, separated by commas
GearHeader, Background, LevelIn the background block or at level 1, the starting gear or its option letter. At a later level, gear gained in play. In the header, gear carried.Value: a list of names, separated by commas
NoteHeader, Species, Background, LevelA note in your own words: a plan, a second version, a reminder. One line per block. It is not part of the build.Value: one line of text

Problems

The editor checks the text as you type and lists each problem with its line and a short fix, such as Move above Species. A code that starts with E is an error: fix it before you save. A code that starts with W is a warning: the build saves as it is. Section 7 of the specification lists every code.

Lines with no value yet, such as an empty Spells:, are not problems. The editor lists them under To choose, with a button for each line.

Format changes

The format can still change. Each release lists what changed and how to update a build.

Send feedback on GitHub about a build you can't write or a build the site reads wrong.