概览
LovelyLib 是 Lovely Robot 模组系列的专用机器人库层。它位于 HZLib 与三个 Lovely Robot 变体之间——处理仅与机器人同伴相关的通用功能,使 Legacy、Tribute 和 Reboot 能够共享同一基础而不必重复实现。
如果你要安装任何 Lovely Robot 模组,就需要这个。
提供内容
- 机器人类型系统 —
LovelyRobotType,具备可组合的功能(等级、战斗、保护、动画) - 动画配置文件系统 — 所有机器人类型共用的动画配置文件(待机、行走、休息、坐下、攻击),基于 HZLib 的配置文件基础设施构建
- 功能组合 —
LevelFeature、CombatLevelFeature、ProtectionFeature按机器人类型进行连接配置 - 机器人配置文件迁移 — 版本感知的 NBT 数据迁移,确保存档在更新后保持兼容
适用对象
这是一个库——它本身不执行任何操作。请将其与任意 Lovely Robot 变体一同安装。
需要:
- Lovely Robot: Legacy
- Lovely Robot: Tribute
- Lovely Robot: Reboot
还需要:
兼容性
| Minecraft | Fabric | Forge | NeoForge |
|---|---|---|---|
| 1.21.1 | ✅ | ✅ | ✅ |
链接
- 源码:GitHub — heria-zone
- 问题反馈:GitHub Issues
鸣谢
由 MSymbios / Heria Zone 开发。 最初灵感来源于 lilacx02 的 Lovely Robot 中的机器人同伴框架。
Overview
LovelyLib is the robot-specific library layer for the Lovely Robot mod family. It sits between HZLib and the three Lovely Robot variants — handling everything that is common to robot companions specifically, so that Legacy, Tribute, and Reboot all share the same foundation without duplicating it.
If you're installing any Lovely Robot mod, you need this.
What It Provides
- Robot type system —
LovelyRobotTypewith composable features (levelling, combat, protection, animation) - Animation Profile System — shared animation profile for all robot types (idle, walk, rest, sit, attack), built on HZLib's profile infrastructure
- Feature composition —
LevelFeature,CombatLevelFeature,ProtectionFeaturewired together per robot type - Robot profile migration — version-aware NBT data migration so saves stay compatible across updates
Who Needs This
This is a library — it does nothing on its own. Install it alongside any Lovely Robot variant.
Required by:
- Lovely Robot: Legacy
- Lovely Robot: Tribute
- Lovely Robot: Reboot
Also requires:
Compatibility
| Minecraft | Fabric | Forge | NeoForge |
|---|---|---|---|
| 1.21.1 | ✅ | ✅ | ✅ |
Links
- Source: GitHub — heria-zone
- Issues: GitHub Issues
Credits
Developed by MSymbios / Heria Zone. Originally inspired by the robot companion framework from lilacx02's Lovely Robot.
下载 LovelyLib
下载 LovelyLib
下载 LovelyLib
下载 LovelyLib
1.0.0 — 2026-07-04
Minecraft 1.21.1
⚠️ 破坏性变更。 ADR_018 生态系统术语重命名涉及多个类的重命名。任何基于 0.1.0-alpha 构建的模组都必须更新其导入语句。详见下文。
首次稳定版本。引入了完整的 NBT 数据管道、全套 AI 目标集、存档迁移链、具有独立动画配置文件的 Tribute 变体、配置驱动的统计系统,以及修复了缺失连接线的动画功能——该功能为所有机器人激活了配置文件感知的动画路径。
破坏性变更:类重命名 (ADR_018)
| 旧名称 | 新名称 |
|---|---|
LovelyRobotType |
RobotFamilyRegistry |
NativeEntityType (lovelylib) |
RobotFamily |
LegacyRobotType |
LegacyRobotFamilies |
TributeRobotType |
TributeRobotFamilies |
EntityVariant |
RobotVariant |
InternalAnimation (lovelylib loaders) |
RobotAnimation |
这些重命名与 HZLib 1.0.0 中确立的“家族 / 变体 / 外观”三级词汇表保持一致。Robot* = LovelyLib 层级。*Families = 注册表/集合类。*Family = 单个家族描述符。
NBT 数据管道
机器人实体数据现在完全通过 HZLib EntityDataSchema / DataField<T> 管道进行管理。所有机器人的 NBT 字段均在 RobotFields 中声明——这是唯一的数据源。调用站点不再出现字符串字面量。
RobotFields — 类型化字段句柄:
| 字段常量 | NBT 键 | 默认值 | 验证规则 |
|---|---|---|---|
LEVEL |
Level |
1 | ≥ 1 |
EXP |
Exp |
0 | ≥ 0 |
MAX_LEVEL |
MaxLevel |
0 | ≥ 0 |
FIRE_PROT |
FireProtection |
0 | 0–100 |
FALL_PROT |
FallProtection |
0 | 0–100 |
BLAST_PROT |
BlastProtection |
0 | 0–100 |
PROJ_PROT |
ProjectileProtection |
0 | 0–100 |
AUTO_ATTACK |
AutoAttack |
true | — |
BASE_X/Y/Z |
BaseX/Y/Z |
0 | — |
SITTING |
IsInSittingPose |
false | — |
HEALTH |
CurrentHealth |
20.0 | > 0 |
IDLE_STATIONARY_TICKS |
IdleStationaryTicks |
0 | ≥ 0 |
STANDBY_TICKS (已弃用) |
StandbyTicks |
0 | 仅读取 |
STANDBY_TARGET_TICKS (已弃用) |
StandbyTargetTicks |
0 | 仅读取 |
IDLE_STATIONARY_TICKS 会被持久化,以便在世界重新加载时正确恢复待机动画状态(rest 与 sit),而无需重置延迟阈值。STANDBY_TICKS 和 STANDBY_TARGET_TICKS 作为仅读取字段保留以兼容存档——它们在迁移时被读取但不会被写入。
架构版本: 1.0.0
迁移链(三个步骤,在 RobotFamily.configureSchema() 中注册):
MigrationStep_V0_Fabric— Gen1-Fabric 本地化字符串 (entity.rlovelyr.bunny) → 稳定的变体键。硬编码查找表。必须作为追加式维护。MigrationStep_V0_Forge— Gen1-Forge / Gen2 扁平 PascalCase 格式 →EntityData复合结构。写入SchemaVersion和McVersion。MigrationStep_V1_1204— 1.20.4 扁平整数 ID 格式(包括TextureID整数 → 字符串变体键)→EntityData复合结构。
每个步骤都是幂等的——已经过迁移的存档会静默跳过。
动画:缺失连接线修复 (ADR_022 Change C)
AnimationProfile 现在直接在 RobotFamily.configureVariants() 中传递给 StandardAnimatorVariant 构造函数。这修复了 ADR_022 中发现的根本连接线缺失问题:此前,由于配置文件仅作为家族特性附加,而解析器的第一步从不检查此特性,导致 AnimationStateManager.resolveProfile() 对每个机器人实体都返回 null。随着连接线闭合,整个配置文件感知的动画路径对所有机器人都处于激活状态。
ROBOT_BASE_PROFILE (Legacy 和 Reboot):
- 命名槽位:
idle,walk,rest,sit,attack(INTERRUPT) - 待机槽位 1 —
rest: 在待机状态下激活,优先级 1,阈值 0 ticks - 待机槽位 2 —
sit: 在待机状态或isInSittingPose()时激活,优先级 2,阈值为StandbyToSitDelayMin(600 ticks / 30 秒)。isInSittingPose()的 OR 条件打破了世界重新加载时的第一帧 SynchedEntityData 竞态条件——如果机器人在保存时处于坐地姿势,则会在第一个渲染帧播放坐姿动画。
TRIBUTE_PROFILE (仅限 Tribute):
- 命名槽位:
idle,walk,sit(映射到"rest"),attack(INTERRUPT) - 无待机槽位 — Tribute 机器人在待机状态下保持直立的
rest姿势 indefinitely,忠实地重现原版模组的行为 .sit("rest")是有意为之:AnimationStateManager的车辆分支在骑行时会首先检查坐姿池;将其指向"rest"可确保 Tribute 机器人在载具中播放站立放松动画,而不是坐地姿势
buildAnimatorProfile() 重写点: 子类重写此方法(而非构造函数参数)以返回其配置文件。TributeRobotFamily 重写它以返回 TRIBUTE_PROFILE。基类返回 ROBOT_BASE_PROFILE。
调色板系统
RobotFamily.withColorPalette() 注册完整的 16 色染料调色板,并附带一个 ConditionalAppearanceFeature,将每种染料物品映射到纹理变体键。提供三种重载:
withColorPalette(RobotVariant)— 完整 16 色调色板,纹理位于lovelylib:命名空间withColorPalette(RobotVariant, List<EntityTexture>)— 受限调色板(例如 Bunny3 的 5 种柔和色彩)withColorPalette(RobotVariant, List<EntityTexture>, String namespace)— 自定义命名空间中的受限调色板(Tribute 使用它从lovely_robot:解析纹理)
注册表键策略:当 namespace 不同于 lovelylib 时,变体键将加上命名空间前缀(例如 "t_bunny_pink"),以防止与 lovelylib 自身针对相同变体/颜色的注册发生冲突。
EntityTexture 枚举 — 16 种命名的染料颜色(WHITE 到 BLACK)以及 RANDOM。用于 TributeRobotFamilies 和 LegacyRobotDefinitions 中的调色板声明。
家族注册表
LegacyRobotFamilies:
- 从
RobotDefinitionRegistry(机器人定义注册表)填充,而非硬编码的静态字段。添加新的 Legacy 机器人只需在LegacyRobotDefinitions中调用一次 builder —— 无需修改LegacyRobotFamilies本身。 initialize()必须在Lovely.onInitialize()封闭注册表之后、且在任何延迟注册供应商(deferred register supplier)触发之前调用。reloadFromConfig()在运行时根据当前配置值应用每个变体的属性(生命值、攻击力、防御力、速度、最大等级)以及标准特性(LevelFeature、CombatLevelFeature、EnchantmentFeature、ProtectionFeature)。
TributeRobotFamilies:
- 4 种机器人类型:VANILLA、BUNNY、BUNNY2、HONEY —— 源自 1.12.2 原版模组中的四种。
- 忠实还原原版的受限调色板:Bunny(5 色)、Bunny2(2 色)、Honey(3 色)、Vanilla(4 色)。
- 纹理通过
createTribute()工厂方法从lovely_robot:命名空间解析。 - 全部四种均通过
TributeRobotFamily子类重写使用TRIBUTE_PROFILE。
AI 目标集
AiBaseDefenseGoal (Legacy / Reboot):
- PATROL(巡逻)↔ GUARD(守卫)状态机。PATROL:在基地半径内徘徊 30–45 秒。GUARD:在基地原地静止 20–30 秒,并执行主动扫描模式。
- 每次守卫周期随机选择四种扫描模式之一(带权重):FULL_SCAN(25%)——单次 360° 旋转;DOUBLE_SWEEP(30%)——两次 180° 扫视;QUADRANT_CHECK(25%)——四次 90° 方位检查;RANDOM_POINTS(20%)——4–6 个随机边界点。
- 战斗会暂停状态机;威胁消除后无缝恢复。
- 如果机器人超出基地的传送范围,则进行紧急传送;如果在 2 倍传送范围内,则尝试步行返回。
AiTributeReturnToBaseGoal (Tribute):
- 对原版 1.12.2 存档中
EntityAIBunnyFollowPoint的忠实翻译。 - 无 PATROL/GUARD 循环 —— Tribute 机器人在 Defense(防御)状态下直接返回基地并保持位置。
canContinueToUse()首先检查navigation.isDone()—— 死路会干净退出,而不是将机器人锁定在原地。moveTo()是无条件的(不以布尔返回值作为门控)—— 门控会导致一个死区,即当传送范围内的路径失败时,机器人会静止不动且无法恢复。
AiFollowOwnerGoal —— 在 Follow(跟随)状态下跟随主人,尊重最小/最大距离配置。
AiConditionalWanderGoal —— 感知主人是否静止的漫游行为,支持可配置的几率、半径、持续时间和冷却时间。
AiConditionalLookGoal / AiConditionalRandomLookGoal —— 具有可配置范围的注视目标。
AiAutoAttackGoal —— 可配置的自动攻击,包含攻击几率和目标类型过滤。
RobotLookControl —— 用于平滑机器人头部追踪的自定义注视控制。
API 功能
CombatLevelFeature—— 使用可插拔的IAttributeCalculationStrategy按等级缩放生命值、攻击力和防御力。Legacy 和 Tribute 均通过LinearAttributeStrategy使用此功能。ProtectionFeature—— 基于等级的伤害类型抗性(火焰、坠落、爆炸、投射物),每种伤害类型有上限并与附魔集成。上限值可通过SharedConfigs配置。EnchantmentFeature—— 掠夺术和锋利度附魔集成。可配置最大等级和掠夺几率。BlazeCycleFeature—— Dragon 变体的火焰循环行为。BlockAllItemInteractionFeature—— 阻止所有物品交互(用于不应接受染料重新着色的 Tribute 机器人)。BoneVisibilityConditions—— 常见BoneCondition谓词的工厂方法:tailVisible(int tailIndex)、textureVariantIs(String key)、textureVariantIsNot(String key)。与 HZLib 的BoneVisibilityFeature配合用于 Kitsune 尾巴的进阶显示。
配置系统
SharedConfigs.Common —— 服务器权威值,同步至客户端:
- 移动速度(近战、跟随、漫游)
- 跟随距离(最小、最大)
- 经验公式(基础 + 等级 × 倍率)
- 战斗(友军伤害、攻击几率、治疗间隔、警惕时间、自动治疗)
- 掠夺附魔(启用、最大等级、掠夺几率)
- 基地防御(范围、传送范围)
- 保护上限(火焰、坠落、爆炸、投射物 —— 默认 80%)
- 附魔书保护(启用、贡献百分比)
- 智能核心检索(启用、距离)
- AI 行为(主人静止阈值、漫游参数、巡逻/守卫持续时间、扫描旋转速度)
- 碰撞避免(启用、检测半径、最小间距)
- 动画(待机转坐姿延迟:600–1800 tick)
SharedConfigs.Client —— 仅客户端:
ShadowRadius—— 渲染器阴影大小
SharedConfigs.EntityConfigData —— 每变体统计容器,带有验证、validateOrDefault() 回退机制和构建器模式。
物品
LovelyCoreItem—— 机器人核心物品基类。携带机器人数据(变体、颜色、属性)作为物品 NBT。BaseSpawnItem—— 从库存部署机器人的生成物品基类。
命令
LovelyCommands/NativeCommands——/llovely命令树:list、summon、teleport、stats、config。ColorArgumentType/ColorArgumentTypeInfo—— 用于 16 种染料名称的自定义命令参数类型,支持标签补全。
工具
EntityDataHelper—— 读取/写入实体数据复合结构的辅助方法。EntitySpawnHelper—— 以正确的初始状态生成机器人实体的辅助方法。NbtProcessingUtils—— 迁移和保存/加载期间使用的 NBT 处理工具。ValidationUtils—— 通用验证辅助方法。BoneVisibilityConditions—— 参见上方的 API 功能部分。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
模组
一个基于构建器的 Minecraft 配置库!
评论 0
登录后参与评分
还没有评论,来抢沙发吧