MojangLogoAnimation

MojangLogoAnimation

一款 Fabric 模组，可将启动画面上静态的 Mojang Studios 标志替换为流畅的逐帧动画。

前置依赖

| 前置库 | 必需 | 链接 |
|—|—|—|
| Fabric API | ✅ | Modrinth / CurseForge |
| Cloth Config | ✅ | Modrinth / CurseForge |
| 模组菜单 | ❌（可选） | Modrinth / CurseForge |

架构

本模组采用数据驱动的动画系统，并以清晰的职责划分为基础：

• ISplashScreenAnimationData — 定义动画元数据（帧数、时长、音效、纹理）的接口。实现此接口即可添加新的动画类型。
• FolderAnimationData — 一个record实现，用于根据textures/gui/title/{id}/解析纹理，并按照gui.title.{id}命名约定解析声音事件。
• AnimationPlayer — 封装所有动画状态（帧进度、音效播放、生命周期）。动画在守护线程上运行，并通过AtomicInteger/AtomicBoolean实现线程安全访问。
• SplashLoader — 动画数据注册表。由于启动画面会在资源加载期间渲染，因此动画会在客户端初始化期间预先注册。
• SplashOverlayMixin — 一个精简的 Mixin 层，将所有逻辑委托给AnimationPlayer。Mixin 本身不包含任何动画相关知识。

添加新动画只需：

1. 将帧纹理放入textures/gui/title/{id}/
2. 将音效放入sounds/gui/title/{id}.ogg
3. 注册到splashLoader.register(new FolderAnimationData("id", frameCount))

预览

AI 使用政策

此模组由 Claude Code 重构。