Skip to content

Releases

dndpaste 0.11.0

Choose a tag to compare

@francescocompa francescocompa released this 21 Nov 22:29

dndpaste 0.11 names the ability scores on the Scores line and can say how they were made: standard array, point buy or custom. Every 0.10 paste still reads as before. The editor now shows each score's final value and the method behind the numbers. Most of this release answers feedback from r/3d6.

Try it: https://dndpaste.fcomfy.workers.dev

The format (SPEC 0.11)

  • The base line names each score: Scores: STR 8/DEX 14/CON 13/INT 12/WIS 10/CHA 15, or only the ones you know: Scores: DEX 16/CHA 17. Tidy and emit write this form.
  • The old forms still read, with no warning: six bare numbers (8/14/13/12/10/15) and the comma form (DEX 16, CHA 17) mean the same.
  • An optional method marker: Scores (standard array): …, Scores (point buy): … or Scores (custom): …. Nothing writes it by default, and the parser doesn't compare it with the numbers.
  • Increase lines (Scores: +2 WIS, +1 DEX) don't change.

The library

  • scoreKind(values) says whether a base is the standard array, point-buy legal (with the points left of 27) or custom. It also works on a partial base. It needs no data: the array and the point costs are a few numbers in the code.
  • A marker with an unknown method is E002. A marker on an increase line is E012, with a safe fix that drops it.
  • The UMD build loads again. In 0.10.0, dist/dndpaste.umd.cjs failed to load as a script, and a test now loads it.

The site

  • Click a score to see its final value, such as WIS 15 → 19 (+4), and the swaps its method allows.
  • A chip at the end of the Scores line shows the method: Std. Array, Point Buy 2/27 or Custom. Its chevron lists the methods.
  • Start a build asks for the method and remembers your last choice.
  • The shared and printed pages show the same mark.
  • Also live since earlier today: name lists open on any empty key, a click on a written name lists what can replace it, a level-up line adds the next level, and the caret moves to the next open choice.

Migrating from 0.10

Readers don't need to change anything. If your tests compare emitted text, they'll see the new base line. If you build lines from scopeLines, write them with lineOfValue to keep the method marker. The full table is in CHANGELOG.md.

dndpaste 0.10.0

Choose a tag to compare

@francescocompa francescocompa released this 20 Nov 19:29

dndpaste 0.10 puts a species' lineage on the Species line, and lets you add names from your own sources to the editor. 0.9 pastes still read, and Tidy rewrites them in the new form.

Try it: https://dndpaste.fcomfy.workers.dev

The format (SPEC 0.10)

  • The lineage goes in brackets on the Species line: Species: Elf [Drow], Species: Dragonborn [Black], Species: Goliath [Fire]. This covers every pick that splits a species: Elven Lineage, Gnomish Lineage, Fiendish Legacy, Draconic Ancestry and Giant Ancestry.
  • The lineage's spellcasting ability comes next, in the same brackets: Species: Elf [Drow; WIS]. An Ability: WIS line in the Species block still reads.
  • 2014 subraces use the same form: Species: Elf|PHB [Wood]. As on every item, the source goes right after the name.
  • Every other species pick (skills, size, the origin feat) stays a line in the Species block.

The library

  • 0.9 pastes keep working. A lineage Feature line in the Species block reads with W006. A name like Elf (Wood)|PHB reads with W007. Both warnings have a safe fix, and tidy and emit write the bracket form.
  • A source written after the brackets (Elf [Wood]|PHB) is E011, with a safe fix.
  • The checker owns the lineage and ability slots on the Species line. It reads Wood Elf and Black Dragonborn as Elf [Wood] and Dragonborn [Black].
  • The checker no longer counts 2024 origin languages as extras. Common is free, and two more languages fill the origin.
  • New: dndpaste/extract, the slot extractor as a pure function (extractSlots, mergeData, srdSubset). Also speciesPicks, shortLineage and speciesLineage.

The site

  • Type Species: Elf [ and the editor lists the lineages, then the abilities. Picking a species that has lineages writes Elf [] and opens the list.
  • 2014 subraces are lineage options of their species now, not separate species names.
  • Your own sources (/sources): add a names file, a folder from your computer or a GitHub link. Its names join the editor's suggestions, the options inside [ ] and the pick counts. Everything stays in your browser. Nothing is uploaded.
  • The format guide and its example use the new Species line. Saved shares re-render.

Migrating from 0.9

You don't have to change anything. 0.9 pastes keep their meaning, and Tidy (or tidy in the library) moves a lineage Feature line onto the Species line. Code that reads the AST finds the lineage and its ability in the Species item's details: speciesPicks from dndpaste/check returns both. The CHANGELOG has the full list.

Feedback

Found a build you can't write, or a paste that reads wrong? Open an issue.

dndpaste is unofficial fan content, not approved or endorsed by Wizards of the Coast. It stores names only, never rules text.

v0.9.0

Choose a tag to compare

@francescocompa francescocompa released this 20 Nov 09:07

dndpaste 0.9 gives class options their own keys and makes the editor tell you how to fix what it flags. Old pastes still read and mean the same: this release only adds forms.

Try it: https://dndpaste.fcomfy.workers.dev

The format (SPEC 0.9)

  • Option families get their own keys: Invocations, Metamagic, Maneuvers, Infusions, Arcane Shots, Runes, Disciplines and Pact Boon. Options still takes any option, and takes a marker for a family with no key of its own: Options (Soul Techniques): ….
  • A level cap on spell lines: Spells (6th): Mass Suggestion lists the spells picked from a higher slot level, next to the uncapped line.
  • A Note key for a plan, a second version or a reminder. It isn't part of the build.
  • A chosen form in brackets on pacts and summons: Pact of the Chain [Imp], Find Steed [Warhorse].
  • Granted features and spells can be written as plain lines, to show what a build relies on. The checker doesn't count them as picks.
  • A Subclass line goes in the header or in the level block where the class gains its subclass. Diviner Wizard is accepted.
  • A name with no source code means its newest printing within the paste's Rules. An Unearthed Arcana name always carries its code.

The library

  • Every diagnostic has a short hint, and most have a fix you can apply with applyFix.
  • tidy makes every safe fix, then writes the canonical form. It never refuses: a line it can't fix stays as written.
  • emit keeps a line with an error instead of dropping it.
  • New helpers: resolveKey, keyGroup, levelCap, familyOf, familyKey, foldOptions. dndpaste/sources lists the Unearthed Arcana codes.
  • The CLI has a tidy command. check exits 1 on errors, and --strict also exits 1 on warnings.
  • The package exports now list types first, so TypeScript finds them.

The site

  • The editor suggests names from the SRD as you type, and keys for the line you're on.
  • One click fixes many errors. Tidy shows a badge with its changes, and you can leave any of them out.
  • Empty lines show as a "To choose" list instead of a wall of warnings.
  • The site remembers your author name in your browser.
  • Shared builds hide empty lines and list their sources.

Migrating from 0.8

Nothing to do: 0.8 pastes keep their meaning and their canonical form. If you write pastes, you can switch to the new keys line by line. Code that reads the AST should read options from every key in the Options group and spells from every key in the Spells and Prepared groups (keyGroup tells you which). The CHANGELOG has the full list, with an example of each change.

Feedback

Found a build you can't write, or a paste that reads wrong? Open an issue.

dndpaste is unofficial fan content, not approved or endorsed by Wizards of the Coast. It stores names only, never rules text.

Full Changelog: v0.8.0...v0.9.0

v0.8.0: first public release

Choose a tag to compare

@francescocompa francescocompa released this 18 Nov 15:32

dndpaste is a plain-text format for sharing D&D 5e character builds. Think Pokepaste, for characters: a build is a short block of text that people can read and apps can import. This is the first release I'm sharing with the community, for feedback.

Try it: https://dndpaste.fcomfy.workers.dev. Paste a build, get a short link. Start with the Guide, or pick a class under "Start a build".

What's in it

  • The format (SPEC.md): a build replays its choices by name only, never rules text. Level blocks keep the order you took things in, so a multiclass reads the way you'd play it. 2014 and 2024 rules both work. A sparse paste is valid: Classes: Warlock alone is a build.
  • The library: zero dependencies, TypeScript, ESM plus a single-file build for pages with no build step. parse gives a typed tree with diagnostics and never throws. emit writes the one canonical text. check reports what a build still owes, what sits at the wrong level and what doesn't resolve, against the SRD or your own data.
  • A CLI: dndpaste check, emit and normalise.
  • The share site: short links, a live preview, edits as revisions, a share image and a Post to Reddit button.

Stability

The format is 0.x and can still change. A paste you write today keeps reading: within Paste: 1, a renamed key stays readable and is never removed (FORMAT-UPDATES.md). Pastes from earlier versions also still read. The CHANGELOG lists every change.

Feedback

Found a build you can't write, or a paste that reads wrong? Open an issue.

dndpaste is unofficial fan content, not approved or endorsed by Wizards of the Coast. It stores names only, never rules text.