ItemSpawnerEnhanced

A client-side item spawner for PEAK built for players across every supported game language, with localized smart search, spectator-aware targeting, and support for spawning items for any connected Scout.

Favorites	Combined tag filtering

English (pack)	简体中文拼音首字母 (bb)

日本語 (パック)	Русский (ранец)

Português (BR) (mochila)	Español (España) (mochila)

Features

Core features

• Responsive item browser: Press F5 or hold View/Share and press RT/R2 to open a clean interface with larger text and controls.
• Full controller support: Navigate targets, filters, and items with a gamepad, with persistent focus, automatic scrolling, controller favorites, and accessible focus visuals.
• Smart targeting: Spawn for yourself while alive or automatically target the Scout you are spectating after death.
• Any Scout: Select any available Scout in the room from the target dropdown.
• Modded item support: Discover items registered in PEAK's item database, including items added by other mods.
• Tag filtering: Filter by Food, Consumables, Equipment, Deployables, Mystical, Other, or Favorites. Tags are single-select by default, with optional multi-select AND/OR matching.
• Curated catalog: Hide known unused and internal duplicate prefabs by default, with an option to reveal every registered item.
• Persistent favorites: Right-click an item to favorite it, mark its tile with a heart, and filter favorites like any other tag.
• Fully localized UI: Use interface text for every language currently supported by PEAK.
• Native multiplayer spawning: Spawn through PEAK's built-in network RPC; click for one item or hold the left mouse button to keep spawning.

Search available in every language

• Multiple name sources: Search by the current-language name, English name, internal/prefab name, or unlocalized source name.
• Flexible matching: Find results by exact match, prefix, word prefix, or substring.
• Typo tolerance: Find longer queries even with a small typing mistake.
• Relevant ranking: See matches for the displayed name ahead of fallback aliases.

Language-specific search

Why ItemSpawnerEnhanced?

The comparison below uses quackandcheese-ItemSpawner 0.1.4 as the baseline.

Language Search Extensions

Language mod authors are welcome to add transliterations and other language-specific search aliases. A provider can be submitted to the ItemSpawnerEnhanced repository or distributed as a standalone companion mod. See the language search extension guide for both workflows and a TinyPinyin-based example.

Installation

Install ItemSpawnerEnhanced with a mod manager. For a manual installation:

1. Install BepInExPack_PEAK.
2. Extract the package and copy plugins/ItemSpawnerEnhanced into <PEAK>/BepInEx/plugins/.

The installed files should be:

<PEAK>/BepInEx/plugins/ItemSpawnerEnhanced/ItemSpawnerEnhanced.dll
<PEAK>/BepInEx/plugins/ItemSpawnerEnhanced/ItemSpawnerEnhanced.ChineseSearch.dll

Usage

Press F5, or hold View/Share and press RT/R2, to open the item spawner.

• Click an item to spawn it, or hold the left mouse button to spawn repeatedly.
• Right-click an item to favorite or unfavorite it.
• Keyboard opening focuses search; controller opening focuses the first visible item.

Controller controls

Search entry is currently a mouse-and-keyboard workflow.

Configuration

Settings are stored in BepInEx/config/com.github.lllei.ItemSpawnerEnhanced.cfg.

Controller bindings use Unity Input System paths. Set the modifier to empty or None for a single-button shortcut; set the toggle path to empty or None to disable controller opening. Favorites are managed by the UI and saved automatically in the same configuration file.

See the item tag and catalog visibility reference for classification rules and the complete default-hidden list.

Multiplayer behavior

PEAK's built-in spawn RPC is used. A client with this mod can request an item for any connected Scout available to the game, and the room's master client performs the spawn. This is intentionally unrestricted and is not a host-enforced permission system. Click an item once to create one, or hold the left mouse button on its tile to spawn repeatedly.

Building

Copy PeakGameDir.props.example to PeakGameDir.props, set the PEAK path, then run:

dotnet test .\tests\ItemSpawnerEnhanced.Core.Tests\ItemSpawnerEnhanced.Core.Tests.csproj -c Release
dotnet test .\tests\ItemSpawnerEnhanced.ChineseSearch.Tests\ItemSpawnerEnhanced.ChineseSearch.Tests.csproj -c Release
dotnet build .\src\ItemSpawnerEnhanced.ChineseSearch\ItemSpawnerEnhanced.ChineseSearch.csproj -c Release
powershell -NoProfile -ExecutionPolicy Bypass -File .\build\Deploy.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\build\Package.ps1

Optimize a 16:10 screenshot for the README with:

powershell -NoProfile -ExecutionPolicy Bypass -File .\build\Optimize-Screenshot.ps1 -InputPath .\screenshot.jpg -OutputPath .\docs\media\search-en-pack.webp

Acknowledgements

Special thanks to my friend 「饺子」 for drawing the mod icon, and to the PEAK Wiki community for documenting the game's items and mechanics.

Changelog

1.3.0 - 2026-08-28

• Added configurable controller opening with View/Share + RT/R2 by default.
• Added full controller navigation for targets, tag filters, clearing filters, and the item grid, including focus restoration and automatic scrolling.
• Added controller spawning, hold-to-repeat spawning, favorites, fast region switching, and anchored full-name tooltips.
• Added independent high-contrast focus visuals for inactive and active tags, target options, disabled item tiles, and action buttons.

1.2.1 - 2026-08-19

• Kept favorited default-hidden prefabs visible when ShowAllItems is disabled.

1.2.0 - 2026-08-18

• Added continuous item spawning while the left mouse button is held on an item tile.
• Added a default-on SingleTagSelection option that replaces the selected tag when another tag is chosen.
• Preloaded the item catalog, search index, and browser UI in the background to reduce the delay when opening the item spawner for the first time.
• Made reviewed vanilla tag mappings use exact prefab names, fixing missing Consumable tags for Anti-Zooka, The Book of Bones, and Ritual Dagger.
• Changed toggle-key handling to support direct key capture and immediate runtime rebinding through PEAKLib ModConfig without restarting the game.

1.1.0 - 2026-08-17

• Added localized multi-select tags for Food, Consumables, Equipment, Deployables, Mystical items, Other items, and Favorites.
• Added configurable AND/OR tag matching, defaulting to AND.
• Added persistent right-click favorites with heart markers on item tiles.
• Added one-click controls for clearing the search query or all selected tags.
• Rounded the window, controls, tag buttons, item tiles, and tooltips.
• Updated the package icon.
• Fixed food detection for items such as Coconut Half and made Food mutually exclusive with Consumables.
• Corrected the Food, Consumable, Equipment, and Other assignments for several vanilla items.
• Hid known unused, test, cheat, scene-prop, and internal duplicate item prefabs from the catalog.
• Added a ShowAllItems catalog option for revealing every registered item prefab.
• Improved UI lifecycle cleanup and reorganized browser, layout, control, and runtime-asset responsibilities.

1.0.1 - 2026-08-17

• Added hover tooltips that show complete localized item names.
• Expanded the README gallery with optimized WebP screenshots for six languages.
• Clarified manual installation and language search extension documentation.

1.0.0 - 2026-08-16

• Runtime-built item spawner UI with a larger centered search field.
• Smart spectator targeting and an explicit player target dropdown.
• Current-language item names with English and internal-name fallbacks.
• Ranked Unicode search with substring and bounded typo matching.
• Simplified and Traditional Chinese pinyin and initial matching.
• Public search alias provider API for language extension mods.
• UI translations for all 15 languages currently supported by PEAK.