Mythcode

Beast (creature)

Creatures use schema: mythforge/creature/v1. Only schema, name, ac, hp.average, and the six ability scores are required; everything else has a sensible default. Tags drive shelving and appearance: a creature-type tag (aberration, beast, celestial, construct, dragon, elemental, fey, fiend, giant, humanoid, monstrosity, ooze, plant, undead) picks the icon, and a size tag (tiny, small, medium, large, huge, gargantuan) shows a size badge. A few alias tags pick icons too: human, goblinoid, devil, demon, titan, shapechanger, and any tag starting with swarm.

Anywhere a table below says dice, the notation is validated: NdM with an optional modifier (6d8+12), keep clauses (4d6kh3, 2d20kl1), and an adv or dis suffix. Die counts run 1–100 and sides 2–1000. A damage string is dice first, then an optional damage type: 2d6+2 slashing, flat 1 piercing, or bare 2d6 with no type at all.

Template: paste this into Import

schema: mythforge/creature/v1
name: Cave Lurker
ac: 13
hp:
  average: 22
  formula: 4d8+4
speed:
  walk: 30
  climb: 20
abilities:
  str: 14
  dex: 12
  con: 13
  int: 3
  wis: 10
  cha: 5
attacks:
  - name: Bite
    to_hit: 4
    damage: 1d8+2 piercing
    type: melee
tags:
  - monstrosity
  - medium

Worked example

schema: mythforge/creature/v1
name: Ashwing Drake
ac: 17
hp:
  average: 75
  formula: 10d10+20
speed:
  walk: 30
  fly: 60
abilities:
  str: 18
  dex: 12
  con: 15
  int: 8
  wis: 11
  cha: 14
saves:
  dex: 4
  con: 5
  wis: 3
skills:
  perception: 6
  stealth: 4
senses:
  - blindsight 30 ft.
  - darkvision 120 ft.
passivePerception: 16
languages: Draconic
alignment: chaotic evil
xp: 1800
damageImmunities:
  - fire
attacks:
  - name: Bite
    to_hit: 7
    damage: 2d10+4 piercing
    type: melee
  - name: Claw
    to_hit: 7
    damage: 2d6+4 slashing
    type: melee
resources:
  - name: Fire Breath
    max: 1
    recharge: recharge_5_6
actions:
  - name: Fire Breath
    text: >-
      The drake exhales fire in a 30-foot cone. Each creature in that area
      must make a DC 14 Dexterity saving throw, taking 8d6 fire damage on a
      failed save, or half as much damage on a successful one.
    save:
      ability: dex
      dc: 14
      onSuccess: half
    damage:
      - dice: 8d6
        type: fire
    resourceName: Fire Breath
legendaryActions:
  - name: Tail Swipe
    text: The drake makes one tail attack.
    cost: 1
    toHit: 7
    damage:
      - dice: 1d8+4
        type: bludgeoning
reactions:
  - name: Wing Buffet
    text: >-
      When a creature the drake can see hits it with a melee attack, the
      drake beats its wings. The attacker must succeed on a DC 14 Strength
      saving throw or be knocked prone.
    save:
      ability: str
      dc: 14
      onSuccess: none
tags:
  - dragon
  - large
source:
  license: Homebrew

NPC

An NPC is not a separate schema: it is a creature (schema: mythforge/creature/v1) whose tags include npc. That one tag is what shelves it under NPCs instead of Beasts; every creature field above applies unchanged.

By convention, generated NPCs also carry a race tag and an occupation tag, which power the NPC shelf’s browsing. Races: human, elf, dwarf, halfling, gnome, half-orc, tiefling, dragonborn. Occupations: shopkeeper, innkeeper, blacksmith, farmer, guard, priest, scholar, thief, hunter, bard, healer, sailor. Both lists are conventions, not validation; any tag imports fine.

Template: paste this into Import

schema: mythforge/creature/v1
name: Marta Thistledown
ac: 10
hp:
  average: 9
  formula: 2d8
abilities:
  str: 11
  dex: 10
  con: 12
  int: 11
  wis: 14
  cha: 13
attacks:
  - name: Iron skillet
    to_hit: 2
    damage: 1d6 bludgeoning
    type: melee
traits:
  - name: Heard It All
    text: Advantage on Insight checks against obvious lies.
tags:
  - npc
  - halfling
  - innkeeper

Worked example

schema: mythforge/creature/v1
name: Brother Aldous
role: independent
ac: 12
hp:
  average: 27
  formula: 5d8+5
speed:
  walk: 30
abilities:
  str: 10
  dex: 10
  con: 12
  int: 11
  wis: 16
  cha: 13
attacks:
  - name: Mace
    to_hit: 2
    damage: 1d6 bludgeoning
    type: melee
traits:
  - name: Devout
    text: Advantage on saving throws against being frightened.
skills:
  medicine: 5
  religion: 2
languages: Common, Dwarvish
spellcasting:
  ability: wis
  proficiencyBonus: 2
  saveDc: 13
  attackBonus: 5
  slots:
    - level: 1
      max: 4
    - level: 2
      max: 2
  knownSpells:
    - spellId: srd:sacred-flame
      name: Sacred Flame
      level: 0
      castMode: at_will
    - spellId: srd:bless
      name: Bless
      level: 1
      castMode: slot
inventory:
  - itemId: srd:potion-of-healing
    name: Potion of Healing
    quantity: 2
tags:
  - npc
  - human
  - priest

Spell

Spells use schema: mythforge/spell/v1. Level 0 is a cantrip. The components block is required (all three flags default to false). castingTime, range, and duration are free-text strings, exactly as they read on a spell card.

Template: paste this into Import

schema: mythforge/spell/v1
name: Ember Lash
level: 1
school: evocation
castingTime: 1 action
range: 60 feet
components:
  verbal: true
  somatic: true
duration: Instantaneous
classes:
  - sorcerer
  - wizard
description: >-
  A whip of embers lashes one creature you can see within range. The target
  must succeed on a Dexterity saving throw or take 2d8 fire damage.

Worked example

schema: mythforge/spell/v1
name: Veil of Brambles
level: 2
school: conjuration
castingTime: 1 action
range: 90 feet
components:
  verbal: true
  somatic: true
  material: true
  materialDesc: a handful of thorns
duration: Concentration, up to 1 minute
concentration: true
ritual: false
classes:
  - druid
  - ranger
description: >-
  Grasping brambles erupt across a 20-foot square of ground you can see
  within range. The area becomes difficult terrain, and a creature that
  enters the area or starts its turn there must succeed on a Dexterity
  saving throw or take 2d6 piercing damage.
higherLevels: >-
  When you cast this spell using a spell slot of 3rd level or higher, the
  damage increases by 1d6 for each slot level above 2nd.
tags:
  - area
  - control

Item

Items use schema: mythforge/item/v1. Only schema, name, and category are required. A weapon’s damage is a validated damage string, dice first with an optional damage type after, exactly as in creature attacks. properties and the armor-ish armorClass are free-form strings, and stealthDisadvantage a simple boolean, so the rest of the format never fights a homebrew item.

Template: paste this into Import

schema: mythforge/item/v1
name: Lantern of Steady Light
category: wondrous
rarity: common
weight: 2
cost: 50 gp
description: >-
  This hooded lantern burns without oil, shedding bright light in a 30-foot
  radius. Speaking its command word extinguishes or relights it.

Worked example

schema: mythforge/item/v1
name: Duskfang Dagger
category: weapon
rarity: rare
attunement: true
weight: 1
cost: 2000 gp
damage: 1d4 piercing
properties:
  - finesse
  - light
  - thrown (range 20/60)
description: >-
  You gain a +1 bonus to attack and damage rolls made with this magic
  weapon. While you hold it in dim light or darkness, you can take the
  Hide action as a bonus action.
tags:
  - magic

Encounter

Encounters use schema: mythforge/encounter/v1: a prebuilt fight — the monster roster, an optional battle map, and any counters — in one block. It is a clean template, never a snapshot: sharing strips party members and everything a running fight accumulates (current hp, initiative, round, conditions), and importing always creates a fresh, un-started encounter in your active campaign.

Each monsters[] entry references its statblock through ref. An srd:-prefixed ref (srd:goblin, srd2024:goblin) resolves against the SRD compendium every install ships with. Any other ref must name an entry under creatures:, where the full statblock travels inside the encounter — each value there is an ordinary, complete mythforge/creature/v1 block you could copy out and import on its own. Importing an encounter adds its embedded homebrew to your bestiary and links the combatants to those new entries.

Map tokens address roster entries by key: an entry with count: 3 and key goblin owns tokens goblin.1 through goblin.3, while a count-1 entry uses its bare key. Token size is not stored — a Large creature takes a 2×2 footprint automatically from its size tag. The optional edition field records which ruleset (2014 or 2024) the encounter was built under; imported homebrew is labelled with it.

Template: paste this into Import

schema: mythforge/encounter/v1
name: Cave Mouth Sentries
edition: '2024'
monsters:
  - key: goblin
    ref: srd:goblin
    count: 2
    group: Sentries
map:
  cols: 10
  rows: 8
  terrain:
    "4,2": tree
    "5,2": rock
  tokens:
    goblin.1:
      x: 3
      y: 5
    goblin.2:
      x: 6
      y: 5

Worked example

schema: mythforge/encounter/v1
name: Ambush at the Ford
edition: '2024'
counters:
  - name: Reinforcement pool
    value: 4
    tickPerRound: -1
    alertAt: 0
monsters:
  - key: goblin
    ref: srd:goblin
    count: 3
    group: Goblins
  - key: warg-rider
    ref: warg-rider
    count: 2
    group: Riders
    arrivalRound: 3
  - key: scout
    ref: srd:scout
    side: party
    name: Tam the Guide
creatures:
  warg-rider:
    schema: mythforge/creature/v1
    name: Warg Rider
    ac: 14
    hp:
      average: 22
      formula: 4d8+4
    abilities:
      str: 14
      dex: 13
      con: 12
      int: 8
      wis: 10
      cha: 7
    attacks:
      - name: Spear
        to_hit: 4
        damage: 1d6+2 piercing
        type: melee
    tags:
      - humanoid
      - medium
map:
  cols: 12
  rows: 16
  background: green
  wallColor: brown
  terrain:
    "3,4": tree
    "3,5": rock
    "4,4": water
  fog:
    - "0,0"
    - "1,0"
  tokens:
    goblin.1:
      x: 2
      y: 3
    goblin.2:
      x: 3
      y: 3
    goblin.3:
      x: 4
      y: 4
    warg-rider.1:
      x: 5
      y: 5
    warg-rider.2:
      x: 6
      y: 5
    scout:
      x: 6
      y: 10