SymbioticGhost / 共生幽灵

Author / 作者: youxia173
Chinese name / 中文名: 共生幽灵

---

What is this? / 这是什么？

可以仅自己主/客机装，也可以全员都装（最推荐）。
Works with host-only / client-only, or everyone (recommended).

中文

和好友联机时，死后变成幽灵只能观战队友，实在太无聊了。所以我做了这个模组，让幽灵也能帮点忙、多一点互动。

死后观战时，按 F3 即可自由行动。你正在观战的队友就是你的宿主：平时最好别超出宿主约 20 米；也可以消耗行动条飞得更远，但条一空就会被拉回宿主身边。待在宿主附近可以缓慢回条。

作为小幽灵，你可以捡不超过 2.5 重量的东西：喂给队友、塞进队友背包、扔出去，或帮队友拔刺、拔箭矢、拔蜱虫。也可以探路、打标记，抱着炸药去炸蝎子，再把熟透的蝎子投喂队友。队友倒地时，可以抱一卷绷带去救；也可以抱一本骸骨之书，复活队友的骨架。

活着的宿主也可以按 F3，把挂在自己身上的幽灵复活回来（有惩罚）。你和这个宿主待得越久，惩罚越小，直到几乎无损耗复活——这就是你们之间的羁绊。每个活着队友的惩罚削减是单独计算的：认定了一个宿主，最好一直和他灵魂连接；频繁切换观战目标，未满 5 秒的进度会清零并重新计时。

单人也能用（仅单人开放）：昏迷时按 F3 灵魂出窍自由行动，在救援条跑完前，赶紧翻自己包里还有什么可以喂给自己。

English

Dying with friends usually means spectating forever — boring. This mod lets ghosts help out and stay in the fun.

After death, press F3 to free-move. The teammate you’re spectating is your host. Stay within about 20 m for free; going farther spends the action bar, and an empty bar pulls you back. Stay near the host to slowly refill it.

As a ghost you can pick up items up to weight 2.5: feed teammates, stash in their backpack, throw, or pull spines / arrows / ticks. Scout and ping. Carry explosives to cook scorpions, then feed the team. Bandage downs, or use a Book of Bones on skeletons.

A living host can press F3 to revive a ghost linked to them (with a penalty). The longer you stay bonded, the smaller the penalty — until revive can be almost free. Penalty decay is per living teammate: pick a host and stick with them; switching spectate targets resets any unfinished 5-second decay tick.

Solo works too (solo only): while passed out, F3 to leave your body, loot your own pack, and feed yourself before the rescue bar ends.

Do not install with FreeGhost on the same client.
不要和 FreeGhost 装在同一客户端。

---

Screenshots / 截图

幽灵自由行动、搬运道具，与宿主之间有灵魂连接线：
Ghost free-fly, carrying items, soul-link to your host:

其他玩家看到的幽灵外观、距离与行动条：
How other players see your ghost, distance, and action bar:

活着的宿主按 F3，选择挂在自己身上的幽灵复活（显示石化/诅咒惩罚与下次减免倒计时）：
Living host presses F3 to revive linked ghosts (petrify/curse penalty + next reduction countdown):

---

What you can do / 能做什么

As a ghost / 作为幽灵

• Spectate as usual; F3 to free-move around your host
  正常观战；F3 以宿主为中心自由行动
• Stay within ~20 m for free; farther costs the action bar — empty bar pulls you back; near the host it slowly recovers
  约 20 米内较自在；更远消耗行动条，条空拉回；宿主边缓慢回条
• Soul-link line to your host
  和宿主之间有灵魂连接线
• Pick up light items (E), drop (Q), hold Q to throw (weight ≤ 2.5)
  E 捡物、Q 放下、长按 Q 投掷（重量不超过 2.5）
• Feed teammates, stash/take one item from backpacks
  喂队友；开背包存取一件（不能背起背包）
• Pull spines / arrows / ticks (hold E)
  长按 E 拔刺、拔箭、去蜱虫
• Scout and ping for the team (everyone can see your pings)
  探路、打标记（所有人都能看见）
• Carry explosives, feed fully cooked scorpion, bandage downs, Book of Bones on skeletons
  抱炸药炸蝎、投喂熟透蝎子、绷带救人、骸骨之书复活骨架
• Bottom-right: your current host’s revive penalty (or free-revive tip at 0)
  右下角显示当前宿主复活惩罚（为 0 时提示可无损耗）

As a living host / 作为活着的宿主

• When a ghost is linked to you and you can afford it, a tip asks you to press F3
  有幽灵挂在你身上且你付得起代价时，会提示按 F3
• Several ghosts → pick one; look locks so you can click
  多个幽灵时弹出选择；视角锁定方便点选
• Default penalty: curse + petrify (configurable 0–3000, default 120). Decay interval/amount configurable (default −1 / 5s); each living teammate counts separately — switching hosts restarts the current decay progress
  默认惩罚：诅咒+石化（可配 0–3000，默认 120）；衰减间隔/点数可配（默认 每 5 秒 −1）；每个队友单独算——换宿主会重新计时当前衰减进度
• Revive beside you; optional inherit of your stamina / statuses after you pay (not weight); can be set to penalty-only
  在你身边复活；可配置是否继承体力与状态（不含负重）；也可设为仅同等惩罚

Solo / 单人

• Solo only: while passed out, F3 free-fly, loot your own pack, and feed yourself before the rescue bar ends
  仅单人： 昏迷时 F3 灵魂出窍，翻自己背包、喂自己，赶在救援条结束前自救一把

Extra QoL / 其它方便功能

• Teammate names + distance (when Enable Names is on)
  队友名字和距离（开启 Enable Names 时自动显示）
• Ping shows distance
  标记显示距离
• Markers for downed / dead bodies (including your own corpse)
  倒地/尸体指示（含自己的尸体）

---

Who should install? / 装法区别

最推荐：所有人都装。 也可以只装主/客机，功能不完全一样。
Best: everyone installs. Host-only / client-only also work, with different sync.

1. 所有人都装（推荐） / Everyone（recommended）

完整功能与同步；玩家之间走私有协议，体验最稳。
Full features and sync via private protocol — smoothest experience.

2. 仅主机安装 / Host only

• 你可以复活队友，复活惩罚与队友同步
  You can revive teammates; revive penalty syncs to them
• 你可以自由飞行、交互、给队友喂东西
  Free-fly, interact, feed teammates
• 未装的队友不能自由飞，但能看到你飞行和拿东西；物品用虚假模型显示，位置可能不准
  Unmodded teammates cannot free-fly, but can see you fly and hold items (proxy models; position may be off)

3. 仅客机安装 / Client only

• 你可以复活队友，但队友没有复活惩罚（只有你自己有）
  You can revive teammates, but they take no revive penalty (only you do)
• 你可以自由飞行、投喂队友；队友能看见你的位置，但看不见你手里拿着什么
  Free-fly and feed; teammates see your position, but not what you’re holding
• 只有丢下物品或放进包里时，东西才会在队友眼中瞬间出现
  Items only appear for them when you drop or stash them

4. 有人装、有人没装 / Mixed lobby

• 装了的人之间走私有协议，互相享有完整功能
  Modded players use private protocol with each other → full features between them
• 主机有装 → 未装的人看到的效果 ≈ 仅主机安装
  Host has mod → unmodded players see ≈ host-only behavior
• 主机没装 → 未装的人看到的效果 ≈ 仅客机安装
  Host has no mod → unmodded players see ≈ client-only behavior

一句话： 想最完整、最省心 → 全员装；只自己想当幽灵玩 → 自己装也行（看上面主/客机差异）。
TL;DR: Full experience → everyone. Solo ghost fun → your own install is enough (see host/client differences above).

---

Using other mods instead / 想用别的同类模组

This mod includes name/distance, ping distance, ghost ping, and downed markers.
本模组自带：名字距离、标记距离、幽灵标记、倒地指示。

If you prefer another mod for one of those, turn that feature OFF in the config — then you can install the other mod without fighting this one.
如果你更喜欢别的模组做其中某一项，请在配置里关掉对应开关，再装那个模组，就不会抢功能。

Config / 配置项	Default / 默认	Turn off to use / 关掉后可改用
Enable Names	true	AlwaysDisplayPlayerName 等
Enable Ping Distance	true	BetterPingDistance 等
Enable Ghost Ping	true	GhostPing 等
Enable Downed Markers	true	DownedAwareness 等

Exception: free-fly / symbiosis — do not mix with FreeGhost.
例外： 自由飞/共生部分 不要 和 FreeGhost 同装。

Config file / 配置文件: BepInEx/config/com.youxia173.SymbioticGhost.cfg

---

Install / 安装

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

---

Credits / 致谢

Built-in extras draw inspiration from community mods — please support the originals:
内置小功能参考了社区模组，请支持原作者：

• AlwaysDisplayPlayerName (names / distance)
• BetterPingDistance
• GhostPing
• DownedAwareness

---

Changelog / 更新日志

See CHANGELOG.md.
详见 CHANGELOG.md。