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。

Changelog

1.5.7

EN

• Fix Thunderstore README / CHANGELOG Chinese encoding (UTF-8) so the package page no longer shows mojibake

中文

• 修复 Thunderstore 说明页中文乱码：README / CHANGELOG 改为正确 UTF-8 编码

1.5.6

EN

• Fix host camera lock when a guest ghost attaches to the host and holds a feedable item: DoUsing no longer syncs lookValues onto Character.localCharacter for remote ghosts

中文

• 修复客机幽灵附身主机并手持投喂道具时主机视角锁死：远程幽灵的 DoUsing 不再把 lookValues 写到本机角色上

1.5.5

EN

• Fix living players camera locking when a ghost teammate picks up food: ghost-held items no longer use solid colliders / movement forces

中文

• 修复队友幽灵捡起食物时活着玩家视角被锁死：幽灵手持物改为无碰撞运动学刚体，并跳过持物推力

1.5.4

EN

• Unify corpse-marker color with ping-distance color (same PlayerColor / mod-skin / MakeReadable pipeline; ping still has ping-mesh fallback)

中文

• 尸体标记颜色与中键标记距离统一为一套逻辑（同一 PlayerColor / 扩色皮肤 / MakeReadable；标记额外保留 3D 标记材质兜底）

1.5.3

EN

• Middle-click ping short name fixed for ghost spectate/free-fly
• Ghost ping raycast uses the spectator camera

中文

• 修复幽灵观战/自由飞时中键标记旁单字短名不显示
• 幽灵中键标记射线改用观战相机

1.5.2

EN

• Ghost spectate/free-fly: ping distance + name use MainCamera
• Downed/corpse marker name on the same line as distance

中文

• 幽灵观战/自由飞：标记距离与名字改用真实视角相机
• 倒地/尸体名字并入距离同一行

1.5.1

EN

• Fix corpse markers locking onto DeathPos after die warp
• Corpse / downed markers show the player name

中文

• 修复死亡后标记被锁定到天上 DeathPos
• 倒地/死亡标记显示玩家名字

1.5.0

EN

• Bilingual config comments; bilingual Thunderstore README; new icon
• In-game HUD/toasts follow PEAK language

中文

• 配置项注释中英双语；Thunderstore 双语介绍与新图标
• 游戏内 HUD / 提示跟随 PEAK 语言

1.4.14

• Ping short name default true; removed deprecated look damping config

1.4.13

• F3: solo can leave while passed out; multiplayer requires full death

1.4.12

• Corpse marker duration 0-20 minutes, default 6

1.4.11

• Fix stuck soul link after disconnect; fix lag when F3 home with held item

1.4.10

• Ghost free-fly Q-throw follows free-fly camera

1.4.9

• Middle-click ping works in free-fly

1.4.8

• Built-in DownedAwareness markers; ghosts can see own corpse

1.4.7

• Living players can see ghost name distance

1.4.6

• ESC pause menu works in free-fly

1.4.5

• Teammates can see ghost-held items

1.4.4

• Backpack take weight check; Shift boost x3

1.4.3

• Free-fly look uses game sensitivity settings

1.4.2

• Block ghost use of Scout Amulets on teammates

1.4.1

• Host/ghost distance fixes; thinner soul link; ghost hold/drop sync

1.4.0

• Ghost can use canUseOnFriend items on teammates

1.3.x - 1.0.0

• Backpack access, haul, names/distance/ping, free-fly, soul link