[MD]
**吸铁石 XiTieShi** 是一个围绕原版磁石扩展的小型 Paper 插件。它不会引入复杂系统，而是把 Minecraft 原本较少使用的“磁石”改造成真正有用的工具：玩家获得磁力附魔书后，可以在铁砧中把磁力附加到磁石上，从而得到可吸取掉落物的“吸铁石”。
玩家手持吸铁石右键，可以把附近掉落物聚拢到身边；潜行右键可以切换大马力模式，在更大范围内制造带粒子与音效的磁力漩涡。插件所有提示、物品名称、Lore、日志和命令反馈均为中文，开箱即用。
### 核心功能
- **原版友好**：基于原版磁石和铁砧流程，不破坏生存体验。
- **磁力附魔书**：管理员可发放专用附魔书，用于制作吸铁石。
- **普通吸取**：右键吸取身边小范围掉落物，适合日常捡矿、捡农作物。
- **大马力模式**：潜行右键切换，右键吸取 16 格范围内掉落物。
- **粒子与音效反馈**：吸取时有发光、粒子、音效，效果直观但不臃肿。
- **轻量运行**：无需数据库，无需额外配置，放入 plugins 目录即可使用。
- **全中文体验**：玩家提示、命令反馈、物品描述均为中文。
### 使用方法
1. 管理员使用命令发放磁力附魔书。
2. 玩家将“磁石”和“磁力附魔书”放入铁砧。
3. 消耗 3 级经验后获得“吸铁石”。
4. 手持吸铁石右键吸取附近掉落物。
5. 手持吸铁石潜行右键切换普通 / 大马力模式。
### 命令
| 命令 | 说明 | 权限 |
| --- | --- | --- |
| `/xitieshi givebook [玩家] [数量]` | 给予磁力附魔书 | `xitieshi.command.givebook` |
### 权限
| 权限 | 默认 | 说明 |
| --- | --- | --- |
| `xitieshi.command.givebook` | OP | 允许使用命令获取磁力附魔书 |
### 合成与玩法说明
- 材料：原版磁石 + 磁力附魔书
- 操作：在铁砧中合成
- 经验消耗：3 级
- 普通模式：右键吸取约 5×5 范围内的掉落物
- 大马力模式：潜行右键开启后，右键吸取 16 格范围内的掉落物
### 适用场景
- 生存服：减少玩家重复捡物品的疲劳感。
- 养老服：提升挖矿、砍树、农场收集体验。
- RPG / 轻魔法服：作为可控的功能型道具或活动奖励。
- 小型服务器：无需配置即可部署，维护成本低。
### 兼容性
- 服务端：Paper 及兼容 Paper API 的服务端
- API 版本：1.20
- Java：17+
> 建议优先在 Paper 1.20.4 以上环境使用。
### 安装方法
1. 下载插件 jar 文件。
2. 将 jar 放入服务器 `plugins` 文件夹。
3. 重启服务器。
4. 使用 `/xitieshi givebook [玩家] [数量]` 发放磁力附魔书。
[/MD]
