@opencharacter/awn-core 0.1.0 → 0.2.0

package/README.md

@@ -15,6 +15,9 @@ edition and is used with the author's permission. Nothing from the paid edition
 pnpm add @opencharacter/awn-core @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`).
+
 ```ts
 import { applyChanges, loadRuleset, startAction } from '@opencharacter/engine';
 import apocalypse from '@opencharacter/awn-core';
@@ -25,9 +28,9 @@ const { ruleset } = loaded;
 
 // A random survivor: every roll and pick made by the engine.
 const blank = {
-  specVersion: '0.2.0',
+  specVersion: '0.3.0',
   id: 'survivor',
-  packs: [{ id: 'awn-core', version: '0.1.0' }],
+  packs: [{ id: 'awn-core', version: '0.2.0' }],
   creating: true,
 };
 const run = startAction(ruleset, blank, {
@@ -83,13 +86,55 @@ const run = startAction(ruleset, blank, {
 - **Encumbrance:** Readied (equipped) and Stowed loads against Strength, small items bundled
   three to one when stowed, and the slower moves of pushing past the limits. A start that brings
   more than its Strength can haul stows Readied items, then leaves Stowed ones behind, heaviest
-  first, until it is within the limits.
+  first, until it is within the limits. A guided player picks which, but can't stop early.
 - **Rolled twice:** Weak Heart's Exert checks keep the worse of two 2d6 rolls; Constant
   Secretions (the `grapple` situational choice) and Survivalist (`foraging`) keep the better. An
   attack given its target's view (`participants.target`) rolls laser damage twice against Light
   Sensitivity, the higher kept.
 - **System strain and stress:** maximums with the edges, foci and mutations that change them.
 
+## Add-on packs
+
+A pack that depends on `awn-core` can add content of its types, and creation and advancement offer
+it with the core's, in the guided picks and the random draws:
+
+- **Edges and foci** join every pick. Their limits are tags, not IDs: `repeatable`, `first-edge`
+  (Forged By Fire), `needs-mutant`, `makes-mutant`, `not-mutant`, `not-underdog`. One with
+  `gainPart: true` runs its own `gain-part` action (`listed: false`) when taken, as Educated,
+  Mutant, Mutation Acceleration and Unstable Mutant do; an edge's mutation points are an effect on
+  `mutations.points.edges`.
+- **Prepared survivors' picks** are content of the type `prepared`: the item (`gear`, by ID;
+  another pack's qualified), its quantity, readied or not, and what comes with it (`extra`).
+- **Weapons:** a wasteland warrior's weapon is any primitive melee weapon, or a primitive one with
+  `kitAmmo` (the bow and its arrows), which comes with that ammunition.
+- **Mutations** join the chosen and the fallback picks; the d6 category and d10 tables, and the
+  d100 negative table, keep the book's odds.
+- **Mutation categories** are content of the type `mutationCategory`, which a mutation names in
+  `category`. An added category joins the "two in one category" pick; its mutations' `roll` is
+  their d10 roll within it.
+- **Tagged steps** take an add-on's rules-level `option` and `changes` effects: `creation.kit`
+  (the starting equipment option: an added option is another way to equip), `creation.mutation`
+  (how mutation points are spent), `creation.finish` (the last step of creation) and
+  `advancement.level` (each new level's level and skill points).
+
+- **Open enums:** the stigma fields (`stigma.part`, `stigma.part2`, `stigma.nature`,
+  `stigma.detail`), for more suggestions to set by hand; the rolled tables keep the book's.
+- **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,
+  `tail` added to `awn-core:fields.stigma.part` is
+  `fields.stigma.part.values.tail.name: Tail` (through `enumOrigins`).
+
+- **Skills** are the `skill` family: an add-on adds one (`families: { 'awn-core:skill': [<key>] }`)
+  and declares its `skills.<key>.level` (tagged `skill` and `skill.<key>`), `.credit` and `.cap`
+  (tagged `skill-cap` and `skill.<key>`). The core's changes reach them through `fieldId`, so
+  creation, `improve-skill`, skill points and a forbidding mutation gain, raise and lower it as the
+  core's. A background's entries (`freeSkill`, `quickSkill1`, `quickSkill2`, `growth1`–`growth6`,
+  `learning1`–`learning8`) and the parameters `improve-skill.skill` and `gain-benefit.entry` are
+  open enums that take its key.
+
+The near-future and wasteland d20 tables are the book's own tables.
+
 ## Rule readings
 
 - **Learning picks** may take any skill: every Learning table ends with Any Skill.

package/content/edges/educated.yaml

@@ -1,6 +1,7 @@
 id: edges.educated
 type: edge
 fields:
+  gainPart: true
   bonusSkill:
     [
       administer,
@@ -27,3 +28,13 @@ effects:
   - target: skills.perLevel
     op: add
     value: 1
+actions:
+  # Taken after 1st level: the bonus skill points of the levels before.
+  - id: gain-part
+    listed: false
+    steps:
+      - id: points
+        kind: changes
+        when: '!character.creating'
+        changes:
+          - { type: adjust, field: skills.points, by: level - 1 }

package/content/edges/focused.yaml

@@ -1,5 +1,6 @@
 id: edges.focused
 type: edge
+tags: [repeatable]
 effects:
   - target: foci.bonus
     op: add

package/content/edges/forged-by-fire.yaml

@@ -1,2 +1,3 @@
 id: edges.forged-by-fire
 type: edge
+tags: [first-edge]

package/content/edges/hardened-genetics.yaml

@@ -1,5 +1,6 @@
 id: edges.hardened-genetics
 type: edge
+tags: [not-mutant]
 prerequisites:
   - { id: not-mutant, when: '!mutations.mutant' }
 effects:

package/content/edges/mutant.yaml

@@ -1,5 +1,10 @@
 id: edges.mutant
 type: edge
+tags: [makes-mutant]
+fields:
+  gainPart: true
+effects:
+  - { target: mutations.points.edges, op: add, value: 2 }
 choices:
   # After the mutations: one attribute with a modifier of -1 or better takes -1.
   - id: penalty
@@ -20,3 +25,15 @@ choices:
           }
         op: add
         value: -1
+actions:
+  # Taken after creation: the mutations come at once.
+  - id: gain-part
+    listed: false
+    params:
+      random: { type: boolean, default: false }
+    steps:
+      - id: mutate
+        kind: action
+        when: '!character.creating'
+        use: mutate
+        params: { random: params.random }

package/content/edges/mutation-acceleration.yaml

@@ -1,4 +1,28 @@
 id: edges.mutation-acceleration
 type: edge
+tags: [needs-mutant]
 prerequisites:
   - { id: mutant, when: mutations.mutant }
+fields:
+  gainPart: true
+effects:
+  - { target: mutations.points.edges, op: add, value: 2 }
+actions:
+  # Taken after creation: its two points are spent at once.
+  - id: gain-part
+    listed: false
+    params:
+      random: { type: boolean, default: false }
+    steps:
+      - id: buy1
+        kind: action
+        sheet: proposed
+        when: '!character.creating && mutations.points.left >= 1'
+        use: buy-mutation
+        params: { random: params.random }
+      - id: buy2
+        kind: action
+        sheet: proposed
+        when: '!character.creating && mutations.points.left >= 1'
+        use: buy-mutation
+        params: { random: params.random }

package/content/edges/prodigy.yaml

@@ -1,5 +1,6 @@
 id: edges.prodigy
 type: edge
+tags: [not-underdog]
 prerequisites:
   - { id: not-underdog, when: '!edges.underdog' }
 choices:

package/content/foci/unstable-mutant.yaml

@@ -1,4 +1,18 @@
 id: foci.unstable-mutant
 type: focus
+tags: [needs-mutant]
 prerequisites:
   - { id: mutant, when: mutations.mutant }
+fields:
+  gainPart: true
+actions:
+  # A new level-1 focus: one free positive mutation, rolled.
+  - id: gain-part
+    listed: false
+    params:
+      random: { type: boolean, default: false }
+    steps:
+      - id: mutation
+        kind: action
+        use: roll-mutation
+        params: { origin: "'unstable'", random: params.random }

package/content/mutation-categories/cognition.yaml

@@ -0,0 +1,2 @@
+id: mutation-categories.cognition
+type: mutationCategory

package/content/mutation-categories/exotic.yaml

@@ -0,0 +1,2 @@
+id: mutation-categories.exotic
+type: mutationCategory

package/content/mutation-categories/hybrid.yaml

@@ -0,0 +1,2 @@
+id: mutation-categories.hybrid
+type: mutationCategory

package/content/mutation-categories/pseudo-psychic.yaml

@@ -0,0 +1,2 @@
+id: mutation-categories.pseudo-psychic
+type: mutationCategory

package/content/mutation-categories/sense.yaml

@@ -0,0 +1,2 @@
+id: mutation-categories.sense
+type: mutationCategory

package/content/mutation-categories/structure.yaml

@@ -0,0 +1,2 @@
+id: mutation-categories.structure
+type: mutationCategory

package/content/mutations/cognition/augmented-cognition.yaml

@@ -1,7 +1,7 @@
 id: mutations.cognition.augmented-cognition
 type: mutation
 fields:
-  category: cognition
+  category: mutation-categories.cognition
   roll: 1
 choices:
   - id: attribute

package/content/mutations/cognition/ballistic-calculator.yaml

@@ -1,6 +1,6 @@
 id: mutations.cognition.ballistic-calculator
 type: mutation
 fields:
-  category: cognition
+  category: mutation-categories.cognition
   roll: 2
   bonusSkill: [shoot]

package/content/mutations/cognition/eidetic-memory.yaml

@@ -1,7 +1,7 @@
 id: mutations.cognition.eidetic-memory
 type: mutation
 fields:
-  category: cognition
+  category: mutation-categories.cognition
   roll: 3
   bonusSkill:
     [

package/content/mutations/cognition/internal-map.yaml

@@ -1,5 +1,5 @@
 id: mutations.cognition.internal-map
 type: mutation
 fields:
-  category: cognition
+  category: mutation-categories.cognition
   roll: 4

package/content/mutations/cognition/intuitive-leap.yaml

@@ -1,7 +1,7 @@
 id: mutations.cognition.intuitive-leap
 type: mutation
 fields:
-  category: cognition
+  category: mutation-categories.cognition
   roll: 5
   bonusSkill: [notice]
 effects:

package/content/mutations/cognition/memory-eater.yaml

@@ -1,5 +1,5 @@
 id: mutations.cognition.memory-eater
 type: mutation
 fields:
-  category: cognition
+  category: mutation-categories.cognition
   roll: 6

package/content/mutations/cognition/mental-bifurcation.yaml

@@ -1,5 +1,5 @@
 id: mutations.cognition.mental-bifurcation
 type: mutation
 fields:
-  category: cognition
+  category: mutation-categories.cognition
   roll: 7

package/content/mutations/cognition/mind-over-body.yaml

@@ -1,7 +1,7 @@
 id: mutations.cognition.mind-over-body
 type: mutation
 fields:
-  category: cognition
+  category: mutation-categories.cognition
   roll: 8
 effects:
   - target: hp.attributeMod

package/content/mutations/cognition/omniglot.yaml

@@ -1,7 +1,7 @@
 id: mutations.cognition.omniglot
 type: mutation
 fields:
-  category: cognition
+  category: mutation-categories.cognition
   roll: 9
 effects:
   - target: attributes.cha.bonus

package/content/mutations/cognition/predictive-analysis.yaml

@@ -1,7 +1,7 @@
 id: mutations.cognition.predictive-analysis
 type: mutation
 fields:
-  category: cognition
+  category: mutation-categories.cognition
   roll: 10
 choices:
   - id: attribute

package/content/mutations/exotic/chameleon-field.yaml

@@ -1,7 +1,7 @@
 id: mutations.exotic.chameleon-field
 type: mutation
 fields:
-  category: exotic
+  category: mutation-categories.exotic
   roll: 1
   bonusSkill: [sneak]
 effects:

package/content/mutations/exotic/electrical-generation.yaml

@@ -1,5 +1,5 @@
 id: mutations.exotic.electrical-generation
 type: mutation
 fields:
-  category: exotic
+  category: mutation-categories.exotic
   roll: 2

package/content/mutations/exotic/hemovore.yaml

@@ -1,5 +1,5 @@
 id: mutations.exotic.hemovore
 type: mutation
 fields:
-  category: exotic
+  category: mutation-categories.exotic
   roll: 3

package/content/mutations/exotic/image-projection.yaml

@@ -1,5 +1,5 @@
 id: mutations.exotic.image-projection
 type: mutation
 fields:
-  category: exotic
+  category: mutation-categories.exotic
   roll: 4

package/content/mutations/exotic/metamorph.yaml

@@ -1,5 +1,5 @@
 id: mutations.exotic.metamorph
 type: mutation
 fields:
-  category: exotic
+  category: mutation-categories.exotic
   roll: 5

package/content/mutations/exotic/molecular-phasing.yaml

@@ -1,5 +1,5 @@
 id: mutations.exotic.molecular-phasing
 type: mutation
 fields:
-  category: exotic
+  category: mutation-categories.exotic
   roll: 6

package/content/mutations/exotic/natural-projectiles.yaml

@@ -1,7 +1,7 @@
 id: mutations.exotic.natural-projectiles
 type: mutation
 fields:
-  category: exotic
+  category: mutation-categories.exotic
   roll: 7
   bonusSkill: [shoot]
 standardCopies:

package/content/mutations/exotic/pheromone-cloud.yaml

@@ -1,5 +1,5 @@
 id: mutations.exotic.pheromone-cloud
 type: mutation
 fields:
-  category: exotic
+  category: mutation-categories.exotic
   roll: 8

package/content/mutations/exotic/photon-manipulation.yaml

@@ -1,5 +1,5 @@
 id: mutations.exotic.photon-manipulation
 type: mutation
 fields:
-  category: exotic
+  category: mutation-categories.exotic
   roll: 9

package/content/mutations/exotic/sound-generation.yaml

@@ -1,5 +1,5 @@
 id: mutations.exotic.sound-generation
 type: mutation
 fields:
-  category: exotic
+  category: mutation-categories.exotic
   roll: 10

package/content/mutations/hybrid/aquatic-adaptation.yaml

@@ -1,5 +1,5 @@
 id: mutations.hybrid.aquatic-adaptation
 type: mutation
 fields:
-  category: hybrid
+  category: mutation-categories.hybrid
   roll: 1

package/content/mutations/hybrid/arboreal-aptitude.yaml

@@ -1,5 +1,5 @@
 id: mutations.hybrid.arboreal-aptitude
 type: mutation
 fields:
-  category: hybrid
+  category: mutation-categories.hybrid
   roll: 2

package/content/mutations/hybrid/centauroid.yaml

@@ -1,7 +1,7 @@
 id: mutations.hybrid.centauroid
 type: mutation
 fields:
-  category: hybrid
+  category: mutation-categories.hybrid
   roll: 3
 effects:
   - target: move.base

package/content/mutations/hybrid/crushing-jaws.yaml

@@ -1,7 +1,7 @@
 id: mutations.hybrid.crushing-jaws
 type: mutation
 fields:
-  category: hybrid
+  category: mutation-categories.hybrid
   roll: 4
 standardCopies:
   - { type: weapon, where: 'item.id == @weapons.natural.jaws' }

package/content/mutations/hybrid/digitigrade-legs.yaml

@@ -1,7 +1,7 @@
 id: mutations.hybrid.digitigrade-legs
 type: mutation
 fields:
-  category: hybrid
+  category: mutation-categories.hybrid
   roll: 5
 effects:
   - target: move.base

package/content/mutations/hybrid/functional-wings.yaml

@@ -1,5 +1,5 @@
 id: mutations.hybrid.functional-wings
 type: mutation
 fields:
-  category: hybrid
+  category: mutation-categories.hybrid
   roll: 6

package/content/mutations/hybrid/prehensile-limb.yaml

@@ -1,5 +1,5 @@
 id: mutations.hybrid.prehensile-limb
 type: mutation
 fields:
-  category: hybrid
+  category: mutation-categories.hybrid
   roll: 7

package/content/mutations/hybrid/savage-claws.yaml

@@ -1,7 +1,7 @@
 id: mutations.hybrid.savage-claws
 type: mutation
 fields:
-  category: hybrid
+  category: mutation-categories.hybrid
   roll: 8
 standardCopies:
   - { type: weapon, where: 'item.id == @weapons.natural.claws' }

package/content/mutations/hybrid/thick-hide.yaml

@@ -1,7 +1,7 @@
 id: mutations.hybrid.thick-hide
 type: mutation
 fields:
-  category: hybrid
+  category: mutation-categories.hybrid
   roll: 9
 effects:
   - target: ac.armor

package/content/mutations/hybrid/venom-glands.yaml

@@ -1,5 +1,5 @@
 id: mutations.hybrid.venom-glands
 type: mutation
 fields:
-  category: hybrid
+  category: mutation-categories.hybrid
   roll: 10

package/content/mutations/pseudo-psychic/force-field.yaml

@@ -1,5 +1,5 @@
 id: mutations.pseudo-psychic.force-field
 type: mutation
 fields:
-  category: pseudo-psychic
+  category: mutation-categories.pseudo-psychic
   roll: 1

package/content/mutations/pseudo-psychic/induce-confusion.yaml

@@ -1,5 +1,5 @@
 id: mutations.pseudo-psychic.induce-confusion
 type: mutation
 fields:
-  category: pseudo-psychic
+  category: mutation-categories.pseudo-psychic
   roll: 2

package/content/mutations/pseudo-psychic/limited-precognition.yaml

@@ -1,5 +1,5 @@
 id: mutations.pseudo-psychic.limited-precognition
 type: mutation
 fields:
-  category: pseudo-psychic
+  category: mutation-categories.pseudo-psychic
   roll: 3

package/content/mutations/pseudo-psychic/mental-domination.yaml

@@ -1,5 +1,5 @@
 id: mutations.pseudo-psychic.mental-domination
 type: mutation
 fields:
-  category: pseudo-psychic
+  category: mutation-categories.pseudo-psychic
   roll: 4

package/content/mutations/pseudo-psychic/mind-reader.yaml

@@ -1,5 +1,5 @@
 id: mutations.pseudo-psychic.mind-reader
 type: mutation
 fields:
-  category: pseudo-psychic
+  category: mutation-categories.pseudo-psychic
   roll: 5

package/content/mutations/pseudo-psychic/neural-lockdown.yaml

@@ -1,5 +1,5 @@
 id: mutations.pseudo-psychic.neural-lockdown
 type: mutation
 fields:
-  category: pseudo-psychic
+  category: mutation-categories.pseudo-psychic
   roll: 6

package/content/mutations/pseudo-psychic/panic-wave.yaml

@@ -1,5 +1,5 @@
 id: mutations.pseudo-psychic.panic-wave
 type: mutation
 fields:
-  category: pseudo-psychic
+  category: mutation-categories.pseudo-psychic
   roll: 7

package/content/mutations/pseudo-psychic/spatial-displacement.yaml

@@ -1,5 +1,5 @@
 id: mutations.pseudo-psychic.spatial-displacement
 type: mutation
 fields:
-  category: pseudo-psychic
+  category: mutation-categories.pseudo-psychic
   roll: 8

package/content/mutations/pseudo-psychic/telekinetic-reach.yaml

@@ -1,5 +1,5 @@
 id: mutations.pseudo-psychic.telekinetic-reach
 type: mutation
 fields:
-  category: pseudo-psychic
+  category: mutation-categories.pseudo-psychic
   roll: 9

package/content/mutations/pseudo-psychic/thermokinesis.yaml

@@ -1,5 +1,5 @@
 id: mutations.pseudo-psychic.thermokinesis
 type: mutation
 fields:
-  category: pseudo-psychic
+  category: mutation-categories.pseudo-psychic
   roll: 10

package/content/mutations/sense/accelerated-perception.yaml

@@ -1,5 +1,5 @@
 id: mutations.sense.accelerated-perception
 type: mutation
 fields:
-  category: sense
+  category: mutation-categories.sense
   roll: 1

package/content/mutations/sense/acute-hearing.yaml

@@ -2,5 +2,5 @@ id: mutations.sense.acute-hearing
 type: mutation
 tags: [hearing]
 fields:
-  category: sense
+  category: mutation-categories.sense
   roll: 2

package/content/mutations/sense/acute-olfaction.yaml

@@ -1,5 +1,5 @@
 id: mutations.sense.acute-olfaction
 type: mutation
 fields:
-  category: sense
+  category: mutation-categories.sense
   roll: 3

package/content/mutations/sense/echolocation.yaml

@@ -2,5 +2,5 @@ id: mutations.sense.echolocation
 type: mutation
 tags: [hearing]
 fields:
-  category: sense
+  category: mutation-categories.sense
   roll: 4

package/content/mutations/sense/empathic-sensitivity.yaml

@@ -1,7 +1,7 @@
 id: mutations.sense.empathic-sensitivity
 type: mutation
 fields:
-  category: sense
+  category: mutation-categories.sense
   roll: 5
 effects:
   - target: { rolls: [check] }

package/content/mutations/sense/night-vision.yaml

@@ -2,5 +2,5 @@ id: mutations.sense.night-vision
 type: mutation
 tags: [vision]
 fields:
-  category: sense
+  category: mutation-categories.sense
   roll: 6

package/content/mutations/sense/panoptic-vision.yaml

@@ -2,5 +2,5 @@ id: mutations.sense.panoptic-vision
 type: mutation
 tags: [vision]
 fields:
-  category: sense
+  category: mutation-categories.sense
   roll: 7