@opencharacter/cwn-srd 0.1.0 → 0.2.0

package/README.md

@@ -17,6 +17,9 @@ affiliated with, approved or endorsed by Kevin Crawford or Sine Nomine Publishin
 pnpm add @opencharacter/cwn-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/cwn-srd/i18n/en` (also as JSON, `release.json` and `i18n/en.json`).
 
@@ -31,9 +34,9 @@ const { ruleset } = loaded;
 // A random character: attributes rolled in order, the background's skills rolled, every other
 // pick drawn.
 const blank = {
-  specVersion: '0.2.0',
+  specVersion: '0.3.0',
   id: 'new-operator',
-  packs: [{ id: 'cwn-srd', version: '0.1.0' }],
+  packs: [{ id: 'cwn-srd', version: '0.2.0' }],
   creating: true,
 };
 const run = startAction(ruleset, blank, {
@@ -81,7 +84,9 @@ the player's choices and other characters.
   two Acquaintances or a Friend, $500 and an item of up to $1,000. Edges and Foci bring their
   bonus skills, gear budgets, starting cyber, programs, spells and arts.
 - **Edges** (14, and the three magical ones) in rules-level choices: two at creation, the
-  Underdog Rule's, and a third at 5th level. **Foci** (26) are copies with a level, gained at
+  Underdog Rule's, and a third at 5th level. `gain-edge` finishes `closed` for the 5th-level
+  Edge below 5th level and for the Underdog Edge without the rule. The Underdog Rule counts the
+  modifiers of the rolled scores (`attributes.modTotal`), so its bonus Edge can't undo it. **Foci** (26) are copies with a level, gained at
   creation, at 2nd, 5th, 7th and 10th level and with Focused; a Focus's bonus skill during
   advancement is three skill points toward it, banked as credit.
 - **Advancement:** experience on the fast or slow table, a level-up action (hit points rerolled
@@ -108,6 +113,40 @@ the player's choices and other characters.
   with rest; Occult Pavis rolls saves against magic (`versusMagic`) twice.
 - **Contacts**, named by the player, as Acquaintances or Friends.
 
+## Add-on packs
+
+A pack that depends on `cwn-srd` can add content of its types, and creation and advancement offer
+it with the core's: backgrounds, Edges and Foci in the guided picks and the random draws, and
+weapons, armor, gear, cyberdecks and drones as the free starting item. What content brings is read
+from its fields and tags, not its ID: a Focus or Edge's `startingItems` and `startingCyber` (write
+another pack's items by qualified ID, `<pack>:gear.<id>`), `brings-cyber` for one that brings
+cyberware, `bars-cyber` for one that bars it (as All Natural does), `repeatable`, `not-underdog`.
+
+- **Open enums:** cyberware `category`, a program Subject's `subjectType` (a Verb's `targets`
+  name them), a drone's `moveKind` and a spell's `duration`. An add-on lists new values in
+  `extendEnums` and names them in its text.
+- **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,
+  `psionic` added to `cwn-srd:types.cyberware.fields.category` is
+  `types.cyberware.fields.category.values.psionic.name: Psionic` (through `enumOrigins`).
+- **Tagged steps** take an add-on's rules-level `option` and `changes` effects: `creation.item`
+  (the free starting item's kind: an added option is another free item), `creation.gear` (the
+  starting money and lifestyle), `creation.finish` (the last step of creation),
+  `advancement.level` (each new level), `rest.night` (a night's rest) and `rest.scene` (the end of
+  a scene).
+
+- **Skills** are the `skill` family: an add-on adds one (`families: { 'cwn-srd:skill': [<key>] }`)
+  and declares its `skills.<key>.base` (tagged `skill-base` and `skill.<key>`), `.credit` and
+  `.level` (tagged `skill` and `skill.<key>`). The core's changes reach them through `fieldId`, so
+  creation, a Focus's or Edge's bonus skill and `improve-skill` gain and raise it as the core's. A
+  background's entries (`freeSkill`, `growth1`–`growth6`, `learning1`–`learning8`), a Focus's
+  `bonusSkill`, `bonusSkill2` and `levelTwoSkill`, an Edge's `bonusSkill`, a weapon's `skill` and
+  the parameters `gain-skill.code` and `improve-skill.skill` are open enums that take its key.
+
+Still closed: the enums that are the rules' own: a program's `kind` (Verb or Subject), armor `kind`,
+cyberware `concealment`, a spell's `effort`, vehicle `size`, and the attributes.
+
 ## Left to the table
 
 - Situational modifiers (cover, range, prone targets, snap attacks, charges, dual wielding) are

package/content/foci/all-natural.yaml

@@ -2,6 +2,7 @@ id: foci.all-natural
 type: focus
 tags:
   - asks-attribute
+  - bars-cyber
 fields:
   maxLevel: 1
   bonusSkill: any