PitSave

值钱物掉进坑里自动捞回，不再消失。只需房主安装，其他玩家什么都不用装。 Valuables that fall into pits get pulled back instead of vanishing. Host-side only — other players install nothing.

---

中文

功能

• 掉坑自动捞回：值钱物掉进坑、跌破判定高度就自动拉回，不管它是怎么掉下去的。
• 回原位：捞回它最后一次的正常位置，抬高一点避免插进地板，落地前短暂无敌。
• 自己往外爬：先朝安全点给一个水平速度加一个向上速度；一次没出来就按间隔续推，直到爬出来为止。
• 防坑口无限弹：同一件东西短时间内连掉两次，说明原位就在坑边，直接送卡车安全点，不再来回弹。
• 手持也护着：东西被抓住期间持续保护，松手后还有几秒。搬贵重物手抖磕一下不再直接翻车。
• 原生特效：掉坑那一刻亮绿色烟雾/电弧，落地或被拿起就熄灭。
• 屏幕提示：救回时右下角淡出一行提示，可关。
• 双语界面：配置菜单中文 / English 实时切换，不用重启游戏。
• 含怪物掉落物：怪物掉的贵重物一样处理。

配置

BepInEx/config/com.yanyan.pitsave.cfg，装了 REPOConfig 也能在游戏内 MOD 菜单改。

界面语言是第一项，改完立即生效。

键	默认	范围	说明
启用掉落救回	true	—	总开关
判定掉坑高度	-25	-80 ~ -10	低于这个高度就捞
安全位置下限	-2	-20 ~ 10	只有高于这个高度才记快照
安全位置上限	60	10 ~ 150	高于这个高度不记，防空中位置被当安全点
救回抬高	1.5	0 ~ 8	米，避开插进地板
同物品冷却	2	0 ~ 10	秒，同一件东西两次救回之间的间隔
掉坑判定落差	4	1 ~ 20	米，比快照低这么多又还在往下掉才算掉坑
弹回水平速度	40	2 ~ 60	米/秒，朝安全点的水平速度，填多少就是多少
坑内续推间隔秒	0.35	0.1 ~ 2	秒，出不来就按这个间隔再推
抬升力度倍率	2	0.3 ~ 3	倍，向上速度的倍率，1 差不多刚好
掉坑时闪原生特效	true	—	掉坑时亮绿色烟雾/电弧
含怪物掉落物	true	—	怪物掉的贵重物也算
救回时屏幕提示	true	—	右下角淡出提示
扫描间隔秒	0.15	0.05 ~ 1	别低于 0.05
调试日志	false	—	排查用

注意

• 只处理值钱物，普通道具、手雷、桶不管。
• 保护期间物品暂时不可破坏，保护窗口结束自动还原。
• 东西正被人抱着掉坑时会连人带物一起捞走，人留在坑里，属预期。
• 手持保护对房主自己抓取必生效；其他玩家抓取能否触发，取决于抓取状态有没有同步到房主端。

---

English

Features

• Automatic rescue: valuables that fall into a pit and drop below the threshold are pulled back, no matter how they fell.
• Back to its spot: returned to the last known good position, lifted slightly so it cannot clip into the floor, briefly invulnerable on landing.
• Climbs out on its own: a horizontal kick toward the safe spot plus an upward kick; if it is still down there it gets re-pushed at a fixed interval until it is out.
• No pit-mouth loop: a second fall in a short window means the spot sits on the edge, so the item goes to the truck safe spot instead of bouncing forever.
• Protected while held: protection keeps refreshing while grabbed, plus a few seconds after release. Fumbling a valuable into a wall is no longer instant loss.
• Native effect: green smoke / arc the moment it falls, gone on landing or pickup.
• Screen toast: a fading one-liner in the corner, can be turned off.
• Bilingual UI: the config menu switches between 中文 and English live, no restart.
• Enemy valuables included: dropped valuables from monsters are handled the same way.

Config

BepInEx/config/com.yanyan.pitsave.cfg, or the in-game MOD menu if REPOConfig is installed.

Interface language is the first entry and applies immediately.

Key	Default	Range	Meaning
Enable rescue	true	—	Master switch
Pit Y threshold	-25	-80 ~ -10	Below this height the item is rescued
Safe min Y	-2	-20 ~ 10	Snapshots only above this height
Safe max Y	60	10 ~ 150	Nothing above this is recorded
Rescue lift	1.5	0 ~ 8	Meters above the safe spot
Same-item cooldown	2	0 ~ 10	Seconds between two saves of one item
Fall depth	4	1 ~ 20	Meters below the snapshot while still falling
Horizontal bounce speed	40	2 ~ 60	m/s toward the safe spot, used as-is
Re-push interval	0.35	0.1 ~ 2	Seconds between pushes while stuck
Rise multiplier	2	0.3 ~ 3	Scales the upward speed; 1 is about right
Native pit effect	true	—	Green smoke / arc while falling
Include enemy valuables	true	—	Count drops from monsters too
Screen toast	true	—	Fading one-liner in the corner
Scan interval	0.15	0.05 ~ 1	Seconds; do not go below 0.05
Debug log	false	—	Verbose console output

Notes

• Only valuables. Plain props, grenades and barrels are untouched.
• Protected items are temporarily unbreakable; the original state is restored when the window ends.
• If someone is carrying an item when it falls, the item is saved and the player stays in the pit — expected.
• Held protection always works for the host's own grab; for other players it depends on whether their grab state reaches the host.