Getting Started zh

快速开始

English

本指南将帮助你在 7 步内创建你的第一个 CuBlocky 模组。

---

环境要求

在开始之前，请确保你已安装以下软件：

软件	说明	下载链接
Casualties Unknown	游戏本体（Steam 安装）	Steam 商店
CUCoreLib (CCL)	模组依赖库	安装指南
.NET 9 运行时	编译模组 DLL 所需	下载
CuBlocky	本编辑器	下载 v0.1.3

注意： 如果你只想运行 CuBlocky 而不打算从源码编译，只需要安装 .NET 9 运行时，不需要 .NET 9 SDK。

---

第一步：启动 CuBlocky

1. 解压下载的 CuBlocky zip 文件到任意目录
2. 双击运行 CuBlocky.Server.exe
3. 浏览器会自动打开 http://localhost:5099

如果没有自动打开浏览器，请手动在浏览器中输入上述地址。

提示： 首次启动可能需要几秒钟，请耐心等待。

---

第二步：创建新项目

1. 在欢迎页面点击 "新建项目" 按钮
2. 填写项目信息：
   • 项目名称： 你的模组名称（如 MyFirstMod）
   • 模组 GUID： 唯一标识符，使用反向域名格式（如 com.yourname.myfirstmod）
   • 版本号： 语义化版本（如 1.0.0）
   • 描述： 简要说明模组功能（可选）
   • C# 命名空间： 自动生成，通常不需要修改
3. 点击 "创建" 按钮

重要： 模组 GUID 必须全局唯一，建议使用 com.你的名字.模组名 的格式。

---

第三步：添加物品

1. 在左侧积木编辑器中，找到 注册 分类（粉色）
2. 从积木库中拖拽 "注册物品" 积木到工作区
3. 配置物品属性：
   • ID： 物品标识符，使用下划线分隔（如 my_sword）
   • 显示名称： 物品在游戏中的显示名称
   • 描述： 物品描述文本
   • 分类： 选择物品类型（weapon、tool、medical、food、material、armor、container、misc）
   • 重量： 物品重量（浮点数）
   • 价值： 物品价值（整数）
   • 腐烂时间： 物品腐烂时间（分钟，0 表示不腐烂）
   • 精灵图： 可选，上传自定义图片

提示： 物品 ID 必须在你的模组内唯一，建议使用小写字母和下划线。

---

第四步：添加属性（可选）

为物品添加特殊属性，让物品更加丰富：

工具属性

设置工具属性:
  伤害: 25          # 攻击伤害值
  结构伤害: 10      # 对建筑物的伤害
  距离: 1.5         # 攻击距离
  击退: 0.5         # 击退力度
  冷却: 0.8         # 攻击冷却时间（秒）
  体力消耗: 5       # 每次攻击消耗的体力
  穿透: 0           # 穿透护甲值

可穿戴属性

设置可穿戴属性:
  穿戴部位: Torso   # 穿戴位置（Head/Torso/LeftArm/RightArm/LeftLeg/RightLeg）
  插槽ID: 1         # 装备插槽
  护甲: 10          # 护甲值
  隔离: 0           # 环境隔离度
  耐久损失倍率: 1.0 # 耐久消耗倍率

容器属性

设置容器属性:
  容量: 20          # 容器容量（格子数）
  单物品最大重量: 5 # 单个物品最大重量
  减重: 0.5         # 重量减轻比例
  物品可见: true    # 物品是否在地面可见
  标签限制: ""      # 限制可存放的物品标签

---

第五步：添加配方（可选）

让玩家可以通过合成获得你的物品：

配方注册:
  材料: [列表]
    - 铁锭 ×3
    - 木头 ×1
    - 绳子 ×2
  产出: [物品]
    - my_sword ×1
  耐久: 1.0         # 产出物品的耐久度（0~1）
  修理: false       # 是否为修理配方

提示： 材料中的物品 ID 必须是游戏中已存在的物品（原版或你注册的物品）。

---

第六步：构建模组

1. 点击工具栏的 "构建" 按钮（绿色播放图标）
2. 等待编译完成（通常需要 5-15 秒）
3. 如果构建成功，会显示 DLL 文件路径
4. 如果构建失败，检查错误信息并修正

构建产物位置：

CuBlocky/builds/MyFirstMod/bin/Release/net4.7.2/MyFirstMod.dll

---

第七步：安装模组

1. 将生成的 DLL 文件复制到游戏的 BepInEx 插件目录：

   Windows 默认路径：

   C:\Program Files (x86)\Steam\steamapps\common\Casualties Unknown Demo\BepInEx\plugins\
   

2. 重启游戏（如果游戏正在运行）

3. 进入游戏后，你的模组应该已经生效

验证方法： 如果你的模组包含新物品，在游戏中应该可以看到它们出现在物品生成列表中。

---

下一步

• 积木参考 — 了解所有可用积木及其参数
• API 参考 — 了解后端 API 端点和数据模型
• CCL 文档 — 了解 CUCoreLib 的高级功能

---

常见问题

Q: 构建时提示 "dotnet is not recognized"？

A: 请确保已安装 .NET 9 运行时，并重启了命令行终端。

Q: 模组安装后没有生效？

A: 检查以下几点：

• DLL 文件是否放在正确的 plugins 目录
• BepInEx 是否正确安装
• CUCoreLib 是否已安装
• 游戏是否重启

Q: 如何调试模组？

A: 查看 BepInEx 控制台输出，错误信息会显示在那里。你也可以在 CuBlocky 中使用 cu_talk 积木来输出调试信息。

Q: 可以同时运行多个模组吗？

A: 可以，只要它们的模组 GUID 不同。