{"url":"https://levimc.org/mods/github.com/MRUIAW/Animated-Mojang/","id":"github.com/MRUIAW/Animated-Mojang","name":"Animated Mojang","description":"Animated Minecraft title, 3D cave background and menu camera transitions for Bedrock 1.26.51.01 / LeviLamina 26.51.6 client.","owner":"MRUIAW","logo":"https://github.com/MRUIAW.png","repository":"https://github.com/MRUIAW/Animated-Mojang","issues":"https://github.com/MRUIAW/Animated-Mojang/issues","releases":"https://github.com/MRUIAW/Animated-Mojang/releases","stars":10,"downloads":341,"updated":"2026-10-04T14:12:02Z","published":"2026-10-04T14:12:02Z","created":"2026-10-02T02:10:38Z","license":"LGPL-3.0","side":["client"],"platform":["win-x64"],"gameVersions":["1.26.51"],"tags":["platform:levilamina","type:mod","platform:client"],"latest":{"variant":"client","version":"1.0.0-mc26.51","install":"lip install github.com/MRUIAW/Animated-Mojang#client@1.0.0-mc26.51"},"readmes":[{"file":"README.md","lang":"en","text":"# Animated Mojang\n\n[![简体中文](https://img.shields.io/badge/README-%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87-blue)](README.zh-CN.md)\n[![Release](https://img.shields.io/github/v/release/MRUIAW/Animated-Mojang)](https://github.com/MRUIAW/Animated-Mojang/releases/latest)\n\nA LeviLamina client mod that brings an animated Minecraft title, a 3D cave background, and camera transitions to Minecraft Bedrock Edition. Inspired by [chara2015/animated_mojang](https://github.com/chara2015/animated_mojang); the startup and menu integration are implemented for Bedrock.\n\n## Compatibility\n\n| Component | Supported version |\n| --- | --- |\n| Minecraft Bedrock for Windows | 1.26.51.01 |\n| LeviLamina | 26.51.6, client variant |\n| Platform | Windows x64 |\n| Mod | 1.0.0-mc26.51 |\n\nThe `-mc26.51` suffix identifies the compatible Minecraft version family, following Playback's version convention. The feature version is 1.0.0. This is a client mod; other game or loader versions have not been verified.\n\n## Features\n\n- A 3D cave with baked colored lighting, animated flowing lava, wall-mounted soul torches, and flame/smoke particles.\n- A flight from a loading-screen image into the cave, synchronized with the title animation and menu fade. Press **Esc** to skip.\n- Camera views and transitions for the main menu, world list, settings, dressing room, Realms, and Marketplace.\n- Resource preloading and reused scene buffers. After a rendering stall, animations resume without jumping over the entire stalled interval.\n- The game's built-in JSON main menu is selected by default for title and control animations. No separate resource pack activation is required.\n\n## Installation\n\nClose the game before installing or updating.\n\n### Using lip\n\nRun this in the game installation directory managed by LeviLamina/lip:\n\n```powershell\nlip install \"github.com/MRUIAW/Animated-Mojang#client@1.0.0-mc26.51\"\n```\n\nThe client dependency is declared in [tooth.json](https://github.com/MRUIAW/Animated-Mojang/blob/main/tooth.json). You can also install the client variant through LeviLauncher when the package is listed.\n\n### Manual installation\n\n1. Download **Animated-Mojang-client-windows-x64.zip** from the [latest release](https://github.com/MRUIAW/Animated-Mojang/releases/latest).\n2. Extract the **AnimatedMojang** folder into the game's **mods** directory.\n3. Start the game with LeviLamina.\n\nWhen updating manually, keep your existing **mods/AnimatedMojang/config/config.json**. The lip manifest marks that file for preservation; back up custom settings before updating.\n\n## Configuration\n\nEdit **mods/AnimatedMojang/config/config.json** and restart the game. The configuration schema version is **4**; it is independent of the mod release version.\n\n| Option | Default | Behavior |\n| --- | --- | --- |\n| enabled | true | Enable the mod |\n| preferJsonMainMenu | true | Use the built-in JSON main menu |\n| minecraftTitleAnimation | true | Play the title and shared intro; disabling it opens the menu directly |\n| caveBackground | true | Show the 3D cave and intro loading image |\n| restyleLoadingProgress | true | Recolor matching JSON progress bars before the first main menu |\n| replayOnReturnToMenu | false | Request intro replay when returning to the main menu |\n| blockMenuInputDuringIntro | true | Block menu button presses before the menu is revealed |\n| maxPresentationSeconds | 15 | Resource/presentation timeout; clamped to 5–60 seconds |\n| debugScreens | false | Log JSON screen names when explicitly enabled |\n| menuScreenNames | start_screen | JSON main-menu recognition list |\n| titleControlNames | minecraft_title, title_image, logo | Candidate original title controls |\n\nRoutine resource, camera, frame-gap and periodic performance diagnostics are removed from the release. Normal logging is limited to the version message and actionable warnings/errors.\n\n## Known limitations\n\n- Native UI loading can still stall the game. Animations cannot display new frames while the game stops rendering.\n- Lighting is baked, with CPU projection and ordering plus extra clipping for lava intersections; there is no full-scene GPU depth buffer or dynamic fragment lighting.\n- Some thin block models are simplified. Glass, cobwebs, grass/flowers, and wall signs are not drawn. A flattened lava strip and some stone texture borders remain possible visual issues.\n- The loading image contains a static progress bar. The earliest native loading screen is not fully replaced; a dark background is used until its texture is ready.\n- Title/control animation for the native OreUI main menu, dedicated world connection/exit camera flows, and an in-game mod settings page are not implemented.\n- Paper-doll fading, controller/touch input, world entry/exit, and additional display modes need further in-game verification.\n\n## Building\n\nRequires the Visual Studio C++ toolchain, Windows SDK, LLVM clang-cl, xmake, Node.js, and PowerShell. LeviLamina is pinned in xmake.lua.\n\n```powershell\nnode tools/fetch-assets.mjs --verify-only\nnode tools/build-cave-atlas.mjs --verify-only\nnode tools/build-cave.mjs --verify-only\nnode tools/build-cave-particles.mjs --verify-only\nnode tests/cave_builder_tests.mjs\nxmake f -y -p windows -a x64 -m release --target_type=client\nxmake -y AnimatedMojang TimelineTests CpuSceneTests CaveSceneTests CaveParticleTests CaveOcclusionTests CaveCameraTests\nxmake run TimelineTests\nxmake run CpuSceneTests\nxmake run CaveSceneTests\nxmake run CaveParticleTests\nxmake run CaveOcclusionTests\nxmake run CaveCameraTests\nnode tests/cave_camera_path_tests.mjs\n./tools/package-release.ps1\n```\n\nRun tools/fetch-assets.mjs without --verify-only to restore missing pinned upstream assets. The scene builders regenerate their respective derived files when run without that flag.\n\nBuild output is in **bin/AnimatedMojang**. Release ZIPs include runtime files, configuration, both READMEs, the changelog, and license/provenance notices. Development notes, source assets, tests, and debug symbols are excluded.\n\n## Maintenance and credits\n\nSee [AGENTS.md](https://github.com/MRUIAW/Animated-Mojang/blob/main/AGENTS.md) for architecture, coding rules, camera extension instructions, validation, and release procedures. The two foundational analyses in vibe_development are source-repository references only.\n\nSee [CHANGELOG.md](CHANGELOG.md), [NOTICE.md](NOTICE.md), and [LICENSE](LICENSE). The repository uses CC0 1.0; NOTICE describes upstream and game asset provenance. Minecraft and Mojang belong to their respective owners. This is an unofficial project.\n"},{"file":"README.zh-CN.md","lang":"zh-Hans","text":"# Animated Mojang\n\n[![English](https://img.shields.io/badge/README-English-blue)](README.md)\n[![Release](https://img.shields.io/github/v/release/MRUIAW/Animated-Mojang)](https://github.com/MRUIAW/Animated-Mojang/releases/latest)\n\n基于 LeviLamina 的客户端模组，为基岩版加入 Minecraft 标题动画、三维洞穴背景和菜单运镜。参考 [chara2015/animated_mojang](https://github.com/chara2015/animated_mojang) 的设计与素材，启动和菜单接入针对基岩版重新实现。\n\n## 兼容环境\n\n| 组件 | 支持版本 |\n| --- | --- |\n| Windows Minecraft 基岩版 | 1.26.51.01 |\n| LeviLamina | 26.51.6，客户端变体 |\n| 平台 | Windows x64 |\n| 模组 | 1.0.0-mc26.51 |\n\n沿用 Playback 的版本命名方式，`-mc26.51` 表示兼容的 Minecraft 版本系列，功能版本为 1.0.0。本模组仅用于客户端，其他游戏或加载器版本尚未验证。\n\n## 功能\n\n- 三维洞穴，包含烘焙彩色光照、动态流动岩浆、墙上灵魂火把，以及火焰和烟雾粒子。\n- 从加载界面图片飞入洞穴，与标题动画及菜单渐显同步；按 **Esc** 跳过。\n- 主菜单、世界列表、设置、更衣室、Realms 和市场各有相机视角及切换动画。\n- 预读资源、复用场景缓存；渲染卡顿后继续播放，避免直接跳过整个停顿区间。\n- 默认选择游戏内置 JSON 主菜单来实现标题和控件动画；无需额外启用资源包。\n\n## 安装\n\n安装或更新前请关闭游戏。\n\n### 使用 lip\n\n在由 LeviLamina/lip 管理的游戏安装目录执行：\n\n```powershell\nlip install \"github.com/MRUIAW/Animated-Mojang#client@1.0.0-mc26.51\"\n```\n\n客户端依赖已写入 [tooth.json](https://github.com/MRUIAW/Animated-Mojang/blob/main/tooth.json)。模组被收录后，也可通过 LeviLauncher 选择客户端变体安装。\n\n### 手动安装\n\n1. 从 [最新 Release](https://github.com/MRUIAW/Animated-Mojang/releases/latest) 下载 **Animated-Mojang-client-windows-x64.zip**。\n2. 解压，将 **AnimatedMojang** 文件夹放入游戏的 **mods** 目录。\n3. 通过 LeviLamina 启动游戏。\n\n手动更新时保留自己的 **mods/AnimatedMojang/config/config.json**。lip 清单已将该文件列入保留规则；更新前建议备份自定义配置。\n\n## 配置\n\n修改 **mods/AnimatedMojang/config/config.json** 后重启游戏。配置格式版本为 **4**，与模组发行版本独立。\n\n| 选项 | 默认值 | 行为 |\n| --- | --- | --- |\n| enabled | true | 启用模组 |\n| preferJsonMainMenu | true | 使用内置 JSON 主菜单 |\n| minecraftTitleAnimation | true | 播放标题和共享开场；关闭后直接进入菜单 |\n| caveBackground | true | 三维洞穴与开场加载图片 |\n| restyleLoadingProgress | true | 对首次菜单前匹配到的 JSON 进度条改色 |\n| replayOnReturnToMenu | false | 返回主菜单时请求重播开场 |\n| blockMenuInputDuringIntro | true | 菜单揭示前阻止按钮按下 |\n| maxPresentationSeconds | 15 | 资源等待和展示超时，限制在 5–60 秒 |\n| debugScreens | false | 手动开启后记录 JSON 页面名 |\n| menuScreenNames | start_screen | JSON 主菜单识别列表 |\n| titleControlNames | minecraft_title、title_image、logo | 原标题控件候选名称 |\n\n发行版已移除资源预读、运镜状态、帧间卡顿及周期性能诊断日志。默认仅输出版本加载信息和必要异常提示。\n\n## 已知限制\n\n- 原生 UI 加载仍可能让游戏停帧；游戏停止渲染时，运镜无法继续显示新画面。\n- 使用烘焙光照、CPU 投影与排序，并对岩浆交叠做额外裁切；尚无全场景 GPU 深度或动态片元光照。\n- 部分薄形状模型简化，玻璃、蛛网、草花和墙牌尚未绘制。岩浆斜面底部压扁条带与部分石头纹理边框仍可能存在。\n- 加载图片里的进度条是静态画面。最早的原生加载界面未完整接管，纹理未就绪时显示暗底。\n- 原生 OreUI 主菜单的标题与控件动画、连接及退出世界专用运镜、游戏内模组设置页面尚未实现。\n- 纸娃娃渐显、手柄和触屏、世界进出及更多显示模式仍需进一步游戏验证。\n\n## 构建\n\n需要 Visual Studio C++ 工具链、Windows SDK、LLVM clang-cl、xmake、Node.js 和 PowerShell。xmake.lua 已固定 LeviLamina 版本。\n\n```powershell\nnode tools/fetch-assets.mjs --verify-only\nnode tools/build-cave-atlas.mjs --verify-only\nnode tools/build-cave.mjs --verify-only\nnode tools/build-cave-particles.mjs --verify-only\nnode tests/cave_builder_tests.mjs\nxmake f -y -p windows -a x64 -m release --target_type=client\nxmake -y AnimatedMojang TimelineTests CpuSceneTests CaveSceneTests CaveParticleTests CaveOcclusionTests CaveCameraTests\nxmake run TimelineTests\nxmake run CpuSceneTests\nxmake run CaveSceneTests\nxmake run CaveParticleTests\nxmake run CaveOcclusionTests\nxmake run CaveCameraTests\nnode tests/cave_camera_path_tests.mjs\n./tools/package-release.ps1\n```\n\n不带 --verify-only 运行 tools/fetch-assets.mjs 可补回固定上游素材；各场景生成工具不带该参数时重新生成对应派生资源。\n\n构建产物在 **bin/AnimatedMojang**。安装包包含运行文件、配置、双语 README、更新记录和许可及来源说明，排除开发文档、素材源文件、测试和调试符号。\n\n## 维护与来源\n\n后续维护请阅读 [AGENTS.md](https://github.com/MRUIAW/Animated-Mojang/blob/main/AGENTS.md)，其中说明架构、编程规范、新增运镜、验证与发布步骤。vibe_development 中的两份基础分析仅作为源码仓库参考。\n\n更新记录见 [CHANGELOG.md](CHANGELOG.md)，素材来源见 [NOTICE.md](NOTICE.md)，许可见 [LICENSE](LICENSE)。仓库采用 CC0 1.0；上游及游戏素材来源在 NOTICE 中单独说明。Minecraft 和 Mojang 的名称、标识属于各自权利人，本项目为非官方模组。\n"}],"gallery":[],"versions":[{"version":"1.0.0-mc26.51","prerelease":false,"released":"2026-10-04T14:12:02Z","releaseUrl":"https://github.com/MRUIAW/Animated-Mojang/releases/tag/v1.0.0-mc26.51","manifestUrl":"https://github.com/MRUIAW/Animated-Mojang/blob/v1.0.0-mc26.51/tooth.json","info":{"name":"Animated Mojang","description":"Animated Minecraft title, 3D cave background and menu camera transitions for Bedrock 1.26.51.01 / LeviLamina 26.51.6 client.","tags":["platform:levilamina","type:mod","platform:client"],"logo":"https://github.com/MRUIAW.png"},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.51.6"}}]}},{"version":"0.0.0","prerelease":false,"releaseUrl":"https://github.com/MRUIAW/Animated-Mojang/releases","manifestUrl":"https://github.com/MRUIAW/Animated-Mojang/blob/v0.0.0/tooth.json","info":{"name":"Animated Mojang","description":"Animated Minecraft title, 3D cave background and menu camera transitions for Bedrock 1.26.51.01 / LeviLamina 26.51.6 client.","tags":["platform:levilamina","type:mod","platform:client"],"logo":"https://github.com/MRUIAW.png"},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.51.6"}}]}}],"dependencies":{"github.com/liteldev/levilamina":{"id":"github.com/LiteLDev/LeviLamina","name":"LeviLamina","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LeviLamina/"}},"requiredBy":[]}