SymbioticGhost / 共生幽灵

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

---

What is this? / 这是什么？

中文

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

在你死了之后观战时，可以按 F3 自由行动。你正在观战的队友就是你的宿主：平时最好不要超出宿主 20 米；当然你也可以消耗行动条飞得更远，但行动条一旦耗尽，就会被拉回宿主身边。待在宿主边上可以缓慢恢复行动条。

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

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

当然，如果你是自己单人游玩的，也可以用这个 mod，这个功能仅单人游玩开放。你可以在昏迷的时候灵魂出窍，按下 F3 自由行动，在你自己救援条跑完之前，赶快翻翻自己包里还有什么道具可以喂给自己。

English

Playing with friends, dying into a ghost usually means you can only spectate — and that’s boring. So I made this mod: ghosts can help out and stay in the fun.

After you die and start spectating, press F3 to free-move. The teammate you’re spectating is your host. Try to stay within about 20 m; you can go farther by spending your action bar, but when the bar empties you’re pulled back to the host. Stay near them to slowly refill it.

As a little ghost you can pick up items up to weight 2.5: feed teammates, put things in their backpack, throw them, or pull spines, arrows, and ticks. Scout ahead and ping for the team. Carry explosives to blow up scorpions, then feed teammates a fully cooked scorpion. If someone is down, wrap a bandage to help; or carry a Book of Bones and revive their skeleton.

A living host can also press F3 to revive a ghost linked to them (with a penalty). The longer you stay with that host, the smaller the penalty, until revive can be almost free — that’s the bond between you. Penalty reduction is per living teammate: if you pick a host, stick with them; switching spectate targets restarts the current 5-second progress (completed reductions stay).

Playing solo? You can use this mod too — solo only. While you’re passed out, press F3 to leave your body as a ghost, dig through your own pack, and feed yourself something before your rescue bar runs out.

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

---

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, default 60). Linked time -1 / 5s until 0; each living teammate counts separately — switching hosts restarts the current 5s progress
  默认惩罚：诅咒+石化（可配置，默认 60）；绑定每 5 秒减 1 直到 0；每个队友单独算——换宿主会重新计时当前这 5 秒
• Revive beside you; they inherit your stamina / statuses after you pay (not weight)
  在你身边复活；你付完惩罚后继承体力与状态（不含负重）

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 (toggle T by default)
  队友名字和距离（默认 T 开关）
• Ping shows distance
  标记显示距离
• Markers for downed / dead bodies (including your own corpse)
  倒地/尸体指示（含自己的尸体）

---

Who should install? / 谁装比较好？

Who installs / 谁装	What you get / 效果
Everyone (best) / 全员装（最好）	Smooth free-fly, held items, revive, and UI for everyone. / 自由飞、手持、复活、界面都最顺。
Clients only / 仅客机	You still get free-fly, haul, tips, etc. People without the mod may see free-fly a bit less smoothly, and may not see what you’re holding well if the host also has no mod. / 你自己仍能自由飞、搬运、看提示。没装的人可能看你飞得不那么顺；若主机也没装，他们可能看不清你手里拿着什么。
Host only / 仅主机	Helps unmodded players see ghost-held items better in mixed lobbies. Host alone doesn’t give guests free-fly. / 混局里更方便没装的人看见幽灵手里的东西。只主机装，客机不会因此获得自由飞。

Simple rule / 一句话：
Want the full experience → everyone installs.
Only care about your own ghost play → client install is enough.
Want unmodded friends to see held items clearly → host should install too.

想玩全套 → 大家都装。
只在乎自己当幽灵好不好玩 → 自己装客机就行。
希望没装的朋友也能看清你手里东西 → 主机也要装。

---

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。