toxicity188/BetterModel：适用于 Minecraft Java Edition 的现代

技术解读

以下内容由 GitRead 中文社区编辑团队基于项目 README 与官方资料整理，结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

BetterModel：针对 Minecraft Java 版本的 Modern Bedrock 模型渲染引擎

项目背景与痛点

BetterModel 插件正是针对这样一个核心痛点：在 Minecraft Java 版本中实现 Bedrock 资源包（即 Java 版本的 Legacy 1.14 之前格式）的渲染。这不仅满足了玩家能够加载 Bedrock 版本的资源包，更重要的是提高了模型渲染的真实性。

现代版 Minecraft 在模型渲染上做了大量的改进，床岩版（Bedrock）因其跨平台的特性受益良多，引入的 Modern Model Renderer 系统可以支持更复杂的模型以及先进的光照效果。传统 Java 版本的 Minecraft 本身较为老旧，依赖较为简单的模型格式，这使得 Java 玩家难以复刻 Bedrock 的复杂模型。

这导致了 Java 版本和 Bedrock 版本间模型渲染能力的巨大差异。为了弥补这一鸿沟，众多玩家呼吁开发兼容 Bedrock 模型格式的 Java 玩家基础。在此背景下，BetterModel 应运而生，它在 Minecraft Java 版本中引入了 Modern Bedrock Model Renderer，致力于缩小版本间的体验差距。

核心技术揭秘

BetterModel 插件并不是简单地嫁接 Bedrock 模型到 Java 上，它在架构层面做了一系列的创新性改动。

封装 Bedrock 模型格式

BetterModel 的第一步就是解析 Bedrock 内核的模型。这涉及到对多个 Bedrock 资源包模型文件结构的理解。模型数据包往往遵循一种特定的 JSON 格式，其中包括顶点、纹理坐标等多个部分。BetterModel 需要将这些数据转换为 Java 版本可以理解的格式。

资源加载流程

为了分析 BetterModel 的具体实现，我们引入了一张架构图。

graph TD A[资源加载] --> B{"校验资源完整性"} B -->|"通过"| C[解析模型文件] B -->|"失败"| D[返回错误] C --> E[模型预处理] E --> F{"材质解析"} F -->|"成功"| G[分配材质资源] F -->|"失败"| H[错误提示] G --> I[纹理加载] I --> J[模型渲染]

模型预处理

在解析完毕后，BetterModel 需要对模型进行预处理。涉及到的步骤包括顶点重组，匀光和纹理映射。此外，BetterModel 还实现了子模型的管理机制，对包含多个子模型的资源进行了拆分和缓存。

资源管理

模型资源管理是整个过程的关键环节，BetterModel 引入了对所有资源的引用管理机制，缓存模型数据块以减少频繁的 IO 操作。

编译优化

为了提升渲染效率，BetterModel 优化了模型渲染代码，采用了一系列的编译时优化策略。这包括但不限于光照计算、材质优化以及显存分配等。

功能亮点与差异

在实现 Bedrock 模型格式支持的同时，BetterModel 还集成了许多特色功能。区分于其他竞品，BetterModel 通过巧妙结合 Bedrock 格式的现代渲染特性，使最终用户能在 Java 版本享受到与 Bedrock 版本近似的渲染效果。

优化的渲染性能

对比同类插件，BetterModel 节省了大量的系统资源，并且在渲染大模型时其优势更为显著，优秀的渲染性能反馈给客户端更清晰更流畅的模型展示。

显示效果更进一层

BetterModel 提供了一系列模型可视化参数的修改能力，可以让用户进一步定制模型纹理和光照效果，使得模型渲染效果比其他插件更加出色。

应用场景与落地建议

在生产环境中使用 BetterModel 时，开发者需要特别注意资源文件的兼容性与完整性以确保插件的正常运作。其次，由于其对系统资源的需求较高，建议在配置较高的机器上运行并预览大型模型文件以达到最高运行效率。

适合使用 BetterModel 的场景包括了复杂模型加载、材质多变的项目或需要进行跨平台渲染效果一致性的项目。

综合评价

总体而言，BetterModel 在很大程度上解决了 Minecraft Java 版本渲染 Bedrock 资源包的问题。其庞大的兼容性、优秀的渲染效率以及丰富的渲染控制功能都可以满足各种复杂场景的应用需求，是值得推荐的一个优质组件。

然而，考虑到资源密集型渲染可能带来的性能压力，开发者在实际项目中的整合与管理能力也是决定此项插件应用成败的关键。

关于

GitHub 原始描述（英文）

Modern Bedrock model engine for Minecraft Java Edition

blockbench bukkit-plugin fabric-mod fabric-server folia-plugin java kotlin minecraft minecraft-mod minecraft-model minecraft-plugin modelengine paper-plugin resource-pack spigot-plugin

MIT License
358 Stars
92 Forks
6 Watching

描述取自 GitHub 官方 API，保持仓库作者书写的原文。

简要分析

热度分

548

价值分

239

活跃状态

活跃

GitHub

语言占比

Java

Kotlin

Release

贡献者

BetterModel

- Modern Bedrock model engine for Bukkit -

_{(In BlockBench / In Minecraft)}

✨ Introduction

BetterModel is a plugin-based engine that provides runtime BlockBench model rendering & animating for Minecraft Java Edition.

It implements fully server-side 3D models by using an item display entity packet.

Importing Generic BlockBench model .bbmodel
Auto-generating resource pack
Playing animation
Syncing with base entity
Custom hit box
12-limb player animation

In-Game Screenshots

🚀 Key Features & Focus

BetterModel aims to be a reliable engine that provides stable, high-quality animations for Paper-based high-traffic servers.

Stability First: We take a conservative approach to feature expansion. By avoiding the implementation of features that are difficult to maintain or have limited use cases, we focus on providing a stable API and ensuring overall operational safety.
Performance Optimized: Our goal is to minimize runtime computation, memory footprint, and network overhead. Through asynchronous design and optimized packet handling, we ensure the engine runs efficiently even under heavy server loads.
Tailored for Large-scale Servers: We provide essential features specifically designed for high-population servers and MMORPG content creation.
- Per-player Animation: Individual animation control tailored to each player’s perspective.
- Player Model Animation: Support for sophisticated 12-limb animations based on player models.

📚 Wiki

🛠️ Build info

Build

./gradlew build: Builds all jars
./gradlew shadowJar: Builds plugin jar
./gradlew javadocJar: Builds javadoc jar
./gradlew runServer: Runs Paper test server with test plugin

Library

Kotlin stdlib: modern functional programming
semver4j: semver parser
cloud: command
adventure: component
stable player display: player animation
caffeine: concurrent map cache
DynamicUV: player model
ArmorModel: armor in player model
molang-compiler: compiling and evaluating molang expression
libby: runtime library downloader

Tested Server Platform

💻 API

[!NOTE]
For more detailed API specifications, please refer to our GitHub Wiki.

Gradle (Kotlin)

Release

repositories {
    mavenCentral()
}

dependencies {
    compileOnly("io.github.toxicity188:bettermodel:VERSION")
}

Snapshot

repositories {
    maven("https://maven.pkg.github.com/toxicity188/BetterModel") {
        credentials {
            username = YOUR_GITHUB_USERNAME
            password = YOUR_GITHUB_TOKEN
        }
    }
}

dependencies {
    compileOnly("io.github.toxicity188:bettermodel:VERSION-SNAPSHOT")
}

Gradle (Groovy)

Release

repositories {
    mavenCentral()
}

dependencies {
    compileOnly 'io.github.toxicity188:bettermodel:VERSION'
}

Snapshot

repositories {
    maven {
        url "https://maven.pkg.github.com/toxicity188/BetterModel"
        credentials {
            username = YOUR_GITHUB_USERNAME
            password = YOUR_GITHUB_TOKEN
        }
    }
}

dependencies {
    compileOnly 'io.github.toxicity188:bettermodel:VERSION-SNAPSHOT'
}

Maven

Release

<repositories>
    <repository>
        <id>central</id>
        <url>https://repo.maven.apache.org/maven2</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>io.github.toxicity188</groupId>
        <artifactId>bettermodel</artifactId>
        <version>VERSION</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

Snapshot

<repositories>
    <repository>
        <id>github</id>
        <url>https://maven.pkg.github.com/toxicity188/BetterModel</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>io.github.toxicity188</groupId>
        <artifactId>bettermodel</artifactId>
        <version>VERSION-SNAPSHOT</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

Example code

Gets some model or limb

BetterModel.model("demon_knight"); //A model file in BetterModel/models (for general model with saving)
BetterModel.limb("steve"); //A model file in BetterModel/players (for player model with no saveing)

BetterModel.modelOrNull("demon_knight"); //general model or null
BetterModel.limbOrNull("steve"); //player model or null

Creates model (entity)

EntityTracker tracker = BetterModel.model("demon_knight")
    .map(r -> r.getOrCreate(entity)) //Gets or creates entity tracker by this renderer to some entity.
    .orElse(null);

EntityTracker tracker = BetterModel.model("demon_knight")
    .map(r -> r.create(entity, TrackerModifier.DEFAULT, t -> t.update(TrackerUpdateAction.tint(0x0026FF)))) //Creates entity tracker with pre-spawn task.
    .orElse(null);

Creates model (dummy)

DummyTracker tracker = BetterModel.model("demon_knight")
    .map(r -> r.create(location)) //Creates some dummy tracker to this location.
    .orElse(null);

DummyTracker tracker = BetterModel.limb("steve")
    .map(r -> r.create(location, ModelProfile.of(player))) //Creates some dummy tracker to this location and player's skin profile.
    .orElse(null);

Update some tracker’s display data

BetterModel.model("demon_knight")
    .map(r -> r.create(entity, TrackerModifier.DEFAULT, t -> {
        t.update(TrackerUpdateAction.tint(rgb)); //Tint
        t.update(TrackerUpdateAction.enchant(true), bone -> true); //Enchant with predicate
    }))
    .ifPresent(tracker -> tracker.update(TrackerUpdateAction.composite( //Composite
        TrackerUpdateAction.brightness(15, 15)  //Brightness
        TrackerUpdateAction.billboard(Display.Billboard.CENTER) //Billboard
    )));
}

💬 Community

💖 Support

暂无评论

BetterModel

技术解读

BetterModel：针对 Minecraft Java 版本的 Modern Bedrock 模型渲染引擎

项目背景与痛点

核心技术揭秘

封装 Bedrock 模型格式

资源加载流程

模型预处理

资源管理

编译优化

功能亮点与差异

优化的渲染性能

显示效果更进一层

应用场景与落地建议

综合评价

相关仓库

关于

简要分析

语言占比

Release

贡献者

BetterModel

✨ Introduction

🚀 Key Features & Focus

📚 Wiki

🛠️ Build info

Build

Library

Tested Server Platform

💻 API

Release

Snapshot

Release

Snapshot

Release

Snapshot

Gets some model or limb

Creates model (entity)

Creates model (dummy)

Update some tracker’s display data

💬 Community

💖 Support

评论