PEAK Item Insight

See what changes before you use an item. 使用前，看见变化。

An unofficial, experimental PEAK mod by Rachel560lu. Version 0.2.2.

Features

• Hover or hold: aim at a pick-up-able item to preview it. With no hovered target, the held item is previewed instead. Hover takes priority.
• Recovery on the native HUD: the recoverable part of hunger or injury pulses toward healthy green. Hunger 30 and food -10: one third pulses. Hunger 5 and food -10: the whole hunger segment pulses. Zero recovery does not pulse.
• Harm before consumption: recognized poison, spores and other status increases have pulsing HUD previews, including a new poison segment when you are not already poisoned. Extra/infinite stamina have separate cues.
• Timed poison: the card shows recognized delay, duration and cumulative poison. You do not need to wait out the poison delay while hovering. Totals are item-only estimates, not guaranteed final states.
• Readable item cards: game-style icons and fonts, item type, separate poison/spore warnings, signed effects and useful charges. Chinese/English follows the game or your setting.
• Empty hands plus no target clears the preview. Looking away while holding an item keeps the held preview. The used item's preview pauses during use and refreshes afterward.

中文

这是 Rachel560lu 制作的非官方实验版 Mod，范围是可拾取物品。准星对准物品时显示预览；没有悬停目标时，预览手持物品。

• 饥饿／伤势预计恢复的部分，在原色与健康绿色之间闪烁；完整、部分、零恢复分别处理。
• 已识别的毒素、孢子和其他状态增加也有原生 HUD 闪烁预览；当前没有中毒时，也会显示新增毒素区域。
• 持续中毒显示延迟、持续时间与累计估计量；无需悬停到毒性延迟结束才出现预览。
• 简介卡显示图标、类别、毒性／孢子风险、单次效果与有用的剩余次数，不再重复显示“准星／手持”或“烹饪：否”。
• 空手看地板会清除预览；手持看地板保留预览；使用期间暂停，使用后重新计算。

累计毒素是物品自身效果的估计，不包含自然恢复、环境、已有增益和完整游戏时间步进。未知不等于无毒。 并非所有物品、烹饪变种和特殊角色均已适配；多人及其他 HUD Mod 的兼容性尚未验证。

Installation / 安装

Development testing used Windows and PEAK 2.4.b. User testing confirmed working previews; a completely fresh standard mod-manager startup has not yet been independently verified.

1. Close PEAK and back up saves. Use a separate mod-manager profile for the first run.
2. Install PeakItemInsight and dependency BepInEx-BepInExPack_PEAK-5.4.2403 through your manager. For a local candidate ZIP, use the manager's local-import option.
3. Start Modded PEAK. Check the current BepInEx log for PEAK Item Insight 0.2.2 loaded.
4. Manual installation: with BepInEx working, copy the included BepInEx/plugins/PeakItemInsight/PeakItemInsight.dll into the matching profile path. Keep only one plugin DLL.

首次使用请备份存档，并使用独立 profile。安装本 Mod 及所需 BepInEx 后，从管理器启动 Modded PEAK；日志应显示本次运行加载了 0.2.2。不要同时保留多个版本的 DLL。

Configuration / 配置

After the first successful load, close the game before editing BepInEx/config/dev.rachel.peakiteminsight.cfg.

Accuracy and compatibility

The mod reads current item/player data and draws UI; it does not consume items, change gameplay status or send gameplay network actions. Preview-owned UI copies and temporary native-image visibility changes are restored when the preview clears.

Recognized immediate and timed effects are supported, but target-dependent tools, random area effects, special characters, environmental interactions and some conditional/cooking variants remain incomplete. Mushroom mapping must be available for mapping-dependent effects. No poison preview is not proof of safety: check the card's risk and incomplete-effect warnings. Environmental thorns and spore clouds are not targetable-item features of this mod.

81 offline checks pass, with separate loaded-asset/synthetic HUD coverage for six audited poison-food variants. Player-supplied recordings demonstrate poisonous food, safe-food recovery and item cards. These checks do not certify every food, multiplayer or compatibility with other mods.

Troubleshooting / 问题反馈

• No card: confirm the current session loaded 0.2.2, Enabled is true and only one DLL is installed.
• Card but no recovery pulse: check that the relevant status exists and the item can reduce it. Zero recovery deliberately has no pulse.
• Poison warning but no poison pulse: record the item/variant, existing status and whether it is hovered or held; this needs investigation, not an assumption that the food is safe.
• Overlap or tiny text: adjust PanelScale, OffsetX and OffsetY.
• For a report, include mod/game versions, item and cooking state, hover/held, reproduction steps and a screenshot. Share relevant BepInEx log excerpts only after removing personal paths, usernames and room/account details. Diagnostics stay local; the mod does not automatically upload them.

Removal / 卸载

Close PEAK, then disable/uninstall PeakItemInsight in the manager, or remove only its plugin folder. No save reset is required by this mod. Leave shared BepInEx dependencies used by other mods intact.

License and credits

Copyright (c) 2026 Rachel560lu. Released under the MIT License, included in the package. Game assets and dependencies retain their respective owners' rights and are not relicensed by this notice. Not affiliated with or endorsed by the PEAK developers.

Changelog

0.2.13 — 2026-09-14 / Optional readable detailed descriptions

• Add Minimal / Detailed description selection in the pause-menu settings; stamina preview controls remain independent.
• Detailed cards show the item icon beside its name, known cooking count and adjustable background transparency.
• Describe immediate effects, per-second changes, duration and delayed side effects in plain language with status icons. Combine redundant drowsiness clearing; omit unavailable information.
• Add Turkish and Spanish translations alongside Chinese and English.
• Stop refreshing hidden settings, limit prediction refreshes, reuse unchanged text layouts and release settings UI focus on close.
• 新增可选详细模式、名称旁物品图标、烹饪次数与背景透明度设置；精力条预览仍可独立调整。
• 详细版使用文字配图标，明确即时／每秒效果、持续时间及延迟副作用；合并重复困倦恢复，省略不存在的信息。
• 保留中英文并新增土耳其语、西班牙语；减少隐藏设置和重复布局的刷新，关闭设置时清理其 UI 焦点。

0.2.12 — 2026-09-13 / English instructions first

• Move English instructions above Chinese instructions; retain all screenshots and demos.
• 英文使用说明移至中文上方，保留全部截图与演示。仅更新文档，沿用 0.2.11 DLL。

0.2.11 — 2026-09-13 / In-game preview settings

• Add independent Hover / Held / Both / Off controls for inventory text and stamina previews, with automatic saving.
• Show setup on the first Airport visit; reopen through the top-right pause-menu entry. Fix pause entry click layering.
• 新增物品栏文字与精力条预览独立设置，首次进入机场显示，暂停菜单右上角可重新打开，选择自动保存。
• Add bilingual setup instructions and screenshots. Existing preview typography and stamina rendering remain unchanged.

0.2.10 — 2026-09-13 / README update

• Separate English and Chinese demos, English first. Add the new English GIF and retain both Chinese demos.
• 演示分为英文和中文，英文在前；新增英文 GIF，保留两张中文演示。
• Documentation only; the tested 0.2.9 Mod DLL is unchanged. 仅更新文档，Mod 功能不变。

0.2.9 — 2026-09-12 / Simpler timed effects

• Timed items show one final change per status, using the same snapshot as the stamina preview. Remove raw rates, durations and delay text.
• Keep short labels for speed boosts, temporary infinite stamina and mushroom abilities; preserve poison warnings at the status cap.
• Replace the previous gameplay demo with new energy/sports drink and trail mix recordings.
• 持续类物品按状态合并显示最终预计变化量，去掉速率、持续时长和延迟；保留临时能力短标签与毒性风险提示。
• 更新饮料和混合坚果实机 GIF。精力条闪烁、字体及物品栏定位沿用原有实现。

0.2.8 — 2026-09-12 / Native text and inventory positioning

• Fix missing Chinese glyphs and restore the game's rounded font, native status icons and clear up/down effect arrows.

• Anchor aimed-at item information above the first empty inventory slot; use the backpack position when all three slots are full. Holstered slot highlights no longer misplace the preview.

• Keep held-item information above its own slot and preserve stamina-bar preview behavior.

• Replace the old README demos with one new energy-drink gameplay GIF.

• 修复中文方框乱码，恢复原生圆润字体、状态图标与增减三角。

• 准星物品提示显示在第一个空槽上方，满栏时显示在背包栏上方，不再受收起物品后的高亮影响。

• 手持提示仍跟随自身槽位；精力条预览保持不变。

• README 旧演示统一替换为新版能量饮料实机 GIF。

0.2.7 — 2026-09-12 / Minimal interface

• Replace the detailed card with a compact, background-free interface using game fonts and status icons. No mode selection is needed.

• Keep stamina-bar previews, signed effects, poison/spore risks, duration, remaining uses and useful item instructions.

• Position information near the inventory; support Chinese/English, adjustable size and offsets.

• Remove legacy card settings. Existing minimal-interface settings remain compatible.

• 仅保留极简界面：原生字体与状态图标、无背景，无需切换模式。

• 保留精力条闪烁、效果数值、毒性／孢子提示、持续时间、剩余次数和必要用途说明。

• 信息定位在物品栏附近，支持中英文、大小和位置调整；旧详情卡配置不再生效。

0.2.6 — native stamina previews

• Bonus stamina now uses PEAK's original lightning icon, white outline and textured fill.
• New bonus previews appear above the main bar; existing bonus previews extend the lower bar. Only the gain pulses, with a clear gap between the bars.
• Hunger recovery and poison increases are previewed together, including full and partial hunger recovery.
• Add sports-drink, special-item and Remedy Fungus GIFs. Replace the bandage demo with a first aid kit.

额外精力预览使用原生闪电、白框和填充；没有额外精力时显示在上方，已有时在下方衔接，仅新增部分闪烁。饥饿恢复与毒性增加同步预览。新增运动饮料、特殊道具和灵药菇演示，以急救箱替换绷带演示。

0.2.5 — preview fixes and clearer item cards

• Fix the floating flashing block near the stamina bar when previewing bonus stamina.
• Improve Chinese/English descriptions for the Scout Cannon, Passport, Piton and Remedy Fungus.
• Explain piton reuse and Remedy Fungus group healing; remove generic internal diagnostic messages from item cards.
• Refresh gameplay demos: energy drink, poisonous mushroom, poisonous berry, bandage, safe mushroom and item information.

修复精力条外的闪烁方块，完善童军大炮、护照、岩钉和灵药菇的中英文说明，移除无用诊断文案，并更新六组演示。

0.2.4 — player-page and cover update

• Replace the package cover with the new Item Insight artwork.
• Streamline the bilingual README around download, gameplay demos, usage and common settings.
• Keep the same gameplay DLL and dependencies as 0.2.3.

0.2.3 — demonstration and source-link update

• Add poisonous-food, safe-food and item-card GIF demonstrations to the public page.
• Link the public MIT-licensed GitHub repository and issue tracker.
• Documentation-only package: the DLL is byte-identical to the tested 0.2.2 plugin, whose in-game log version remains 0.2.2. No gameplay changes or additional dependencies.

0.2.2 — first public release

• Preview hovered items with held-item fallback.
• Pulse hunger and injury recovery inside the affected native status segment.
• Preview recognized poison/spore/status increases, including poison when the native poison slot starts hidden or empty.
• Include item-only cumulative timed effects with delay and duration in the card; totals remain estimates.
• Add extra/infinite stamina cues and game-style bilingual cards with icons, risk warnings and useful charges.
• Read real runtime poison components rather than hardcoding food names or overwriting cooking-dependent effects.
• Validate six audited poison-food variants and pass 81 offline regression checks.
• Include the MIT License. Player testing supplied poisonous-food, safe-food and card demonstrations; full item/multiplayer compatibility is not claimed.

Earlier version numbers were local development builds, not previous public Thunderstore releases.