✨ 3DItems

3DItems 是一款 Minecraft 插件，它可以将掉落在地上的物品以 3D 模型的形式展示，从而增强视觉效果。它不依赖任何其他插件，且默认情况下不会改变原有的物品机制，也不会干扰游戏玩法，同时避免了复制漏洞。

⚙️ 工作原理

该插件通过将物品伪装成盔甲架来展示 3D 物品。这些盔甲架仅存在于客户端，因此不会对服务器性能造成太大影响，也不会改变物品本身的任何机制（除非启用了配置中的“manual-pickup”参数）。物品的物理特性（例如掉落和水流）、与方块的交互（例如漏斗）以及与实体（例如生物和玩家）的交互均不受影响。

盔甲架完全通过客户端数据包实现，因此它们实际上并不存在于服务器上，也不可能出现复制漏洞。盔甲架的位置会根据其相对于物品实际位置的偏移量进行调整，以便在物品的真实位置显示 3D 模型。

这些盔甲架不会干扰任何游戏玩法，玩家无法右键单击或左键单击它们（可选）。盔甲架也不会阻止玩家放置方块。

⌨️ 命令

• /itemsreload - 重载配置文件。
• /toggle3ditems - 切换玩家的 3D 物品效果。

🔑 权限

• 3ditems.command.reload - 使用 /itemsreload 命令的权限。
• 3ditems.command.toggle - 使用 /toggle3ditems 命令的权限。
• 3ditems.bypass - 禁用拥有此权限的玩家的 3D 效果。注意：必须在配置文件中将 use-bypass-permission 选项设置为 true 才能生效。
• 3ditems.pickup.right - 通过右键单击拾取物品的权限 (仅当 "use-manual-pickup" 启用时)。
• 3ditems.pickup.left - 通过左键单击拾取物品的权限 (仅当 "use-manual-pickup" 启用时)。
• 3ditems.pickup.normal - 正常拾取物品的权限 (站在物品上) (仅当 "use-manual-pickup" 启用时)。

🛠️ 配置

#Use /itemsreload for changes to take effect

#Should this plugin change the appearance of items?
enabled: true


#Max amount of items that can be be visible as 3D
max-visible-items: 20

#When enabled, players that have the permission 3ditems.bypass will see items normally
use-bypass-permission: false

#Item appearances will not be changed in these worlds
disabled-worlds:
    - world1
    - world2

#Smooth animation for when items spawn
use-smooth-landing: true

#When enabled, items will be luminescent which will prevent items from becoming dark
luminescent-items: false

#WARNING: This option changes the picking up mechanics of items!!!!!
#When enabled, players will need to have the following permissions to pick up items:
# 3ditems.pickup.right  - permission to pickup items by right-clicking them
# 3ditems.pickup.left   - permission to pickup items by left-clicking them
# 3ditems.pickup.normal - permission to pickup items normally (standing on them)
use-manual-pickup: false

🐛 已知问题

• 水中的 3D 物品可能会出现“跳跃”现象，然后才会恢复到原位。这是因为物品正在被“刷新”，这会重置盔甲架的偏移量。
• 武器和工具在被扔到墙角时可能会“变暗”（可以通过在配置中启用 luminescent-items 来解决）。

注意：某些物品的朝向可能不正确。这些问题将在后续版本中修复。

该插件可能不适用于通过 ViaVersion 加入的 1.16 之前的版本的玩家。