Roost Easy 鸡 [Roost 终极扩展]

Roost Easy 鸡 [Roost 终极扩展]

通过游戏内GUI创建和管理自定义Roost Ultimate资源鸡。支持Roost 4.1.x和4.2.x/CRLib。

Roost Easy Chickens

GITHUB

无需手动维护成堆的 JSON、模型、语言文件、标签和配方,即可创建自定义 Roost Ultimate 鸡。

Roost Easy Chickens 为整合包作者增加了游戏内编辑器和简单的配置层。定义鸡的产出物、等级、亲本、配种时间和外观;REC 会自动生成运行所需的 Roost 配置/资源和 KubeJS 集成。

功能特性

  • 游戏内鸡编辑器 /rec editor
  • 创建、编辑、禁用和删除自定义鸡
  • 产出物品 + 产出数量
  • 配种亲本
  • 复制配种
  • 可配置的配种/复制/Roost 时间
  • 可配置的种子等级
  • 可复用任何已有的 Roost 鸡纹理
  • 可选的自定义物品/生物 PNG 纹理
  • 自动为已连接客户端同步配置和纹理
  • 自动生成模型、语言条目和标签
  • 自动生成 KubeJS Roost 配方
  • 对产出 ID、亲本、模板和纹理进行验证
  • 对拼写错误的 ID 提供有用的建议
  • /rec list、/rec info、/rec validate、/rec reload、/rec give

兼容性

Minecraft: 1.21.1 加载器: NeoForge 21.1.x+ Roost Ultimate: 4.1.x 和 4.2.x KubeJS: 必需

REC 自动支持两种 Roost 内容布局:

  • Roost Ultimate 4.1.x: 旧版 config/roostultimate/chicken_config_v*.json
  • Roost Ultimate 4.2.x: CRLib crlib/chicken_config_v*.json

使用 Roost Ultimate 4.2.x 时,CRLib 已是 Roost 的依赖,REC 会自动将资源写入 CRLib 资源区域。

快速开始

  1. 在客户端和服务器上都安装 Roost Ultimate、KubeJS 和 Roost Easy Chickens。
  2. 启动游戏/服务器一次。
  3. 以管理员身份运行 /rec editor。
  4. 创建你的鸡并保存。
  5. 已连接的客户端会自动收到更新后的 REC 配置和自定义纹理。
  6. 当编辑器提示需要注册表级更改时,请重启客户端和服务器。

REC 的源配置文件位于:

config/roost_easy_chickens/chickens.json

大多数用户无需手动编辑它。

同步机制

REC 会自动将其鸡配置和自定义纹理与当前连接到服务器的客户端同步。

这意味着通过游戏内编辑器创建或编辑的鸡可以分发给已连接的玩家,而无需手动将 REC 配置文件或纹理复制到每个客户端。

当有玩家在线时创建新鸡,REC 会将更新后的配置发送给这些客户端。在所需的重启之后,双方即可注册该新鸡。

如果某个客户端离线期间添加了全新的鸡,该客户端在下次完整启动游戏前可能仍需要更新后的配置,因为新的 Roost 鸡类型是在 Minecraft 初始化期间注册的。

创建一只鸡

使用以下命令打开编辑器:

/rec editor

在编辑器中你可以配置:

  • 鸡的名称
  • 鸡的 ID
  • 等级
  • 产出物品
  • 产出数量
  • 配种亲本
  • 配种时间
  • 配种种子等级
  • 复制配种
  • 复制时间
  • 复制种子等级
  • Roost 产蛋时间
  • Roost 种子等级
  • 已有的鸡纹理模板
  • 自定义物品纹理
  • 自定义生物纹理

REC 会自动处理生成的 Roost 配置、模型、语言条目、标签和配方。

自定义纹理

你可以复用已有 Roost 鸡的外观,或者提供自己的纹理。

自定义纹理可以通过 REC 编辑器进行管理。

推荐的纹理尺寸:

Item texture: 16x16 PNG
Mob texture:  64x32 PNG

REC 会自动将自定义纹理与已连接的客户端同步。

命令

/rec editor
/rec list
/rec info <id>
/rec validate
/rec reload
/rec give <id>

/rec editor

打开游戏内的鸡编辑器。

/rec list

列出所有由 REC 管理的鸡。

/rec info <id>

显示某只受管理鸡的配置信息。

/rec validate

检查当前配置是否存在问题,例如:

  • 无效的产出物品 ID
  • 缺少亲本
  • 无效的纹理模板
  • 缺少自定义纹理
  • 重复的 ID
  • 无效的等级或数值

REC 也可能对拼写错误的 ID 提供建议。

/rec reload

重新生成无需重启游戏即可更新的配方级配置。

/rec give <id>

将选定的自定义鸡给予命令使用者。

重启要求

新的鸡类型由 Roost 在 Minecraft 启动期间注册。

因此,以下更改需要客户端 + 服务器重启:

  • 添加新鸡
  • 移除鸡
  • 注册表级的鸡更改

仅配方级的更改通常可以使用以下命令应用:

/rec reload

编辑器会在需要重启时发出警告。

推荐工作流程

为了获得最流畅的多人生存流程:

  1. 让玩家连接到服务器。
  2. 打开 /rec editor。
  3. 创建或编辑你的鸡。
  4. 保存配置。
  5. 允许 REC 同步配置和纹理。
  6. 如有提示,重启服务器和客户端。
  7. 继续游戏,使用新的鸡。

面向整合包作者

REC 的设计目标是让自定义 Roost Ultimate 进度线的维护变得简单得多。

无需手动管理:

chicken_config_v*.json
models/item/
textures/
lang/
tags/
breeding recipes
copy recipes
roost output recipes

你只需通过一个 REC 配置或直接在游戏内编辑器中即可管理自定义鸡。

主配置文件位于:

config/roost_easy_chickens/chickens.json

需求

  • Minecraft 1.21.1
  • NeoForge 21.1.x+
  • Roost Ultimate 4.1.x 或 4.2.x
  • KubeJS

对于 Roost Ultimate 4.2.x 的安装,CRLib 已由 Roost Ultimate 引入为必要依赖。

注意事项

  • 在客户端和服务器上都安装 REC。
  • 需要 KubeJS。
  • 需要 Roost Ultimate。
  • 新增注册表级别的鸡类型需要重启。
  • 已连接的客户端会自动收到 REC 配置和纹理同步。
  • REC 同时支持旧版 Roost 4.1.x 配置布局和较新的 Roost 4.2.x CRLib 布局。

Roost Easy Chickens 是 Roost Ultimate 的非官方附属模组。


鸣谢: Roost Ultimate 模组: Tarantei