
You are viewing a potentially older version of this package. View Latest Version
PeakStaminaHost
房主联机控制全房体力上限/无限体力/免饥饿/免伤 + 独立负面条。上限倍率文本框输入百分数自由调(2.5=一丝、100=原版、500=5倍),满足极限体力与更多体力登顶的玩家。独立负面条复制原生体力条UI结构、内部橙色、对齐显示在体力条正下方,含负重/饥饿/伤害等全部原生状态条,默认50可调10-100、不压体力上限,满到上限才倒地,起身与倒地阈值统一从根本消除黑屏循环(对所有负面类型通用),更轻松爬山。非房主本地也立即生效,房主经 Photon RPC 广播全房。PeakStaminaHost
Host-controlled stamina cap, extra affliction bar, infinite stamina, no-hunger and god-mode for PEAK (Steam).
房主联机控制全房体力上限 / 独立负面条 / 无限体力 / 免饥饿 / 免伤(BepInEx 5)。
Changelog / 更新
v1.9.0
- 重写体力条视觉驱动:原版
desired = currentStamina × 框宽假设满值=1,倍率>1 时 Lerp 目标过冲。本插件用自维护的平滑字段朝绝对映射目标(Clamp01(currentStamina)、Clamp01(GetMaxStamina),即相对原版满值=1 的比例,不除倍率)Lerp,再直接覆盖 sizeDelta——不与原版 Lerp 串联(串联会把宽度拉到两个目标之间、且随帧率漂移导致抖动)。低倍率随倍率缩短、高倍率钳满不超框,收敛后与帧率无关故不抖。 - 该 Postfix 设
HarmonyPriority(600)(高于默认 400),先于 PeakStatsEx 执行,使其读到正确宽度。 - 不修改私有
desiredStaminaSize,PeakStatsEx 数字仍按它显示绝对体力值(如 500),视觉条与数字分离。 - 免饥饿等开关新增不依赖
SettingChanged事件的轮询:每帧直接比对ConfigEntry.Value,只要 BoxedValue 被写回即同步,并记录[轮询检测]日志,定位下拉是否真的写回。 - 抖动诊断改为限频(0.25s)且静止时也记录真实视觉宽度,覆盖此前“静止完全静默”的观察盲区。
v1.8.0
- 修复独立条仍是绿色:改色目标改为真实的
Stamina/FillImage(此前对无 Image 的Stamina改色无效)。 - 修复无限体力数字无限增长:不再写
infiniteStam,改为拦截Character.UseStamina。 - 独立条新增数字(游戏自带字体,显示剩余容量百分制)。
- 新增配置变更来源 / 每帧体力变化诊断,用于定位免饥饿被覆盖与数字抖动(见已知限制)。
Features / 功能
- 可调节的体力上限(文本框输入百分数) — 直接输入百分比:
2.5= 原版 2.5%(一丝)、100= 原版、200= 2 倍、500= 5 倍;每 2.5 都能调,无滑块、无下拉。既满足想玩极限体力的玩家,也满足想要更多体力轻松登顶的玩家。Adjustable stamina cap via a free percentage text box — every 2.5 increment works, no slider/dropdown. - 独立负面条(含负重条,默认开启) — 开启后玩家拥有一条独立的负面条,复制游戏原生体力条的 UI 结构、内部为橙色、对齐显示在体力条正下方,与原体力条等同对应。负重 / 饥饿 / 伤害等全部原生状态都显示在下方这条上,出现后挤占橙色总条(与原版绿色条被状态条挤占的行为完全一致)。默认提供 50(可在 10–100 之间调节) 的额外负面容量且不占用体力条,拿再重的道具体力上限也不缩,爬山更轻松。An extra affliction bar (weight included) that clones the vanilla stamina-bar layout, recolored orange, placed directly under the stamina bar; default 50, adjustable 10–100, and it never shrinks the stamina cap.
- 原体力条保持干净 — 独立负面条开启时,原体力条上的彩色负面条隐藏(保留白色外框与溢出线);关闭该功能后,原版负面条恢复显示。With the extra bar on, the colored afflictions on the original bar are hidden while the white outline is kept; turn it off to restore vanilla.
- 不再反复倒地起身(根本修复,无滞回) — 起身条件与倒地阈值统一:负面总量达到额外容量才倒地,降到容量以下后正常起身;对火烤、负重、饥饿、伤害等所有负面类型通用。The stand-up and pass-out thresholds are unified, fixing the black-screen loop for every affliction type, without any hysteresis.
- 贴体力条模式(关闭独立负面条) — 回到原版行为:负面条压体力上限,体力条低于负面条就倒地。Turn the extra bar off for vanilla stick-to-stamina behavior.
- 无限体力(修复数字无限增长) — 不再写游戏的
infiniteStam字段(该字段会让 currentStamina 只增不减、钳制失效导致数字一路涨),改为 Harmony 拦截Character.UseStamina:开启时所有消耗动作直接返回成功、不扣体力,运行时切换即时生效。Infinite stamina now intercepts UseStamina instead of setting infiniteStam, fixing the runaway number. - 独立条带数字 — 用游戏自带字体(
heroDayText.font)在独立条上显示剩余负面容量百分制(满 100、负面越多越小、到容量倒地为 0),不依赖第三方数值 mod。The extra bar shows its own number using the game's built-in font. - 免饥饿 / 免伤无敌 — 饥饿不再累加;免疫伤害性状态且不会死亡。No-hunger / god mode.
- 体力条长度正确、不溢出 — 条长按绝对体力值相对原版满值(=1)的比例显示:低倍率随倍率缩短(50%→半框、2.5%→很短),高倍率钳满框、不超框。Bar length follows the absolute value vs the vanilla cap: low multipliers shrink proportionally, high ones clamp to the frame.
Installation / 安装
Mod manager (recommended) / 模组管理器(推荐)
- Online: click Install on the Thunderstore page; dependencies are added automatically. 在线安装:在雷霆商店页面点击安装,依赖自动配齐。
- Local zip: profile → Import local mod → select
PeakStaminaHost.zip→ Start modded. 本地 zip:profile → Import local mod → 选择PeakStaminaHost.zip→ Start modded。
Manual / 手动安装
- Requires BepInEx 5. Extract the
BepInExfolder from the zip into the game root (Steam\steamapps\common\PEAK) and merge; the dll lands inBepInEx/plugins/PeakStaminaHost.dll. 需先装 BepInEx 5。把 zip 内BepInEx文件夹解压到游戏根目录Steam\steamapps\common\PEAK并合并,dll 落入BepInEx/plugins/PeakStaminaHost.dll。
Dependencies (BepInEx-BepInExPack_PEAK-5.4.2403, PEAKModding-ModConfig-1.8.2) are auto-installed by managers; manual users must have them present.
依赖(BepInEx-BepInExPack_PEAK-5.4.2403、PEAKModding-ModConfig-1.8.2)管理器会自动安装,手动安装需自行确认。
Usage / 使用
暂停菜单 → MOD SETTINGS → PeakStaminaHost(由 PEAKLib.ModConfig 自动收集):
| 配置项 Setting | 控件 Control | 说明 Explanation |
|---|---|---|
| 上限倍率(%) Stamina cap | 文本框 Text | 百分数,如 2.5 / 100 / 200 / 500 |
| 独立负面条 Extra bar | On/Off | 开(默认):独立橙色条、不压体力、到容量才倒地;关:贴体力条(原版) |
| 独立负面条上限(%) Extra bar cap | 文本框 Text | 倒地阈值,10–100,默认 50 |
| 免饥饿 No-hunger | On/Off | 饥饿不再累加 |
| 免伤无敌 God mode | On/Off | 免疫伤害性状态、不会死亡 |
| 全房无限体力 Infinite stamina | On/Off | 攀爬不消耗体力 |
Multiplayer / 联机
- 全房玩家都需安装本 mod(PEAK 为点对点,体力在本地计算)。
- 房主(MasterClient)修改后经 Photon RPC 广播统一全房;非房主的本地修改也会在自己角色上立即生效。
- 全部玩法设置(上限、独立负面条、免饥饿、免伤、无限体力)均会广播。
How it works / 原理
全部依据 Assembly-CSharp.dll 反编译核实,无编造接口(verified against a decompile, nothing invented):
Character.GetMaxStamina()原版为1 − statusSum;独立负面条模式下让其忽略statusSum,返回恒定的1 × 倍率,因此拿重物体力上限不缩、数值稳定。- 独立负面条在运行时
Object.Instantiate复制整个原生StaminaBar游戏对象(含背景框、白色外框、图标位与全部BarAffliction子节点),删除副本上的StaminaBar与各BarAffliction脚本后由本插件驱动:橙色总条长度 = 剩余容量,各原生状态条按1/ExtraBarCap缩放并挤占橙色总条。绿色填充 Image 实际位于Stamina/Fill(Stamina本身无 Image),改色针对该 Fill;数字用游戏自带heroDayText.font新建 TMP 显示。复制保留了原生锚点与布局,故不手写任何 RectTransform 数值。 - 无限体力不写
Character.infiniteStam:该字段会让currentStaminasetter 只允许上升、ClampStamina失效而数字无限增长。改为 Prefix 拦截 internalCharacter.UseStamina,开启时__result=true并跳过原方法,所有 12 处主动消耗(攀爬/冲刺/跳跃/抓握/绳索/藤蔓/滑翔/Exhaustion)均经此方法。 - 原体力条通过
BarAffliction.ChangeAffliction的 Postfix 在额外模式下隐藏彩色条,白色外框(Outline)与溢出线保持不动。 - 倒地:原版
shouldPassOut = statusSum > 0.99,额外模式改为statusSum > ExtraBarCap;HandlePassedOut的 Prefix 在总量未降到容量以下时刷新lastPassedOut,使起身条件不成立,从根本上消除循环,而非加滞回。 - 负重走
SetStatus(Weight, …)而非AddStatus;额外模式把负重/饥饿/伤害与体力上限分离,统一由独立条承载。 - 上限与额外容量为
string配置,ModConfig 据此渲染纯文本框(无滑块/下拉)。 - 原版体力条宽度 =
currentStamina × fullBar 宽,假设满值=1;倍率>1 时该目标过冲。本插件在StaminaBar.Update的高优先级(600)Postfix 中,用自维护的静态平滑字段(_smoothStam/_smoothMax)朝绝对映射目标 Lerp——体力条Clamp01(currentStamina) × fullBar 宽、上限条Clamp01(GetMaxStamina()) × fullBar 宽(不除倍率)——再直接覆盖 sizeDelta。因不与原版 Lerp 串联,宽度精确收敛,且收敛后Lerp(B,B,t)=B与帧率无关、不抖动。私有desiredStaminaSize保持原版值不变,PeakStatsEx 据此显示绝对数字。 - 房主通过
photonView.RPC("RPC_SetStaminaMultiplier", All, cap, infinite, noHunger, godMode, extraBar, extraCap)广播。
Known limitations / 已知限制
- 全房必须安装;仅房主修改会被广播。
- 免饥饿 / 数字抖动的定位方式:v1.8 日志确认问题在于下拉操作未把
BoxedValue写回(独立条同机制可成功切换,补丁逻辑本身正确),而非补丁拦截错误。v1.9 改为每帧直接比对ConfigEntry.Value:只要值被写回即同步,不依赖事件;并打印[轮询检测]。若操作后日志仍无[轮询检测] 免饥饿实际值变化=True,说明是该下拉 UI 未写回,需核对具体点击步骤。数字抖动方向,v1.9 已消除 Lerp 过冲与硬钳、并控制补丁顺序;复现后提供BepInEx/LogOutput.log(含静止时限频的视觉宽度记录)即可继续锁定。 - 免伤覆盖状态累加与死亡入口;特殊即时伤害路径可能未覆盖(附源码可自行扩展)。
- 视觉条按比例显示,>1 倍时条体本身读不出绝对上限,绝对体力值看 PeakStatsEx 数字、独立条数字看剩余负面容量。
- 若游戏更新改动这些 hook,需用附带源码重新编译。
Source / 源码
交付包含完整 C# 源码(Harmony + Photon,net472)。
License
MIT — 可自由使用与修改。