@opencharacter/wwn-srd 0.1.0 → 0.2.0

package/README.md

@@ -18,6 +18,9 @@ Publishing.
 pnpm add @opencharacter/wwn-srd @opencharacter/engine
 ```
 
+This release needs spec 0.3: `@opencharacter/engine` 0.3.0 or later. An engine for an older
+spec refuses it (`spec-version-unsupported`).
+
 The package's default export is the pack's release, ready for `loadRuleset`; its English text is
 `@opencharacter/wwn-srd/i18n/en`.
 
@@ -31,9 +34,9 @@ const { ruleset } = loaded;
 
 // A random character: attributes, skills and silver rolled, every other pick drawn.
 const blank = {
-  specVersion: '0.2.0',
+  specVersion: '0.3.0',
   id: 'new',
-  packs: [{ id: 'wwn-srd', version: '0.1.0' }],
+  packs: [{ id: 'wwn-srd', version: '0.2.0' }],
   creating: true,
 };
 const run = startAction(ruleset, blank, {
@@ -87,7 +90,7 @@ computeSheet(ruleset, made.character).values['wwn-srd:saves.physical']?.value; /
 - **Gear:** the SRD's weapons, armor, adventuring gear, gear bundles and beasts, with
   encumbrance in Readied and Stowed items, bundles, worn clothing, coins and movement. A new
   character rolls 3d6 x 10 silver and buys a weapon, armor and up to six pieces of gear at list
-  price.
+  price; gear it couldn't carry isn't offered.
 - **Creation:** two starts running `create-character`, in the book's order.
   - `random`: attributes, three rolls split between Growth and Learning, and silver are rolled;
     the background, class, partial classes, Foci, arts, spells and purchases are drawn evenly
@@ -95,6 +98,41 @@ computeSheet(ruleset, made.character).values['wwn-srd:saves.physical']?.value; /
     finishes.
   - `guided`: the player picks, each pick recommended.
 
+## Add-on packs
+
+A pack that depends on `wwn-srd` can add content of its types, and creation and advancement offer
+it with the core's, in the guided picks and the random draws: classes, partial classes,
+backgrounds, foci, arts, spells, weapons, armor and gear.
+
+- **A Mage's tradition** is `tradition` content: its `key` is a key of the `trad` family, which
+  the add-on extends (`families: { 'wwn-srd:trad': [<key>] }`) and declares the fields for
+  (`tradition.<key>.tier`, counting the picks as the core's do, and `tradition.<key>.skill`, the
+  bonus skill at creation, set by an effect of the content that brings the tradition). A
+  tradition that casts from the spell lists joins `spellTrad` too; its spells are those of the
+  list named by its key, and the High Magic list.
+- **Spell lists and arts:** a spell's `list` and an art's `tradition` are open enums; an add-on adds
+  its tradition's key to them (`extendEnums`). A tradition with arts joins `artTrad` and declares
+  `arts.<key>.allowed`, `.taken` and `.owed`, which the art picks and `arts.owed` read. Joining
+  `armorTrad` (armor and shields stop its arts, as they stop spells) or `heavyArmorTrad` (medium
+  or heavy armor or a large shield do, as for the Duelist) sets when `commit-effort` is offered.
+- **Effort:** a tradition with Effort joins `effortTrad` and declares `effort.<key>.max`,
+  `.scene`, `.day`, `.ongoing` and `.free`; the core's `commit-effort` and `release-effort` change
+  them for its arts, and a night's rest and a scene's end clear them, as the core's.
+- **Skills:** a skill joins the `skill` family (`families: { 'wwn-srd:skill': [<key>] }`) and
+  declares `skills.<key>` (tagged `skill`) and `skillCredit.<key>`; creation and `improve` gain
+  and raise it as the core's. A background's table entries (`types.background.fields.freeSkill`,
+  `growth1`–`growth6`, `learning1`–`learning8`), a focus's `bonusSkill` and a weapon's `skill`
+  are open enums that take its key.
+- **Naming what an add-on adds:** it names each added value, option or key in its own text,
+  under the key this pack would use, and `createText` finds it there when the app passes the
+  ruleset's `enumOrigins`, `optionOrigins` and `familyOrigins`. For example,
+  a tradition `stormcaller` added to `wwn-srd:types.spell.fields.list` is
+  `types.spell.fields.list.values.stormcaller.name: Stormcaller` (through `enumOrigins`).
+- **Tagged steps** take an add-on's rules-level `option` and `changes` effects: `creation.purse`
+  (the starting silver), `creation.finish` (the last step of creation), `advancement.level` (each
+  new level's level and skill points), `rest.night` (a night's rest) and `rest.scene` (the end of
+  a scene).
+
 ## Left to the app or the table
 
 - **Text effects.** Most arts, Foci and spells change no number on the sheet; their names are

package/content/classes/mage.yaml

@@ -1,20 +1,8 @@
 id: classes.mage
 type: class
+tags: [full-mage]
 effects:
   - { target: class.mage, op: add, value: 2 }
 choices:
   - id: tradition
-    from:
-      options:
-        - id: high-mage
-          effects:
-            - { target: tradition.highmage.tier, op: add, value: 2 }
-        - id: elementalist
-          effects:
-            - { target: tradition.elementalist.tier, op: add, value: 2 }
-        - id: necromancer
-          effects:
-            - { target: tradition.necromancer.tier, op: add, value: 2 }
-        - id: invoker
-          effects:
-            - { target: tradition.invoker.tier, op: add, value: 2 }
+    from: { type: tradition }

package/content/foci/lucky.yaml

@@ -5,6 +5,7 @@ fields:
   requires: low-attribute
 prerequisites:
   - id: low-attribute
+    # A score that gives -1 or less, whatever later bonuses (Xenoblooded) do to the modifier.
     when: >-
-      min(attributes.str.mod, attributes.dex.mod, attributes.con.mod, attributes.int.mod,
-        attributes.wis.mod, attributes.cha.mod) <= -1
+      min(attributes.str.score, attributes.dex.score, attributes.con.score, attributes.int.score,
+        attributes.wis.score, attributes.cha.score) <= 7

package/content/foci/traditional-education.yaml

@@ -9,7 +9,7 @@ prerequisites:
 choices:
   # The specialist tradition whose spells and first-level arts the Invoker gains.
   - id: tradition
-    from: { values: [highmage, elementalist, necromancer] }
+    from: { values: { formula: "keysOf('spellTrad')" } }
     recommend: "'elementalist'"
     effects:
       - { target: invoker.education, op: set, value: pick.value }

package/content/partials/accursed.yaml

@@ -4,6 +4,7 @@ tags: [mage-class]
 effects:
   - { target: class.mage, op: add, value: 1 }
   - { target: tradition.accursed.tier, op: add, value: 1 }
+  - { target: tradition.accursed.skill, op: set, value: "'magic'" }
 choices:
   # The starting art: Accursed Blade or Accursed Bolt.
   - id: starting-art

package/content/partials/bard.yaml

@@ -4,5 +4,6 @@ effects:
   - { target: chassis.attackExpert, op: add, value: 1 }
   - { target: chassis.hitsExpert, op: add, value: 1 }
   - { target: tradition.bard.tier, op: add, value: 1 }
+  - { target: tradition.bard.skill, op: set, value: "'perform'" }
 grants:
   - { item: arts.bard.a-thousand-tongues }

package/content/partials/beastmaster.yaml

@@ -4,5 +4,6 @@ tags: [mage-class]
 effects:
   - { target: class.mage, op: add, value: 1 }
   - { target: tradition.beastmaster.tier, op: add, value: 1 }
+  - { target: tradition.beastmaster.skill, op: set, value: "'survive'" }
 grants:
   - { item: arts.beastmaster.bind-companion }

package/content/partials/blood-priest.yaml

@@ -4,3 +4,4 @@ tags: [mage-class]
 effects:
   - { target: class.mage, op: add, value: 1 }
   - { target: tradition.bloodpriest.tier, op: add, value: 1 }
+  - { target: tradition.bloodpriest.skill, op: set, value: "'pray'" }

package/content/partials/duelist.yaml

@@ -5,5 +5,6 @@ effects:
   - { target: class.mage, op: add, value: 1 }
   - { target: chassis.fragile, op: add, value: 1 }
   - { target: tradition.duelist.tier, op: add, value: 1 }
+  - { target: tradition.duelist.skill, op: set, value: "'stab'" }
 grants:
   - { item: arts.duelist.favored-weapon }

package/content/partials/healer.yaml

@@ -4,5 +4,6 @@ tags: [mage-class]
 effects:
   - { target: class.mage, op: add, value: 1 }
   - { target: tradition.healer.tier, op: add, value: 1 }
+  - { target: tradition.healer.skill, op: set, value: "'heal'" }
 grants:
   - { item: arts.healer.healing-touch }

package/content/partials/mage.yaml

@@ -8,26 +8,5 @@ effects:
 choices:
   - id: tradition
     unique: partial-traditions
-    from:
-      options:
-        - id: high-mage
-          prerequisites:
-            - { id: no-invoker, when: tradition.invoker.tier == 0 }
-          effects:
-            - { target: tradition.highmage.tier, op: add, value: 1 }
-        - id: elementalist
-          prerequisites:
-            - { id: no-invoker, when: tradition.invoker.tier == 0 }
-          effects:
-            - { target: tradition.elementalist.tier, op: add, value: 1 }
-        - id: necromancer
-          prerequisites:
-            - { id: no-invoker, when: tradition.invoker.tier == 0 }
-          effects:
-            - { target: tradition.necromancer.tier, op: add, value: 1 }
-        - id: invoker
-          prerequisites:
-            - id: no-other-caster
-              when: tradition.highmage.tier + tradition.elementalist.tier + tradition.necromancer.tier == 0
-          effects:
-            - { target: tradition.invoker.tier, op: add, value: 1 }
+    requiresOption: true
+    from: { type: tradition }

package/content/partials/mageslayer.yaml

@@ -4,6 +4,7 @@ effects:
   - { target: chassis.attackWarrior, op: add, value: 1 }
   - { target: chassis.hitsExpert, op: add, value: 1 }
   - { target: tradition.mageslayer.tier, op: add, value: 1 }
+  - { target: tradition.mageslayer.skill, op: set, value: "'magic'" }
 # Arts at a set rate.
 grants:
   - { item: arts.mageslayer.antimage, when: level >= 1 }

package/content/partials/skinshifter.yaml

@@ -4,5 +4,6 @@ tags: [mage-class]
 effects:
   - { target: class.mage, op: add, value: 1 }
   - { target: tradition.skinshifter.tier, op: add, value: 1 }
+  - { target: tradition.skinshifter.skill, op: set, value: "'survive'" }
 grants:
   - { item: arts.skinshifter.change-form }

package/content/partials/thought-noble.yaml

@@ -4,5 +4,6 @@ tags: [mage-class]
 effects:
   - { target: class.mage, op: add, value: 1 }
   - { target: tradition.thoughtnoble.tier, op: add, value: 1 }
+  - { target: tradition.thoughtnoble.skill, op: set, value: "'notice'" }
 grants:
   - { item: arts.thought-noble.open-mind }

package/content/partials/vowed.yaml

@@ -4,6 +4,7 @@ tags: [mage-class]
 effects:
   - { target: class.mage, op: add, value: 1 }
   - { target: tradition.vowed.tier, op: add, value: 1 }
+  - { target: tradition.vowed.skill, op: set, value: 'vowed.skill' }
 grants:
   - { item: arts.vowed.martial-style }
   - { item: arts.vowed.unarmed-might }

package/content/partials/wise.yaml

@@ -3,6 +3,7 @@ type: partial
 effects:
   - { target: chassis.hitsExpert, op: add, value: 1 }
   - { target: tradition.wise.tier, op: add, value: 1 }
+  - { target: tradition.wise.skill, op: set, value: 'wise.skill' }
 choices:
   # The skill that suits the Wise's concept.
   - id: skill

package/content/traditions/elementalist.yaml

@@ -0,0 +1,8 @@
+id: traditions.elementalist
+type: tradition
+fields:
+  key: elementalist
+prerequisites:
+  - { id: no-invoker, when: tradition.invoker.tier == 0 }
+effects:
+  - { target: tradition.elementalist.skill, op: set, value: "'magic'" }

package/content/traditions/high-mage.yaml

@@ -0,0 +1,8 @@
+id: traditions.high-mage
+type: tradition
+fields:
+  key: highmage
+prerequisites:
+  - { id: no-invoker, when: tradition.invoker.tier == 0 }
+effects:
+  - { target: tradition.highmage.skill, op: set, value: "'magic'" }

package/content/traditions/invoker.yaml

@@ -0,0 +1,9 @@
+id: traditions.invoker
+type: tradition
+fields:
+  key: invoker
+prerequisites:
+  - id: no-other-caster
+    when: tradition.highmage.tier + tradition.elementalist.tier + tradition.necromancer.tier == 0
+effects:
+  - { target: tradition.invoker.skill, op: set, value: "'magic'" }

package/content/traditions/necromancer.yaml

@@ -0,0 +1,8 @@
+id: traditions.necromancer
+type: tradition
+fields:
+  key: necromancer
+prerequisites:
+  - { id: no-invoker, when: tradition.invoker.tier == 0 }
+effects:
+  - { target: tradition.necromancer.skill, op: set, value: "'magic'" }