Blockbench 导入库

Blockbench 导入库

这个库简化了模型导入，生成物品模型与纹理，并利用polymer进行资源包创建。支持动画、Molang表达式及多种Blockbench特性。

Blockbench 模型导入库

该库简化了将 Blockbench 模型（包括通用模型与 AnimatedJava Blockbench 插件生成的模型）集成到 Fabric 模组中的流程。

它自动化了物品模型和纹理的创建过程，并利用资源包结合物品展示实体进行客户端集成，玩家无需安装额外的模组。

该库提供了全面的动画支持，包括用于关键帧的 Molang 表达式，以及各种 Blockbench 功能特性，并且额外支持其插件 AnimatedJava。

功能特性：

  • 动画支持：导入带有预渲染动画的模型，并利用 Molang 表达式（目前仅支持 q.anim_time 和 q.life_time）实现动态动画控制。
  • CustomModelData 与物品展示：采用 CustomModelData 和物品展示实体，通过“虚拟”物品展示实体以极小的服务器开销来呈现模型。- 物品展示的变换会进行异步更新，以确保流畅的性能表现。
  • 大型骨骼支持：突破原版限制，允许使用超过标准 3x3x3 尺寸限制的骨骼。
  • 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>

    修改 <targets> 中任何拥有自定义模型的实体的模型。允许你临时更改模型的比例、更新变体以及播放/暂停/停止动画。这也主要供测试和尝试使用模型。

路线图

1.x

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

2.x

  • 动态动画以实现动态动画速度，目前所有动画在导入期间都已预渲染
  • 逐玩家动画；仅向单个玩家或一组玩家显示动画。目前所有动画均为全局播放，对所有玩家可见
  • 多个骑乘者（针对实体），目前仅支持1个
  • 多个碰撞箱（需要与多骑乘者支持相同的更改）
  • 粒子效果（？）

测试服务器

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

mc.tomalbrc.de:25565

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