The Forge is currently under construction. Data is synchronized with the hub every 30 minutes. Help report issues!

Mod Details

Blackhorse311 — Keep Starting Gear (SPT 3.11.x)

Blackhorse311 — Keep Starting Gear (SPT 3.11.x) 1.1.3

Created by Blackhorse311

472 Downloads

SPT 3.11.3 Compatible

Keep your starting PMC gear if you die in a raid.

- **SHA‑256 (v1.1.3):**

c2dd859eef77d9ac2d841e79469963d3a21e0098ed616df21c321b0f5d35fedc

# Blackhorse311 — Keep Starting Gear (SPT 3.11.x)

Keep the **PMC gear you entered the raid with** if you **die**. The mod snapshots your equipped kit on raid start and restores it when you return to the main menu after a death-like exit.

- Hooks the game via HTTP route hooks (no fragile service overrides)

- Robust exit detection (results.result) and PMC detection (profile side + .Pmc. in serverId)

- Restore happens **after** SPT finishes post-raid work, so nothing overwrites it

- Configurable: restore only certain equipment slots, exclude secure container, restore quickbar, more

Tested on **SPT 3.11.3** using payloads where exit is in results.result and PMC side in profile.Info.Side.

---

## Installation

1. Extract this folder into SPT/user/mods/.

2. Start **SPT.Server.exe**, then **SPT.Launcher.exe**, click **Play**.

3. In server logs you should see:

- Static route hooks registered (start/end/after).

- On raid start: \[start\] isPMC=true ... + Snapshot saved (NN items).

- On death: \[end\] exit='killed' ... queued=true

- Back at menu: \[after\] performed restore ... + Restored starting kit (NN items).

---

## What it restores

- Your **equipped PMC items** that were under the equipment root when the raid started (weapons, armor, clothing, containers depending on config).

- Optionally your **quickbar/fastPanel** (1..9 hotkeys).

It does **not** touch stash, XP, quests, etc.

---

## Configuration (config.json)

| Key | Type | Default | Description |

|—|—|—:|—|

| restoreOn | string[] | \["killed","missinginaction","mia","left"\] | Exit results that trigger a restore. |

| treatRunnerAsSuccess | boolean | true | If true, **Runner** exit will **not** restore. |

| logLevel | "warn" \\| "info" \\| "debug" | "warn" | Amount of logging. |

| persistSnapshotsOnDisk | boolean | true | Also write snapshot files under state/. |

| dumpEndPayload | boolean | false | Dump raw /end body to state/last-end-payload-<sid>.json (debug). |

| forceRestoreIfExitUnknown | boolean | false | Restore even if exit is missing/unknown. |

| equippedOnly | boolean | false | Convenience mode that **defaults** to excluding container slots (Backpack, Pockets). Combine with excludeSlots for finer control. |

| excludeSecureContainer | boolean | false | Exclude SecuredContainer from restore. |

| excludeSlots | string[] | \[\] | Names of **root equipment slots** to exclude entirely (root + all contents). Examples: "Backpack", "Pockets", "TacticalVest", "SecuredContainer". |

| restoreQuickbar | boolean | true | Restore fastPanel (1..9 hotkeys). |

**Notes**

- *Equipped‑only:* If you want **no backpack** restoration, set equippedOnly: true (which excludes Backpack + Pockets by default). If you also wish to exclude rig contents, add "TacticalVest" to excludeSlots.

- Slot names are taken from the slotId on **direct children** of Inventory.equipment (e.g. Headwear, ArmorVest, TacticalVest, Backpack, Pockets, SecuredContainer, Holster, FirstPrimaryWeapon, etc.).

---

## Compatibility

- Designed for **SPT 3.11.x** (tested 3.11.3).

- Uses **StaticRouterModService** to hook only three endpoints: /client/match/local/start, /client/match/local/end, /client/game/profile/list.

- Avoids replacing LocationLifecycleService, making it more resilient to updates and other mods.

---

## Known limitations

- Only applies to **PMC raids** (intended design). SCAV is ignored.

- Insurance / mail systems still function normally. Restoring your starting gear does not cancel insurance processing.

---

## Uninstall

Delete the folder user/mods/blackhorse311-keepstartinggear. No permanent changes are made besides your saved profile updates.

---

## Credits

- **Blackhorse311** — author

- **GPT‑5 Pro** — AI assist (design, debugging, docs)

-**SPT User: LIKLY** - Giving me the idea and wanting to produce one for 3.11.3

---

## License

[MIT](./LICENSE)

Version 1.1.3
Download Mod Version

SPT 3.11.3

Latest Compatible SPT Version

117 Downloads

Created Aug 16th, 3:21 AM

Updated Aug 16th, 3:21 AM

Virus Total Results

1.1.3

Fix – Secure Container restore: Resolved the edge case where restoring gear could clash with the game’s inventory processing, leading to secure‑container items not being kept or to parent/child re‑parenting issues. Restore now happens using a late “after” hook so the game finishes its post‑raid updates before we put your kit back.

Safer late restore path: Uses the post‑menu route to minimize conflicts with insurance/mail and other mods that touch inventory right after a raid.

Exit handling polish: Exit result matching is now case‑insensitive and honors your restoreOn list. Runner exits are treated as success by default (treatRunnerAsSuccess: true), so no restore occurs unless you override it.

Config clarity: Documented how equippedOnly acts as a convenience preset that excludes Backpack + Pockets (and how to add more via excludeSlots). excludeSecureContainer remains a simple on/off switch if you want to avoid restoring it entirely. See the Configuration table above.

Diagnostics: Cleaner logs at info level; set logLevel: “debug” to see snapshot counts, exit decisions, and when a restore is queued/performed. Optional on‑disk snapshots (persistSnapshotsOnDisk) and raw end payload dumps (dumpEndPayload) remain available for troubleshooting.

Version 1.1.1
Download Mod Version

SPT 3.11.3

Latest Compatible SPT Version

325 Downloads

Created Aug 10th, 8:30 PM

Updated Aug 10th, 8:30 PM

Virus Total Results

Fix: Download button now points to the direct GitHub asset (no code changes).

Version 1.1.0
Download Mod Version

SPT 3.11.3

Latest Compatible SPT Version

33 Downloads

Created Aug 10th, 7:32 PM

Updated Aug 10th, 7:32 PM

Virus Total Results

Not quite yet...