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):

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

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 / 装好后先启动一次游戏生成配置。

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。