Cobblemon 过场动画

Cobblemon 过场动画

Cobblemon Cinematics 是一款适用于 Minecraft 1.21.1、NeoForge 和 Cobblemon 1.7.3 的客户端过场动画模组。它为训练家对战和徽章获取添加了程序化动画、动态摄像机以及音效，而不需要打包大型背景帧序列。

功能

• 训练家对战开场：当 Cobblemon 训练家对局开始时，播放受宝可梦启发的动画序列，包含高速背景、闪光、训练家名字以及动画 NPC 模型。
• 训练家精灵球动画：Cobblemon NPC 使用它们自己的 send_out 骨骼动画和精灵球物品挂载。其他训练家实体则使用兼容的回退动画。
• 对战摄像机：平滑地环绕双方场上的宝可梦，并在选择招式后将镜头聚焦于攻击方和目标的身上。
• 摄像机碰撞：使用 Minecraft 原生的摄像机碰撞检测来缩短摄像机距离，防止其穿入墙壁或方块中。
• 徽章获取过场动画：获得匹配物品时，播放程序生成的黄金背景、粒子、光环、实际徽章物品模型以及获取音效。
• 界面兼容性：当没有界面打开时，会暂停游戏并打开专用界面。如果已有其他界面打开，过场动画将在其上渲染，而不会阻止其交互。
• 可选模组兼容性：不依赖特定的徽章模组。默认配置可识别 Badge Box 和 Cobblemon Pokemon Badges 的物品，也能匹配自定义整合包中的物品。

所有背景、速度线、光束、粒子、光环和闪光均由代码实时绘制。该模组不包含参考模组中的背景图像或徽章纹理。

需求

必需：

• Minecraft 1.21.1
• NeoForge 21.1.x
• Kotlin for Forge 5.12+
• Cobblemon 1.7.3

Badge Box 和 Cobblemon Pokemon Badges 都是可选的。如果安装了它们，其物品会通过默认物品匹配规则被识别，无需 API 集成或加载器依赖。

配置

客户端配置文件保存在 config/cobblemoncinematics-client.toml。

选项	默认值	描述
battleIntros	true	启用训练家对战开场动画
delayBattleIntroSounds	true	延迟放出宝可梦和叫声，直到开场动画结束
battleCamera	true	启用动态对战摄像机
attackCamera	true	选择动作后聚焦于攻击方和目标的身上
badgeCinematics	true	启用徽章获取过场动画
badgeOncePerType	true	每种徽章类型只播放一次过场动画
badgeSound	true	播放徽章获取音效
badgeItemMatchers	见下文	定义哪些物品被视为徽章
obtainedBadgeIds	[]	存储已播放过一次过场动画的徽章 ID

徽章匹配规则

badgeItemMatchers 支持三种规则类型：

badgeItemMatchers = [
  "item:examplemod:league_badge",
  "regex:^examplemod:[a-z0-9_]+_badge$",
  "tag:examplemod:badges"
]

• item: 匹配一个精确的物品 ID。
• regex: 使用正则表达式匹配完整的 namespace:path ID。
• tag: 匹配指定物品标签中的任意物品。

NeoForge 会在规则更改后重新加载客户端配置。清除 obtainedBadgeIds 可以重新播放已显示过的徽章的过场动画。

操作

• V：在对战中临时启用或禁用动态摄像机。此按键可在 Minecraft 的控制设置中重新绑定。