[MD]
# 吸铁石 XiTieShi 1.3.3 更新日志
本次更新整合了自 1.2.0 起加入的全部功能与体验优化。磁力系统现在拥有清晰的等级成长、副手自动吸附、完整的动画反馈和更严谨的交互保护，建议从旧版直接升级至 1.3.3。
## 磁力等级与成长
- 新增四种磁力附魔书：磁力 I、磁力 II、磁力 III、磁力 X。
- 磁力 I 仅可使用小吸力。
- 磁力 II 可使用小、中吸力。
- 磁力 III 可使用小、中、大吸力。
- 磁力 X 可使用全部普通吸力，并解锁独立大马力。
- 铁砧支持使用更高级磁力附魔书继续升级已有吸铁石，低级附魔书不会覆盖高级磁力。
- 管理员可使用 `/xitieshi givebook <I|II|III|X> [玩家] [数量]` 发放指定等级的附魔书。
## 操作与副手体验
- 手持吸铁石右键，按当前档位吸取附近掉落物。
- 潜行左键循环切换当前磁力等级允许的小、中、大吸力。
- 磁力 X 可潜行右键独立开关大马力；关闭后恢复此前选择的普通档位。
- 吸铁石放入副手后立即自动持续吸附，无需权限或手动开启。
- 副手自动吸附优先于主手持续模式，同一玩家不会重复扫描掉落物。
- 吸铁石无论位于主手还是副手，都不能作为磁石方块放置。
- 放置被阻止后会同步背包以避免客户端残影，提示带有限频且不会影响普通方块或其他物品的正常交互。
## 动画与声音反馈
- 新增随磁力等级增强的铁砧附魔动画。
- 新增小、中、大档位各自的切换磁环。
- 新增大马力开启扩张与关闭收束动画。
- 新增主动扫描、吸取启动、掉落物飞行轨迹和抵达反馈。
- 新增副手启动动画与低频环绕光点。
- 优化高掉落物场景的粒子刷新频率，减少持续吸附造成的视觉和性能负担。
## 配置与性能
- 新增 `visual.animations-enabled`，用于统一开关粒子动画。
- 新增 `visual.sounds-enabled`，用于统一开关插件音效。
- 新增 `visual.particle-density`，支持低、标准、高三级粒子密度。
- 小、中、大吸力和大马力的范围、基础速度、距离加速与最大速度均可独立配置。
- 配置可通过 `/xitieshi reload` 重新加载并实时应用。
- 保留已加载区块限制、单次物品上限、区块扫描上限及大范围搜索冷却，避免持续吸附造成过高负载。
## 兼容与修复
- 旧版无等级数据的吸铁石自动迁移为磁力 X，保留原有全部能力和大马力状态。
- 旧版磁力附魔书按磁力 I 兼容。
- 所有等级限制会在运行时再次校验，异常或旧版档位数据不能绕过等级限制。
- 修复副手自动吸附与主手持续模式同时启用时可能出现的重复扫描与重复启动反馈。
## 升级说明
1. 关闭服务器。
2. 使用 `xitieshi-1.3.3.jar` 替换旧版插件文件。
3. 启动服务器，让插件加载新增配置项。
4. 如需调整动画强度或吸力参数，修改配置后执行 `/xitieshi reload`。
现有吸铁石与附魔书无需重新制作。
[/MD]
