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
