StargazerLib

模组

· 作者 Natsu91

一个用于渲染支持 GLB 模型和动画的实体的库,灵感来源于 GeckoLib 的接口。

0 本站下载 0 关注 更新于 3 个月前

最新 0.1.0 · 1.18.2 · Forge

一键开服(送7天)

这是一个巨大的 WIP(开发中),但我最终会完成它。文档和维基也尚未发布。

描述

StargazerLib 是一个库,能够在 Minecraft 实体上直接渲染并动画化 glTF / GLB 模型,包括其骨架、动画和纹理。

简而言之:它就像 GeckoLib,但使用的是真实网格而非方块。

它的诞生源于一个简单的挫败感:GeckoLib 只能渲染方块。当你的艺术家在 Blender 中工作并交给你低多边形模型时,你的选择会很糟糕。

  • 为什么要将干净的低多边形模型体素化,这使得它比原始模型 更丑 且 更重?
  • 为什么要手动在 Blockbench 中重建整个模型,而它已经以 .glb 格式存在?
  • 为什么在这个过程中会丢失你的骨架、动画和纹理?

StargazerLib 采取了另一条路线:它以原样加载 .glb 文件,并通过 Minecraft 自身的管道渲染实际网格,因此光照和光影仍然有效。蒙皮、动画片段(支持片段间的交叉淡入淡出)、纹理和自动缩放都由你处理。

它的用途类似于 GeckoLib,供其他模组使用,但你可以保留你的艺术家已经使用的 Blender 工作流程。

对于开发者

将你的模型放入 assets/<modid>/models/entity/<name>.glb,然后让你的实体声明它:

public class Dragon extends Entity implements GltfAnimatable {

    public ResourceLocation getGltfModel() {
        return new ResourceLocation("mymod", "dragon");
    }

    public float getGltfSize() {
        return 2.0f; // 最大维度约 2 个方块
    }

    public void registerControllers(ControllerRegistrar registrar) {
        registrar.add(new AnimationController<>("main",
                state -> state.isMoving() ? "fly" : "idle"));
    }
}

然后注册提供的通用渲染器:

event.registerEntityRenderer(DRAGON_TYPE, GltfEntityRenderer::new);

就这样,Blender 模型就会出现在你的实体上,带有动画和纹理。包含两个演示实体(stargazerlib:gltf_test 和 stargazerlib:gltf_dragon),以便你在游戏中查看效果。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源