Item Spawner / 物品生成器

A compact in-game item spawning panel for Casualties Unknown Demo. 一个用于 Casualties Unknown Demo 的游戏内物品生成面板。

Warning

本插件只在 Casualties Unknown Demo V6.1 上测试过，其他游戏版本的兼容性未知。 This plugin has only been tested on Casualties Unknown Demo V6.1. Compatibility with other game versions is unknown.

目录 / Contents

• 简介 / Overview
• 功能 / Features
• 安装 / Install
• 编译方法 / Compile Method
• 配置 / Configuration
• 作者 / Author
• 许可证 / License

简介 / Overview

物品生成器是 Casualties Unknown Demo V6.1 的 BepInEx 插件，用于在游戏内搜索、筛选并生成已注册物品。它面向本地调试、测试和单机 Mod 使用，不包含网络访问或外部进程调用。

Item Spawner is a BepInEx plugin tested on Casualties Unknown Demo V6.1. It lets you search, filter, and spawn registered in-game items from an in-game panel. It is intended for local testing, debugging, and single-player mod use, with no network access or external process execution.

功能 / Features

功能	Features
按名称或物品 ID 搜索并生成物品。	Search and spawn items by name or item ID.
支持全部、收藏和分类筛选。	Filter by all items, favorites, or item categories.
收藏会持久保存，重启游戏后仍然保留。	Favorites are persisted after restarting the game.	-
UI 支持中文和 English，并可跟随游戏语言。（部分文字需要重启）	The UI supports ZH and English, with an auto language mode. (Need restart game)	-
面板支持拖动、缩放、复古像素边框和半透明背景。	The panel supports dragging, scaling, retro pixel borders, and translucent backgrounds.
可开启穿透模式，让面板打开时仍可操控角色。	Passthrough mode can keep player controls active while the panel is open.	-
鼠标悬停在物品图标上时，复用游戏原生物品详情弹窗。	Hovering item icons reuses the game's native item tooltip.

安装 / Install

1. 先为游戏安装 BepInEx。 / Install BepInEx for the game first.
2. 将 ItemSpawner.build.dll 放到以下位置。 / Copy ItemSpawner.build.dll to:

BepInEx/plugins/ItemSpawner/ItemSpawner.build.dll

3. 启动游戏。 / Launch the game.
4. 默认按 左Control + I 打开或关闭面板。 / Press LeftControl + I by default to open or close the panel.

编译方法 / Compile Method

普通玩家不需要自己编译，直接下载发布页中的 ItemSpawner.build.dll 并按安装步骤放入游戏目录即可。

Regular players do not need to compile the plugin. Download ItemSpawner.build.dll from the release page and install it as described above.

如果你需要从源码手动编译，请准备：

If you need to compile from source manually, prepare:

• 已安装 BepInEx 的 Casualties Unknown Demo V6.1 游戏目录。 / A Casualties Unknown Demo V6.1 game folder with BepInEx installed.
• .NET SDK。 / .NET SDK.
• 本仓库源码。 / This repository's source code.

手动编译方式：

Manual compile method:

dotnet build ItemSpawner.csproj -c Release

编译完成后，在输出目录中找到生成的 DLL，并手动复制到：

After compilation, find the generated DLL in the output directory and manually copy it to:

BepInEx/plugins/ItemSpawner/ItemSpawner.build.dll

如果输出文件名不是 ItemSpawner.build.dll，可以将生成的 ItemSpawner.dll 重命名为 ItemSpawner.build.dll 后再放入上面的目录。

If the output file is not named ItemSpawner.build.dll, rename the generated ItemSpawner.dll to ItemSpawner.build.dll before placing it in the directory above.

如果游戏正在运行，Windows 可能会锁定已部署的 DLL。请关闭游戏后再替换文件。

If the game is running, Windows may lock the deployed DLL. Close the game before replacing the file.

配置 / Configuration

BepInEx 会把配置写入：

BepInEx writes the config to:

BepInEx/config/casualtiesunknown.item-spawner.cfg

配置项 / Setting	说明 / Description
Hotkey/ToggleShortcut	打开或关闭面板。 / Opens or closes the panel.
Favorites/FavoriteItemIds	已收藏物品 ID。 / Persisted favorite item IDs.
UI/Language	Auto、ZhHans 或 English。 / Auto, ZhHans, or English.
UI/MousePassthrough	面板打开时是否允许继续操控角色。 / Whether player controls keep working while the panel is open.
Layout/PanelScale	面板缩放比例。 / Panel scale multiplier.

作者 / Author

Aakber (小叶子)

许可证 / License

MIT。详见 LICENSE。

MIT. See LICENSE.

本项目不包含游戏资源、游戏程序集、BepInEx、Harmony、Unity 程序集或 TextMeshPro 程序集；这些仅作为本地构建和运行依赖。

This project does not include game assets, game assemblies, BepInEx, Harmony, Unity assemblies, or TextMeshPro assemblies. Those are external dependencies required only for local build and runtime.