AnimatedFrames - 动态画框

AnimatedFrames 是一款允许你在物品展示框上播放动画的插件！如果你觉得它好用，欢迎通过捐赠支持开发者。

💡前置插件

• PacketListenerAPI
• MapManager

🎮命令列表

• /afhelp - 获取命令列表
• /afcreate - 创建一个指定名称的新图像
• /afremove - 移除指定的图像
• /aflist - 获取已创建图像的列表
• /afplace - 辅助放置多个物品展示框
• /afpause - 暂停正在播放的动画
• /afstop - 停止正在播放的动画（与暂停类似，但会重置到动画的第一帧）
• /afplay - 开始或恢复已停止/暂停的动画

✨权限节点

• animatedframes.create - 创建图像的权限
• animatedframes.remove - 移除图像的权限
• animatedframes.list - 列出图像的权限
• animatedframes.pause - 暂停动画的权限
• animatedframes.stop - 停止动画的权限
• animatedframes.play - 播放动画的权限

🔧配置说明

配置文件为 YAML 格式，主要选项如下

核心设置

• synchronizedStart: false
• 确保所有动画在服务器启动时同步开始（适用于同一图像用于多个展示框的情况）
• doNotStartAutomatically: false
• 启用后，服务器启动时不会自动播放任何动画，需要手动启动
• fixImageTypes: false
• 修复 Java 可能错误识别图像类型的问题。如果创建图像时遇到 java.lang.IllegalArgumentException: Unknown image type 0 错误，请启用此项
• maxAnimateDistance: 32
• 动画对玩家生效的最大距离。注意：增加此值仅在同时提高服务器实体渲染距离（如 spigot.yml 中的 entity-tracking-range）时才有效
• defaultDelay: 50
• 对于缺少延迟信息的 GIF，每帧显示的默认时间（单位：毫秒）

消息文本

插件内置了丰富的操作反馈消息，涵盖创建、设置、错误提示等场景，均支持颜色代码，可在配置文件中自定义。

❓使用教程

如何创建一个屏幕（动画展示）

• 放置用于承载物品展示框的方块。
• 在方块上放置你打算用于展示图像的所有物品展示框。
• 准备一张动画或静态图片（支持 .GIF 或 .PNG 格式），确保其为矩形，否则会被拉伸。
• 注意：由于某些 Java 版本的 Bug，JPEG 图片可能无法正常显示。
• 对于本地图片文件，只需指定完整路径（例如 C:\\Users\\Me\\myImage.png）。
• 对于在线图片，可以使用短链接服务（如 bitly）来处理过长的 URL。
• GIPHY 图片提示：将链接中的域名 media.giphy.com 替换为 i.giphy.com。
• 运行命令 /afcreate 。
• 根据聊天栏的提示完成设置：
• 右键点击左下角的物品展示框。
• 右键点击右上角的物品展示框，等待图像加载完成。

如何移除一个屏幕

运行命令 /afremove 并指定要移除的动画名称即可。

⭐工作原理与性能

本插件不会造成预期的卡顿或帧率下降问题。

• 它并非每帧都更新整个画面（那样会导致严重的帧率问题），而是只更新物品展示框内的地图物品。
• 动画的实际帧数据只会以一定的延迟发送一次，从而避免任何卡顿问题。

🎮相关链接

• 源码: GitHub
• 问题反馈: Issue Tracker
• 官网: 插件主页

如果你喜欢这个插件，请别忘了给它评分。我们也非常感激任何形式的捐赠来支持开发者或本项目的持续更新。