掉落物全息显示 Holograms on dropped items

掉落物全息显示 (Holograms on dropped items)

掉落物全息显示

在每一个掉落物品的上方，都会浮现出一个全息文本，清晰地显示物品名称及其数量！该插件与所有其他附加包兼容。从此，您无需凑近查看纹理，从远处即可准确识别掉落物！

功能列表

• 射线检测 (Raycasting)：全息图仅在您视线范围内的物品上显示！例如，位于方块后方或草地中的物品，只有当您处于可观察视角时才会显示全息图，有效减少视觉混乱。
• 两种操作模式：您可以选择仅在特定半径内的最近物品上显示全息图，或仅在您的准星所指向的物品上显示。
• 可编辑的全息文本模板：您可以自定义文本色彩、添加前缀或后缀、自行编写内容，甚至支持多行文本显示！
• 精细化调整：您可以设定全息图显示的距离上限、限制同屏显示全息图的物品数量、调整字体大小，以及进行更多深度设置。
• 多人游戏支持与强兼容性：完全支持多人联机，并兼容其他插件（无需修改 player.json）。
• 多语言翻译：内置多种语言支持，您也可以轻松将其翻译为您的语言。

安装步骤

下载行为包 (BP) 与资源包 (RP)，并将这两个包加载至您的 Minecraft 世界中。

• 请确保在世界设置中启用了“Beta API”实验性玩法。
• 插件仅支持 Minecraft 正式版本（不支持测试版或预览版）。

使用指南

将插件应用到您的世界后即可生效！进入世界后，插件将自动启动。

注意：插件启用后，仅对新产生的掉落物有效。在插件安装前已经掉落在地上的物品不会显示全息图。

射线检测：当玩家与物品之间有方块遮挡时，全息图将自动隐藏。 多人支持：该插件在多人联机环境下同样适用。

插件配置

输入指令：/function itemsHolograms_config 这将打开插件的设置菜单，您可以进行以下配置：

• 启用插件：无需离开世界即可开关插件功能。
• 缩小全息字体：开启后，全息图的字体大小会适当减小。
• 射线检测：若关闭，全息图将穿透方块显示，即使物品在障碍物后方也能看到。
• 显示范围逻辑：您可以选择“最近的物品”模式或“准星所指”模式。

在“最近的物品”模式下：全息图显示在一定半径内的物品上。若开启了射线检测，插件会先检查物品的可见性。 可用选项：

• 限制显示全息图的物品数量：您可以输入整数，默认为 10。输入 0 为不限制（不推荐）。
• 全息显示最大距离：默认为 12，建议上限设为 50。

在“准星所指”模式下：全息图仅在准星指向时显示。此模式下射线检测功能无效。 可用选项：

• 掉落后短暂显示：开启后，物品掉落后的最初几秒内会自动显示全息图，即使未瞄准。之后全息图会消失，直到您再次瞄准它。

更改全息格式

输入指令：/function itemsHolograms_config，并滚动至菜单底部。

您可以在此处根据喜好修改显示模板。 该模板仅受字符数量限制（最多 100 字符），您可以尽情发挥想象力！

常见问题解答

问：该插件能在领域服 (Realms) 中运行吗？ 答：可以。请先下载领域服的世界存档，在本地开启必要的实验性设置，添加此插件，然后再将其上传回领域服。若仍无法运行，则可能是领域服自身存在的漏洞。

问：在多人游戏中，即使在“准星所指”模式下，全息图对所有玩家都可见！ 答：这是一个已知的问题，目前尚无法修复。

问：插件无法正常工作怎么办？ 答：请依次检查以下步骤：

1. 确保您的 Minecraft 版本类型为“正式版”（非测试版或预览版），且版本号符合要求。
2. 确保在世界设置中启用了上述 checklist 中的所有实验性功能。若在服务器上运行，请检查服务器控制面板。若无法操作，建议下载世界存档至本地，开启功能后再重新上传。
3. 确保世界设置中，“行为包”和“资源包”都仅激活了一个版本的插件，避免存在重复或旧版本。若同时存在冲突，插件将失效。这同样适用于服务器环境。

问：插件在单机模式下正常，但服务器不工作！ 答：请参考上一点，确保所有配置步骤无误。如果您使用 Aternos 等托管服务，请尝试“关闭再开启”实验性开关，有时首轮激活可能不成功。同时，确保您的托管主机支持插件脚本执行（Beta APIs）。