
VRRW动画 - OBJ ANIM
将物品、方块、Steve、实体交换为动画OBJ
✨ VRRW ANIMATION — OBJ ANIM 🎨 游戏内 OBJ 动画与建模框架 导入 OBJ 模型,使用关键帧为其制作动画,替换实体和方块,在游戏内编辑模型,添加行为与音效,并直接在 Minecraft 中构建动画 3D 内容。 导入。动画。编辑。替换。构建。
🌿 专为补充 VRRW OVERWORLD 而打造
OBJ Anim 可作为独立的建模与动画框架使用,但它同时也是 VRRW Overworld 的必需配套模组。Overworld 使用 OBJ Anim 的工具/模型管线,两个模组在设计上相互配合,涵盖模型、平滑地形 / Surface Net、渲染与着色。
| 🌐 VRRW.online → 项目中心与生态 |
🟣 Twitch → 直播与社区 |
💚 Kick → 直播与社区 |
▶️ YouTube → 视频与展示 |
| 🖥️ Kinetic Hosting → 服务器托管 • 优惠码 VRRW |
🎁 优惠 → 长期问答与项目 |
❓ Reddit 问答 → 提问与讨论 |
💜 Patreon → 支持开发 |
## ▶️ 观看 OBJ ANIM 实战演示 ### 🎬 在深入了解细节之前,先观看 OBJ Anim、VRRW Overworld 以及更广泛的 VRRW 视觉系统的实战演示。
🔴 VRRW 直播活动与社区行动 🎁
在特定的 VRRW 直播活动期间,VRRW 材质包礼物可能完全免费提供。
🟣 在 TWITCH 上观看 VRREALISTICWORLDS 直播 →
💚 在 KICK 上观看 VRREALISTICWORLDS 直播 →
🔴 打开 VRRW 社区直播行动 →
特殊的社区行动与直播活动通过 VRRW Community Live Actions 页面进行。
🎁 直播行动与礼物:请查看 Live Actions 页面了解当前的社区活动。直播本身可在 Twitch 或 Kick 上观看。
🟣 TWITCH 社区
TWITCH 社区、频道推荐与直播组件 →
Twitch 在 VRRW Minecraft 模组中显示为默认直播选项,并配有切换栏,可在 Twitch 与 Kick 之间选择。
- 📺 Twitch 社区信息
- ⭐ Twitch 频道推荐
- 📅 集成直播日程组件
- 🎮 Minecraft 直播、展示与开发直播
- 💬 问答、社区反馈与投票
📅 直播日期与时间通过其组件直接显示在 Twitch 社区页面内。
💚 KICK 社区
KICK 社区、频道推荐与直播组件 →
Kick 作为额外的直播与社区平台继续提供。
- 📺 Kick 社区信息
- ⭐ Kick 频道推荐
- 📅 集成直播日程组件
- 🎮 开发直播与展示
- 💬 问答、社区反馈与投票
📅 直播日期与时间通过其组件直接显示在 Kick 社区页面内。
🗳️ 社区参与 — 帮助塑造 VRRW
VRRW 不仅仅是观看的内容 —— 社区可以积极帮助塑造未来的方向。
在直播和社区活动期间,观众可能会被邀请参与:
- 🗳️ 直播投票 — 在直播期间对选定的想法、优先级或社区问题进行投票。
- 💡 功能建议轮次 — 为 AI Reborn、VRRW 项目及未来改进分享想法。
- ⚡ Blitz Reactions — 针对新概念、功能、变更或直播决策的快速社区反应轮次。
- 💬 直接反馈 — 告诉我们哪些做得好、哪些需要改变以及你希望接下来看到什么。
- 🎮 直播参与 — 部分直播可能包含社区提问、投票和互动决策。
- 🌐 VRRW.online 参与 — 在直播之外也可使用现有的投票、建议和社区工具。
🧠 社区驱动开发:社区反馈可以影响想法、优先级、功能及未来的 VRRW 活动。部分决策可能会直接开放给社区投票或快速反馈轮次。
🟣 加入 TWITCH 社区 →
💚 加入 KICK 社区 →
🔴 参与 VRRW 直播行动 →
## 🌄 真实表面网格与全新碰撞系统 OBJAnim 现在还包含 Realistic Surface Net / Smooth Terrain 系统。 其目标是超越纯粹方块化的地形外观,配合全新的碰撞方案,创造更平滑、更自然的表面。 > ⚠️ **2.0.0+ 版本变更:** > 旧版的游戏内 `M` 模式切换不再以相同方式提供,因为新的碰撞系统已集成到较新的地形实现中。 --- 🔥 OBJANIM 能做什么 📂 从 OBJAnim 导入文件夹加载 Wavefront OBJ + MTL 模型 🧍 用自定义 3D OBJ 模型替换或渲染实体 🧱 将 OBJ 模型用于方块和动画世界物体 🗡️ 将自定义 OBJ 模型用于物品 🎞️ 使用游戏内关键帧时间轴创建动画 🧠 配置行为,如睡觉、进食、饮水、游荡、攻击性、情绪和跟随 🛠️ 使用模型工作台编辑模型 🎨 在游戏内编辑 UV、网格和纹理 🔊 为动画和活动分配自定义 `.ogg` 音效 🖼️ 生成模型缩略图并配置纹理覆盖 💾 将动画快照导出为 JSON 🔁 使用命令重新加载并应用导入的模型 🌄 使用集成的 Realistic Surface Net / Smooth Terrain 系统 🧩 通过模型 API 将 OBJAnim 集成到其他模组中 ---
🌍 想要完整的 VRRW 多人游戏体验? 🤖 NATIONS & VILLAGERS — AI REBORN → OBJAnim 是更广泛的 VRRW 项目生态的一部分。 Nations & Villagers — AI Reborn 添加了许多 VRRW 体验中使用的关联文明与多人游戏系统,包括 AI 市民、国家、经济、外交、公共服务器玩法及支持的社区活动。 ⬇️ 在 MODRINTH 上下载 AI REBORN →
📚 完整的 OBJANIM 指南 以下所有内容均组织为可展开的部分,你可以只打开所需的部分。
🚀 核心功能 — 这个模组做什么?
OBJ 实体动画器 OBJ Entity Animator 为 OBJ 内容提供游戏内动画、建模和行为框架。 核心功能包括: 从 `config/objanim/import/...` 加载 Wavefront OBJ + MTL 文件 用自定义 3D 模型替换实体、方块和物品 游戏内基于时间轴的关键帧动画 逐部件的位移、旋转和缩放编辑 基于活动的动画,如待机、行走、攻击、睡觉、进食和饮水 行为配置 动画 OBJ 世界方块 游戏内模型导入与导出 UV 编辑 纹理绘制 网格编辑 自定义音效支持 模型缩略图生成 动画 JSON 导出 用于与其他模组集成的 API 该工作流的设计使得大量模型设置、动画和编辑都可以直接在 Minecraft 内完成。🌄 真实表面网格 — 平滑地形与碰撞
平滑地形集成 OBJAnim 包含 Realistic Surface Net / Smooth Terrain 系统。 该系统旨在创造更平滑、更自然的地形表面,而非仅依赖传统的方块化外观。 2.0.0+ 版本行为 旧版本通过 `M` 热键暴露地形模式。 在较新的 2.0.0+ 碰撞系统中,旧的模式切换不再以相同方式提供。 > **当前概念:** 更平滑的地形渲染配合更新的碰撞实现。 地形系统与 OBJ 动画框架可在本页顶部的主展示视频中一同看到。📂 安装与导入文件夹结构
安装 安装适用于 Minecraft 1.21.x 的受支持 NeoForge 版本。 将 OBJAnim 的 `.jar` 文件放入 Minecraft 的 `mods/` 文件夹。 启动游戏一次。 OBJAnim 会创建其配置和导入文件夹。 将你的 OBJ/MTL 文件添加到相应的导入类别中。 需要时在游戏内重新加载模型。 导入文件夹 该模组使用以下路径下的文件夹: `config/objanim/` 典型结构: `import/entity` — 实体和生物模型 `import/block` — 方块模型 `import/item` — 物品和手持模型 `import/custommodels` — 杂项模型、道具、工具和 Steve 风格骨骼 `export` — 导出的 OBJ 文件和纹理 `customsound` — 自定义 `.ogg` 文件 `UIelements` — 生成的 GUI/模型缩略图 额外的 JSON 配置文件可用于控制行为、视频/渲染设置、调试和统一配置。 OBJAnim 会扫描导入目录并构建内部模型索引。🧍 实体动画器与行为系统
打开实体编辑器 默认按键:`O` 在编辑器内你可以: 选择实体 手动加载模型 创建活动 在时间轴上构建动画 为各个部件添加关键帧 更改旋转 更改位移 更改缩放 预览动画 保存动画数据 分配自定义音效 示例活动 待机 行走 攻击 睡觉 进食 饮水 自定义活动 行为配置 BehaviorConfig 系统可配置如下行为: 夜间睡觉 躺卧/睡觉姿势 进食 饮水 攻击性 攻击行为 待机情绪 跟随 游荡 原版行为保留可通过以下方式配置: `preserveVanillaBehaviors = true` 这允许 OBJAnim 行为系统与受支持的原版 AI 行为共存,而不是简单地将其移除。🧱 动画 OBJ 方块
OBJAnim 包含一个 Animated OBJ Block,用于将动画 3D 模型直接放置到世界中。 已注册的对象包括: 方块:`animated_obj_block` 方块实体:`animated_obj_block` 物品:`animated_obj_block` 可能的用途 装饰 动画标牌 展示 机器 活动部件 动画雕像 道具 自定义世界物体 获取方块 ```mcfunction /give @p objanim:animated_obj_block ``` 基本工作流 放置方块。 打开方块编辑器。 选择 OBJ 模型。 选择/配置动画。 配置朝向。 配置缩放及其他设置。 如有需要,调整性能。 视频/渲染相关选项可存储在: `config/objanim/video/objanim_video.json`🛠️ 模型工作台 — 游戏内 3D 编辑
OBJAnim 包含一个通过 `model_editor` 物品访问的模型工作台。 获取编辑器 ```mcfunction /give @p objanim:model_editor ``` 该工作台可提供以下工具: OBJ 导入 OBJ 导出 网格编辑 顶点编辑 变换操纵器(gizmos) UV 编辑 纹理绘制 创建 PNG 纹理 编辑模型几何 导出成品 示例 Steve 模型包含在: `assets/objanim/models/steve` 典型工作流 打开模型工作台。 从 OBJAnim 导入文件夹导入模型。 编辑几何或变换。 调整 UV 坐标。 绘制或创建纹理。 将结果导出到导出文件夹。🖼️ 缩略图、纹理与自定义音效
GUI 缩略图 OBJAnim 可生成用于其用户界面的模型缩略图。 缩略图存储在: `UIelements/` 可能的选项包括: 自动生成的模型预览 可选的物品栏图标覆盖 针对物品、方块和实体的分类设置 纹理覆盖 导入的模型可使用自己的纹理和分类专用的纹理配置。 自定义音效 将 `.ogg` 音效文件放入: `config/objanim/customsound` 在动画器内你可以: 打开自定义音效选择界面。 预览可用音效。 选择音效。 将其分配给动画或活动。 これにより、动画生物、机器和道具可以拥有各自同步的音频。🔁 模型替换与命令
OBJAnim 可将导入的模型映射到受支持的实体、方块和物品。 重新加载导入的模型 ```mcfunction /objanim reload ``` 重新加载导入的模型内容。 应用特定模型 ```mcfunction /objanim apply ``` 将选定的模型应用到匹配的目标。 批量应用导入的模型 ```mcfunction /objanim apply-all ``` 应用所有受支持的导入模型映射。 这些命令在开发模型时很有用,因为你可以更新导入的文件并重新加载它们,而无需重建整个模组。🎮 玩家手册 — 快速工作流
添加你自己的模型 将模型文件放入正确的类别: 实体 → `import/entity` 方块 → `import/block` 物品 → `import/item` 杂项模型 → `import/custommodels` 然后重新加载: ```mcfunction /objanim reload ``` 为实体制作动画 按 `O`。 选择实体或模型。 创建活动。 打开部件动画器。 选择模型部件。 添加关键帧。 调整旋转、位移和缩放。 保存。 预览动画。 如有需要配置行为。 如需要可分配音效。 使用动画 OBJ 方块 ```mcfunction /give @p objanim:animated_obj_block ``` 然后: 放置方块。 打开其编辑器。 选择 OBJ 模型。 选择动画。 调整朝向和缩放。 保存配置。 使用模型工作台 ```mcfunction /give @p objanim:model_editor ``` 使用编辑器导入、修改和导出 OBJ 内容、纹理、UV 和网格。 添加自定义音效 将 `.ogg` 文件添加到 `customsound/`。 打开动画器。 选择音效。 预览它。 将其分配给活动或关键帧。🧩 模组开发者文档 — 依赖与模型 API
OBJAnim 也可作为其他模组的框架使用。 依赖示例 `mods.toml` 配置示例: ```toml [[dependencies.yourmod]] modId="objanim" type="required" versionRange="[0.2.0,)" ordering="NONE" side="CLIENT" ``` 如需可选集成,请使用: ```toml type="optional" ``` ModModelAPI 加载模型: ```java OBJModel model = ModModelAPI.loadModel("entity/sheep_custom"); ``` 列出实体模型: ```java var lists = ModModelAPI.listModels(ModModelRegistry.ModelCategory.ENTITY); ``` 搜索模型: ```java var dragons = ModModelAPI.findModels("dragon"); ``` 预加载模型: ```java ModModelAPI.preloadModel("entity/sheep_custom"); ``` 可能的用途包括: 自定义渲染器 自动加载模型 大型模型库 预加载常用内容🧩 模组开发者文档 — 注册表、实体状态与物品显示 API
ModModelRegistry ```java ModModelRegistry registry = ModModelRegistry.getInstance(); registry.initialize();var meta = registry.getModelMetadata("entity/sheep_custom"); OBJModel model = registry.getModel("entity/sheep_custom");
该注册表可用于较低层级的模型元数据处理与缓存管理。
OBJEntityManager
```java
OBJEntityData data = OBJEntityManager.getOrCreate(entity);
OBJModel current = data.getCurrentModel();
String activity = data.getCurrentActivity();
int tick = data.getAnimationTick();
可能的用途: 读取当前动画状态 触发粒子 基于上下文的效果 响应实体活动 ItemDisplayAPI
String path = ItemDisplayAPI.getObjModelPath(stack);
if (path != null) {
OBJModel model = ModModelAPI.loadModel(path);
}
可能的用途: 自定义物品渲染器 一致的 OBJ 模型加载 将导入的物品模型与其他渲染器集成
🧑💻 开发者命令与最佳实践
开发命令 ```text /objanim reload /objanim apply /objanim apply-all ``` 这些命令对迭代导入内容的美术和开发者很有用。 最佳实践 当 OBJAnim 并非必需时,使用可选依赖加载。 遵循 OBJAnim 导入文件夹结构。 在需要时于适当的客户端线程加载模型。 当能改善运行时行为时,预加载大型模型集合。 保持模型和纹理尺寸适合目标硬件。 在部署到更大的多人环境之前,测试复杂的动画场景。✔ 兼容性与要求
当前项目目标 Minecraft:1.21.x 主要发布版本:Minecraft 1.21.1 加载器:NeoForge 环境:支持客户端与服务端 编辑器 / GUI:客户端界面 首次启动 安装后,启动 Minecraft 一次,以便 OBJAnim 创建其配置和导入文件夹。 多人游戏 在已正确安装所需模组配置的多人环境中,该模组可以使用。 编辑器和 GUI 功能主要在客户端操作。▶️ 额外的 OBJAnim 视频
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。