OSE Statblock Importer for Foundry VTT

Import Old-School Essentials statblocks into Foundry VTT v13 actors with preview, selective apply, SV/class mapping, monster-focused conversion logic, and compendium-backed equipment linking.

13.0.0 Highlights

• Parses OSE statblocks into structured actor updates with preview confidence, warnings, and unknown-token diagnostics.
• Handles OSE save mapping from SV abbreviations and applies class/level save progressions automatically.
• Recognizes class abbreviations with levels (for example Barb3, MU2, Rgr4) and auto-imports all matching class features from the Advanced Tome compendium.
• Improves monster import reliability with AC/AAC handling, damage-to-formula conversion, and generated Attack item updates.
• Auto-derives monster attack bonus from HD progression when missing in source damage lines.
• Links equipment from compendiums using canonicalized OSE item stubs and explicit magic-item matching behavior.

What It Does

• Adds an import workflow to actor sheets for OSE statblock text.
• Supports strict/lenient parse modes and single or multi-block import.
• Lets you selectively apply parsed fields before committing updates.
• Supports create-new-actor from parsed blocks.
• Preserves rollback snapshots so imports can be audited/recovered.

Features

• ApplicationV2 import dialog:
  • parse preview cards and confidence indicators
  • strict/lenient mode toggle
  • per-field apply controls
  • single and multi-block import flows
• Parser pipeline:
  • tokenization-first strategy
  • warnings/errors/unknown token reporting
  • flexible key aliases and variant field handling
• OSE save and class logic:
  • parses SV values (F, MU, C, NM, etc.)
  • writes actor class and save progression from class+level
  • resolves class abbreviations with levels (e.g. Barb3) for class-feature import
  • Normal Man (NM/NH) uses fixed 18/18/18/18/18
• Class feature import:
  • auto-adds items from ose-advancedfantasytome.abilities based on parsed class
  • avoids duplicate imports using compendium source UUID tracking
• Monster conversion helpers:
  • supports both descending AC and ascending AAC
  • converts damage ranges to dice formulas
  • creates/updates default monster Attack item
  • derives attack bonus from HD when needed
• Equipment matching:
  • canonical OSE item stub matching
  • compendium lookup and add-to-actor flow
  • explicit magic variant selection only when requested

Example Input

Mladen: AC 15; HD 1 (12 hp); MV 40'; #AT 1; Dmg 1-8 (axe); ML 10; SV F1; AL N; Str 10 Dex 6 Con 6 Int 16 Wis 8 Cha 13; Notes: armor leather+shield; weapon axe; traits direct, no-nonsense, blunt; role straightforward escort

Kobold: AC 7; HD 1/2; MV 40'; #AT 1; Dmg 1-4; ML 6; SV NM; AL C; Notes: small dog-faced humanoids, often with spears or slings

Requirements

• Foundry Virtual Tabletop v13
• OSE system in your world for schema-compatible actor updates

Installation

Use this manifest URL in Foundry (Add-on Modules -> Install Module -> Manifest URL):

https://raw.githubusercontent.com/apoapostolov/OSE-Statblock-Importer-for-Foundry-VTT/main/module.json

Direct module archive URL:

https://github.com/apoapostolov/OSE-Statblock-Importer-for-Foundry-VTT/archive/refs/heads/main.zip

Usage

1. Enable the module in your world.
2. Open an actor and click the Import header button.
3. Paste one or more OSE statblocks.
4. Review preview/warnings and apply selected fields.

Compatibility Notes

• Optimized for OSE statblock conventions and OSE actor data structures.
• Non-standard formatting can still parse, but strict mode is recommended for consistent results.

Changelog

See CHANGELOG.md.

License

MIT. See LICENSE.