MagneticItems - 磁力物品

💡简介

MagneticItems 是一款能让掉落物像经验球一样被玩家吸引的插件。物品离你越远，移动越慢；离你越近，移动越快（此行为完全可配置）。这是我的第一个插件，如有任何问题或功能请求，请通过 GitHub 发送消息或提交问题报告，我会尽快处理。

本插件目前支持 Minecraft 1.13 至 1.16.x 版本。

🔧功能示例

以下为演示视频，请注意所有效果均可自定义，视频中采用默认配置（“排斥”示例除外，其 reverse 参数设置为 true）。

• 最常见情况：物品被玩家吸引。
• 方块遮挡：如果物品与玩家之间有不可通过的方块，则不会被吸引。
• 冰面效果：在冰上正常工作（可配置）。
• 水中效果：在水中同样有效（可配置）。
• 反向排斥：物品会被玩家推开。

✨主要特性

• 完全可配置：可调整吸引强度、作用半径、速度变化曲线（无论远近是否保持匀速）、急转弯平滑度（例如在冰面上）。
• 易于使用：可通过命令或配置文件管理所有设置（配置文件内附有详细参数说明）。另设两条权限，分别用于执行命令和启用吸引/排斥功能。
• 智能遮挡检测：如果物品与玩家之间存在不可通过的方块（花、草丛、草等为可通过方块），物品将不会被吸引。

🎮命令列表

目前提供以下命令，如需添加新命令，请提出请求。

• /magneticitems reload

重载配置文件并应用所有设置。

• /magneticitems set <parameter> <value>

更改配置文件中的参数并立即生效。支持标签补全，方便快速管理设置。

⭐配置说明

magnetism:
  # 注意：所有数值均支持浮点数，例如半径设为 7.5 或强度设为 1.125 均可。
  # 改变玩家对物品的吸引力，此设置不改变作用半径，请查看 radius 参数。（默认值：1）
  strength: 1

  # 切换磁力方向（物品将被玩家排斥）
  reverse: false

  # 玩家周围球形区域半径，位于此区域内的物品将被吸引。（默认值：7）
  radius: 7

  # 此参数根据物品与玩家的距离改变其加速度曲线，但请注意，它不改变物品的最终速度，最终速度由 strength 控制。
  # 该值越接近 0，加速度曲线越平缓（设为 0 时物品始终匀速运动）；若设为较高值（例如 100），
  # 物品在远处移动缓慢，接近时急速加速。（默认值：25）
  acceleration: 25

  # 物品的最小速度，防止其在最大作用距离处停止。这是一个相对值，与方块距离无关。（默认值：2）
  minimum_speed: 2

  # 如果物品的运动方向与玩家相反（例如在冰面上被抛出），这些设置允许你调整其“回转”的力度。
  # 默认值较为平滑，但你可以通过增加数值使其急转弯。（数值越小，物品越保持原有惯性）
  # 针对不同“特殊”方块设有独立值，例如可单独调整物品在水中的表现。
  smoothness:
    # 水中（默认：0.35）
    water: 0.35
    # 冰类方块，包括冰、浮冰和蓝冰（默认：2）
    ice: 2
    # 其他所有方块（默认：0.2）
    other: 0.2

aesthetic:
  # 选择在使用 /magneticitems 命令时显示短前缀 [MI] 还是长前缀 [MagneticItems]。（默认：long）
  prefix_type: long

❓权限节点

目前仅有 2 条权限，如需更多请提出。

• magneticitems.manage

允许使用 /magneticitems <set | reload> 命令及其子命令来管理插件和重载配置，无需直接操作配置文件。

• magneticitems.use

允许吸引/排斥物品。如果用户没有此权限，物品将保持原版行为。

🔧未来计划

• 多语言支持
• 更好的插件图标
• 插件描述页的图形化展示

（当前图标来自 https://www.flaticon.com/free-icon/magnet_428162）