jakub
6a667d8deb
Include the current addon, terrain integrations, tools, regression tests and recorded development evidence.
161 lines
8.7 KiB
Markdown
161 lines
8.7 KiB
Markdown
# Single Workshop mod
|
||
|
||
All five owned modules are now one project: `addons/core/addon.gproj`, titled
|
||
**Co10 Escape Reintroduced**, with the existing Core GUID `2528466DE220D91C`.
|
||
There are no separate AI, Intel, Map or Chat project descriptors to publish.
|
||
The project ID `ERR_Core` is retained; it now identifies the complete mod.
|
||
|
||
The supplied Workshop banner is [publishing/previewImage.png](../publishing/previewImage.png).
|
||
Select it in **Publish project → Preview Image** before publishing; see
|
||
[preview setup](../publishing/README.md) for the Proton file-picker path.
|
||
|
||
For the post-publication RKS #2 join failure, see the
|
||
[prefab identity fix and update steps](multiplayer-prefab-ids.md).
|
||
|
||
In Workbench, close the previous project, remove stale entries for the four removed
|
||
projects, and open the Core project again. Keep the installed RHS/WCS projects and
|
||
their dependencies registered. Launch `Missions/ERR_Everon.conf`. The old Base
|
||
mission header is retained for diagnostic scripts but hidden from the scenario
|
||
menu; it loads the same combined gameplay and dependencies.
|
||
|
||
Scripts live in `Scripts/Game/ERR/{00_Core,10_AI,20_Intel,30_Map,40_Chat}`.
|
||
GameLib and WorkbenchGame retain their native script-module directories. The
|
||
numeric prefixes preserve the ordering required by `modded class` extensions,
|
||
including the full-scenario probes that use Core and Intel members. Moving those
|
||
folders into alphabetical feature order breaks native compilation.
|
||
|
||
All 34 authored resource GUIDs and resource-relative paths are preserved. Non-script
|
||
assets remain in their native Prefabs, Configs, Missions, Worlds, Materials and UI
|
||
folders. RHS and WCS remain external dependencies, not copied assets. No Workshop
|
||
publication or release qualification is part of this migration.
|
||
|
||
The [playtest build guide](playtest-build.md) identifies the latest retained, source-matched development candidate. The [30 September candidate](combined-candidate-2026-09-30.md) and historical five-addon handoffs remain earlier snapshots.
|
||
|
||
## Source and package checks
|
||
|
||
```sh
|
||
python3 tools/check.py
|
||
python3 tools/source_bundle.py
|
||
```
|
||
|
||
The bundle contains one project. Native packaging builds only that project:
|
||
|
||
```sh
|
||
python3 tools/native_package.py --project core \
|
||
--session /tmp/erri-merged-package-NEW \
|
||
--compat /tmp/YOUR-IDLE-DISPOSABLE-TOOLS-PREFIX \
|
||
--external-addons /path/to/installed/workshop/addons \
|
||
--timeout 300
|
||
```
|
||
|
||
A successful packing attempt writes `packages/core`; inspect its PAK contents
|
||
before treating it as a playable artifact. Packaging does not publish anything.
|
||
|
||
## Native verification
|
||
|
||
The existing Workbench `--project core` and `--project chat` arguments select
|
||
**fixture families**, not separate addon projects. Both load the same combined
|
||
`.gproj` and require `--external-addons`. For the integrated HQ fixture:
|
||
|
||
The historical `core/victory` fixture still asserts that companion HQ/support
|
||
controllers are absent and fails against the merged project. Use the combined
|
||
fixture below for this checkpoint; Core isolation results do not apply here.
|
||
|
||
```sh
|
||
python3 tools/headless_workbench.py \
|
||
--compat /tmp/YOUR-IDLE-DISPOSABLE-TOOLS-PREFIX \
|
||
--profile /tmp/erri-merged-workbench-NEW \
|
||
--external-addons /path/to/installed/workshop/addons \
|
||
--project chat --smoke hq-memory --rounds 1 --timeout 360
|
||
```
|
||
|
||
For the focused prison/clues/radio/extraction route, use `--project chat --smoke escape-route --rounds 1 --timeout 360` with the same private-runner options. This keeps real inventory and mission gates but uses scripted movement/actions; `--smoke victory` retains the separate extended administrator and intel-reroll stress.
|
||
|
||
For ordinary packed startup, schema 4 validates one owned addon plus seven external
|
||
addons (ten engine/vanilla/mod/dependency mounts in total):
|
||
|
||
```sh
|
||
python3 tools/headless_game.py --project chat \
|
||
--packed-addons /tmp/erri-merged-package-NEW/packages \
|
||
--packed-session /tmp/erri-packed-chat-merged-NEW \
|
||
--compat /tmp/YOUR-IDLE-DISPOSABLE-TOOLS-PREFIX \
|
||
--external-addons /path/to/installed/workshop/addons \
|
||
--timeout 180 --failure-grace 120
|
||
```
|
||
|
||
Core v1 / Chat v2 packed validators remain frozen for historical artifacts and
|
||
reject the merged dependency graph. Older five-addon external v3 records are
|
||
historical; the current external runner uses schema 4. Native dedicated inputs
|
||
must also supply the external dependency closure; this migration does not establish
|
||
multiplayer acceptance.
|
||
|
||
## Verified migration checkpoint
|
||
|
||
`python3 tools/check.py` passes all 191 regression programs. A comparison with the
|
||
pre-merge tree preserves all 187 scripts and all 34 resource metadata identities
|
||
and paths; the only changed script body is the ordinary full-scenario launcher's
|
||
addon GUID. The base diagnostic mission header is now hidden from the menu.
|
||
|
||
The [merged native run](evidence/native-2026-09-20-merged-mod/report.json) compiles
|
||
GameLib, Game and WorkbenchGame, loads Everon and completes the HQ-memory fixture
|
||
with 101 passed assertions and no script/runtime failures. Its
|
||
[runner record](evidence/native-2026-09-20-merged-mod/runner.json.txt) confirms owned
|
||
cleanup and unchanged authored/external inputs. The strict native verdict remains
|
||
failed because of the four previously documented RHS/WCS localization resource
|
||
errors, all retained in the raw log. This is local Workbench evidence, not a
|
||
Workshop release or multiplayer qualification.
|
||
|
||
## Administration: helicopter timer and server items
|
||
|
||
The Mission page includes **Search helicopter delay** (1–1440 minutes), with
|
||
Apply and Random. Saving changes a waiting countdown; an active flight
|
||
continues. Random is saved as a selection and resolved to a positive duration.
|
||
A failed save leaves the current countdown intact.
|
||
|
||
The Mods page shows the existing mission-content switches followed by **all
|
||
server-loaded addons**, including terrain, audio and script mods with zero
|
||
catalogued inventory items. **Edit items** opens that mod's selection page.
|
||
Workshop addons remain loaded; the editor controls future automatic equipment
|
||
grants, not script execution or authored soldier inventories.
|
||
|
||
The **Items** page lists registered inventory items defined or modified by each
|
||
mod, twelve per page, with prefab paths and equipment eligibility. Items outside
|
||
the supported automatic-equipment categories remain visible; enabling them does
|
||
not force unsupported clothing, attachments or other assets into the equipment
|
||
lottery. Existing content-pack exclusions also continue to apply. Modified
|
||
vanilla items may appear under several source mods. Unregistered prefabs and
|
||
non-inventory assets are outside this catalog.
|
||
|
||
Use **Enable/Disable** on an item, or **Enable all/Disable all** for the displayed
|
||
mod. Disable actions are red. Each item has a green **Enabled** or red
|
||
**Disabled** badge; a mod with a mixture of allowed and blocked items shows
|
||
**Mixed** in amber. The badge includes shared-source and current content-pack
|
||
blocks, while the row text also explains whether that item is supported by the
|
||
automatic equipment pool. Preset changes refresh these states from the server. Bulk actions clear that mod's individual overrides and set its default,
|
||
including items added in later versions. An item override takes precedence over
|
||
its own mod's default; for shared items, every loaded source mod must allow the
|
||
item. Any source's disable wins. Controls affect future random equipment and
|
||
matching ammunition, without removing items already issued or changing spawn
|
||
chance. Pending grants check the selection again before issuing an item.
|
||
|
||
Edits save automatically in the `items` section of `$profile:Escapists.json`. The equipment pool
|
||
refreshes on its next selection after an edit; no restart is required. **Presets**
|
||
cover the complete item selection across all mods. Enter a name and use
|
||
**Save / replace**, or select an existing preset and **Load** or **Delete** it.
|
||
Names use 1–24 lowercase letters, digits, underscores or hyphens; `active` is
|
||
reserved. Up to 16 presets are stored. Loading replaces the working selection;
|
||
subsequent edits do not change a saved preset until it is saved again.
|
||
|
||
Missing mods disappear from the loaded-mod list. Their saved rules and preset
|
||
entries remain dormant, without loading or resolving missing resources. If the
|
||
same mod returns, its rules become effective again. New mods/items default to
|
||
allowed unless their loaded source mod has a disabled default. Failed writes
|
||
retain the previous in-memory selection; validated backup recovery and damaged
|
||
file protection follow the other mission preference files.
|
||
|
||
Discovery runs in small batches. Browsing belongs to each authenticated admin
|
||
session; edits and presets are shared server settings. Original catalog/timer
|
||
evidence: [2 October checks](evidence/server-items-2026-10-02/report.json).
|
||
|
||
Item editor and preset validation: [native and repository checks](evidence/item-editor-2026-10-02/report.json).
|