局内神器管理 · InRunArtifacts

在游戏途中开关神器，下一张地图生效。游戏内支持中英文菜单，自动跟随游戏语言；其他语言使用英文菜单，神器名称与效果使用游戏提供的本地化文本。

问题反馈和功能建议请提交到 GitHub Issues。提交错误时，请附上复现步骤、模组版本和相关日志；上传前请移除日志中的个人信息。

使用方法

• 按 F7 打开单页神器菜单，点击图标开关神器，悬停查看名称与效果。
• 亮色表示下一地图开启，灰色表示关闭；青色边框和星号表示待应用的修改。
• 点击「完成」保留修改，点击「撤销全部修改」恢复当前状态。
• 再次按 F7 或 Esc 关闭菜单。打开时暂停游戏，关闭后恢复。
• 修改在当前关卡结束时应用，不会重新生成或删除当前地图已有的物品。

配置与兼容

依赖 BepInExPack。首次启动后，可在 BepInEx/config/com.lml.inrunartifacts.cfg 修改快捷键。

读取游戏注册的神器，包括第三方神器；能否中途切换取决于其实现。修改仅在本局生效，不改变开局预设或解锁记录。使用游戏自带图标，未打包游戏资源。

主要面向单人游戏，仅房主可操作。联机暂停、特殊关卡及第三方神器兼容性尚未全面验证。无图形界面的专用服务器不提供菜单。

源码与构建

项目使用 .NET SDK 构建。编译前请在 libs/BepInEx.dll 放置 BepInEx 5 的程序集，然后运行 ./build.ps1。生成的 Thunderstore 安装包位于 dist/。libs/、构建输出及发布包不提交到仓库。

English

Toggle artifacts during a run, with changes taking effect on the next stage. Supports Chinese and English in-game menus, automatically selected from the game language. Other languages use English menus; artifact names and descriptions use the game's localization.

Please report bugs and feature requests through GitHub Issues. For bugs, include reproduction steps, the mod version, and relevant logs after removing personal information.

How to use

• Press F7 to open the single-page artifact menu. Click an icon to toggle it; hover for its name and effect.
• Bright means enabled next stage; gray means disabled. A cyan border and asterisk indicate pending changes.
• Select Done to keep changes or Undo all to restore current states.
• Press F7 or Esc to close. Opening the menu pauses the game; closing it resumes play.
• Changes apply when the current stage ends. Existing pickups are not regenerated or removed.

Configuration and compatibility

Requires BepInExPack. After the first launch, change the hotkey in BepInEx/config/com.lml.inrunartifacts.cfg.

Lists registered artifacts, including third-party artifacts. Runtime switching support depends on each artifact's implementation. Changes affect only the current run, not lobby presets or unlock records. Uses built-in artifact icons; no game assets are bundled.

Primarily intended for single-player; only the host can operate the menu. Multiplayer pausing, special stages, and third-party compatibility have not been fully verified. Headless dedicated servers do not have a menu.

Source and building

Build with the .NET SDK. Place the BepInEx 5 assembly at libs/BepInEx.dll, then run ./build.ps1. The Thunderstore package is written to dist/. Dependencies, build output, and release archives are not committed.

更新记录 / Changelog

• 1.0.2：开放 GitHub 源码与 Issues 反馈入口。 / Published the source and added a GitHub Issues feedback link.
• 1.0.1：补齐中英文菜单与发布说明。 / Added Chinese/English menu text and bilingual documentation.
• 1.0.0：单页神器菜单、悬停说明、下关生效与撤销功能。 / Single-page artifact menu, hover descriptions, next-stage changes, and undo.