AniMotion - 游戏内动画录制工具

简介

AniMotion 是一款让你无需任何 Mod 即可在游戏中轻松创建电影级镜头的插件。它通过一套可自定义的步骤系统来运作，你可以设置位置、移动速度和步骤间的延迟，整个过程无需使用命令或配置文件。

💡兼容性与警告

• 支持版本： 1.8.x 至 1.19.x
• 已知不兼容插件：
• MyCommand
• WorldGuard (在 Minecraft 1.19 及以上版本中存在兼容性问题，可能导致某些区域无法播放)
• 重要设置：为避免区块加载错误，请在 server.properties 文件中将 view-distance 设置为 16 或 32。

🎮主要功能

• 逐步创建电影镜头
• 自定义每个步骤的持续时间、速度和延迟
• 播放电影镜头（通过命令或 API）
• 自定义镜头平滑度（普通、轻度、平滑、深度）
• 将镜头保存为文件（.anm 格式）
• 用粒子效果显示路径轨迹
• 播放时可取消玩家命令（需权限 animotion.bypass.command 绕过）
• 可取消的镜头播放（需权限 animotion.cancel.<Animotion Name>）
• 跨世界复制和粘贴步骤（位置相对于你）
• 支持标题和副标题
• 提供 API 供开发者使用

🔧命令与权限

主权限节点：animotion.use

• /am help

显示帮助信息。

• /am edit <Animotion Name>

编辑一个镜头。

• 权限：animotion.edit

• /am list

显示所有已加载镜头的列表。

• /am delete <Animotion Name>

删除一个镜头。

• 权限：animotion.delete

• /am play <Animotion Name> [Player]

播放镜头给指定玩家。

• 权限：animotion.play
• 播放给所有玩家：/am play <Animotion Name> !

- 权限：`animotion.play.all`

• 从全体播放中排除特定玩家：/am play <Animotion Name> !玩家1,玩家2
• 播放给特定 WorldGuard 区域的所有玩家：/am play <Animotion Name> $region:<区域名称>

• /am stop [Player]

停止播放给玩家的镜头。

• 权限：animotion.stop + animotion.stop.player（用于停止特定玩家）

• /am [sub]title <message>

设置当前编辑步骤的标题或副标题（必须在编辑模式下使用）。

• 权限：animotion.edit

⭐API 接口

主要类：APath，代表一个由步骤组成的列表。

• 获取所有已加载镜头名称：

  AnimotionApi.getAnimotionNames()

• 获取特定镜头路径：

  AnimotionApi.getAnimotion(String animotionName)

• 注意：如果未找到，将返回 null。

• 播放镜头：

  APlay.playPath(Player player, APath path)

• 此函数返回镜头播放的总时长（以游戏刻为单位）。

• 停止玩家正在播放的镜头：

  APlay.stopPlayerAnimations(Player player)

API 特性说明

• 播放镜头时，玩家的游戏模式会自动设置为旁观者模式，并在播放结束后自动恢复。玩家的位置也会被还原。
• 支持 PlaceholderAPI：
• %animotion_is_playing%：如果玩家正在播放镜头则返回 "true"，否则返回 "false"。
• %animotion_name%：返回玩家正在播放的镜头名称，如果未播放则返回空字符串 ""。

✨未来计划

以下是正在或将要开发的功能

• 1.8.x 至 1.19.x 兼容性（自 1.0_b 版本已完成）
• 向所有玩家播放镜头（自 1.0_d 版本已完成）
• 使用粒子效果完整可视化路径
• 路径步骤 GUI（自 1.0_e 版本已完成）
• 默认平滑路径现已真正平滑（感谢 Korease）
• 步骤编辑器间的转场效果（增加更多延迟、药水效果、粒子效果等）

❓支持与反馈

• 如果你制作了关于本插件的视频，欢迎联系我！
• 如有任何漏洞或新功能建议，请在评论区留言、发起讨论或发送私信。请勿在评价区报告漏洞。
• 无论你是否喜欢这个插件，都欢迎留下评价告诉我原因！
• 请注意：你不得出售、重新发布或反编译此插件。