SymbioticGhost / 共生幽灵

Author / 作者: youxia173
Version / 版本: 1.6.0
Chinese name / 中文名: 共生幽灵
Install tags / 安装标签: 主客都安装 · 仅客机

PEAK co-op QoL: keep vanilla attach spectate, press F3 to free-fly. Soul-link leash, teammate names & distances, better pings, ghost haul / feed / backpack / Book of Bones revive, downed & corpse markers — with hybrid sync for mixed lobbies.
PEAK 联机生活质量模组：保留原版附着观战，按 F3 离体自由飞行。含灵魂寄宿线、队友名字与距离、标记增强、幽灵搬运 / 喂食 / 开背包 / 骸骨之书复活、倒地与尸体指示；支持混局同步。

---

Who should install? / 谁该安装？

Mode / 模式	EN	中文
Recommended	Everyone (host + all clients)	推荐全员安装（主机 + 所有客机）
Also supported	Clients only (host may skip)	也支持仅客机装（主机可不装）
Soft-deps	Conflicting upstream mods → matching built-ins are skipped	检测到冲突上游模组时，对应内置功能会跳过

Do not install SymbioticGhost and FreeGhost on the same client.
不要在同一客户端同时装共生幽灵与 FreeGhost。

---

All clients vs clients-only / 全员安装 vs 仅客机

A) Everyone has the mod（全员安装）— best

• Free-fly pose uses RaiseEvent 174 only (lookValues left for aim / throw)
  自由飞位姿只走事件 174（不占用 look，瞄准/投掷更干净）
• Soul-link / free-fly look tight between modded peers
  已装玩家之间的灵魂线与自由飞观感最跟手
• Ghost-held items: each client poses locally — no visual twin needed
  幽灵手持各自本机跟手，不需要地面视觉替身
• All features below work for every player when they die / spectate
  下列功能对每个死亡/观战玩家都可用

B) Clients only / mixed（仅客机装，或只有部分人装）

Whoever has the mod still gets local gameplay (free-fly, haul, HUD, names, pings, markers, …).
装了的人自己仍能用本机功能（自由飞、搬运、状态栏、名字、标记、指示等）。

Feature / 功能	Works for the modded client? / 装了的客机自己用？	What unmodded players see / 未装的人看到什么
Free-fly F3, leash points, status HUD	Yes / 可以	Free-fly ghost via hybrid look encode (may lag slightly) / 能看见自由飞（look 编码，可能略延迟）
Soul-link line (own)	Yes on your screen / 自己屏幕有	Unmodded: no soul-link UI / 未装：无灵魂线
Teammate names & distance	Yes / 可以	Unmodded: vanilla only / 未装：仅原版
Ping distance / ghost ping	Yes / 可以	Unmodded: vanilla ping / 未装：原版标记
Downed / corpse markers	Yes / 可以	Unmodded: none from this mod / 未装：无本模组指示
Ghost haul / feed / backpack / Book of Bones	Yes (vanilla item RPCs) / 可以（走原版物品同步）	Actions apply in world; held mesh for unmodded needs modded host (see below) / 行为生效；手持外观给未装看需要主机也装（见下）
Soft ItemInfoDisplay free-fly tip	Yes if that mod is present / 有「物品信息显示」时可以	—

Important host rules / 与主机相关的限制

Situation / 情况	Effect / 效果
Host has this mod + someone lacks it	Unmodded can see ghost-held items via a Ground visual twin (snapped ~20 Hz; still not as glued as full-mod) / 未装的人能看见幽灵手持（地面替身硬吸附；仍不如全员装那么贴）
Host does NOT have this mod (clients-only)	Visual twin off — unmodded (incl. host) often cannot see what the ghost is holding (item may sit at DeathPos). Haul/feed logic can still work. / 不开替身 — 未装方（含主机）经常看不见幽灵手里东西（可能停在 DeathPos）；搬运/喂食逻辑仍可能可用
Full-mod lobby	Twin unused; cleanest hold + free-fly / 不用替身；手持与自由飞最干净

Summary / 一句话：

• Only you care about your own free-fly / UI / haul → client install is enough.
  只在乎自己自由飞、界面、搬运 → 只装客机也行。
• Want unmodded teammates (or unmodded host) to see free-fly cleanly + held items → host should install too; ideally everyone.
  希望未装的队友/主机也能看清自由飞和手持 → 主机也要装；最好全员装。

---

Features / 功能

Symbiotic free-fly / 共生自由飞行

• Keep vanilla attach spectate; F3 leaves the host and free-flies
  保留原版附着观战；F3 离开宿主自由飞行
• Solo: free-fly while passed out · Multiplayer: only after fully dead
  单人： 昏迷即可离体 · 多人： 须完全死亡
• Move: WASD · Space up · Ctrl down · Shift ×3 · look = game sensitivity × multiplier
  移动：WASD · 空格升 · Ctrl 降 · Shift ×3 · 视角 = 游戏灵敏度 × 倍率
• Leash distance + points bar (default 100, configurable)
  寄宿距离 + 点数条（默认 100，可在配置改）
• Rates: out of range −4/s · free-fly in-range +1/s · attach spectate +2/s
  速率：超距 −4/s · 自由飞范围内 +1/s · 原版观战 +2/s
• Status HUD in both free-fly and attach spectate (above the hotbar)
  状态栏：自由飞与原版观战同位置（物品栏上方）
• Soul-link line tracks in free-fly and attach spectate
  灵魂连接线在自由飞与原版观战都紧跟
• Free-fly UI: host stamina stays · host hotbar hidden · your held-item icon still shows
  自由飞 UI：保留宿主体力条 · 隐藏宿主物品栏 · 仍显示自己手持图标

Sync / 同步

• Always RaiseEvent 174 to players who have this mod
  对已装本模组的玩家始终发事件 174
• If anyone lacks the mod → also encode free-fly into vanilla look so they can still see you
  局里有人未装 → 同时把自由飞编码进原版 look，未装客户端也能看见
• When everyone has the mod → look encode off (better aim/throw)
  全员都装 → 关闭 look 编码（瞄准/投掷更干净）
• Mixed + modded host: held-item Ground twin for unmodded viewers
  混局且主机已装：手持地面替身给未装观众看

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

• Names + distance when looking at players · default T toggle
  看向队友显示名字与距离 · 默认 T 开关

Ping / 标记

• Ping distance text (+ optional short name)
  标记显示距离（可选短名）
• Ghost ping while dead / passed out
  幽灵也可标记

Ghost haul · feed · interact / 幽灵搬运 · 喂食 · 交互

• Haul light ground items (UI weight ≤ 2.5) · E pick / Q drop · hold Q throw
  提起轻物（界面重量 ≤ 2.5）· E 拾取 / Q 放下 · 长按 Q 投掷
• Feed canUseOnFriend items; Scout Amulets & Ritual Dagger blocked for ghosts on teammates
  可喂队友；童军护身符与仪式匕首禁止幽灵对队友使用
• Hold E: remove cactus spines / arrows / ticks
  长按 E：拔刺 / 箭、移除蜱虫
• Book of Bones: aim skeleton + hold E to revive (incl. your own in MP)
  骸骨之书： 瞄准骨架 长按 E 复活（多人可对自己的骨架）
• Open ground / worn backpacks (temp hold only; cannot wear)
  可开地上 / 背上背包（仅临时手持；不能背起）
• Does not require every teammate to have the mod for the actions themselves
  操作本身不要求全员安装（外观同步见上方「主机」表）

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

• Markers for passed-out / dead bodies, including your own
  昏厥 / 死亡指示，含自己的尸体
• Corpse pin default 6 minutes (0–20); one pin per player
  尸体标记默认 6 分钟；同一玩家只保留一具

Soft compat / 软兼容

• ItemInfoDisplay: free-fly shows the ghost held item (not the host’s)
  「物品信息显示」：自由飞时跟幽灵手持

Localization / 语言

• In-game HUD / toasts follow PEAK language · config comments bilingual
  游戏内提示跟随 PEAK 语言 · 配置注释中英双语

---

Do NOT install together / 请勿同装

This mod bundles (rewritten) features from:

本模组已内置并改写下列模组能力：

Upstream	Built-in here / 本模组内置
AlwaysDisplayPlayerName	Names + distance / 名字与距离
BetterPingDistance	Ping distance UI / 标记距离
GhostPing	Ping while dead / 幽灵标记
DownedAwareness	Downed / corpse markers / 倒地尸体指示

Installing those alongside SymbioticGhost → duplicate UI / wrong anchors / built-ins skipped. Prefer this mod alone.
与上表同装 → 重复 UI / 锚点错乱 / 内置功能被跳过。建议只留共生幽灵。

---

Install / 安装

1. BepInExPack PEAK
2. Thunderstore / Gale, or drop SymbioticGhost.dll into BepInEx/plugins/
3. Prefer everyone installs; clients-only is OK if you accept weaker held-item visibility for unmodded peers when the host has no mod
   建议全员安装；仅客机可以，但主机未装时未装方对幽灵手持观感较弱

---

Config / 配置

BepInEx/config/com.youxia173.SymbioticGhost.cfg (created on first launch)

Section	Key	Default	Notes / 说明
Hotkeys	Free Fly Toggle	F3	Solo passed-out / MP fully dead · 单人昏迷 / 多人须死亡
Camera	Move Speed	12	Free-fly force · 移动力度
Camera	Move Damping	3	Damping · 阻尼
Camera	Look Sensitivity Multiplier	1	× game sens · ×游戏灵敏度
Symbiosis	Leash Distance	20	Drain starts beyond this · 超距开始消耗
Symbiosis	Leash Points	100	Max points · −4 / +1 / +2 per sec · 点数上限可改
Symbiosis	Status HUD X / Y	1 / 0.06	Shared above-hotbar base · 自由飞与观战同基准
Player Names	Enable / Angle / Distance / Toggle	true / 52 / true / T
Ping Distance	Duration / Short name	3 / true
Ghost Ping	Enable	true
Ghost Haul	Enable / Max weight / Key / Range	true / 2.5 / legacy / 4	Key unused · E pick / Q drop · 按键弃用
Ghost Backpack	Enable	true
Downed Markers	Enable / Corpse minutes	true / 6

---

Credits / 致谢

• Symbiosis / free-fly: youxia173
• Names / distance ideas: AlwaysDisplayPlayerName community
• Ping distance: LucydDemon/BetterPingDistance
• Ghost ping: Boxofbiscuits97/GhostPing
• Downed markers: lucyd-dev/DownedAwareness

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

---

Changelog / 更新日志

See CHANGELOG.md (latest 1.6.0).
详见 CHANGELOG.md（最新 1.6.0）。