GlymeraCaptureCrate

GlymeraCaptureCrate

扩展Hytale原生捕获箱:可捕获451种生物角色,并在之后释放出完全相同的复制体。箱内精确保留外观变体、可见装备、物品栏及生命值。一次性使用。

生活质量

GlymeraCaptureCrate - 一款能记住内容的捕获笼

扩展 Hytale 原生的捕获笼:可捕获 451 种生物角色,并在之后释放出完全相同的复制品。外观变体、可见装备、物品栏和生命值都会被保存在笼内。一次性使用。

当前版本仅适用于 Hytale 稳定版 5! 不要错过我的其他精彩项目——请查看 GlymeraCraft 的主页 Discord: https://discord.gg/s5NRFWfxgy


什么是 GlymeraCaptureCrate?

Hytale 自带的捕获笼是一种有趣的农耕工具,但它只能捕捉约 32 种小型生物(大多是幼年动物和小型生物),而且释放后它们会变成全新的随机个体。GlymeraCaptureCrate 将其转变为一种通用捕获工具,能够保留你所捕获生物的身份。

捕获一个戴着僧侣帽、穿着女仆装的特定僵尸?几个月后释放它,它仍然穿着那顶僧侣帽和那件女仆装。捕获一个手持武器的 Trork 战士?释放它时,它仍然手持那把特定的武器。笼子本身携带数据,因此被捕获的生物在服务器重启、登出、交易和存放在箱子中后依然保持不变。


工作原理

合成(与之前相同的合成台)

农耕台 的“农耕”分类下合成:

  • 4x 木材
  • 15x 生命精华

(Hytale 原始配方需要 50 个生命精华 - 由于笼子现在在释放时被消耗,我们降低了插件的成本。)

捕获

  1. 手持一个空的捕获笼。
  2. 右键点击你想要捕获的生物。
  3. 如果该角色受支持(所有 451 种活体角色均受支持),笼子会变为已填满状态并显示所捕获生物的图标。

当笼子已满时,被捕获生物的完整状态(生命值、外观变体、可见装备、物品栏、名牌)会以 BSON 元数据的形式存储在该物品本身中。

释放

  1. 手持一个已满的捕获笼。
  2. 右键点击地面。
  3. 生物会作为你所捕获个体的精确复制品生成。
  4. 笼子会被消耗。

哪些内容会被保留

数据 是否保留?
生物角色(僵尸、Kweebec_Sapling、Hatworm 等)
外观变体(毛色、服装、帽子、珠宝等)
可见装备(手持武器、护甲附件)
物品栏(快捷栏)
名牌文本(自定义名称)
当前生命值 已捕获,但 Hytale 在大多数情况下释放时会重新随机生成

对于具有丰富外观系统的生物(僵尸有 1824 种组合,Kweebec_Sapling 有 4992 种,Hatworm 有 9 种不同的帽子,骆驼有 6 种毛色等),每个被捕获的个体释放后都会与你捕获时一模一样。


命令

命令 权限 描述
/gcc 所有人 显示可用的子命令
/gcc info 所有人 显示手中捕获笼的详细信息(生物、外观、装备)
/gcc give 仅 OP 给自己一个空的捕获笼

手持已满的捕获笼时使用 /gcc info 可以查看其中存储的确切内容 - 这在决定何时释放或交易一个特别好的捕获品时很有用。


配置

文件:plugins/GlymeraCaptureCrate/config.json(首次启动时创建)

设置项 默认值 描述
craftingEnabled true 非 OP 玩家是否可以通过配方合成捕获笼。设为 false 可在服务器范围内禁用配方;OP 仍然可以使用 /gcc give

持久性

被捕获的状态以 BSON 元数据的形式存在于物品本身,而不是存放在单独的插件数据库中。这意味着:

  • 服务器重启: 已满的笼子会保留其内容。
  • 玩家登出 / 重新登录: 物品栏与物品一起被序列化,元数据保持不变。
  • 交易 / 给予其他玩家: 物品会随自身携带数据。
  • 存放在箱子中: 正常工作。一个装满被捕获生物的箱子就是一个可用的生物库。
  • 堆叠性: 已满的笼子具有独特的内容,无法堆叠;空笼子可以堆叠(Hytale 标准行为)。

功能特色

  • 所有 451 种生物角色均可捕获 - 家畜、野兽、智能 NPC、亡灵、骷髅、傀儡、Boss
  • 外观变体保留,通过 Hytale 的 PersistentModel.ModelReference 实现(稳定可靠,使用引擎自身的 RandomAttachment ID)
  • 基于 UUID 的释放追踪 - 插件通过实体 UUID 识别新生成的 NPC,因此在有许多同角色生物拥挤的区域也不会混淆
  • 基于重试的释放 - 多次短重试(50、150、350、700 毫秒),以处理原生捕获交互产生的生成时间差异
  • 逐物品元数据存储 - 无需插件数据库,物品能存活多久,数据就能存活多久
  • 配方开关,通过配置实现,适用于希望通过 /gcc give 单独控制获取途径的服务器
  • 合成成本降低,从 50 个生命精华减少到 15 个(笼子现在在释放时被消耗,不同于原生的多次使用行为)

安装

  1. GlymeraCaptureCrate-1.0.0.jar 放入服务器的 mods/ 文件夹。
  2. 启动(或重启)服务器。
  3. 所有内容都嵌入在 JAR 文件中 - 无需外部资源文件夹。

须知

  • Hytale 原始的捕获笼是可多次使用的(你可以释放后重新填充)。本插件使笼子变为一次性使用(释放时被消耗),这就是合成成本更低的原因。
  • 本插件覆盖了 Hytale 原生的捕获笼物品和 NPC 组 - 并非添加新物品。安装后,世界中已有的捕获笼可与插件正常工作。
  • 如果 craftingEnabledfalse,任何合成捕获笼的尝试都会被取消。OP 仍然可以通过 /gcc give 获得笼子。
  • 释放时的生命值通常会恢复到满值,因为原生释放流程会在插件应用后重新随机生成属性。外观和装备的保留是可靠的。

由 Glymera 为 Hytale 社区精心制作