ArmorStand

模组

· 作者 fifth_light

将原版玩家模型替换为外部模型。支持加载 glTF、VRM、PMD 和 PMX(MMD)模型,以及 VMD 动画!

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

需要前置:Fabric API、Fabric Language Kotlin

最新 0.0.10+fabric · 1.21.8 · Fabric

一键开服(送7天)

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

目前仅维护 1.21.8 版本!其他游戏版本(1.21.7、1.21.6 和 1.21.5)已停止维护,缺少各种新功能,仅用于存档目的。

ArmorStand

ArmorStand 是一款 Minecraft 1.21.8 的玩家模型模组,支持加载外部模型以替换原版玩家模型。

目前该模组处于早期开发阶段,支持以下功能:

  • 渲染 glTF、VRM、PMX、PMD 模型
  • 渲染基岩版实体模型(兼容 YSM 未加密且非压缩的模型)
  • 导入 VMD 格式动画文件
  • 支持实例化渲染,提升渲染多个模型时的性能
  • 支持多人游戏(可同步模型显示,但不支持同步模型文件)
  • 支持光影(在模组配置中将渲染器更改为使用光影即可)

如果遇到任何问题或有建议,欢迎在 问题反馈区 和 讨论区 提交 issue 或发起讨论。

使用方法

首先,你需要准备一个模型。在使用任何模型之前,请检查模型的版权以避免版权问题。准备好模型文件后,将其放入 models 目录即可加载。

在游戏中,按 I 键打开模组设置,并选择你准备好的模型。

在游戏中,按 K 键打开动画控制界面,你可以在这里加载动画文件(同样需要将它们放入 models 目录),并控制动画速度和播放进度。

多人游戏

该模组支持多人游戏中的模型同步。使用前,请确保你的服务器也安装了该模组(如果服务器未安装该模组,其他玩家将无法看到你的模型,但你自己仍能看到自己的模型)。

考虑到分发模型可能引发版权问题,该模组不能也不会支持同步模型文件。你需要确保其他玩家也将你的模型放入他们的 models 目录中,这样他们才能看到你的模型。

该模组使用模型的哈希值来同步模型,因此你可以重命名模型,甚至将其放在子目录中。只要模型内容不变,你就可以看到其他玩家的模型。

BlazeRod

BlazeRod 是 ArmorStand 提供底层渲染能力的库,它支持:

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

BlazeRod 由 Kotlin 和 Java 编写。它不使用原生库,也不依赖特定平台,因此 BlazeRod 可以在许多环境中运行。

BlazeRod 目前作为 Jar-in-Jar 模组打包在 ArmorStand 中,但也可以作为独立的库使用。由于缺乏文档,且其 API 可能随时更改,目前不鼓励在其他项目中使用 BlazeRod。

与 ArmorStand 一样,BlazeRod 采用 LGPL 3.0 或更高版本许可证。此外还有一个演示模组 ball_block,它添加了一个球形的方块,作为 BlazeRod 模型渲染的示例。演示模组采用 Apache 2.0 许可证。

致谢

捆绑了 H2 database(MPL 2.0 或 EPL 1.0),作为模型管理功能的存储后端,感谢他们。

感谢 Saba(MIT)项目提供了 MMD(PMX/PMD/VMD 格式)的参考。

捆绑了来自 KaiMyEntity-C 的动画(作者声明不需要署名,允许修改和重新分发)作为默认动画,感谢他们。

收藏图标来自 Cherished Worlds(LGPL 3.0 或更高版本),感谢他们。

捆绑了 JavaOSC(BSD-3-Clause)以提供 OSC/VMC 支持,感谢他们。

感谢 GeckoLib(MIT)项目提供了基岩版模型渲染的参考。

捆绑了 mocha(MIT)项目作为 molang 的执行引擎,感谢他们。

捆绑了 Javassist(MPL 1.1、LGPL 2.1 或更高版本或 Apache 2.0)作为 mocha 的代码生成引擎,感谢他们。

许可证

本模组采用 LGPL 3.0 或更高版本许可证。在分发和修改时请遵守许可证要求。

虽然这不是强制要求的,但如果你的作品(例如视频等)使用了该模组,请声明你正在使用该模组,如果可能,还请附上模组的链接。


ArmorStand

ArmorStand 是一款适用于 Minecraft 1.21.8 的玩家模型模组,支持加载外部模型以替换原版玩家模型。

功能

目前模组处于早期开发阶段,支持以下功能:

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

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

使用方法

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

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

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

多人游戏

模组支持多人游戏中模型的同步显示。使用前请确保你的服务端也安装了本模组(如果服务器未安装,其他玩家将无法看到你的模型,但你自己的模型可以正常显示)。

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

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

BlazeRod

BlazeRod 是为 ArmorStand 提供底层渲染功能的基础库,支持的功能包括:

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

BlazeRod 由 Kotlin 和 Java 编写,不使用原生库,不依赖特定平台,因此可以在各种环境中运行。

烈焰棒目前作为一个 Jar-in-Jar 模组打包在盔甲架中,但可以作为一个单独的库来使用。由于目前没有详细的文档,并且 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 的代码生成引擎,在此感谢。

许可证

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

虽然不是强制要求,如果你的作品(例如视频等)使用到了本模组,请声明使用了本模组,如果可以的话,还可以带上本模组的链接。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源