modwright 0.1.0

package/scaffolds/cyberpunk2077/new-player-replacer.yaml

@@ -0,0 +1,1003 @@
+# new-player-replacer (Cyberpunk 2077), Part A: the body (decided
+# 2026-09-24: the body alone first, the take later).
+#
+# A replacer is a second PlayerPuppet the engine switches the player into:
+# V's own FPP entity template with its `appearances` pointed at another
+# `.app`, spawned from a Character record that derives
+# Character.Player_Replacer_Puppet_Base, and switched to by the quest node
+# questReplacer_NodeType. The node's enable only stores a body the
+# community system spawned (fact
+# cp2077.player.control.replacer-enable-stores-the-body-through-its-entity-stub),
+# so the body comes with the world pieces that spawn it that way. A working
+# android-body mod ships all of this by hand; this scaffold is that work
+# with the mod's names turned into inputs. Every value in the three world
+# resources below is hand-written; nothing is copied from a game file, and
+# the entity comes from the user's install through the template cache at
+# scaffold time, as in new-entity-patch and new-item-chain.
+#
+# What it writes (one run per body):
+#   1. `<body>.ent.json` — the template, rewritten:
+#      - `appearances` replaced by one entry wearing `appearanceName` from
+#        `targetApp` (the entity-level name is the .app's own), and
+#        `defaultAppearance` set to it; plus one entry per `extraLooks` row
+#        (optional, empty by default: `entityName|appearanceName|app`), so
+#        a mod can switch the body to the look of the target it took over
+#        (the 2.0 android templates wear 28 looks from two .apps under
+#        entity-level names such as corpo__android_ma_militech_droid__lvl2_01;
+#        fact cp2077.npc.appearance.world-androids-use-the-2-0-templates);
+#      - the `hud_component` pointed at V's HUD (prototype_hud.inkhud with
+#        ui_main_hud.mt), in the component list and in the compiled package.
+#        The android replacer loads mq060's showroom proxy HUD
+#        (cp2077.player.control.android-replacer-loads-the-showroom-hud);
+#        A mod can fix that with an ArchiveXL patch entity on the vanilla
+#        template. Here the mod owns the copy, so the change is made in the
+#        copy and no patch entity is needed. On V's own template the rewrite
+#        restates what is there.
+#      The template must be on the rig family's player skeleton (the
+#      `require` below): the replacer is V's skeleton, so only same-rig
+#      humans and the androids can be worn.
+#   2. A TweakXL record deriving Character.Player_Replacer_Puppet_Base. Its
+#      flats follow Character.android_replacer (read from the vanilla index,
+#      2026-09-24): entityTemplatePath and appearanceName; persistentName
+#      emptied (the base's "#player_current_object" is V's); savable;
+#      priority Quest; no item groups; the android's five attachment slots.
+#      The android's own stat modifiers (no RAM or health regen, half
+#      visibility) are left out as a showroom choice, and the stat pools
+#      are inherited from the player (V's RAM among them).
+#   3. The AlwaysLoaded streaming sector (the community registry with one
+#      entry, the compiled community area, one AI spot), its streaming
+#      block, and a quest phase ArchiveXL merges into the main quest and
+#      the Phantom Liberty standalone quest. The phase runs two loops from
+#      its input node, each gated on a fact:
+#        <body>_spawn    >= 1 -> community Activate;  == 0 -> Deactivate
+#        <body>_replacer >= 1 -> questReplacer_NodeType enable 1 on the
+#                                entry;               == 0 -> enable 0
+#      Handles are named for what they are (`spawnWaitOn.In`,
+#      `start.Out->spawnWaitOn.In`) and numbered by the engine in encounter
+#      order, which keeps the numbering stable between runs.
+#   4. The .xl entries: `streaming.blocks` and `quest.phases` (appended
+#      once each, `unique`), and four deserialize build steps.
+#
+# NodeRefs: the community and the spot are
+# `$/03_night_city/#<nodeRefGroup>/#<body>_community` and `..._spot`; their
+# ids are FNV-1a 64 of the same path with the `#` marks left out
+# (cp2077.quests.scenes.noderef-hash-is-fnv-of-the-path-without-hash-marks),
+# the `fnv1a64` id form over the mark-free slot. The quest names the
+# community by its alias `#<body>_community`, as vanilla does. The spot's
+# persistent position is FixedPoint bits (metres x 2^17), the `fixed-point`
+# id form. The spot's orientation is fixed (yaw 0).
+#
+# Not here (Part B): the take (the lead, the guard, the
+# first-person pass, the carry-in and carry-back, the release), the target
+# hide, and the plugin the switch needs. The `<body>_replacer` loop runs
+# the vanilla node, and on its own that switch crashed at the body's first
+# resize event (observed in game); it held only with a plugin guarding the
+# resize handler. The manual checklist says so.
+id: cyberpunk2077.new-player-replacer
+game: cyberpunk2077
+title: New Cyberpunk 2077 player replacer body (a playable body for a same-rig target)
+summary: Copy a replacer entity template from the install with its appearance pointed at a target's .app and V's HUD, derive a TweakXL record from Character.Player_Replacer_Puppet_Base, and write the community sector, streaming block and fact-gated quest phase that spawn it and run the replacer switch, with the .xl entries and build steps.
+modTypes: [player-replacer, npc, quickhack]
+needs: { index: true }
+inputs:
+  - type: string
+    name: modSlug
+    prompt: "Lowercase depot folder name for this mod, e.g. mymod. The body's files compile to mod\\<modSlug>\\<bodyName>\\."
+    pattern: "^[a-z][a-z0-9_]*$"
+  - type: string
+    name: bodyName
+    prompt: "Lowercase name for this body, e.g. my_body. It names the files, the NodeRefs (#<bodyName>_community, #<bodyName>_spot) and the two facts (<bodyName>_spawn, <bodyName>_replacer)."
+    pattern: "^[a-z][a-z0-9_]*$"
+  - type: string
+    name: nodeRefGroup
+    prompt: "The NodeRef group the community and the spot sit under, e.g. mymod for $/03_night_city/#mymod/#<bodyName>_community. Keep it unique to the mod."
+    pattern: "^[a-z][a-z0-9_]*$"
+  - type: string
+    name: entryName
+    prompt: "The community entry's name, the name a script passes to GetFixedEntityIdsFromSpawnerEntityID to find the body, e.g. android_replacer, or the body name."
+    pattern: "^[a-z][a-z0-9_]*$"
+  - type: string
+    name: recordName
+    prompt: "The body's TweakDB record, e.g. Character.my_android_body."
+    pattern: "^Character\\.[A-Za-z][A-Za-z0-9_]*$"
+  - type: enum
+    name: rigFamily
+    prompt: "The rig family of the target and of the template: man (the _ma bodies, player_man_skeleton.rig) or woman (the _wa bodies, player_woman_skeleton.rig)."
+    values: [man, woman]
+  - type: template-record
+    name: template
+    prompt: "Template cache directory of the replacer entity, extracted from your install with the template tool: base\\quest\\minor_quests\\mq060\\entities\\mq060_android_replacer_v2.ent (the man android; _v2_f.ent for the woman) or base\\characters\\entities\\player\\player_ma_fpp.ent / player_wa_fpp.ent (V herself, for a human target). It must be on the rig family's skeleton."
+  - type: string
+    name: targetApp
+    prompt: "Depot path of the target's .app, e.g. base\\characters\\appearances\\corpo\\corpo__android_ma.app. Backslashes, lowercase, no leading slash."
+    pattern: "^[a-z0-9_]+(\\\\[a-z0-9_.]+)+\\.app$"
+  - type: string
+    name: appearanceName
+    prompt: "The appearance in that .app the body wears, e.g. arasaka_droid__lvl2_01. It is also the entity's appearance name, the record's appearanceName and the community phase's appearance."
+    pattern: "^[A-Za-z0-9_]+$"
+  - type: list
+    name: extraLooks
+    prompt: "Optional further looks the body can switch to, one per line: entityName|appearanceName|app, e.g. corpo__android_ma_militech_droid__lvl2_01|militech_droid__lvl2_01|base\\characters\\appearances\\corpo\\corpo__android_ma.app. Each becomes an entity appearance named entityName, wearing appearanceName from app. Empty by default (the body wears appearanceName only)."
+    itemPattern: "^[A-Za-z0-9_]+\\|[A-Za-z0-9_]+\\|[a-z0-9_]+(\\\\[a-z0-9_.]+)+\\.app$"
+    minItems: 0
+    default: ""
+  - type: number
+    name: spotX
+    prompt: "World X of the spot where the body waits after it spawns (metres)."
+  - type: number
+    name: spotY
+    prompt: "World Y of the spot."
+  - type: number
+    name: spotZ
+    prompt: "World Z of the spot (the spot snaps to the ground)."
+  - type: string
+    name: spotWorkspot
+    prompt: "The workspot resource the spot carries (the body stands at it)."
+    pattern: "^[a-z0-9_]+(\\\\[a-z0-9_.]+)+\\.workspot$"
+    default: "base\\workspots\\common\\ground\\generic__stand_ground__guard__01.workspot"
+  - type: path
+    name: tweaksFile
+    prompt: "A TweakXL .yaml of the body's own for the record, under a project source of kind tweaks, e.g. r6/tweaks/<Project>/<bodyName>.yaml. Every apply rewrites it whole, so keep nothing else in it."
+    mustExist: false
+  - type: path
+    name: xlFile
+    prompt: "The mod's .archive.xl manifest (created if missing), beside the staged folder, e.g. archive-staging/<Project>.archive.xl."
+    mustExist: false
+  - type: path
+    name: sourceDir
+    prompt: "Directory for the four JSON sources, e.g. sources/<modSlug>/<bodyName>."
+    mustExist: false
+  - type: path
+    name: archiveStagingDir
+    prompt: "The staged archive folder the deserialized resources go under, e.g. archive-staging/<Project>. They land in <archiveStagingDir>/mod/<modSlug>/<bodyName>/."
+    mustExist: false
+ids:
+  # The record's name is checked against the vanilla index only: the
+  # project check would find the scaffold's own earlier record in
+  # tweaksFile and refuse every re-apply.
+  - name: recordName
+    slot: "${input.recordName}"
+    form: tweak-record
+    collision:
+      project: false
+      index: { kind: record, param: name }
+  - name: communityId
+    slot: "$/03_night_city/${input.nodeRefGroup}/${input.bodyName}_community"
+    form: fnv1a64
+  - name: spotId
+    slot: "$/03_night_city/${input.nodeRefGroup}/${input.bodyName}_spot"
+    form: fnv1a64
+  - name: spotXBits
+    slot: "${input.spotX}"
+    form: fixed-point
+  - name: spotYBits
+    slot: "${input.spotY}"
+    form: fixed-point
+  - name: spotZBits
+    slot: "${input.spotZ}"
+    form: fixed-point
+emits:
+  # 1. The body's entity.
+  - op: write-json-from-template
+    path: "${input.sourceDir}/${input.bodyName}.ent.json"
+    template: template
+    require:
+      - match: { $type: ResourcePath, $value: "base\\characters\\entities\\player\\player_${input.rigFamily}_skeleton.rig" }
+        reason: "The template is not on player_${input.rigFamily}_skeleton.rig, so it cannot wear a ${input.rigFamily}-rig target. Extract the replacer template for that rig (the _f android or player_wa_fpp.ent for woman; the android or player_ma_fpp.ent for man), or pick the other rig family."
+    rewrite:
+      - path: Header.ArchiveFileName
+        value: "mod\\${input.modSlug}\\${input.bodyName}\\${input.bodyName}.ent"
+      - path: Data.RootChunk.appearances
+        value:
+          - $type: entTemplateAppearance
+            appearanceName: { $type: CName, $storage: string, $value: "${input.appearanceName}" }
+            appearanceResource:
+              DepotPath: { $type: ResourcePath, $storage: string, $value: "${input.targetApp}" }
+              Flags: Soft
+            name: { $type: CName, $storage: string, $value: "${input.appearanceName}" }
+          - $each: "${input.extraLooks}"
+            $item:
+              $type: entTemplateAppearance
+              appearanceName: { $type: CName, $storage: string, $value: "${each.1}" }
+              appearanceResource:
+                DepotPath: { $type: ResourcePath, $storage: string, $value: "${each.2}" }
+                Flags: Soft
+              name: { $type: CName, $storage: string, $value: "${each.0}" }
+      - path: Data.RootChunk.defaultAppearance
+        value: { $type: CName, $storage: string, $value: "${input.appearanceName}" }
+      - match: { $type: WidgetHudComponent, name.$value: hud_component }
+        path: hudEntriesResource
+        value:
+          DepotPath: { $type: ResourcePath, $storage: string, $value: "base\\gameplay\\gui\\prototype_hud.inkhud" }
+          Flags: Obligatory
+      - match: { $type: WidgetHudComponent, name.$value: hud_component }
+        path: externalMaterial
+        value:
+          DepotPath: { $type: ResourcePath, $storage: string, $value: "base\\materials\\ui_main_hud.mt" }
+          Flags: Obligatory
+    strip:
+      - Header.ExportedDateTime
+  # 2. The record, in a file of its own that every apply rewrites, so a
+  #    re-run with a new appearance keeps the record and the entity in step.
+  - op: write-text
+    path: "${input.tweaksFile}"
+    ifExists: overwrite
+    body: |
+      ${ids.recordName}:
+        $base: Character.Player_Replacer_Puppet_Base
+        entityTemplatePath: mod\${input.modSlug}\${input.bodyName}\${input.bodyName}.ent
+        appearanceName: ${input.appearanceName}
+        persistentName: ""
+        savable: true
+        priority: SpawnableObjectPriority.Quest
+        itemGroups: []
+        attachmentSlots:
+          - AttachmentSlots.WeaponRight
+          - AttachmentSlots.WeaponLeft
+          - AttachmentSlots.RightArm
+          - AttachmentSlots.PersonalLink
+          - AttachmentSlots.Consumable
+  # 3. The world pieces, regenerated on every apply (they are output).
+  - op: write-json
+    path: "${input.sourceDir}/${input.bodyName}_always_loaded.streamingsector.json"
+    ifExists: overwrite
+    value:
+      Header: {WolvenKitVersion: 8.20.0, WKitJsonVersion: 0.0.9, GameVersion: 2310, DataType: CR2W}
+      Data:
+        Version: 195
+        BuildVersion: 0
+        RootChunk:
+          $type: worldStreamingSector
+          category: AlwaysLoaded
+          cookingPlatform: PLATFORM_PC
+          externInplaceResource:
+            DepotPath: {$type: ResourcePath, $storage: uint64, $value: '0'}
+            Flags: Soft
+          level: 0
+          localInplaceResource: []
+          nodeData:
+            BufferId: '0'
+            Flags: 4063232
+            Type: WolvenKit.RED4.Archive.Buffer.worldNodeDataBuffer, WolvenKit.RED4, Version=8.20.0.0, Culture=neutral, PublicKeyToken=null
+            Data:
+            - Id: '0'
+              NodeIndex: 0
+              Position: {$type: Vector4, W: 0, X: 0, Y: 0, Z: 0}
+              Orientation: {$type: Quaternion, i: 0, j: 0, k: 0, r: 1}
+              Scale: {$type: Vector3, X: 1, Y: 1, Z: 1}
+              Pivot: {$type: Vector3, X: 0, Y: 0, Z: 0}
+              Bounds:
+                $type: Box
+                Max: {$type: Vector4, W: 0, X: 0, Y: 0, Z: 0}
+                Min: {$type: Vector4, W: 0, X: 0, Y: 0, Z: 0}
+              QuestPrefabRefHash: {$type: NodeRef, $storage: uint64, $value: '0'}
+              UkHash1: {$type: NodeRef, $storage: uint64, $value: '0'}
+              CookedPrefabData:
+                DepotPath: {$type: ResourcePath, $storage: uint64, $value: '0'}
+                Flags: Default
+              MaxStreamingDistance: 20000
+              UkFloat1: 17.320507
+              Uk10: 32
+              Uk11: 512
+              Uk12: 0
+              Uk13: '0'
+              Uk14: '0'
+            - Id: '0'
+              NodeIndex: 1
+              Position: {$type: Vector4, W: 0, X: '${input.spotX}', Y: '${input.spotY}', Z: '${input.spotZ}'}
+              Orientation: {$type: Quaternion, i: 0, j: 0, k: 0, r: 1}
+              Scale: {$type: Vector3, X: 1, Y: 1, Z: 1}
+              Pivot: {$type: Vector3, X: 0, Y: 0, Z: 0}
+              Bounds:
+                $type: Box
+                Max: {$type: Vector4, W: 0, X: 0, Y: 0, Z: 0}
+                Min: {$type: Vector4, W: 0, X: 0, Y: 0, Z: 0}
+              QuestPrefabRefHash: {$type: NodeRef, $storage: uint64, $value: '0'}
+              UkHash1: {$type: NodeRef, $storage: uint64, $value: '0'}
+              CookedPrefabData:
+                DepotPath: {$type: ResourcePath, $storage: uint64, $value: '0'}
+                Flags: Default
+              MaxStreamingDistance: 20000
+              UkFloat1: 115.0
+              Uk10: 32
+              Uk11: 512
+              Uk12: 0
+              Uk13: '0'
+              Uk14: '0'
+            - Id: '0'
+              NodeIndex: 2
+              Position: {$type: Vector4, W: 0, X: '${input.spotX}', Y: '${input.spotY}', Z: '${input.spotZ}'}
+              Orientation: {$type: Quaternion, i: 0, j: 0, k: 0, r: 1}
+              Scale: {$type: Vector3, X: 1, Y: 1, Z: 1}
+              Pivot: {$type: Vector3, X: 0, Y: 0, Z: 0}
+              Bounds:
+                $type: Box
+                Max: {$type: Vector4, W: 0, X: 0, Y: 0, Z: 0}
+                Min: {$type: Vector4, W: 0, X: 0, Y: 0, Z: 0}
+              QuestPrefabRefHash: {$type: NodeRef, $storage: string, $value: '$/03_night_city/#${input.nodeRefGroup}/#${input.bodyName}_spot'}
+              UkHash1: {$type: NodeRef, $storage: uint64, $value: '0'}
+              CookedPrefabData:
+                DepotPath: {$type: ResourcePath, $storage: uint64, $value: '0'}
+                Flags: Default
+              MaxStreamingDistance: 520
+              UkFloat1: 120
+              Uk10: 32
+              Uk11: 512
+              Uk12: 0
+              Uk13: '0'
+              Uk14: '0'
+          nodeRefs:
+          - {$type: NodeRef, $storage: string, $value: '$/03_night_city/#${input.nodeRefGroup}/#${input.bodyName}_community'}
+          - {$type: NodeRef, $storage: string, $value: '$/03_night_city/#${input.nodeRefGroup}/#${input.bodyName}_spot'}
+          nodes:
+          - HandleId: registryNode
+            Data:
+              $type: worldCommunityRegistryNode
+              debugName: {$type: CName, $storage: string, $value: '{${input.bodyName}_registry}'}
+              isHostOnly: 0
+              isVisibleInGame: 1
+              proxyScale: null
+              sourcePrefabHash: '0'
+              tag: None
+              tagExt: None
+              communitiesData:
+              - $type: worldCommunityRegistryItem
+                communityAreaType: Regular
+                communityId:
+                  $type: gameCommunityID
+                  entityId: {$type: entEntityID, hash: '${ids.communityId}'}
+                entriesInitialState:
+                - $type: worldCommunityEntryInitialState
+                  entryActiveOnStart: 0
+                  entryName: {$type: CName, $storage: string, $value: '${input.entryName}'}
+                  initialPhaseName: {$type: CName, $storage: string, $value: spawn}
+                template:
+                  HandleId: communityTemplate
+                  Data:
+                    $type: communityCommunityTemplateData
+                    crowdEntries: []
+                    entries:
+                    - HandleId: spawnEntry
+                      Data:
+                        $type: communitySpawnEntry
+                        characterRecordId: {$type: TweakDBID, $storage: string, $value: '${ids.recordName}'}
+                        entryName: {$type: CName, $storage: string, $value: '${input.entryName}'}
+                        initializers: []
+                        phases:
+                        - HandleId: spawnPhase
+                          Data:
+                            $type: communitySpawnPhase
+                            alwaysSpawned: true_
+                            appearances:
+                            - {$type: CName, $storage: string, $value: '${input.appearanceName}'}
+                            phaseName: {$type: CName, $storage: string, $value: spawn}
+                            prefetchAppearance: 0
+                            timePeriods:
+                            - $type: communityPhaseTimePeriod
+                              categories: []
+                              hour: Day
+                              isSequence: 0
+                              markings: []
+                              quantity: 1
+                              spotNodeRefs:
+                              - {$type: NodeRef, $storage: string, $value: '$/03_night_city/#${input.nodeRefGroup}/#${input.bodyName}_spot'}
+                        spawnInView: default__true_
+                    spawnSetReference: {$type: CName, $storage: string, $value: None}
+              crowdCreationRegistry: null
+              representsCrowd: 0
+              spawnSetNameToCommunityID:
+                $type: gameCommunitySpawnSetNameToID
+                entries: []
+              workspotsPersistentData:
+              - $type: AISpotPersistentData
+                globalNodeId: {$type: worldGlobalNodeID, hash: '${ids.spotId}'}
+                isEnabled: 1
+                worldPosition:
+                  $type: WorldPosition
+                  x: {$type: FixedPoint, Bits: '${ids.spotXBits}'}
+                  y: {$type: FixedPoint, Bits: '${ids.spotYBits}'}
+                  z: {$type: FixedPoint, Bits: '${ids.spotZBits}'}
+                yaw: 0
+          - HandleId: areaNode
+            Data:
+              $type: worldCompiledCommunityAreaNode
+              debugName: {$type: CName, $storage: string, $value: '{${input.bodyName}_community}'}
+              isHostOnly: 0
+              isVisibleInGame: 1
+              proxyScale: null
+              sourcePrefabHash: '0'
+              tag: None
+              tagExt: None
+              area:
+                HandleId: area
+                Data:
+                  $type: communityArea
+                  entriesData:
+                  - $type: communityCommunityEntrySpotsData
+                    entryName: {$type: CName, $storage: string, $value: '${input.entryName}'}
+                    phasesData:
+                    - $type: communityCommunityEntryPhaseSpotsData
+                      entryPhaseName: {$type: CName, $storage: string, $value: spawn}
+                      timePeriodsData:
+                      - $type: communityCommunityEntryPhaseTimePeriodData
+                        isSequence: 0
+                        periodName: {$type: CName, $storage: string, $value: Day}
+                        spotNodeIds:
+                        - {$type: worldGlobalNodeID, hash: '${ids.spotId}'}
+              sourceObjectId: {$type: entEntityID, hash: '${ids.communityId}'}
+          - HandleId: spotNode
+            Data:
+              $type: worldAISpotNode
+              debugName: {$type: CName, $storage: string, $value: '{${input.bodyName}_spot}'}
+              isHostOnly: 0
+              isVisibleInGame: 1
+              proxyScale: null
+              sourcePrefabHash: '0'
+              tag: None
+              tagExt: None
+              crowdBlacklist:
+                $type: redTagList
+                tags: []
+              crowdWhitelist:
+                $type: redTagList
+                tags: []
+              disableBumps: 0
+              isWorkspotInfinite: 0
+              isWorkspotStatic: 0
+              lookAtTarget: {$type: NodeRef, $storage: uint64, $value: '0'}
+              markings: []
+              spot:
+                HandleId: actionSpot
+                Data:
+                  $type: AIActionSpot
+                  ActorBodytypeE3: Undefined
+                  clippingSpaceOrientation: 180
+                  clippingSpaceRange: 120
+                  enabledWhenMasterOccupied: 0
+                  masterNodeRef: {$type: NodeRef, $storage: uint64, $value: '0'}
+                  resource:
+                    DepotPath: {$type: ResourcePath, $storage: string, $value: '${input.spotWorkspot}'}
+                    Flags: Soft
+                  snapToGround: 1
+                  useClippingSpace: 0
+              spotDef: null
+              useCrowdBlacklist: 0
+              useCrowdWhitelist: 0
+          persistentNodeIndex: 0
+          persistentNodes: []
+          variantIndices: [0]
+          variantNodes: []
+          version: 62
+        EmbeddedFiles: []
+  - op: write-json
+    path: "${input.sourceDir}/${input.bodyName}.streamingblock.json"
+    ifExists: overwrite
+    value:
+      Header: {WolvenKitVersion: 8.20.0, WKitJsonVersion: 0.0.9, GameVersion: 2310, DataType: CR2W}
+      Data:
+        Version: 195
+        BuildVersion: 0
+        RootChunk:
+          $type: worldStreamingBlock
+          cookingPlatform: PLATFORM_PC
+          descriptors:
+          - $type: worldStreamingSectorDescriptor
+            blockIndex: {$type: worldStreamingBlockIndex, oup: Base, rldGridCell: 0}
+            category: AlwaysLoaded
+            data:
+              DepotPath: {$type: ResourcePath, $storage: string, $value: 'mod\${input.modSlug}\${input.bodyName}\${input.bodyName}_always_loaded.streamingsector'}
+              Flags: Soft
+            level: 0
+            numNodeRanges: 1
+            questPrefabNodeRef: {$type: NodeRef, $storage: uint64, $value: '0'}
+            streamingBox:
+              $type: Box
+              Max: {$type: Vector4, W: 1, X: 20000.0, Y: 20000.0, Z: 2000.0}
+              Min: {$type: Vector4, W: 1, X: -20000.0, Y: -20000.0, Z: -2000.0}
+            variants: []
+        EmbeddedFiles: []
+  - op: write-json
+    path: "${input.sourceDir}/${input.bodyName}.questphase.json"
+    ifExists: overwrite
+    value:
+      Header: {WolvenKitVersion: 8.20.0, WKitJsonVersion: 0.0.9, GameVersion: 2310, DataType: CR2W}
+      Data:
+        Version: 195
+        BuildVersion: 0
+        RootChunk:
+          $type: questQuestPhaseResource
+          cookingPlatform: PLATFORM_PC
+          graph:
+            HandleId: graph
+            Data:
+              $type: questGraphDefinition
+              nodes:
+              - HandleId: start
+                Data:
+                  $type: questInputNodeDefinition
+                  id: 0
+                  socketName: {$type: CName, $storage: string, $value: In1}
+                  sockets:
+                  - HandleId: start.CutDestination
+                    Data:
+                      $type: questSocketDefinition
+                      connections: []
+                      name: {$type: CName, $storage: string, $value: CutDestination}
+                      type: CutDestination
+                  - HandleId: start.Out
+                    Data:
+                      $type: questSocketDefinition
+                      connections:
+                      - HandleId: start.Out->spawnWaitOn.In
+                        Data:
+                          $type: graphGraphConnectionDefinition
+                          destination:
+                            HandleId: spawnWaitOn.In
+                            Data:
+                              $type: questSocketDefinition
+                              connections:
+                              - {HandleRefId: start.Out->spawnWaitOn.In}
+                              - HandleId: spawnDeactivate.Out->spawnWaitOn.In
+                                Data:
+                                  $type: graphGraphConnectionDefinition
+                                  destination: {HandleRefId: spawnWaitOn.In}
+                                  source:
+                                    HandleId: spawnDeactivate.Out
+                                    Data:
+                                      $type: questSocketDefinition
+                                      connections:
+                                      - {HandleRefId: spawnDeactivate.Out->spawnWaitOn.In}
+                                      name: {$type: CName, $storage: string, $value: Out}
+                                      type: Output
+                              name: {$type: CName, $storage: string, $value: In}
+                              type: Input
+                          source: {HandleRefId: start.Out}
+                      - HandleId: start.Out->replacerWaitOn.In
+                        Data:
+                          $type: graphGraphConnectionDefinition
+                          destination:
+                            HandleId: replacerWaitOn.In
+                            Data:
+                              $type: questSocketDefinition
+                              connections:
+                              - {HandleRefId: start.Out->replacerWaitOn.In}
+                              - HandleId: replacerDisable.Out->replacerWaitOn.In
+                                Data:
+                                  $type: graphGraphConnectionDefinition
+                                  destination: {HandleRefId: replacerWaitOn.In}
+                                  source:
+                                    HandleId: replacerDisable.Out
+                                    Data:
+                                      $type: questSocketDefinition
+                                      connections:
+                                      - {HandleRefId: replacerDisable.Out->replacerWaitOn.In}
+                                      name: {$type: CName, $storage: string, $value: Out}
+                                      type: Output
+                              name: {$type: CName, $storage: string, $value: In}
+                              type: Input
+                          source: {HandleRefId: start.Out}
+                      name: {$type: CName, $storage: string, $value: Out}
+                      type: Output
+              - HandleId: end
+                Data:
+                  $type: questOutputNodeDefinition
+                  id: 1
+                  socketName: {$type: CName, $storage: string, $value: Out1}
+                  sockets:
+                  - HandleId: end.CutDestination
+                    Data:
+                      $type: questSocketDefinition
+                      connections: []
+                      name: {$type: CName, $storage: string, $value: CutDestination}
+                      type: CutDestination
+                  - HandleId: end.In
+                    Data:
+                      $type: questSocketDefinition
+                      connections: []
+                      name: {$type: CName, $storage: string, $value: In}
+                      type: Input
+                  type: Terminating
+              - HandleId: spawnWaitOn
+                Data:
+                  $type: questPauseConditionNodeDefinition
+                  condition:
+                    HandleId: spawnWaitOn.condition
+                    Data:
+                      $type: questFactsDBCondition
+                      type:
+                        HandleId: spawnWaitOn.factCheck
+                        Data: {$type: questVarComparison_ConditionType, comparisonType: GreaterOrEqual, factName: '${input.bodyName}_spawn', value: 1}
+                  id: 10
+                  sockets:
+                  - HandleId: spawnWaitOn.CutDestination
+                    Data:
+                      $type: questSocketDefinition
+                      connections: []
+                      name: {$type: CName, $storage: string, $value: CutDestination}
+                      type: CutDestination
+                  - {HandleRefId: spawnWaitOn.In}
+                  - HandleId: spawnWaitOn.Out
+                    Data:
+                      $type: questSocketDefinition
+                      connections:
+                      - HandleId: spawnWaitOn.Out->spawnActivate.In
+                        Data:
+                          $type: graphGraphConnectionDefinition
+                          destination:
+                            HandleId: spawnActivate.In
+                            Data:
+                              $type: questSocketDefinition
+                              connections:
+                              - {HandleRefId: spawnWaitOn.Out->spawnActivate.In}
+                              name: {$type: CName, $storage: string, $value: In}
+                              type: Input
+                          source: {HandleRefId: spawnWaitOn.Out}
+                      name: {$type: CName, $storage: string, $value: Out}
+                      type: Output
+              - HandleId: spawnActivate
+                Data:
+                  $type: questSpawnManagerNodeDefinition
+                  actions:
+                  - $type: questSpawnManagerNodeActionEntry
+                    type:
+                      HandleId: spawnActivate.action
+                      Data:
+                        $type: questCommunityTemplate_NodeType
+                        action: Activate
+                        communityEntryName: {$type: CName, $storage: string, $value: '${input.entryName}'}
+                        communityEntryPhaseName: {$type: CName, $storage: string, $value: spawn}
+                        spawnerReference: {$type: NodeRef, $storage: string, $value: '#${input.bodyName}_community'}
+                  id: 11
+                  sockets:
+                  - HandleId: spawnActivate.CutDestination
+                    Data:
+                      $type: questSocketDefinition
+                      connections: []
+                      name: {$type: CName, $storage: string, $value: CutDestination}
+                      type: CutDestination
+                  - {HandleRefId: spawnActivate.In}
+                  - HandleId: spawnActivate.Out
+                    Data:
+                      $type: questSocketDefinition
+                      connections:
+                      - HandleId: spawnActivate.Out->spawnWaitOff.In
+                        Data:
+                          $type: graphGraphConnectionDefinition
+                          destination:
+                            HandleId: spawnWaitOff.In
+                            Data:
+                              $type: questSocketDefinition
+                              connections:
+                              - {HandleRefId: spawnActivate.Out->spawnWaitOff.In}
+                              name: {$type: CName, $storage: string, $value: In}
+                              type: Input
+                          source: {HandleRefId: spawnActivate.Out}
+                      name: {$type: CName, $storage: string, $value: Out}
+                      type: Output
+              - HandleId: spawnWaitOff
+                Data:
+                  $type: questPauseConditionNodeDefinition
+                  condition:
+                    HandleId: spawnWaitOff.condition
+                    Data:
+                      $type: questFactsDBCondition
+                      type:
+                        HandleId: spawnWaitOff.factCheck
+                        Data: {$type: questVarComparison_ConditionType, comparisonType: Equal, factName: '${input.bodyName}_spawn', value: 0}
+                  id: 12
+                  sockets:
+                  - HandleId: spawnWaitOff.CutDestination
+                    Data:
+                      $type: questSocketDefinition
+                      connections: []
+                      name: {$type: CName, $storage: string, $value: CutDestination}
+                      type: CutDestination
+                  - {HandleRefId: spawnWaitOff.In}
+                  - HandleId: spawnWaitOff.Out
+                    Data:
+                      $type: questSocketDefinition
+                      connections:
+                      - HandleId: spawnWaitOff.Out->spawnDeactivate.In
+                        Data:
+                          $type: graphGraphConnectionDefinition
+                          destination:
+                            HandleId: spawnDeactivate.In
+                            Data:
+                              $type: questSocketDefinition
+                              connections:
+                              - {HandleRefId: spawnWaitOff.Out->spawnDeactivate.In}
+                              name: {$type: CName, $storage: string, $value: In}
+                              type: Input
+                          source: {HandleRefId: spawnWaitOff.Out}
+                      name: {$type: CName, $storage: string, $value: Out}
+                      type: Output
+              - HandleId: spawnDeactivate
+                Data:
+                  $type: questSpawnManagerNodeDefinition
+                  actions:
+                  - $type: questSpawnManagerNodeActionEntry
+                    type:
+                      HandleId: spawnDeactivate.action
+                      Data:
+                        $type: questCommunityTemplate_NodeType
+                        action: Deactivate
+                        communityEntryName: {$type: CName, $storage: string, $value: '${input.entryName}'}
+                        communityEntryPhaseName: {$type: CName, $storage: string, $value: spawn}
+                        spawnerReference: {$type: NodeRef, $storage: string, $value: '#${input.bodyName}_community'}
+                  id: 13
+                  sockets:
+                  - HandleId: spawnDeactivate.CutDestination
+                    Data:
+                      $type: questSocketDefinition
+                      connections: []
+                      name: {$type: CName, $storage: string, $value: CutDestination}
+                      type: CutDestination
+                  - {HandleRefId: spawnDeactivate.In}
+                  - {HandleRefId: spawnDeactivate.Out}
+              - HandleId: replacerWaitOn
+                Data:
+                  $type: questPauseConditionNodeDefinition
+                  condition:
+                    HandleId: replacerWaitOn.condition
+                    Data:
+                      $type: questFactsDBCondition
+                      type:
+                        HandleId: replacerWaitOn.factCheck
+                        Data: {$type: questVarComparison_ConditionType, comparisonType: GreaterOrEqual, factName: '${input.bodyName}_replacer', value: 1}
+                  id: 20
+                  sockets:
+                  - HandleId: replacerWaitOn.CutDestination
+                    Data:
+                      $type: questSocketDefinition
+                      connections: []
+                      name: {$type: CName, $storage: string, $value: CutDestination}
+                      type: CutDestination
+                  - {HandleRefId: replacerWaitOn.In}
+                  - HandleId: replacerWaitOn.Out
+                    Data:
+                      $type: questSocketDefinition
+                      connections:
+                      - HandleId: replacerWaitOn.Out->replacerEnable.In
+                        Data:
+                          $type: graphGraphConnectionDefinition
+                          destination:
+                            HandleId: replacerEnable.In
+                            Data:
+                              $type: questSocketDefinition
+                              connections:
+                              - {HandleRefId: replacerWaitOn.Out->replacerEnable.In}
+                              name: {$type: CName, $storage: string, $value: In}
+                              type: Input
+                          source: {HandleRefId: replacerWaitOn.Out}
+                      name: {$type: CName, $storage: string, $value: Out}
+                      type: Output
+              - HandleId: replacerEnable
+                Data:
+                  $type: questGameManagerNodeDefinition
+                  type:
+                    HandleId: replacerEnable.action
+                    Data:
+                      $type: questReplacer_NodeType
+                      audioOverrideAppearanceName: {$type: CName, $storage: string, $value: None}
+                      enable: 1
+                      objectRef:
+                        $type: gameEntityReference
+                        dynamicEntityUniqueName: {$type: CName, $storage: string, $value: None}
+                        names:
+                        - {$type: CName, $storage: string, $value: '${input.entryName}'}
+                        reference: {$type: NodeRef, $storage: string, $value: '#${input.bodyName}_community'}
+                        sceneActorContextName: {$type: CName, $storage: string, $value: None}
+                        slotName: {$type: CName, $storage: string, $value: None}
+                        type: EntityRef
+                  id: 21
+                  sockets:
+                  - HandleId: replacerEnable.CutDestination
+                    Data:
+                      $type: questSocketDefinition
+                      connections: []
+                      name: {$type: CName, $storage: string, $value: CutDestination}
+                      type: CutDestination
+                  - {HandleRefId: replacerEnable.In}
+                  - HandleId: replacerEnable.Out
+                    Data:
+                      $type: questSocketDefinition
+                      connections:
+                      - HandleId: replacerEnable.Out->replacerWaitOff.In
+                        Data:
+                          $type: graphGraphConnectionDefinition
+                          destination:
+                            HandleId: replacerWaitOff.In
+                            Data:
+                              $type: questSocketDefinition
+                              connections:
+                              - {HandleRefId: replacerEnable.Out->replacerWaitOff.In}
+                              name: {$type: CName, $storage: string, $value: In}
+                              type: Input
+                          source: {HandleRefId: replacerEnable.Out}
+                      name: {$type: CName, $storage: string, $value: Out}
+                      type: Output
+              - HandleId: replacerWaitOff
+                Data:
+                  $type: questPauseConditionNodeDefinition
+                  condition:
+                    HandleId: replacerWaitOff.condition
+                    Data:
+                      $type: questFactsDBCondition
+                      type:
+                        HandleId: replacerWaitOff.factCheck
+                        Data: {$type: questVarComparison_ConditionType, comparisonType: Equal, factName: '${input.bodyName}_replacer', value: 0}
+                  id: 22
+                  sockets:
+                  - HandleId: replacerWaitOff.CutDestination
+                    Data:
+                      $type: questSocketDefinition
+                      connections: []
+                      name: {$type: CName, $storage: string, $value: CutDestination}
+                      type: CutDestination
+                  - {HandleRefId: replacerWaitOff.In}
+                  - HandleId: replacerWaitOff.Out
+                    Data:
+                      $type: questSocketDefinition
+                      connections:
+                      - HandleId: replacerWaitOff.Out->replacerDisable.In
+                        Data:
+                          $type: graphGraphConnectionDefinition
+                          destination:
+                            HandleId: replacerDisable.In
+                            Data:
+                              $type: questSocketDefinition
+                              connections:
+                              - {HandleRefId: replacerWaitOff.Out->replacerDisable.In}
+                              name: {$type: CName, $storage: string, $value: In}
+                              type: Input
+                          source: {HandleRefId: replacerWaitOff.Out}
+                      name: {$type: CName, $storage: string, $value: Out}
+                      type: Output
+              - HandleId: replacerDisable
+                Data:
+                  $type: questGameManagerNodeDefinition
+                  type:
+                    HandleId: replacerDisable.action
+                    Data:
+                      $type: questReplacer_NodeType
+                      audioOverrideAppearanceName: {$type: CName, $storage: string, $value: None}
+                      enable: 0
+                      objectRef:
+                        $type: gameEntityReference
+                        dynamicEntityUniqueName: {$type: CName, $storage: string, $value: None}
+                        names:
+                        - {$type: CName, $storage: string, $value: '${input.entryName}'}
+                        reference: {$type: NodeRef, $storage: string, $value: '#${input.bodyName}_community'}
+                        sceneActorContextName: {$type: CName, $storage: string, $value: None}
+                        slotName: {$type: CName, $storage: string, $value: None}
+                        type: EntityRef
+                  id: 23
+                  sockets:
+                  - HandleId: replacerDisable.CutDestination
+                    Data:
+                      $type: questSocketDefinition
+                      connections: []
+                      name: {$type: CName, $storage: string, $value: CutDestination}
+                      type: CutDestination
+                  - {HandleRefId: replacerDisable.In}
+                  - {HandleRefId: replacerDisable.Out}
+          inplacePhases: []
+          phasePrefabs: []
+        EmbeddedFiles: []
+  # 4. The .xl entries and the build.
+  - op: write-text
+    path: "${input.xlFile}"
+    ifExists: skip
+    body: |
+      {}
+  - op: insert-xl-entry
+    path: "${input.xlFile}"
+    pointer: streaming.blocks.-
+    unique: true
+    value: "mod\\${input.modSlug}\\${input.bodyName}\\${input.bodyName}.streamingblock"
+  - op: insert-xl-entry
+    path: "${input.xlFile}"
+    pointer: quest.phases.-
+    unique: true
+    value:
+      path: "mod\\${input.modSlug}\\${input.bodyName}\\${input.bodyName}.questphase"
+      parent: "base\\quest\\cyberpunk2077.quest"
+  - op: insert-xl-entry
+    path: "${input.xlFile}"
+    pointer: quest.phases.-
+    unique: true
+    value:
+      path: "mod\\${input.modSlug}\\${input.bodyName}\\${input.bodyName}.questphase"
+      parent: "ep1\\quest\\ep1_standalone.quest"
+  - op: patch-project
+    add:
+      outDir: "archive-staging"
+      sources:
+        - id: "xl-${input.modSlug}"
+          path: "${input.xlFile}"
+          kind: xl
+      steps:
+        - step: exec
+          id: "deserialize-${input.modSlug}-${input.bodyName}-ent"
+          command: wolvenkit-cli
+          args: ["convert", "deserialize", "${input.sourceDir}/${input.bodyName}.ent.json", "-o", "${input.archiveStagingDir}/mod/${input.modSlug}/${input.bodyName}"]
+          expectOutputs: ["${input.archiveStagingDir}/mod/${input.modSlug}/${input.bodyName}/${input.bodyName}.ent"]
+          inputs: ["${input.sourceDir}/${input.bodyName}.ent.json"]
+          before: stage
+        - step: exec
+          id: "deserialize-${input.modSlug}-${input.bodyName}-sector"
+          command: wolvenkit-cli
+          args: ["convert", "deserialize", "${input.sourceDir}/${input.bodyName}_always_loaded.streamingsector.json", "-o", "${input.archiveStagingDir}/mod/${input.modSlug}/${input.bodyName}"]
+          expectOutputs: ["${input.archiveStagingDir}/mod/${input.modSlug}/${input.bodyName}/${input.bodyName}_always_loaded.streamingsector"]
+          inputs: ["${input.sourceDir}/${input.bodyName}_always_loaded.streamingsector.json"]
+          before: stage
+        - step: exec
+          id: "deserialize-${input.modSlug}-${input.bodyName}-block"
+          command: wolvenkit-cli
+          args: ["convert", "deserialize", "${input.sourceDir}/${input.bodyName}.streamingblock.json", "-o", "${input.archiveStagingDir}/mod/${input.modSlug}/${input.bodyName}"]
+          expectOutputs: ["${input.archiveStagingDir}/mod/${input.modSlug}/${input.bodyName}/${input.bodyName}.streamingblock"]
+          inputs: ["${input.sourceDir}/${input.bodyName}.streamingblock.json"]
+          before: stage
+        - step: exec
+          id: "deserialize-${input.modSlug}-${input.bodyName}-phase"
+          command: wolvenkit-cli
+          args: ["convert", "deserialize", "${input.sourceDir}/${input.bodyName}.questphase.json", "-o", "${input.archiveStagingDir}/mod/${input.modSlug}/${input.bodyName}"]
+          expectOutputs: ["${input.archiveStagingDir}/mod/${input.modSlug}/${input.bodyName}/${input.bodyName}.questphase"]
+          inputs: ["${input.sourceDir}/${input.bodyName}.questphase.json"]
+          before: stage
+      deployTargets:
+        - rootId: archive
+          from: "${input.xlFile}"
+          locked: false
+          backup: true
+templates:
+  - ref: template
+    from: "${template.template.contentPath}"
+    provenanceFrom: template
+satisfies:
+  - cp2077.tweaks.yaml-lint
+  - cp2077.tweaks.base-exists
+  - cp2077.tweaks.flat-name-exists
+  - cp2077.tweaks.replacer-template-staged
+  - cp2077.history.xl-manifest-lint
+  - cp2077.vehicles.cr2w-unique-ids
+  - cp2077.vehicles.cr2w-enums-are-strings
+  - cp2077.vehicles.cr2w-resource-path-shape
+  - cp2077.vehicles.cr2w-gameversion-header
+manual:
+  - title: Check the target and build
+    steps:
+      - "Confirm ${input.targetApp} is a ${input.rigFamily}-rig appearance file (an _ma .app for man, _wa for woman) and that it declares ${input.appearanceName}; the scaffold checks the template's skeleton, not the .app, which is not extracted."
+      - "Build and deploy, then run validate again: cp2077.garments.xl-entries-resolve and cp2077.tweaks.replacer-template-staged read the staged tree, where the four resources exist only after the deserialize steps."
+    expected: "The build writes ${input.bodyName}.ent, the sector, the block and the phase under mod\\${input.modSlug}\\${input.bodyName}\\, and validate is clean."
+  - title: The spawn, in one boot (older saves only)
+    steps:
+      - "Load a save with both facts at 0. ArchiveXL.log should show 'Merged phase \"mod\\${input.modSlug}\\${input.bodyName}\\${input.bodyName}.questphase\"' after the save loads."
+      - "Set the fact ${input.bodyName}_spawn to 1 (CET: Game.GetQuestsSystem():SetFactStr(\"${input.bodyName}_spawn\", 1)). The body spawns at (${input.spotX}, ${input.spotY}, ${input.spotZ}) wearing ${input.appearanceName}; Codeware's GetFixedEntityIdsFromSpawnerEntityID on the community id ${ids.communityId} returns one entity, of class PlayerPuppet, whose record is ${ids.recordName} and whose IsReplacer() is true."
+      - "Set ${input.bodyName}_spawn back to 0: the body despawns."
+      - "Set both facts to 0 before any save; they persist in it."
+    expected: "The community spawns and despawns the body on the fact, and the body is a PlayerPuppet replacer."
+  - title: The switch needs a plugin (Part B)
+    steps:
+      - "Do not set ${input.bodyName}_replacer to 1 without a RED4ext plugin that guards the resize handler: the vanilla node's enable switched control and then crashed on the body's first resize event (observed in game). With such a guard in place, V walked as the body."
+      - "With the guard in place: ${input.bodyName}_replacer 1 switches to the body and 0 switches back. Check V's HUD (not the showroom proxy) while in the body."
+    expected: "V plays as the body with her own HUD, and returns cleanly."
+claim:
+  idSuffix: "${input.bodyName}.spawns"
+  claim: "Setting ${input.bodyName}_spawn to 1 spawns ${ids.recordName} through the mod's community at the spot, a PlayerPuppet replacer wearing ${input.appearanceName} from ${input.targetApp}, with V's HUD on its template."
+testRows:
+  - gate: R-1
+    title: "The replacer record and its template path"
+    expected: "cp2077.tweakdb.record confirms ${ids.recordName}; cp2077.tweakdb.flat reads its entityTemplatePath as mod\\${input.modSlug}\\${input.bodyName}\\${input.bodyName}.ent."
+    manual: false
+    probes:
+      - kind: cp2077.tweakdb.record
+        params: { id: "${ids.recordName}" }
+      - kind: cp2077.tweakdb.flat
+        params: { id: "${ids.recordName}.entityTemplatePath" }
+  - gate: R-2
+    title: "The body spawns and despawns on its fact"
+    expected: "With ${input.bodyName}_spawn at 1 the community's one entity exists, is a PlayerPuppet, and IsReplacer() is true; at 0 it is gone (the manual checklist's second item)."
+    manual: true
+    probeKinds: [cp2077.lua.eval]
+evidence: ["ModWright research"]