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.
The header
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: 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 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
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 asPHB,XPHBandTCE(all book codes). The code is optional. Without one, the name means its newest printing in the edition ofRules:, or in either edition when there is noRules:. 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, onGearonly. WriteShortsword x2, not the name twice. Brackets on gear hold a choice the item asks for, not a note:Headband of Intellectneeds nothing after it.Arrows (20): parentheses in a name are part of the name. A species' lineage is not part of its name: writeHuman|ERLW [Mark of Making], notHuman (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 asFeat (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
|HBif 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.
| Key | Goes in | Holds |
|---|---|---|
| Paste | Header | The version of the format. Leave it out for version 1.Value: a whole number |
| Producer | Header | The app and version that wrote the text.Value: one line of text |
| Rules | Header | The edition for names that have no book code.Value: 2014 or 2024 |
| Scores | Header, Species, Background, Level | Without 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 |
| Classes | Header | Each class and its levels.Value: Fighter 1 / Warlock 4, in the order taken |
| HP | Header, Level | How the build gains hit points.Value: Fixed or Rolled, and in a level block also the number rolled |
| Species | Header, opens a block | The species, with its lineage in brackets and the lineage's spellcasting ability after it. Its other choices follow in its block.Value: one name |
| Background | Header, opens a block | The background. Its choices follow in its block.Value: one name |
| Subclass | Header, Level | The subclass.Value: a list of names, or one name in a level block |
| Skills | Header, Species, Background, Level | Skill proficiencies chosen.Value: a list of names, separated by commas |
| Tools | Header, Species, Background, Level | Tool proficiencies chosen.Value: a list of names, separated by commas |
| Languages | Header, Species, Background, Level | Languages chosen.Value: a list of names, separated by commas |
| Expertise | Header, Level | Skills chosen for expertise.Value: a list of names, separated by commas |
| Feat | Header, Species, Background, Level | Feats, 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 |
| Masteries | Header, Level | Weapon masteries.Value: a list of names, separated by commas |
| Invocations | Header, Level | Eldritch invocations.Value: a list of names, separated by commas |
| Metamagic | Header, Level | Metamagic options.Value: a list of names, separated by commas |
| Maneuvers | Header, Level | Battle Master maneuvers.Value: a list of names, separated by commas |
| Infusions | Header, Level | Artificer infusions.Value: a list of names, separated by commas |
| Arcane Shots | Header, Level | Arcane Archer shots.Value: a list of names, separated by commas |
| Runes | Header, Level | Rune Knight runes.Value: a list of names, separated by commas |
| Disciplines | Header, Level | Elemental disciplines.Value: a list of names, separated by commas |
| Pact Boon | Header, Level | The pact boon, under 2014 rules. Under 2024 rules a pact is an invocation.Value: a list of names, separated by commas |
| Options | Header, Level | Optional 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 |
| Feature | Header, Species, Background, Level | A named feature and its choices, or an optional class feature taken.Value: a list of names, separated by commas |
| Cantrips | Header, Species, Background, Level | Cantrips chosen.Value: a list of names, separated by commas |
| Spells | Header, Species, Background, Level | Spells 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 |
| Prepared | Header, Level | The spells prepared by default, for a caster who knows more spells than it prepares.Value: a list of names, separated by commas |
| Gear | Header, Background, Level | In 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 |
| Note | Header, Species, Background, Level | A 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.