You are viewing a potentially older version of this package. View Latest Version
StickHead
Aim at a teammate, press R to ride their head. Stamina drops only on real HP loss. F shakes off riders. G fires a spirit orb that hunts and stuns enemies. Config zh/en.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 3-second cooldown on landing.
准星对准队友（10 米内、30° 锥形、无遮挡），按 R 直接传送到他头顶并黏住，跟着他走。再按 R 无效，要下来请按翻滚键，落地后有 3 秒冷却。
中文
功能
- 挂载：瞄队友按 R，位置每帧硬写（连人一起走），不会被甩掉
- 高度自适应：头顶高度取「碰撞体顶部 / 模型顶部 + 0.12m」，队友蹲下爬行会跟着降
- 能量条：右下角胶囊，5 格。真掉血才掉一格（0.35 秒去重）；你挂着的那个队友掉血也算，一样掉一格；被顶住、被物品击打或被翻滚的队友撞到都不扣。掉光强制落下 + 5 秒冷却
- 甩人（F）：你被别人挂在头顶的时候，按 F 演 0.7 秒「我倒了」，对面那套插件一看到挂着的队友倒了就会主动松手。自己血量一点不掉（只是给别的客户端发了个假信息），0.7 秒后自动广播回真实血量
- 灵球（G）：从胸前射出一颗浅绿色光球，沿准星方向飞 5 米停住悬停 3 秒。从出膛那一刻起它一直在扫，球心 5 米内有敌人就立刻拐弯追过去，命中后那家伙在原地疯狂闪现（高频传送）3 秒。冷却 10 秒。这一套数值全部写死，不进配置菜单
- 右下角能量条旁边有个常驻小方块：亮绿「G」＝可以放，黄字数字＝还剩几秒冷却（内部由下往上充能）。只要在关卡里活着就一直显示，死了才消失，不用挂在谁头上
- 主动落下：按翻滚键，3 秒冷却
- 抗翻滚：被物品打、被翻滚的队友撞到都不会把你从头顶掀下来
- 增益队友（输血）：队友掉血超过阈值时，拿自己的血换他的血——扣多少就补多少（一比一），每挂一次最多 5 次
- 队友死亡 / 血量归零 / 换场景，自动松开
安装
- 先装 BepInExPack（r2modman 里直接搜 BepInEx 装上）
- 把本包里的
plugins/StickHead.dll放进REPO/BepInEx/plugins/ - 启动游戏，配置在
BepInEx/config/com.yanyan.stickhead.cfg
用 r2modman / Gale 直接安装更省事。
配置
| 组 | 说明 |
|---|---|
| 0.Language | 界面语言（中文 / English） |
| 1.热键 | 准星挂载键（默认 R）、甩人按键（默认 F） |
| 2.头顶 | 高度偏移、蹲下额外补偿 |
| 3.能量 | 格数、掉光冷却、主动落下冷却 |
| 4.传送 | 最大距离、锥形角度 |
| 5.显示 | 显示能量条、界面缩放、提示停留秒数 |
| 6.调试 | 日志开关 |
| 7.增益队友 | 开启、触发阈值、扣多少＝回多少、最多次数、自己最低保留血量 |
界面语言
配置菜单最上面一项 0.Language > Language，可选 中文 / English。默认中文。
- 改完立即生效：菜单正开着的话会自己重开一次，分组名、条目名、说明当场就换成对应语言，不用重启游戏。
- 切语言不会丢设置：每个设置项本身没被重建，只是把它的名字/说明换掉再落盘，你调过的值原地不动。配置文件里始终只有一种语言的键。
- 屏幕右下角的提示文字（挂上、落下、冷却、输血那些）即时跟随，不用重启。
注意事项
- 别和 RepoCheat 的「黏队友头顶」同时开，两边都在抢位置，会互相拉扯。
- 客机上应该也能用（挂载靠位置硬写 + 面向同步），但队友视角是否完全对齐取决于网络同步，实测后再调。
- 输血功能里「扣自己血」优先走游戏原版受伤流程，非战斗状态会被游戏拦掉，此时改为直接写血量兜底，可能没有红屏反馈。
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. - Stamina bar — A capsule in the bottom-right corner, 5 pips. Only real HP loss costs a pip (0.35 s de-dupe); HP lost by the teammate you are riding also costs a pip; shoves, object strikes and bumps from rolling teammates are free. At zero you're forced off, plus a 5 s cooldown.
- 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 stamina 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.
- Manual drop — Press the tumble key; 3 s cooldown on landing.
- Anti-tumble — Being hit by items or knocked by a tumbling teammate won't throw you off.
- Team support (blood donation) — When a teammate loses more HP than the threshold, you trade your own HP for theirs: what you lose is exactly what they gain (one for one). Up to 5 donations per attach.
- Detaches automatically if the teammate dies, hits 0 HP, or the scene changes.
Installation
- Install BepInExPack first (search "BepInEx" inside r2modman).
- Drop
plugins/StickHead.dllintoREPO/BepInEx/plugins/. - 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) |
| 2. Head | Height offset, extra compensation while crouching |
| 3. Stamina | Pip count, zero-stamina cooldown, manual-drop cooldown |
| 4. Teleport | Max distance, cone angle |
| 5. Display | Show stamina bar, HUD scale, message duration |
| 6. Debug | Logging toggle |
| 7. Team support | Enable, trigger threshold, HP moved (cost = heal), max donations, own HP floor |
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 the team-support feature 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.
Found a bug? Leave a comment below. 有问题在评论区留言。