CreatureKit

CreatureKit v2. 0. 0

Description

CreatureKit is a standalone enemy creation framework for Casualties Unknown, built on BepInEx and CUCoreLib. It turns the complex process of assembling a custom creature into a simple configuration object. Just define your enemy's stats and appearance, call one registration method, and CreatureKit handles the rest.

CreatureKit 是一个为《Casualties Unknown》设计的独立敌人创建框架，基于 BepInEx 和 CUCoreLib 构建。它将组装自定义生物的复杂过程简化为一个配置对象。只需定义你的敌人属性和外观，调用一个注册方法，其余全部由 CreatureKit 处理。

The mod ships with three built‑in AI types—SpiderHandler, SpiderHandlerTBE, and CrystalEnemy—covering the most common vanilla behaviours. If you need completely custom logic, the `ConfigurePrefab` callback lets you attach your own MonoBehaviour scripts without touching the API source.

本 Mod 内置三种 AI 类型——SpiderHandler、SpiderHandlerTBE 和 CrystalEnemy——覆盖了最常见的原版行为。如果你需要完全自定义逻辑，`ConfigurePrefab` 回调允许你挂载自己的 MonoBehaviour 脚本，而无需修改 API 源码。

All registered creatures are automatically compatible with the vanilla `spawn` command (with Tab autocomplete), so players can test and use them immediately.

所有注册的生物都自动兼容原版的 `spawn` 命令（并支持 Tab 补全），玩家可以立即测试和使用它们。

Full documentation and tutorials are included in the download archive.

下载压缩包中包含完整文档、教程。

Installation instructions

1. Install BepInEx 5.x for Casualties Unknown (if not already present).

安装适用于《Casualties Unknown》的 BepInEx 5.x（如果尚未安装）。

2. Install CUCoreLib (hard dependency) and place it in `BepInEx/plugins/CUCoreLib/`.

安装 CUCoreLib（硬依赖）并放入 `BepInEx/plugins/CUCoreLib/` 文件夹。

3. Download and extract this archive.

4. Copy `CreatureKit.dll` into your `BepInEx/plugins/CreatureKit/` folder.

将 `CreatureKit.dll` 复制到你的 `BepInEx/plugins/CreatureKit/` 文件夹。

5. Reference `CreatureKit.dll` in your own mod project and declare hard dependencies on `net.cucorelib` and `com.cixin.creaturekit`.

在你的 Mod 项目中引用 `CreatureKit.dll`，并声明对 `net.cucorelib` 和 `com.cixin.creaturekit` 的硬依赖。

6. Check the included TXT documentation for a step‑by‑step guide and example code.

查看附带的 TXT 文档以获取分步指南和示例代码。

Main features

- Three built‑in AI types – SpiderHandler (standard shadecrawler), SpiderHandlerTBE (Thornback Elder), and CrystalEnemy (laser‑dash enemy).

三种内置 AI 类型 – SpiderHandler（标准暗影爬行者）、SpiderHandlerTBE（棘背兽）和 CrystalEnemy（水晶冲刺敌人）。

- Full customisation – Health, damage, perception, speed, leg appearance, collider shape, loot tables, sounds, and more.

全面自定义 – 生命值、伤害、感知、速度、腿部外观、碰撞体形状、掉落表、音效等。

- Custom AI support – Attach your own scripts via the `ConfigurePrefab` callback; disable or extend the built‑in AI as needed.

自定义 AI 支持 – 通过 `ConfigurePrefab` 回调挂载你自己的脚本；根据需要禁用或扩展内置 AI。

- Vanilla spawn integration – Your creatures work with the game's own `spawn` command and appear in its Tab‑completion list.

原版生成命令集成 – 你的生物可与游戏自带的 `spawn` 命令配合使用，并出现在 Tab 补全列表中。

- Multiplayer ready – Automatic sync across all clients when CUCoreLib and KrokMP are installed.

多人游戏就绪 – 当安装 CUCoreLib 和 KrokMP 时，自动在所有客户端间同步。

- Performance optimised – Spider enemies can automatically freeze physics and IK when far away or during time acceleration.

性能优化 – 蜘蛛敌人在远离玩家或游戏加速时可自动冻结物理和 IK。

- Attack animation scaling – Easily adjust the size of claw attack effects with `ClawAnimScale`.

攻击动画缩放 – 使用 `ClawAnimScale` 轻松调整爪击动画的大小。

- Asset loading via CUCoreLib – Use CCL's `AssetLoader` for embedded sprites; `TextureHelper` is provided for custom leg materials.

通过 CUCoreLib 加载资源 – 使用 CCL 的 `AssetLoader` 加载嵌入式精灵；提供 `TextureHelper` 用于自定义腿部材质。

Requirements

- Casualties Unknown (Playtest / Demo)

- BepInEx 5.x

- CUCoreLib v1. 0. 3 or newer

- (Optional) KrokoshaCasualtiesMP for multiplayer

- The BepInEx team for the powerful plugin framework.

感谢 BepInEx 团队提供强大的插件框架。

- The CUCoreLib project for inspiration on clean API design and solid multiplayer backbone.

感谢 CUCoreLib 项目提供清晰的 API 设计灵感和坚实的多人游戏基础。

- The modding community for constant feedback and testing.

感谢 Mod 社区不断的反馈和测试。