ItemSpawnerPremium

适用于 PEAK 的独立物品生成器。按 F5 打开浏览界面，并将任意物品生成到手中。仅需 BepInEx —— 不需要其他 mod。

多人游戏提示： 物品由房间主机通过网络实例化，因此你生成的任何东西房间内所有人都能看到。请在自己的房间中使用，或先与队友确认。

原 quackandcheese-ItemSpawner 的延续版本，重制为单 DLL 独立 mod。

当前版本基于 PEAK 2.4.b（Steam 版本 25090101，2026-09-03）构建。其依赖项已针对该版本重新验证：物品数据库未变（194 个已注册物品），UI 字体回退链也未变。之后的游戏更新仍可能新增或重命名物品。

功能

• 本地化物品名称 —— UI 已翻译为游戏全部 15 种语言。物品名称来自游戏自身的本地化表；如果该表没有你所用语言的列，则显示英文名称；如果该表完全没有该物品的条目，则显示物品内部名称（或 prefab 名称）；少数游戏从未本地化的物品使用随本 mod 附带的名称。
• 智能搜索 + 拼音（全拼与首字母，例如 regouchang / rgc 可找到热狗肠）。当游戏语言为简体或繁体中文时启用拼音匹配。
• 多标签分类：全部 / 工具 / 食物 / 神秘 / 装备 / 消耗品 / 杂项。
• 相关物品保持在一起：颜色变体和产品系列在网格中分组排列（四种 clusterberry 排成一行，所有 crispberry、所有绳索发射器、所有背包，等等），而不会按名称分散。
• 收藏：右键切换、心形标记、配置持久化、收藏筛选。
• 隐藏未使用物品开关（默认开启）：隐藏棋子、撕破的指南书页、_Prop/_TEMP/_UNUSED/_Hidden prefab，以及一小列模板/占位 prefab。切换时收藏会被保留。
• 两种 UI 风格：HandDrawn（温暖牛皮纸，默认）/ Transparent（透明）。
• 单个 DLL：已内置 TinyPinyin 和全部 15 个本地化 JSON；仅需 BepInEx。

安装

1. 安装 BepInExPack_PEAK。
2. 将 plugins/ItemSpawnerPremium.dll 放入 BepInEx/plugins/。
3. 启动游戏并按 F5。

配置

BepInEx/config/com.itemspawnerpremium.ItemSpawnerPremium.cfg：

构建

前置条件：.NET SDK（目标框架 net472），以及一份 PEAK 安装。

1. 将 GameDir 指向你的 PEAK 根目录（包含 BepInEx 和 PEAK_Data 的文件夹）——可以传入 -p:GameDir="X:\path\to\PEAK"、设置 GameDir 环境变量，或编辑 Directory.Build.props 中的默认值。如果路径错误，构建会立即失败并给出清晰提示。
2. 运行 dotnet build ItemSpawnerEnhancement.csproj -c Release。
3. 输出：bin/Release/ItemSpawnerPremium.dll（Debug 输出到 bin/Debug/，因此两者不会互相覆盖）。

发布

pack.ps1 会从干净的 Release 构建组装 dist/ItemSpawnerPremium/。除非 git 工作树干净且四处版本字符串一致（csproj、Plugin.cs、package/manifest.json、CHANGELOG.md），否则它拒绝运行；它还会运行单元测试，并通过 verify_catalog.py 校验 ItemCatalog.cs 的不变量。压缩打包为可选项（-Pack）。完整的发布顺序见 pack.ps1 的注释头。

测试

tests/ItemSpawnerPremium.Tests 是一个 net8.0 的 NUnit 项目，不依赖 Unity 或 BepInEx：它仅以源码链接方式引入纯逻辑文件（SearchText.cs、SearchRanking.cs、ItemCatalog*.cs、FavoriteCodec.cs、Localization/Loc.cs、Localization/LocalizationCatalog.cs、TinyPinyin/*），并以与发布 DLL 相同的资源名嵌入 15 种语言的 JSON，因此会实际执行真正的标记解析和英文回退链。Localization/GameLanguage.cs 被刻意排除在链接之外——它引用了游戏的 LocalizedText 类型。

dotnet test tests/ItemSpawnerPremium.Tests/ItemSpawnerPremium.Tests.csproj

覆盖内容：搜索规范化与拼音转换（包括遍历整个 BMP 汉字范围，断言解码期间没有任何字符抛出异常）、排名层级与文化无关性、目录排序的全序性质、隐藏规则与分类表的互补性、收藏 JSON 的往返序列化与损坏输入恢复，以及全部 15 种语言的本地化键完整性。

项目结构

• Plugin.cs — BepInEx 入口点、配置、F5 轮询、GUIManager 补丁。
• ItemSpawnerPremiumWindow.cs — MenuWindow 子类（纯代码 UI）。
• ItemListView.cs — 列表视图、对象池、收藏、Unity 生命周期。
• SearchText.cs / SearchRanking.cs — 纯逻辑搜索规范化、排名与目录排序。
• UiEnhancer.cs — UI 构建器（两种风格，SDF 烘焙精灵）。
• ItemCatalog.cs / ItemCatalogMethods.cs — 物品目录数据 + 分类逻辑。
• FavoriteStore.cs / FavoriteCodec.cs — 收藏持久化及其纯逻辑编解码器。
• Warmup.cs — 面板预热 + 渲染准备。
• TinyPinyin/ — 内置拼音库（MIT，本地修改）。
• Localization/ — 15 个内嵌语言 JSON。
• package/ — 用于构建发布文件夹的标准 manifest.json 和 icon.png。
• tests/ — 单元测试（通过 Compile Remove 排除在 mod DLL 之外）。
• pack.ps1 / verify_catalog.py — 发布组装与目录不变量检查。

致谢

• 原 mod 作者： quackandcheese —— quackandcheese-ItemSpawner（0.1.4）。
• 代码参考： lllei 的 ItemSpawnerEnhanced —— 本 mod 的本地化目录和语言代码映射源自该项目（MIT；详见声明文件）。
• TinyPinyin： TinyPinyin.Net（MIT，© 2017 Jay.M.Hu）。

许可证

MIT —— 详见 LICENSE。第三方声明见 THIRD_PARTY_NOTICES.md。