3DItems - 立体物品显示

3DItems 是一款轻量级插件，它可以将掉落在地上的物品以 3D 模型的形式展示出来，从而显著提升视觉效果。它完全在客户端处理，不会干扰游戏玩法，也无需任何前置插件。

💡工作原理

物品被伪装成手持该物品的盔甲架。由于盔甲架仅通过数据包发送给客户端，它们在服务器端并不真实存在，因此完全避免了复制漏洞的可能性。

• 物品的服务器端机制（如物理特性、与漏斗/生物的交互）默认保持不变。
• 盔甲架经过精细的位置校准，以确保 3D 模型精准呈现在物品的实际位置。
• 玩家无法与这些盔甲架互动（可配置），它们也不会阻挡玩家放置方块。

🎮命令与权限

命令

• /itemsreload – 重载插件配置文件。
• /toggle3ditems – 切换使用者自身的 3D 物品显示效果。

权限

• 3ditems.command.reload – 使用 /itemsreload 命令。
• 3ditems.command.toggle – 使用 /toggle3ditems 命令。
• 3ditems.bypass – 拥有此权限的玩家将看不到 3D 效果（需在配置中启用 use-bypass-permission）。
• 3ditems.pickup.right – 允许通过右键点击拾取物品（仅在启用 use-manual-pickup 时有效）。
• 3ditems.pickup.left – 允许通过左键点击拾取物品（仅在启用 use-manual-pickup 时有效）。
• 3ditems.pickup.normal – 允许通过正常站立接触拾取物品（仅在启用 use-manual-pickup 时有效）。

🔧配置说明

配置文件中的主要选项如下

# 是否启用插件功能？
enabled: true
# 同时可见的 3D 物品最大数量
max-visible-items: 20
# 是否启用 bypass 权限功能
use-bypass-permission: false
# 在这些世界中禁用 3D 效果
disabled-worlds:
- world1
- world2
# 物品生成时使用平滑落地动画
use-smooth-landing: true
# 使物品自发光，防止变暗
luminescent-items: false
# 警告：此选项会改变物品拾取机制！
# 启用后，玩家需要特定权限才能拾取物品
use-manual-pickup: false

使用 /itemsreload 可使配置更改生效。

❓已知问题与注意事项

已知显示问题

• 水中的 3D 物品可能会先“跳起”再落回，这是物品刷新重置盔甲架位置导致的。
• 丢在墙角的武器或工具可能会变暗（可在配置中启用 luminescent-items: true 来解决）。
• 部分物品的模型方向可能不正确，将在未来版本修复。

重要提示

• 该插件可能不兼容通过 ViaVersion 以 1.16 之前版本加入游戏的玩家。
• 启用 use-manual-pickup 会彻底改变物品拾取机制，请谨慎使用。