SymbioticGhost / 共生幽灵

PEAK co-op QoL mod: symbiotic free-fly spectate, teammate names and distances, ping distance, ghost ping, light item haul / feed, backpack access, and downed / corpse markers.

PEAK 联机生活质量模组：共生自由飞行观战、队友名字与距离、标记距离、幽灵标记、轻物搬运/喂食、背包存取、倒地/尸体指示。

Author / 作者: youxia173
Chinese alias / 中文名: 共生幽灵
Version / 版本: 1.5.7
Install side / 安装建议: Client + Host recommended for haul / ghost ping / soul link sync · 搬运、幽灵标记、灵魂线建议主客都装

---

Features / 功能

Symbiotic free-fly / 共生自由飞行

• Keep vanilla attach spectate; press F3 to leave the host and free-fly
  保留原版附着观战；按 F3 可离开寄宿玩家自由飞行
• Solo: free-fly while passed out (so you can haul/feed yourself)
  单人： 昏迷即可离体（方便给自己搬/喂物品）
• Multiplayer: free-fly only after you are fully dead (not while merely unconscious)
  多人： 仅在完全死亡后解锁 F3（单纯昏迷不能离体）
• Movement: WASD · Space up · Ctrl down · Shift x3 boost
  操作：WASD · 空格上升 · Ctrl 下降 · Shift x3 加速
• Look sensitivity follows game mouse/controller settings (+ optional multiplier)
  视角灵敏度跟随游戏设置（可再乘倍率）
• Leash distance + countdown back to attach spectate; soul-link line between ghost and host
  寄宿距离 + 超距倒计时强制返回；幽灵与宿主之间有灵魂连接线

Teammate names and distance / 队友名字与距离

• Names + distance when looking toward players (ghost-aware anchors)
  看向队友显示名字与距离（幽灵位置锚点）
• Default T toggles name display
  默认 T 开关名字

Ping distance / 标记距离

• Shows distance text on pings (short name on by default)
  标记出现时显示距离（默认带短名）

Ghost ping / 幽灵标记

• Ping while dead / passed out; no-LOS pings still show
  死亡/昏厥也可标记；无视线标记也会显示

Ghost haul and feed / 幽灵搬运与喂食

• Requires every player in the room to have this mod
  房间内全员安装本模组才启用
• Haul light ground items (UI weight <= 2.5 by default) into temp hold
  可提起轻物（默认界面重量 <= 2.5）到临时手持
• Use canUseOnFriend items on teammates (bandages, antidotes, feedable food, etc.); Scout Amulets blocked for ghosts
  可对队友使用可喂物品（绷带、解毒剂、可喂食物等）；童军护身符禁止幽灵对队友使用
• Default E pick up / drop; throw aim follows free-fly camera
  默认 E 提起/放下；投掷方向跟随自由飞相机

Ghost backpack / 幽灵背包

• Open ground or worn backpacks to stash / take one temp-held item
  可打开地上或他人背上的背包存取（仅临时手持一件）
• Cannot wear backpacks; no hotbar storage
  不能背起背包；不会进快捷栏

Downed / corpse markers / 倒地与尸体指示

• Markers for passed-out / dead bodies, including your own (so ghosts can find their corpse)
  昏厥/死亡位置指示，含自己的尸体（方便幽灵找回身体）
• Corpse marker duration: 0-20 minutes, default 6
  尸体标记时长：0-20 分钟，默认 6

Localization / 语言

• In-game HUD / toasts follow PEAK language (Simplified/Traditional Chinese or English)
  游戏内 HUD / 提示跟随 PEAK 语言设置（简中/繁中或英文）
• Config comments are bilingual (EN + Chinese)
  配置项注释为中英双语

---

Included upstream features / 已内置的原模组功能

This package bundles and reworks ideas from these mods (do not install them together):

本模组已内置并改写下列模组的能力（请不要再同时安装）：

Upstream mod / 原模组	What we include / 本模组对应	Thunderstore / 链接
AlwaysDisplayPlayerName	Teammate names + distance (ghost-aware) / 队友名字与距离（幽灵锚点）	yueby/AlwaysDisplayPlayerName
BetterPingDistance (LucydDemon)	Ping distance UI + short name / 标记距离与短名	LucydDemon/BetterPingDistance
GhostPing (boxofbiscuits97)	Ping while dead / no-LOS visibility / 幽灵也可标记	boxofbiscuits97/GhostPing
DownedAwareness (LucydDemon)	Downed/corpse markers (+ show your own body) / 倒地尸体指示（含自己）	lucyd-dev/DownedAwareness · Thunderstore

Conflicts / 冲突说明

• Installing any of the mods above together with SymbioticGhost can cause duplicate UI, wrong anchors, or skipped built-in features.
  与上表任一模组同时安装可能导致重复 UI、锚点错误，或本模组自动跳过对应内置功能。
• If a conflicting DLL is detected, SymbioticGhost logs a warning and skips that built-in feature. Prefer uninstalling the standalone mod.
  若检测到冲突 DLL，本模组会打日志并跳过对应内置功能。建议卸掉独立模组，只留共生幽灵。

---

Install / 安装

1. Install BepInExPack PEAK
2. Install this mod via Thunderstore / Gale, or put SymbioticGhost.dll in BepInEx/plugins/

Suggested categories: Mods · QoL · Misc

---

Config / 配置

Path / 路径: BepInEx/config/com.youxia173.SymbioticGhost.cfg
Launch once to generate / 装好后先启动一次游戏生成配置。

Section	Key	Default	EN	中文
1. Hotkeys	Free Fly Toggle	F3	Solo: free-fly while passed out; MP: only when fully dead	单人昏迷可离体；多人须完全死亡
2. Camera	Move Speed	12	Free-fly move force	移动力度
2. Camera	Move Damping	3	Velocity damping	速度阻尼
2. Camera	Look Sensitivity Multiplier	1	x game sensitivity	x 游戏灵敏度
3. Symbiosis	Leash Distance	20	Start countdown beyond this	超距开始倒计时
3. Symbiosis	Leash Countdown	30	Force exit seconds	强制退出秒数
4. Player Names	Enable Names	true	Show names	显示名字
4. Player Names	Visible Angle	52	Name cone angle	可见锥角
4. Player Names	Display When Blind	false	Show when blind	致盲时显示
4. Player Names	Show Distance	true	Distance under name	名字下距离
4. Player Names	Name Display Toggle	T	Toggle names	名字开关
4. Player Names	Name Display Duration	0	0 = sticky	0 = 手动开关
5. Ping Distance	Ping Text Duration	3	Distance text lifetime	距离文字秒数
5. Ping Distance	Show Ping Name Short	true	Short name after distance	距离后短名
6. Ghost Ping	Enable Ghost Ping	true	Ping while dead	幽灵可标记
7. Ghost Haul	Enable Ghost Haul	true	Haul/feed (all must have mod)	搬运/喂食（需全员）
7. Ghost Haul	Max Display Weight	2.5	Max UI weight	最大界面重量
7. Ghost Haul	Haul Key	E	Pick up / drop	提起/放下
7. Ghost Haul	Haul Range	4	Reach distance	伸手距离
8. Ghost Backpack	Enable Ghost Backpack	true	Open backpacks	开背包
9. Downed Markers	Enable Downed Markers	true	Downed/corpse UI	倒地指示
9. Downed Markers	Dead Corpse Marker Minutes	6	0-20 minutes	尸体标记分钟

---

Credits / 致谢

• Free-fly / symbiosis design and integration: youxia173
• Name/distance ideas: AlwaysDisplayPlayerName community mods
• Ping distance: LucydDemon/BetterPingDistance · lucyd-dev
• Ghost ping idea: boxofbiscuits97/GhostPing
• Downed markers: lucyd-dev/DownedAwareness

Please support the original authors.
请支持各位原作者。

---

Changelog / 更新日志

See CHANGELOG.md in this package.
详见包内 CHANGELOG.md。