Reference for what Mimir tracks on player characters and NPCs. For full table schemas, see the Data Model.
PCs and NPCs share one data model. The is_npc flag distinguishes them and controls which fields are relevant:
| Aspect |
PC |
NPC |
player_name |
Real player’s name |
— |
role, location, faction |
— |
NPC organization fields |
| Listing |
PC-only campaign lists |
NPC-only campaign lists |
Both kinds support the full set of related records below (classes, inventory, spells, and so on).
| Category |
Fields |
| Identity |
Name, race (catalog reference), background (catalog reference) |
| Ability scores |
Strength, Dexterity, Constitution, Intelligence, Wisdom, Charisma (default 10) |
| Currency |
cp, sp, ep, gp, pp |
| Personality |
Traits, ideals, bonds, flaws |
Characters can have any number of class entries, one per class:
| Field |
Description |
| Class + source |
e.g., Fighter (PHB) |
| Level |
Levels in this class |
| Subclass + source |
Set when the class reaches its subclass level |
| Starting class |
Flags the first class, for multiclass proficiency rules |
| Field |
Description |
| Item + source |
Catalog or homebrew item reference |
| Quantity |
Stack count |
| Equipped |
Worn/held flag |
| Attuned |
Attunement flag; Mimir counts attuned items (the D&D 5e limit of 3 is a game rule, tracked but not enforced) |
| Notes |
Free-text notes |
| Field |
Description |
| Spell + source |
Catalog spell reference |
| Source class |
Which class grants the spell |
| Prepared |
Whether currently prepared (known vs. prepared) |
| Field |
Description |
| Type |
skill, save, tool, weapon, armor, or language |
| Name |
e.g., “Perception”, “Thieves’ Tools” |
| Expertise |
Double proficiency bonus flag |
Selectable class features chosen during level-up:
| Type |
Granted by |
fighting_style |
Fighter 1, Paladin 2, Ranger 2 |
metamagic |
Sorcerer 3, 10, 17 |
maneuver |
Battle Master 3, 7, 10, 15 |
invocation |
Warlock 2, 5, 7, 9, 12, 15, 18 |
pact_boon |
Warlock 3 |
Each feature records its source class.
| Field |
Description |
| Feat + source |
Catalog feat reference |
| Source type |
How it was acquired: asi, race, class, or bonus |
Characters can carry their own enabled-source list, separate from the campaign’s source filter.
A level-up request specifies:
| Choice |
Options |
| Class |
Any class (adding a new class multiclasses) |
| HP gain |
Average (half hit die + 1, rounded up), Roll (enter the die result), or Manual (enter any value) |
| Subclass |
Required at the class’s subclass level |
| ASI or feat |
Ability score improvement (+2 total across one or two abilities) or a feat |
| Spell changes |
New spells, new cantrips, and one known-spell swap |
| Feature choices |
Fighting style, metamagic, maneuvers (with swap), invocations (with swap), pact boon, expertise skills (Rogue 1/6, Bard 3/10) |