blockbench import library

Blockbench 导入前置库

此前置库简化了将 Blockbench 模型（通用模型以及使用 AnimatedJava Blockbench 插件制作的模型）集成到 Fabric 模组中的流程。

它会自动创建物品模型和贴图，并结合使用资源包与物品展示实体，在客户端实现模型集成，无需玩家安装额外模组。

此前置库全面支持动画，包括关键帧中的 Molang 表达式，还支持多种 Blockbench 功能，并额外兼容 AnimatedJava 插件。

功能：

• 动画支持：导入预渲染动画模型，并使用 Molang 表达式（目前仅支持 q.anim_time 和 q.life_time）动态控制动画。
• CustomModelData 与物品展示实体：通过 CustomModelData 和物品展示实体呈现模型，并使用“虚拟”物品展示实体，最大限度降低服务器负担。- 物品展示实体的变换会异步更新，确保流畅运行。
• 支持大型骨骼：突破原版限制，允许骨骼超出标准的 3×3×3 尺寸限制。
• 支持 Blockbench 功能：兼容多种 Blockbench 功能，包括效果关键帧（命令和音效）、动画循环模式、插值等。
• AnimatedJava 扩展：为 AnimatedJava 提供额外功能，包括 变体支持、骨骼黑名单、条件效果和定位器支持
• 集成原版生物功能：开箱即用地支持多种原版生物功能，例如精准碰撞箱（可在 F3+B 中查看）、可骑乘性、命名牌、隐形、发光、火焰动画、粒子效果、拴绳、死亡动画、平滑碰撞、动态碰撞箱/缩放，以及针对实体的专属刻更新，以优化性能。

更多信息请查看 GitHub README 和文档！

安装

repositories {
    maven { url "https://maven.tomalbrc.de" }
}

dependencies {
    modImplementation include("de.tomalbrc:blockbench-import-library:[TAG]")
}

用法

文档请见此处

命令

• /bil model create id<.ajmodel>|filepath <model>

根据生物标识符或模型 JSON 文件路径（相对于服务器根目录），在游戏中生成模型。这些模型不会被保存，主要用于测试。若要加载 .ajmodel 文件，请将 .ajmodel 添加到标识符或文件路径末尾。

• /bil model <targets> animation|variant|scale <args>

修改 中选中的、拥有自定义模型的实体的模型。你可以临时调整模型缩放、更新变体，以及播放/暂停/停止动画。这同样主要用于测试和体验模型。

开发路线图

1.x

• 用于实现更动态动画的骨骼修饰器
• 处理关键帧的前置/后置值
• 生成动态贴图的 mcmeta 文件
• 支持关键帧贝塞尔曲线

2.x

• 动态动画：支持动态调整动画速度；目前所有动画都在导入时预渲染
• 按玩家播放动画：仅向单个玩家或一组玩家展示动画。目前动画是全局播放，所有玩家都能看到
• 支持多名骑乘者（适用于实体）；目前仅支持 1 名
• 支持多个碰撞箱（需要与支持多名骑乘者相同的改动）
• 粒子效果（？）

测试服务器

使用 1.20.5-1.21+ 客户端加入测试服务器，地址：

mc.tomalbrc.de:25565

即可测试此模组、我的其他模组，以及即将推出的未发布模组和功能！