PEAK
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
Downloads
806
Size
18KB

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/Fill Image(此前对无 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 BepInEx folder from the zip into the game root (Steam\steamapps\common\PEAK) and merge; the dll lands in BepInEx/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:该字段会让 currentStamina setter 只允许上升、ClampStamina 失效而数字无限增长。改为 Prefix 拦截 internal Character.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 — 可自由使用与修改。

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.