Add configurable crash-site salvage; record Workshop 0.0.146

2026-11-06 23:26:57 +01:00
parent 8b1c3cf88a
commit a7452f8be6
47 changed files with 2154 additions and 13 deletions
@@ -0,0 +1,44 @@
+# Crash-site salvage
+
+Open **Forces → Crash sites** in mission administration. Saved changes apply next round. **Random loot is the default**: each crate rolls independently and only once.
+
+| Setting | Default | Range |
+| --- | ---: | ---: |
+| Loot mode | Random | Random (1) or Custom (0) |
+| Crash sites | 3 | 0–12; zero disables |
+| Helicopter chance | 50% | 0–100%; remaining sites are armored wrecks |
+| Custom: scoped rifles per crate | 3 | 1–6 |
+| Custom: magazines per rifle | 4 | 1–8 |
+| Custom: anti-air launcher chance | 25% | 0–100% per crate |
+| Custom: RPG launcher chance | 50% | 0–100% per crate |
+
+Helicopter sites use a static UH-1 wreck; armored sites use a static BTR-70 wreck. Neither is a vehicle, so neither can be driven or repaired. Replicated smoke marks each site. A weapon crate sits beside the wreck, outside its footprint.
+
+Random mode ignores the four Custom loot controls. A crate can be poor or excellent:
+
+| Quality chance | Possible contents |
+| --- | --- |
+| Poor — 30% | 1–3 PM magazines, with a 50% chance of a PM pistol; no rifles or launchers |
+| Useful — 35% | One scoped rifle and 1–3 matching magazines |
+| Good — 25% | 2–3 scoped rifles, 2–5 magazines each, 15% AA and 35% RPG chance |
+| Excellent — 10% | 4–6 scoped rifles, 4–8 magazines each, 50% AA and 75% RPG chance |
+
+Quantities and weapon variants are randomized within the quality range. The quality is never announced or rerolled when the crate is opened. In Custom mode, rifle and magazine quantities come from the saved controls and launcher rolls use the configured chances.
+
+Premium rifles are M21/ART II and SVD/PSO, each with matching magazines. The RPG option adds a scoped RPG-7 and two PG-7VL rockets. The AA option adds one loaded disposable WCS Stinger if that resource is available. No new addon dependency is required. Content item and mod switches apply to weapons, scopes and ammunition; blocked/unavailable loadouts are omitted. Blocked content can leave a random crate poorer or empty. In Custom mode, the configured rifle count is an upper limit when equipment has been disabled. These curated crates do not use the extra-item probability weights.
+
+Sites are generated after ordinary mission sites finish preparation, on dry clear terrain away from roads, players and mission objectives. Each slot has a bounded search; unsafe or unavailable slots are skipped. Sites are found by following smoke, with no automatic map marker or radio-intel credit. They have no dedicated guards, although ordinary patrols can encounter them.
+
+Each slot and each inventory item is created at most once. Crates do not refill and wrecks do not respawn during the round. Mission cleanup owns the scenery and remaining issued equipment. Status → Mission status shows created and skipped slots.
+
+Chat commands use the same authenticated settings service:
+
+- `/esc mission crashloot set random` (or `custom`)
+- `/esc mission crashsites set 3`
+- `/esc mission crashhelis set 50`
+- `/esc mission crashrifles set 3`
+- `/esc mission crashammo set 4`
+- `/esc mission crashaa set 25`
+- `/esc mission crashrockets set 50`
+
+Each command also supports `show` and `help`.