InteractionVisualizer - 交互可视化动画

InteractionVisualizer 交互可视化插件

在 Minecraft 中，当你点击工作台并放入物品时，其他玩家并不知道你在做什么……难道我们不应该能看到物品在桌上按逻辑摆放吗？有了这个插件，你就可以实现！当玩家在 GUI 中操作时，你可以真实地看到物品被放置在工作台上，还有更多精彩功能！

💡关于插件

InteractionVisualizer 是一个客户端效果插件，它能在玩家与方块交互时，在服务器上显示视觉动画，而所有效果仅在客户端呈现，不会实际影响服务器世界。

✨功能特性

已实现可视化的方块与实体

• 工作台 & 合成器（仅朝上方向）
• 切石机
• 砂轮
• 铁砧
• 制图台
• 附魔台
• 熔炉、高炉与烟熏炉
• 营火与灵魂营火
• 酿造台
• 织布机
• 箱子、双箱与末影箱（包括陷阱变种）
• 潜影盒、木桶、投掷器、发射器与漏斗
• 信标与潮涌核心
• 唱片机
• 音符盒
• 蜂巢与蜂箱
• 讲台
• 刷怪笼
• 旗帜
• 物品
• 村民

核心特点

• 纯客户端效果：所有显示的方块和物品实际上并不存在于服务器上。
• 无法被干扰：它们不能被杀死或通过清除命令移除。
• 不影响世界：不会以任何方式改变游戏世界。
• 高度可定制：每个方块的显示效果都可以在配置文件中单独禁用。
• 玩家个人设置：玩家可以为自己切换一些显示选项。
• 多语言支持：部分悬浮文本会自动使用每位玩家客户端的语言显示。

数据存储

• 玩家切换数据可以保存在 SQLite（默认）或 MySQL 数据库中。

🎮依赖需求

必需依赖

• ProtocolLib（仅限 1.12.2 或更低版本）
• 请安装与你的服务器版本兼容的最新版本。

• LightAPI Fork（仅限 1.16.5 或更低版本）
• 请注意，这是 Fork 版本，不要与原始的 LightAPI 混淆。

兼容插件

当玩家处于隐身状态时，以下插件会禁用相关动画

• OpenInv（开启静默箱子时，箱子动画将被禁用）
• SuperVanish & PremiumVanish
• CMI
• Essentials

🔧安装步骤

• 将 InteractionVisualizer.jar 和所有必需的依赖放入服务器的 plugins 文件夹。
• 启动服务器。
• 根据需要编辑配置文件。
• 重启服务器以使配置更改生效。

重要提示：如果你在配置中禁用了任何方块或实体，必须重启服务器才能看到变化。

❓常见问题

`/iv toggle` 命令如何工作？

该命令有三种模式，用于启用或禁用显示效果所使用的特定机制：

• itemstand：指所有使用盔甲架创建的视觉物品（平铺在方块上，不像普通掉落物那样漂浮）以及物品展示框（例如制图台上的地图）。
• itemdrop：指所有作为掉落物显示的视觉物品。
• hologram：指所有悬浮文字（例如熔炉进度条）。

用于 /iv toggle 的玩家数据保存在数据库中。

保存 `blockdata.json` 时出错怎么办？

这很可能是由于服务器未正常关闭导致的。无论原因如何，你都可以进入 InteractionVisualizer 插件文件夹，用 backup 文件夹中的备份文件替换 blockdata.json。

⭐命令与权限

命令列表

• /interactionvisualizer reload 或 /iv reload - 重载插件
• /interactionvisualizer refresh 或 /iv refresh - 为执行命令的玩家刷新所有物品显示
• /interactionvisualizer update 或 /iv update - 检查更新
• /interactionvisualizer toggle 或 /iv toggle - 切换显示选项

权限节点

• interactionvisualizer.reload - 允许重载插件 [默认：OP]
• interactionvisualizer.refresh - 允许刷新显示 [默认：true]
• interactionvisualizer.toggle - 允许切换模块 [默认：true]
• interactionvisualizer.toggle.others - 允许为他人切换模块 [默认：OP]
• interactionvisualizer.update - 允许接收更新消息 [默认：OP]

🎮附加功能

PlaceholderAPI 支持

安装 PlaceholderAPI 后，你可以使用以下占位符获取玩家的切换状态：

• %interactionvisualizer_itemstand_<entry>%
• %interactionvisualizer_itemdrop_<entry>%
• %interactionvisualizer_hologram_<entry>%

例如，如果玩家为工作台启用了“itemstand”模块，%interactionvisualizer_itemstand_crafting_table% 将返回“enabled”，如果禁用则返回“disabled”。

开发者 API

InteractionVisualizer 为开发者提供了创建附加组件的 API。详情请查阅 Wiki 页面：

https://github.com/LOOHP/InteractionVisualizer/wiki/Developer-API

配置文件

• 最新配置与说明：可在项目页面查看。
• 社区翻译配置：请查看语言仓库。

💡重要说明与限制

• 该插件在 Minecraft 1.10.2 或更低版本上可能无法工作。
• 开发者仅保证插件在最新版本的 Spigot 和 Paper 上能完美运行且功能完整。
• 对旧版本的支持是“尽力而为”，可能缺少某些功能或钩子，但通常应该可以工作。请像对待其他插件一样自行测试。
• 请勿在评论中报告问题，请通过 Discord（推荐）或讨论区提交。

链接与支持

• 语言文件仓库：https://github.com/LOOHP/InteractionVisualizerLanguages
• Discord 社区：欢迎加入以获取支持。
• 演示服务器：想试试插件效果吗？IP: mc.loohpjames.com
• 开发构建：可通过 Jenkins 获取。
• 考虑捐赠：这有助于开发者持续维护并保持插件免费。

服务器托管推荐

正在寻找地方托管你的 Minecraft 服务器？不妨试试 BisectHosting！使用专属链接可享受首月 25% 折扣，同时也能支持插件开发。

https://www.bisecthosting.com/loohp