中文介绍在下面。目前只维护 1.21.8 的版本！其它游戏版本（1.21.7、1.21.6 和 1.21.5）不再维护，缺少各种新功能，仅作归档。

Currently only 1.21.8 is maintained! Other game version (1.21.7, 1.21.6 and 1.21.5) is no longer maintained, without various new features, and is only for archive proposes.

ArmorStand

ArmorStand is a Minecraft 1.21.8 player model mod that supports loading external models to replace the vanilla player model.

Currently, the mod is in early development, and supports the following features:

• Render glTF, VRM, PMX, PMD models
• Render bedrock version entity models (compatible with unencrypted and non-zipped models of YSM)
• Import VMD format animation files
• Support instanced rendering, improving performance when rendering multiple models
• Support multiplayer (can synchronize model display, but won't support synchronizing model files)
• Shader support (Change renderer in mod config to use shader)

If you encounter any problems or have any ideas, please feel free to open an issue or discussion in the issue area and discussion area.

Usage

First, you need to prepare a model. Before using any model, please check the copyright of the model to avoid copyright issues. Once you have prepared the model file, place it in the models directory to load it.

In game, press I to open the mod settings, and choose the model you prepared.

In game, press K to open the animation control interface, where you can load animation files (you also need to place them in the models directory), and control the animation speed and playback progress.

Multiplayer

The mod supports multiplayer model synchronization. Before using it, please ensure that your server also has the mod installed (if the server does not have the mod, other players will not be able to see your model, but your own model can still be displayed).

Considering distributing models causes copyright issues, the mod can not and will not support synchronizing model files. You need to ensure that other players will also place your model in the models directory, so that they can see your model.

The mod uses the model's hash value to synchronize models, so you can rename the model, even put it in a subdirectory. As long as the model content does not change, you can see other players' models.

BlazeRod

BlazeRod is the library providing underlying render abilities for ArmorStand, and it supports:

• glTF, VRM, PMX, PMD model loading
• In-game model rendering
• glTF and VMD animation support

BlazeRod is written in Kotlin and Java. It doesn't use native library, and don't depend on particular platform, so BlazeRod can run in many environment.

BlazeRod is currently packed as a Jar-in-Jar mod in ArmorStand, but it can also be used as a standalone library. Due to lack of documentation, and it's API can be changed in any time, it is not encouraged to use BlazeRod in other project for now.

Same as ArmorStand, BlazeRod is licensed under the LGPL 3.0 or later versions. There is also a demo mod ball_block which adds a ball-shaped block, as an example for model rendering of BlazeRod. Demo mods is licensed under the Apache 2.0 license.

Acknowledgments

Bundled H2 database(MPL 2.0 or EPL 1.0), as model management feature's storage backend, thanks to them.

Thanks for Saba(MIT) project for providing reference of MMD (PMX/PMD/VMD format).

Bundled animations from KaiMyEntity-C(Author declared it don't require credits, allow to modify and to redistribute) as default animation, thanks to them.

The favorite icon is from Cherished Worlds(LGPL 3.0 or later), thanks to them.

Bundled JavaOSC(BSD-3-Clause) for providing OSC/VMC support, thanks to them.

Thanks for GeckoLib(MIT) project for providing reference of bedrock model rendering.

Bundled mocha(MIT) project as executing engine of molang, thanks to them.

Bundled Javassist(MPL 1.1, LGPL 2.1-or-later or Apache 2.0) as code generation engine of mocha, thanks to them.

License

The mod is licensed under the LGPL 3.0 or later. Please comply with the license requirements when distributing and modifying.

Although it is not required, if your work (such as videos, etc.) uses the mod, please declare that you are using the mod, and if possible, also include a link to the mod.

---

盔甲架

盔甲架是一款 Minecraft 1.21.8 的玩家模型 mod，支持加载外部模型以替换原版的玩家模型。

功能

目前 mod 在早期开发中，支持下列功能：

• 渲染 glTF、VRM、PMX、PMD 格式的模型
• 渲染基岩版实体模型（兼容 YSM 的无加密且未打包的模型）
• 导入 VMD 格式的动画文件
• 支持实例化渲染，从而提升多个模型渲染时的性能
• 支持多人游戏（可以同步显示模型，但是不能也不会支持同步模型文件）
• 支持光影（在模组设置内修改渲染器以使用光影）

如果发现了任何问题，或者有任何想法，欢迎在 issue 区 和 discussion 区 提出。

使用方式

首先，你需要自己准备模型，在使用模型前请先确认模型的版权。准备好模型文件后，将模型放在游戏目录下的 models 目录以加载。

在游戏内按下 I 键可以打开 mod 设置，在设置界面内可以选择你准备好的模型。

在游戏内按下 K 键可以打开动画控制界面，在其中你可以加载动画文件（也需要放在 models 目录下），并且可以控制动画速度和播放进度。

多人游戏

mod 支持多人游戏同步显示模型。在使用前请确保你的服务端也安装了本 mod（如果服务器没有安装，其他玩家将无法看到你的模型，但你自己的模型可以正常显示）。

考虑到分发模型的版权问题，本 mod 不能也不会支持同步模型文件。你需要确保其他玩家也将你使用的模型放置在 models 目录下，别的玩家才能显示你的模型。

mod 采取同步模型哈希值的方式，因此你可以重命名模型，甚至可以放在子目录下，只要模型内容不变，你就可以看到其他玩家的模型。

烈焰棒

烈焰棒是提供盔甲架底层渲染功能的基础库，支持的功能有：

• glTF、VRM、PMX、PMD 模型加载
• 游戏内模型渲染
• glTF 和 VMD 动画支持

烈焰棒由 Kotlin 和 Java 编写，不使用原生库，不依赖特定平台，因此可以运行在各种环境上。

烈焰棒目前作为一个 Jar-in-Jar mod 打包在盔甲架中，但可以作为一个单独的库来使用。由于目前没有详细的文档，并且 API 随时可能发生变化，目前不建议在其他项目使用烈焰棒。

与盔甲架相同，烈焰棒也使用 LGPL 3.0 及上版本授权。还有一个示例模组 ball_block，其添加了一个球形方块，作为烈焰棒渲染模型的简单示例。示例模组采用 Apache 2.0 许可证授权。

鸣谢

捆绑了 H2 数据库（MPL 2.0 或 EPL 1.0），作为模型管理功能的存储后端，在此感谢。

感谢 Saba（MIT） 项目为 MMD（PMX/PMD/VMD 格式）的逻辑提供了参考。

捆绑了 KaiMyEntity-C 项目的动画（作者已经在 README 声明不需要署名、可修改、可再分发）作为默认动画，在此感谢。

使用了来自 Cherished Worlds（LGPL 3.0 及以上版本） 的贴图作为收藏图标，在此感谢。

捆绑了 JavaOSC（BSD-3-Clause）以提供 OSC/VMC 支持，在此感谢。

感谢 GeckoLib（MIT）提供了基岩版模型渲染逻辑的参考。

捆绑了 mocha（MIT）项目作为 molang 执行引擎，在此感谢。

捆绑了 Javassist（MPL 1.1 或 LGPL 2.1-or-later 或 Apache 2.0）作为 mocha 的代码生成引擎，在此感谢。

许可证

本 mod 以 LGPL 3.0 及以上版本授权，在发布和修改时请遵守许可证要求。

虽然不是强制要求，如果你的作品（例如视频等）使用到了本 mod，请声明使用了本 mod，如果可以的话，还可以带上本 mod 的链接。