Arroweds Adversary Bank

by arrowedisgaming
5
4
3
2
1
Score: 46/100

Description

Adversary & environment stat blocks for Daggerheart TTRPG. Fork of BeastVault with renaming, conditions, summon, and instance tracking.

Reviews

No reviews yet.

Stats

2
stars
1,571
downloads
2
forks
176
days
7
days
7
days
1
total PRs
0
open PRs
0
closed PRs
1
merged PRs
3
total issues
1
open issues
2
closed issues
38
commits

Latest Version

7 days ago

Changelog

Changelog — Arroweds Adversary Bank

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[1.13.0] - 2026-11-12

Added

  • Insert improvised adversary command (also in the ribbon menu): pick a tier and a role to insert a ready-to-run stat block with quick stats and the role's signature features. Numbers follow the Daggerheart Homebrew Kit's adversary guidance, tuned to the SRD adversaries of each tier and role.

Fixed

  • Inserting an adversary with the cursor in the middle of a line no longer breaks the code block: the stat block now starts on its own line.

[1.12.0] - 2026-11-12

Added

  • Hope & Fear adversaries and environments from Daggerheart SRD 2.0 (#2): 135 adversaries across tiers 1–4 and 28 environments, bringing the built-in library to 264 adversaries and 47 environments. New entries are tagged source: hopeandfear. Thanks to Garonenur for the original contribution (#3); the shipped entries were regenerated from the SRD 2.0 PDF and checked against the SRD's adversary index. Features of type Evolution are listed as ordinary features for now.

Changed

  • The copyright notice in README.md now cites Daggerheart SRD 2.0.

Fixed

  • Dice expressions with a subtracted modifier, such as 1d4-1, are now clickable as a whole. Previously only the 1d4 part was picked up, so the roll ignored the modifier.

[1.11.0] - 2026-11-12

Added

  • CONTRIBUTING.md covering bug reports, development setup, pull request expectations, code guidelines, and how to add adversary and environment data.

Changed

  • Updated development dependencies: esbuild 0.17.3 → 0.28.2, eslint-plugin-obsidianmd 0.4.1 → 0.5.1, and in-range updates to eslint, typescript-eslint, typescript, globals, tslib, and @types/node. This clears 35 of 38 pnpm audit advisories; the remaining three are moderate and sit in upstream packages (moment via obsidian, minimatch via the lint plugin). None of these packages ship in the plugin bundle.
  • Filled in author and keywords in package.json.

[1.10.1] - 2026-07-24

Fixed

  • Adversaries inserted from the library no longer lose every feature. A note that describes the same stat block in both YAML frontmatter and a daggerheart code block was indexed twice, and the frontmatter copy — which never read features — was the one the duplicate filter kept. Code blocks are now parsed first, and a daggerheart block takes precedence over a frontmatter entry with the same name, so inserting reproduces the note's own stat block verbatim, features included. Notes with frontmatter only, blocks naming something other than the frontmatter, and statblock blocks read under FSB compatibility are all unaffected.
  • A features: (or conditions:) list in a note's frontmatter is now read. Previously both keys were silently dropped, so frontmatter-only notes had to spell their features out as ***Name - Type:*** body prose to have them picked up at all.
  • Library scans no longer read every Markdown file in a library folder off disk. Notes with neither frontmatter nor a code block are skipped on metadata alone, and notes that have both are read once rather than twice.

[1.10.0] - 2026-07-22

Changed

  • Settings are now declared with Obsidian's declarative settings API (getSettingDefinitions()), so every setting is findable from Obsidian's settings search. The library folder list moves to the built-in list control, so removing a folder gains a standard delete button and Delete/Backspace keyboard support. This raises minAppVersion to 1.13.0; the imperative display() implementation has been removed.
  • The "Reset all customizations" button uses setDestructive() instead of the deprecated setWarning(), condition badges use createSpan(), and the dice-roll notice builds its fragment with Obsidian's createFragment() helper rather than a native createDocumentFragment() call.

[1.9.0] - 2026-07-22

Added

  • Markdown in every text property, not just feature desc (#1). name, desc, weapon, range, damage, difficulty, xp, motives, tone, impulses, adversaries, and a feature's name, type, and flavor now render through Obsidian's markdown pipeline, so **bold**, *italic*, ==highlight==, `code`, [[wikilinks]], and #tags work anywhere on a stat block. Fields with no markdown characters skip the renderer entirely, so cards with plain text render exactly as before. Markdown in damage may wrap dice notation ("*2d6 magic*") and still produce a working roller. Inline rename edits the raw YAML value and now quotes it when the name needs quoting, so renaming a card to **Wolf** no longer writes invalid YAML.

Changed

  • Builds can now mirror main.js, manifest.json, and styles.css into a local Obsidian vault's plugin folder, so changes are testable in the real app without a manual copy. Point .dev-vault (gitignored) or $OBSIDIAN_PLUGIN_DIR at the folder; pnpm dev additionally watches styles.css and manifest.json, which esbuild does not rebuild. Syncing is opt-in and validates that the target path ends in .obsidian/plugins/<plugin id> before writing, so CI and fresh clones are unaffected.

Fixed

  • Relative links and dice in a stat block now resolve against the note the code block actually lives in, rather than whichever note happens to be active. Cards rendered in an embed, in a canvas, or in the background previously resolved links against the wrong file. Stat block ids are still derived from the active file, so tracked HP, stress, and conditions are unaffected.

  • Dice rollers rendered by the dice-roller plugin sat below the baseline of the text around them, most visibly inside feature descriptions. The plugin's .dice-roller is an inline-flex box that vertically centers its contents around an 18px dice icon and then top-aligns itself in the line; against a stat block's smaller body text that pushed the formula about 1.5px low. Stat block dice are now laid out as plain inline text on the shared baseline, with the icon scaled to the surrounding font size.

[1.8.1] - 2026-05-27

Changed

  • Renamed plugin to "Arroweds Adversary Bank" (removed the apostrophe from "Arrowed's") to comply with Obsidian community directory naming guidelines, which prohibit punctuation other than hyphens. The plugin id (arroweds-adversary-bank) is unchanged, so existing installs keep all settings, customizations, and tracked instance state.

[1.8.0] - 2026-05-14

Added

  • Stat block overrides. Each rendered adversary card has a pencil icon in the top-right corner that opens an edit modal for adjusting Max HP, Max Stress, Thresholds, Attack, Difficulty, Weapon, Range, Damage, and Motives & Tactics mid-session without editing the YAML in the code block. Overrides are stored in plugin state — the library entry is never mutated — and survive vault reloads. Overridden values replace the library values in-place in the card header and are marked with a dotted underline. HP/Stress marks are clamped across all instances when the effective max drops (either by setting a lower override or by clearing an override that previously raised the max). A "Reset all customizations" button in the modal footer reverts every overridden field back to the library value.
  • Per-instance reset button. Each instance's stat bar has a small reset icon at the top-right that clears that instance's HP marks, stress marks, conditions, feature uses, and feature countdowns. Customizations stay intact (they reset only from inside the edit modal), so a GM can fully refresh one creature in a multi-instance encounter without disturbing the rest.

[1.7.5] - 2026-05-13

Changed

  • Rewrote README.md to lead with GM-facing utility rather than fork-vs-original framing: replaced the "What's New" / "Original BeastVault Features" split with a single Features section organized around library, live tracking, and interactive stat blocks; added hero and per-feature screenshots under docs/images/; reduced Installation to a single sentence pointing at the Obsidian community plugin directory; removed the BRAT install option; moved manual install and release-provenance instructions into collapsed <details> blocks below the Reference section. BeastVault attribution preserved in the Attributions section per the MIT License.

[1.7.4] - 2026-05-12

Fixed

  • Replaced boolean .every() callbacks in asStringOrStringArray and asThresholds (src/utils.ts) with type-predicate callbacks so Array.isArray narrowing flows through to the return value, eliminating two @typescript-eslint/no-unsafe-return warnings.

[1.7.3] - 2026-05-12

Fixed

  • Release tag format now matches the manifest version exactly (e.g. 1.7.3, not v1.7.3), per the repo's existing convention and Obsidian's plugin guidelines. Updated the release workflow trigger and tag-verification accordingly. The previous v1.7.2 tag and release were removed; this metadata-only 1.7.3 republishes the same content under the correct tag.

[1.7.2] - 2026-05-12

Changed

  • Added GitHub Actions release automation that builds release assets in CI, generates GitHub artifact attestations, and uploads main.js, manifest.json, and styles.css.
  • Added local and CI checks for TypeScript, Obsidian ESLint rules, and CSS review guardrails.

Fixed

  • Replaced deprecated builtin-modules dependency usage with the native Node.js module list already used by the build.
  • Tightened YAML, JSON, frontmatter, Fantasy Statblocks, dice-roller, and saved-state typing to avoid unsafe any flows.
  • Marked intentional fire-and-forget promises, improved popout-window compatibility, and removed unused imports.
  • Reworked CSS underlines and overrides to avoid unsupported text-decoration declarations and !important.
  • Preserved brand-name and acronym capitalization (Arrowed's Adversary Bank, Fantasy Statblocks, FSB, SRD) in user-facing settings and ribbon labels by extending the sentence-case lint allowlist.
  • Continued to accept quoted numeric stat fields (e.g. hp: "8") in homebrew YAML, JSON, and frontmatter, restoring parity with prior loose-typed behavior.

[1.7.1] - 2026-05-12

Fixed

  • Metadata-only release to align the Obsidian plugin manifest version with the Git tag name.

[1.7.0] - 2026-05-04

Added

  • Configurable stat block button color for threshold and HP/Stress controls.

Changed

  • Restyled embedded stat block buttons with softer themed backgrounds, centered labels, and larger HP/Stress icon controls.

[1.6.0] - 2026-04-12

Added

  • Mobile support — plugin now installs and runs on Obsidian Mobile (iOS/Android)
  • Touch-friendly interactions: long-press to rename adversary titles, mark/clear damage menu on threshold buttons
  • :active CSS states on all interactive elements for touch press feedback

[1.5.1] - 2026-04-04

Added

  • "Hide built-in library" setting — optionally hide the bundled SRD adversaries and environments from the search modal, showing only your homebrew entries
  • Markdown body parsing for frontmatter-based entries — description, motives & tactics, experience, and features are now extracted from the note body when not present in frontmatter

[1.5.0] - 2026-04-04

Added

  • Multiple library folder support — add as many homebrew folder paths as you need in settings, each scanned independently for adversary YAML/JSON/MD files
  • Folder picker modal — click "Choose folders" to visually browse and select vault folders with search and checkboxes, replacing the old single text field
  • Frontmatter adversary loading — markdown notes with adversary stats in YAML frontmatter (name, hp, stress, difficulty, etc.) are now recognized as library entries, with field mapping for common third-party formats (role→type, atk_bonus→attack, weapon_name→weapon, etc.)

[1.4.0] - 2026-04-04

Added

  • Dice-roller plugin integration — when dice-roller is installed, dice formulas in statblocks (attack, damage, feature descriptions) render as interactive dice-roller elements with tooltips and click-to-reroll

Fixed

  • Dice pattern regex lastIndex bug that could cause alternating match failures on damage strings

[1.3.0] - 2026-04-03

Forked from BeastVault 1.2.3 by Lyova Potyomkin.

Added

  • Auto-suffix duplicate adversary names on insert (e.g. "Bladed Guard 2", "Bladed Guard 3")
  • Inline rename on rendered adversary cards (double-click the name to edit)
  • Condition tracking badges per adversary instance (Vulnerable, Restrained, Frightened, Disoriented, Weakened, Hidden, Empowered, Slowed)
  • Custom conditions via YAML conditions field and ad-hoc "+" button on condition bar
  • Per-instance naming for multi-count adversaries (click to rename "Chimera 1", "Chimera 2", etc.)
  • Clickable "Mark a Stress" text in feature descriptions — auto-marks stress on single instances, shows picker for multi-count
  • Per-stat +/- and clear buttons for HP and Stress slot rows
  • Summon buttons on features with a summon field — inserts the named adversary at end of document

Fixed

  • Removed unnecessary type assertions flagged by Obsidian eslint plugin
  • Replaced as any casts with proper typed access to card/instance state

[1.2.3] - 2025-11-30

Note

Last upstream release from original BeastVault. See upstream repository for prior history.

README file from

Github

Arroweds Adversary Bank

An Obsidian.md plugin that turns your campaign notes into a live Daggerheart encounter table. Search the SRD or your homebrew library, drop adversaries and environments straight into the page you're already writing in, then run the fight from the same note — HP, stress, conditions, and all.

Support me on Ko-fi

Arroweds Adversary Bank: a rendered Daggerheart stat block embedded in an Obsidian note

Features

The whole SRD, ready to drop in

Command palette open with the insert-from-library picker, filtered by name

Every adversary and every environment from the Daggerheart SRD, one command away. Hit Ctrl+P, type a name, and the stat block lands in the note you're already in. Drop your own homebrew folder in and it shows up in the same picker — no separate workflow for your custom stuff. Works in Obsidian Canvas too, so you can lay out an encounter visually and run it from the canvas.

Track everything live, per instance

Stat block mid-encounter with HP and stress marked, several conditions toggled on

HP, stress, conditions, feature uses, countdowns — all tracked right on the stat block. Mark a threshold with a click, clear it with Alt-click. Running two Bladed Guards or six skeletons from a single block? Each instance keeps its own state and its own name. Toggle the eight standard Daggerheart conditions on any instance, or define your own — "Burning," "Marked by the Hunter," whatever the table needs.

Stat blocks that work like tools

Feature description with a clickable "Mark a Stress" trigger and a visible summon button

Click an attack bonus to roll it. Click "Mark a Stress" inside a feature description and it actually marks one — and if there are several copies in play, a picker asks which one takes it. A feature that summons reinforcements gets a button that drops the named adversary into the note. The battle points counter in the status bar keeps a running total so you know exactly what the encounter costs. Less flipping between pages, more time running the scene.

Installation

Open Obsidian, go to Settings > Community plugins, click Browse, and search for Arroweds Adversary Bank. Or install it directly from the Obsidian plugin directory.

Usage

Insert from Library

Insert an adversary via a command: Ctrl+P > Insert adversary from library, or use the side ribbon menu (crossed-swords icon).

[!TIP] Bind plugin commands to hotkeys from the Hotkeys settings tab. For example, Alt+A for adversaries and Alt+E for environments.

[!TIP] Click threshold buttons to mark the corresponding amount of HP. Use Alt+Click to clear it instead.

Improvise an adversary

Need a stat block the library doesn't have? Ctrl+P > Insert improvised adversary (also in the ribbon menu) asks for a tier and a role, then inserts a ready-to-run block with Difficulty, thresholds, HP, Stress, attack and damage filled in. Roles with a signature feature get it too: Minions come with Minion and Group Attack, Hordes with Horde, Solos with Relentless, and Bruisers and Leaders with Momentum.

The numbers follow the adversary guidance in the Daggerheart Homebrew Kit and are tuned to the typical values of the SRD adversaries for that tier and role. Treat them as a starting point: rename the block, give the attack a name, and adjust anything in the code block.

Renaming

  • Auto-suffix: Inserting the same adversary twice auto-names them "Bladed Guard" and "Bladed Guard 2"
  • Inline rename: Double-click the adversary name on a rendered card to edit it. Press Enter to save, Escape to cancel.
  • Instance names: When you have 2+ copies (via the +/- buttons), each instance's stat bar shows a clickable name label. Click to customize it.

Conditions

Below each instance's HP and Stress slots, you'll see condition badges for the 8 standard Daggerheart conditions. Click to toggle.

Custom conditions can be added two ways:

  1. In the YAML: add a conditions field with a list of custom condition names
  2. At runtime: click the + button on the condition bar, type a name, press Enter
name: Chimera
hp: 9
stress: 5
conditions:
  - Poisoned
  - Burning

Summon Buttons

Add a summon field to any feature to get a button that inserts the named adversary:

features:
- name: Raise Dead
  type: Action
  desc: The Necromancer raises skeletal warriors.
  summon:
    - Skeleton Warrior
    - Skeleton Archer

HP/Stress Controls

Each HP and Stress row has inline buttons:

  • - removes one mark
  • + adds one mark
  • x clears all marks

Reference

The daggerheart code block parses the adversary or environment as YAML with the following properties:

Property Definition Example
name Name of the adversary Bear
tier Adversary tier 1
type Type of the adversary Bruiser
desc Adversary description A large bear with thick fur and powerful claws.
difficulty Adversary difficulty 14
weapon Name of the adversary's weapon Claws
range Range of the adversary's weapon Close
damage Amount and type of adversary's weapon damage 1d8+3 phy
hp Total adversary hitpoint slots 6
stress Total adversary stress slots 3
thresholds Adversary thresholds, separated by a /; leave blank for minions with 1 HP 9/17
attack Adversary attack bonus; click to roll for attack +1
xp Adversary experiences Ambusher +2, Keen Senses +3
motives Adversary's motives and tactics Climb, defend territory, pummel, track
conditions Custom condition names for this adversary Poisoned, Burning
features List of feature objects, see table below
id Stat block id for state tracking; auto-generated, can be any random string a2sd4vsf

features properties:

Property Definition Example
name Name of the feature Relentless (2)
type Feature type Passive
desc Feature description Make a standard attack. On a success, the target is *Vulnerable* until they next act.
uses Uses per scene 2
countdown Size of the countdown 6
flavor Hints for GM/PCs Have any of the PCs forded rivers like this before?
summon Adversary name(s) to summon Skeleton Warrior or a YAML list

For environments, weapon, damage, range, hp, stress, thresholds, attack, xp, motives are not set. Instead, additional properties are available:

Property Definition Example
impulses Environment impulses Bar crossing, carry away the unready, divide the land
adversaries Potential adversaries in an environment Guards, Masked Thief, Merchant
tone Tone and feel of the environment Musty and mournful, serene yet slightly wrong

All properties are optional and simply won't render if skipped.

Every text property supports markdown — name, desc, weapon, range, damage, difficulty, xp, motives, tone, impulses, adversaries, and a feature's name, type, desc, and flavor. Use **bold**, *italic*, ==highlight==, `code`, ~~strikethrough~~, [[wikilinks]], #tags, and inline HTML. Quote any value that starts with a markdown character so YAML doesn't choke on it — name: "**Bear**", not name: **Bear**. (Renaming a card from the UI quotes the value for you.)

Markdown in damage may wrap dice notation — damage: "*2d6 magic*" renders as one emphasised phrase with a working roller inside it.

Bear in mind name already renders bold, so **bold** there changes nothing visible; italic, highlight, and code do show.

[!IMPORTANT] Do not use TAB in stat blocks. The indents for features must be manually indented with spaces.

Alt install method

  1. Go to the latest release
  2. Download main.js, manifest.json and styles.css
  3. Inside your Obsidian vault, create folder .obsidian/plugins/arroweds-adversary-bank
  4. Copy the downloaded files to this folder
  5. If Obsidian was open, restart it
  6. Navigate to Settings > Community plugins and enable Arroweds Adversary Bank

Release assets are built by GitHub Actions and published with GitHub artifact attestations. To verify a downloaded asset, install the GitHub CLI and run:

gh attestation verify main.js -R arrowedisgaming/arroweds-adversary-bank
gh attestation verify styles.css -R arrowedisgaming/arroweds-adversary-bank

Local development

pnpm install
pnpm dev     # rebuild on change
pnpm check   # typecheck, lint, production build

To test against a real vault, point the build at that vault's plugin folder — every build then writes main.js, manifest.json, and styles.css straight into it:

echo "/path/to/vault/.obsidian/plugins/arroweds-adversary-bank" > .dev-vault

.dev-vault is gitignored; $OBSIDIAN_PLUGIN_DIR overrides it for a single run. pnpm dev also watches styles.css and manifest.json, which esbuild doesn't rebuild on its own. pnpm sync copies the current build without rebuilding. The path must end in .obsidian/plugins/arroweds-adversary-bank or the sync refuses to run, so a typo can't scatter build output through a vault.

If two folders under .obsidian/plugins/ declare the same id in their manifest.json, Obsidian loads only one of them — and it may not be the one you're syncing to. Check for stale copies of this plugin under an old folder name if edits don't seem to take effect.

Obsidian caches plugin code, so reload it to pick up a rebuild (Ctrl+P > Reload app without saving). Hot Reload does this automatically if you add an empty .hotreload file to the plugin folder.

Attributions

Arroweds Adversary Bank began as a fork of BeastVault by Lyova Potyomkin, licensed under the MIT License. The original BeastVault was inspired by FreshCutGrass and DaggerForge.

This plugin includes materials from the Daggerheart System Reference Document 2.0, (c) Critical Role, LLC. All rights reserved.

Public Game Content created and owned by Darrington Press, LLC. Available at https://www.daggerheart.com.

Licensed under the Darrington Press Community Gaming License: https://darringtonpress.com/license/.

Stat blocks may have minor edits to correct obvious errors.