StickHead — Ride on Your Teammate's Head 头顶黏人

Aim at a teammate (within 10 m, 30° cone, unobstructed), press R to teleport onto their head and stick there — he walks, you ride. Pressing R again does nothing; press the tumble key to drop off, with a 5-second cooldown on landing.

准星对准队友（10 米内、30° 锥形、无遮挡），按 R 直接传送到他头顶并黏住，跟着他走。再按 R 无效，要下来请按翻滚键，落地后有 5 秒冷却。

---

中文

功能

• 挂载：瞄队友按 R，位置每帧硬写（连人一起走），不会被甩掉
• 高度自适应：头顶高度取「碰撞体顶部 / 模型顶部 + 0.12m」，队友蹲下爬行会跟着降
• 前后偏移：2.头顶 里可以把挂载点沿队友正面往前/往后挪（正数往前、负数往后），调高度还是用上面那条，两项互不影响
• 护盾条：右下角胶囊，一条护盾值，默认 100，3.护盾 > 护盾值 里可调 50~200。它顶在血前面干活：你自己被怪打，伤害先扣护盾、扣掉多少就把自己的血补回多少，等于这一下被护盾吃掉；你挂着的那个队友掉血，同样从这份护盾里扣、扣多少原样补给他，一对一，没有阈值也没有次数上限 —— 护盾和你挂的那个人共用同一个数。被顶住、被物品击打或被翻滚的队友撞到都不扣。护盾扣空自动落下 + 10 秒冷却，重新挂上去时护盾刷新满
• 甩人（F）：你被别人挂在头顶的时候，按 F 演 0.7 秒「我倒了」，对面那套插件一看到挂着的队友倒了就会主动松手。自己血量一点不掉（只是给别的客户端发了个假信息），0.7 秒后自动广播回真实血量
• 灵球（G）：从胸前射出一颗浅绿色光球，沿准星方向飞 5 米停住悬停 3 秒。从出膛那一刻起它一直在扫，球心 5 米内有敌人就立刻拐弯追过去，命中后那家伙在原地疯狂闪现（高频传送）3 秒。冷却 10 秒。这一套数值全部写死，不进配置菜单
  • 右下角护盾条旁边有个常驻小方块：亮绿「G」＝可以放，黄字数字＝还剩几秒冷却（内部由下往上充能）。只要在关卡里活着就一直显示，死了才消失，不用挂在谁头上
• 三连小球（Y）：从背后甩出小球，5 轮 × 每轮 3 颗 = 共 15 颗，每 2 秒甩一轮。球慢慢散开、乱飘最多 8 秒。同一时刻只允许一颗球索敌 —— 轮到的球在球心 5 米内扫到怪就追上去（9 m/s），一球只认一只、认了不换；打中之后闸门关 1 秒，这 1 秒里其余球照原样乱飘、完全不索敌，闸门一开下一颗才开始扫（扫到别的怪就去追别的）。命中定身 1 秒，效果跟灵球一样（原地不动，不是抖）。五轮甩完进 15 秒冷却。数值同样全部写死，不进配置菜单
  • 护盾条左边还有一个小方块（琥珀色「Y」）：甩球过程中显示「×N」＝还剩几轮；冷却中显示剩余秒数（同样由下往上充能）
• 主动落下：按翻滚键，5 秒冷却
• 抗翻滚：被物品打、被翻滚的队友撞到都不会把你从头顶掀下来
• 给队友补血（护盾共享）：挂着的时候他掉多少血，就从护盾里扣多少、原样补给他，一直补到护盾见底为止。开关在 7.队友护盾 > 开启，默认开
• H 键手动输血：挂在他头上、他又不是满血时按 H，按他缺多少补多少，正好补满为止。例：他满血 180 只剩 20（缺 160），你满血 180 → 给他 160，你自己剩 20。你血不够补满他时只给到你还剩 1 点为止，绝不会为了补他把自己弄死。他满血、或你自己只剩一口气，按了只提示一句、什么都不扣。被挂着的那个人按 H 不生效，这键只对骑手有用。补完血被补的那位屏幕上会过一行绿字，写着谁给他输送了多少点血——只发给他一个人
• 队友死亡 / 血量归零 / 换场景，自动松开

安装

1. 先装 BepInExPack（r2modman 里直接搜 BepInEx 装上）
2. 把本包里的 plugins/StickHead.dll 放进 REPO/BepInEx/plugins/
3. 启动游戏，配置在 BepInEx/config/com.yanyan.stickhead.cfg

用 r2modman / Gale 直接安装更省事。

配置

组	说明
0.Language	界面语言（中文 / English）
1.热键	准星挂载键（默认 R）、甩人按键（默认 F）　※灵球 G、三连球 Y 是写死的，不在这张表里
2.头顶	高度偏移（-1~1）、蹲下额外补偿、前后偏移（-1~1）
3.护盾	护盾值（50~200）、护盾扣空冷却、主动落下冷却
4.传送	最大距离、锥形角度
5.显示	显示护盾条、界面缩放、提示停留秒数
6.调试	日志开关
7.队友护盾	给队友补血开关、H 键手动输血开关

界面语言

配置菜单最上面一项 0.Language > Language，可选 中文 / English。默认中文。

• 改完立即生效：菜单正开着的话会自己重开一次，分组名、条目名、说明当场就换成对应语言，不用重启游戏。
• 切语言不会丢设置：每个设置项本身没被重建，只是把它的名字/说明换掉再落盘，你调过的值原地不动。配置文件里始终只有一种语言的键。
• 屏幕右下角的提示文字（挂上、落下、冷却、输血那些）即时跟随，不用重启。

注意事项

• 别和 RepoCheat 的「黏队友头顶」同时开，两边都在抢位置，会互相拉扯。
• 客机上应该也能用（挂载靠位置硬写 + 面向同步），但队友视角是否完全对齐取决于网络同步，实测后再调。
• 输血（自动和 H 键都是）里「扣自己血」优先走游戏原版受伤流程，非战斗状态会被游戏拦掉，此时改为直接写血量兜底，可能没有红屏反馈。
• H 键如果被别的插件占了，功能本身就用不了 —— 本插件没做换键，想让开得在别的插件里错开。

---

English

What it does

• Attach — Aim at a teammate and press R; your position is force-written every frame, so you travel with them and can't be shaken off.
• Adaptive height — Standing height is max(collider top, renderer top) + 0.12 m; it follows automatically when your teammate crouches or crawls.
• Forward/back offset — An entry under 2. Head slides the mounting point along your teammate's facing direction (positive = forward, negative = back). Height is still handled by the offset above; the two are independent.
• Shield bar — A capsule in the bottom-right corner showing a single shield value: 100 by default, adjustable 50-200 under 3. Shield > Shield points. The shield stands in front of your health: when a monster hits you, the damage comes out of the shield and the same amount is healed back into your HP — the hit is eaten by the shield; when the teammate you are riding loses HP, that amount comes out of the same shield and is handed back to him one for one, with no threshold and no cap — you and your rider share a single pool. Shoves, object strikes and bumps from rolling teammates are free. An empty shield drops you off with a 10 s cooldown, and it refills to full every time you attach again.
• Shake-off (F) — If someone is riding your head, press F to fake a 0.7 s knockdown. Their copy of this plugin sees a dead teammate and lets go. Your own HP never changes — it is only a spoofed message to other clients, and the real value is broadcast back 0.7 s later.
• Spirit orb (G) — Fires a pale-green orb from your chest. It flies 5 m along your crosshair, then hovers for 3 s. From the moment it leaves your hands it keeps scanning; any enemy within 5 m of the orb makes it turn and chase, and on contact that enemy flickers (fast-teleports) in place for 3 s. 10 s cooldown. Every number in this feature is hard-coded and deliberately kept out of the config menu.
  • A small badge sits just left of the shield bar: bright green G = ready, amber number = seconds of cooldown left (it fills from the bottom). It stays on screen the whole time you are alive in a level, you do not need to be riding anyone.
• Trio mini-orbs (Y) — Flicks small orbs out from behind your back: 5 rounds × 3 orbs = 15 in total, one round every 2 s. Each orb drifts apart and wanders for up to 8 s. Only one orb is allowed to seek at any moment — the orb whose turn it is locks onto any enemy within 5 m of it and chases at 9 m/s; one orb, one enemy, no switching. After a hit the gate shuts for 1 s, during which the other orbs just drift and never scan; when it reopens the next orb starts scanning (if it finds a different enemy it chases that one). A hit pins the target in place for 1 s — same hold as the spirit orb (perfectly still, not wobbling). After the fifth round it goes on a 15 s cooldown. These numbers are hard-coded as well, deliberately kept out of the config menu.
  • A second badge sits left of the spirit-orb badge (amber Y): while firing it shows ×N = rounds left; on cooldown it shows the remaining seconds (also filling from the bottom).
• Manual drop — Press the tumble key; 5 s cooldown on landing.
• Anti-tumble — Being hit by items or knocked by a tumbling teammate won't throw you off.
• Topping up your teammate (shared shield) — While riding, whatever HP he loses comes out of the shield and is given back to him, one for one, until the shield runs dry. Toggle: 7. Team shield > Enable, on by default.
• H-key transfer — While attached to his head and he is not at full HP, press H to top him up by exactly what he is missing. Example: his max is 180 and he is at 20 (missing 160), you are at 180 → he gets 160 and you keep 20. If you cannot cover his whole gap you only give down to your last HP — you never kill yourself to heal him. If he is already full, or you are down to your last HP, pressing H just prints a message and costs nothing. Pressing H as the carried player does nothing; the key only responds for the rider. Afterwards the healed player sees a green outlined line on his own screen saying who transferred how much — it is sent to that player only.
• Detaches automatically if the teammate dies, hits 0 HP, or the scene changes.

Installation

1. Install BepInExPack first (search "BepInEx" inside r2modman).
2. Drop plugins/StickHead.dll into REPO/BepInEx/plugins/.
3. Launch the game. Settings live in BepInEx/config/com.yanyan.stickhead.cfg.

Installing through r2modman or Gale is simpler.

Config groups

Group	Contents
0. Language	Interface language (中文 / English)
1. Hotkeys	Attach key (default R), shake-off key (default F) — note: the spirit orb (G) and trio orbs (Y) are hard-coded and do not appear here
2. Head	Height offset (-1 to 1), extra compensation while crouching, forward/back offset (-1 to 1)
3. Shield	Shield points (50-200), cooldown after the shield breaks, manual-drop cooldown
4. Teleport	Max distance, cone angle
5. Display	Show shield bar, HUD scale, message duration
6. Debug	Logging toggle
7. Team shield	Teammate top-up toggle, H-key transfer toggle

Interface language

The first entry in the config menu is 0.Language > Language, offering 中文 / English. Defaults to Chinese.

• Applies instantly — if the menu is open it rebuilds itself on the spot, so section names, entry names and descriptions switch over immediately. No restart.
• Switching never loses your settings: each entry object is relabelled in place rather than re-bound, so your values stay exactly as tuned. The cfg file only ever holds one language's keys.
• On-screen messages (attached, dropped, cooldowns, donations) follow immediately, no restart needed.

Notes

• Don't run this together with RepoCheat's "stick to teammate's head" — both fight for your position and will drag you back and forth.
• It should work for non-host clients too (position is force-written and rotation is synced), but whether other players see you perfectly aligned depends on network sync — tune it after testing.
• The HP cost in team support (both auto and H-key) prefers the game's own damage path. Outside of combat the game blocks that, so it falls back to writing HP directly, which may mean no red-screen feedback.
• If another plugin already owns H, the transfer will not fire — there is no rebind in this plugin, so the other binding has to move.

---

Found a bug? Leave a comment below. 有问题在评论区留言。