UEI - Unknown Enough Items

A JEI-style item, liquid, and recipe helper for Casualties Unknown Demo. 一个用于 Casualties Unknown Demo 的 JEI 风格物品、液体与配方查询辅助插件。

Warning

UEI is currently an early WIP mod. It has only been tested in the local Casualties Unknown Demo v6.1 BepInEx environment used during development. Compatibility with other game versions is not guaranteed.

UEI 目前仍是早期开发版本，只在开发时使用的本地 Casualties Unknown Demo v6.1 BepInEx 环境中测试过。其他游戏版本的兼容性未知。

目录 / Contents

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

简介 / Overview

UEI, short for Unknown Enough Items, is a BepInEx plugin inspired by Minecraft JEI. It adds an in-game helper panel beside the original inventory/radial backpack UI, letting you browse items, liquids, and recipe relationships without replacing the game's native crafting system.

UEI 是 Unknown Enough Items 的缩写，设计灵感来自 Minecraft JEI。它会在原版物品栏 / 径向背包界面旁显示一个辅助面板，用于查询物品、液体和配方关系，但不会替代原版制作系统。

The mod reads runtime game data directly from:

本插件直接读取游戏运行时数据：

• Item.GlobalItems
• Liquids.Registry
• Recipes.recipes

It does not bundle game assets, game assemblies, BepInEx, Harmony, Unity assemblies, or TextMeshPro assemblies.

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

功能 / Features

功能	Feature
在原版右键背包界面旁显示 UEI 面板。	Shows the UEI panel beside the native right-click inventory UI.
列出全部运行时物品和液体。	Lists all runtime items and liquids.
支持搜索、分类筛选和收藏置顶。	Supports search, category filtering, and favorite pinning.
鼠标悬停复用游戏原生 tooltip 风格。	Reuses the game's native tooltip style on hover.
左键查看来源配方，右键查看用途配方。	Left-click opens source recipes, right-click opens usage recipes.
配方材料和结果可点击跳转。	Recipe ingredients and results can jump to related UEI entries.	-
泛材料会显示可用物品 / 液体候选列表。	Generic ingredients show matching item/liquid candidates.
可跳转到原版制作面板并选中对应配方。	Can jump to the original crafting panel and select the matching recipe.	-
适配多人联机模组 KrokMP。	Adapts to the KrokMP multiplayer mod.
支持中文和 English。	Supports Chinese and English.	-

安装 / Install

1. Install BepInEx for Casualties Unknown Demo.
2. Copy the compiled DLL to:

BepInEx/plugins/UEI/UEI.build.dll

3. Launch the game.
4. Open the native inventory/radial backpack UI. UEI appears beside it when the UI state is supported.

步骤：

1. 先为 Casualties Unknown Demo 安装 BepInEx。
2. 将编译好的 DLL 放到：

BepInEx/plugins/UEI/UEI.build.dll

3. 启动游戏。
4. 打开原版物品栏 / 径向背包界面；当界面状态支持时，UEI 会显示在旁边。

编译方法 / Compile Method

Regular players should use the release DLL once releases are published.

普通玩家后续可以直接下载 Release 页面中的 DLL，不需要自己编译。

If you need to compile from source manually, prepare:

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

• A local Casualties Unknown Demo game folder with BepInEx installed.
• .NET SDK.
• This repository's source code.

Release builds use the version declared in Plugin.cs/UEI.csproj. Update those files before creating a new release build.

Release 构建会使用 Plugin.cs/UEI.csproj 中声明的版本号。创建新版本前请先更新这些文件。

Recommended layout:

推荐目录结构：

Casualties Unknown Demo/
├─ BepInEx/
├─ CasualtiesUnknown_Data/
└─ Tools/
   └─ UEI/
      ├─ UEI.csproj
      └─ *.cs

Compile from Tools/UEI:

在 Tools/UEI 中编译：

cd "D:\SteamLibrary\steamapps\common\Casualties Unknown Demo\Tools\UEI"
dotnet build UEI.csproj -c Release

The project file references assemblies from the local game folder and writes the plugin DLL to:

项目文件会引用本地游戏目录中的程序集，并把插件 DLL 输出到：

BepInEx/plugins/UEI/UEI.build.dll

If the source folder is not placed under GameRoot/Tools/UEI, pass the game directory explicitly:

如果源码没有放在 游戏目录/Tools/UEI 下，请显式传入游戏目录：

dotnet build UEI.csproj -c Release /p:GameRoot="D:\SteamLibrary\steamapps\common\Casualties Unknown Demo"

The expected runtime file is:

BepInEx/plugins/UEI/UEI.build.dll

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

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

配置 / Configuration

BepInEx writes UEI configuration to:

BepInEx 会把 UEI 配置写入：

BepInEx/config/casualtiesunknown.uei.cfg

配置项 / Setting	说明 / Description
General/Language	auto、zh 或 en。 / auto, zh, or en.
General/PanelPosition	面板位置：left 或 right。 / Panel position: left or right.
General/PanelScale	面板比例，当前设置页会在 85%、100%、115%、130% 之间循环。 / Panel scale, currently cycles between 85%, 100%, 115%, and 130%.
Favorites/FavoriteEntries	收藏条目，格式为 item:<id> / liquid:<id>。 / Persisted favorite entries as item:<id> / liquid:<id>.
Cheat/Enabled	开关，默认关闭。 / give-item toggle, disabled by default.

使用说明 / Usage

• Open the game's native right-click inventory/radial backpack UI to show UEI.
• Type in the search box to filter entries.
• Use category arrows to switch between All, Favorites, item categories, and Liquid.
• Click the small star button on an entry to favorite it.
• Left-click an entry to view source recipes.
• Right-click an entry to view usage recipes.
• Use the recipe panel arrows to page through recipes.
• Click recipe materials/results to jump through the recipe chain.
• Use the jump button in the detail panel to open the original crafting panel.
• Use the gear button beside the search box to open UEI settings.

说明：

• 打开游戏原版右键物品栏 / 径向背包界面后，UEI 会自动显示。
• 在搜索框中输入关键词可筛选条目。
• 使用分类箭头切换 全部、收藏、物品分类和 液体。
• 点击条目角落的星标按钮可收藏。
• 左键条目查看来源配方。
• 右键条目查看用途配方。
• 使用配方面板箭头翻页。
• 点击配方材料 / 结果可在配方链中跳转。
• 点击详情页跳转按钮可打开原版制作面板并选中配方。
• 点击搜索框旁的齿轮按钮可打开 UEI 设置。

作者 / Author

Aakber (小叶子)

许可证 / License

This repository is licensed under the MIT License.

本仓库源码使用 MIT License 授权。

The license only covers UEI source code in this repository. It does not grant any rights to Casualties Unknown Demo, game assets, game assemblies, BepInEx, Harmony, Unity, TextMeshPro, or any other third-party dependency.

该许可证仅适用于本仓库中的 UEI 源码，不包含 Casualties Unknown Demo 游戏本体、游戏资源、游戏程序集、BepInEx、Harmony、Unity、TextMeshPro 或其他第三方依赖。