ItemSpawnerPremium

ItemSpawnerPremium

A standalone item spawner for PEAK. Press F5 to open the browser and spawn any item in hand. Only BepInEx is required — no other mods.

Multiplayer note: items are network-instantiated by the room host, so anything you spawn is visible to everyone in the room. Use it in your own lobby, or check with your teammates first.

A continuation of the original quackandcheese-ItemSpawner, rebuilt as a single-DLL standalone mod.

The current release is built against PEAK 2.4.b (Steam build 25090101, 2026-09-03). The things it depends on were re-verified against that build: the item database is unchanged (194 registered items) and so is the UI font fallback chain. Later game updates may still add or rename items.

Features

• Localized item names — the UI is translated into all 15 game languages. Item names come from the game's own localization table; if that table has no column for your language the English name is shown, if it has no entry for the item at all the internal item name (or the prefab name) is shown, and a small number of items that the game never localized use a name bundled with this mod.
• Smart search + Pinyin (full spelling and initials, e.g. regouchang / rgc finds hotdog sausage). Pinyin matching is enabled when the game language is Simplified or Traditional Chinese.
• Multi-tag categories: All / Tools / Food / Mystical / Equipment / Consumables / Misc.
• Related items stay together: colour variants and product lines are grouped in the grid (all four clusterberries in a row, all crispberries, all rope launchers, all packs, and so on) instead of being scattered by name.
• Favorites: right-click to toggle, heart marker, config persistence, favorites filter.
• Hide-unused toggle (default on): hides chess pieces, torn guidebook pages, _Prop/_TEMP/_UNUSED/_Hidden prefabs, and a short list of template/placeholder prefabs. Favorites are preserved when toggling.
• Two UI styles: HandDrawn (warm kraft paper, default) / Transparent.
• Single DLL: TinyPinyin and all 15 localization JSONs are bundled; only BepInEx is required.

Installation

• Install BepInExPack_PEAK.
• Put plugins/ItemSpawnerPremium.dll into BepInEx/plugins.
• Launch the game and press F5.

Configuration

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

| Section | Key | Default | Description |

| --- | --- | --- | --- |

| General | ToggleKey | F5 | Key to open/close the spawn menu (UnityEngine.KeyCode). |

| General | Style | HandDrawn | UI style: HandDrawn / Transparent. |

| General | HideUnused | true | Hide decorative/unused items; set false to show everything. |

| Favorites | ItemNames | | Favorite prefab names (JSON array). |

Building

Prerequisites:.NET SDK (targets net472), and a PEAK install.

• Point GameDir at your PEAK root (the folder containing BepInEx and PEAK_Data) — either pass

-p:GameDir="X:\path\to\PEAK", set a GameDir environment variable, or edit the default in

Directory.Build.props. The build fails fast with a clear message if the path is wrong.

• Run dotnet build ItemSpawnerEnhancement.csproj -c Release.
• Output: bin/Release/ItemSpawnerPremium.dll (Debug goes to bin/Debug, so the two never overwrite each other).

Releasing

pack.ps1 assembles dist/ItemSpawnerPremium/ from a clean Release build. It refuses to run unless the

git working tree is clean and all four version strings agree (csproj, Plugin.cs, package/manifest.json,

CHANGELOG.md), it runs the unit tests, and it verifies the ItemCatalog.cs invariants via

verify_catalog.py. Zipping is opt-in (-Pack). See the comment header in pack.ps1 for the full

release order.

Tests

tests/ItemSpawnerPremium.Tests is a net8.0 NUnit project with no Unity or BepInEx dependency: it

source-links only the pure-logic files (SearchText.cs, SearchRanking.cs, ItemCatalog*.cs,

FavoriteCodec.cs, Localization/Loc.cs, Localization/LocalizationCatalog.cs, TinyPinyin/*) and

embeds the 15 language JSONs under the same resource names the shipped DLL uses, so the real marker

pars …