IG: Magnet, Let me get that!

🧲 磁铁（让我拿到它！）

“只要你能看见，就该归你所有。纯粹的磁力吸附，听你号令。”

[!NOTE]

1 个 Jar 对应 1 个版本政策： 我为每个 Minecraft 版本构建 1 个专用 JAR（例如 MC 26.2、MC 26.3）。请下载与你的 Minecraft 安装版本完全匹配的构建。

必需依赖： Fabric API + Dasik Library >=1.11.0

厌倦了看着挖到的钻石掉进岩浆？厌倦了为了捡回散落的生物掉落物而在水流中游泳或在土堆里挖掘？

磁铁（让我拿到它！） 赋予玩家内在的磁力吸引——一个无缝、可配置的真空场，将地面物品和经验球直接吸向你。无需装备饰品，无需充电，没有物品栏限制。纯粹、轻松的便利。

属于 即时满足合集 —— 尊重你时间的模组。

---

✨ 特性

🧲 内在真空场

平滑吸附，将掉落物品直接拉向玩家

穿墙模式：物品穿过固体方块和墙壁到达你身边

• 无需装备 —— 磁力是玩家的固有能力。让你的副手空出来拿盾牌、火把和武器。
• 相位转移（穿墙） —— 启用穿墙（默认：开启）后，物品直接滑过固体地形进入你的物品栏。不再有物品卡在树后或楼梯下。
• 视线（LOS）物理 —— 默认情况下，磁力遵循视线。固体地牢墙后的物品保持不动，直到你探索并看到它们。
• 平滑加速 —— 物品以可配置的速度和加速度曲线向你加速，而不是瞬间吸附。
• 经验球真空 —— 经验球遵循同样的磁力吸引（默认：开启）。Boss 战和农场收获后零经验损失。

🎮 个人玩家开关与按键绑定

• 按键绑定：在游戏中按 \（反斜杠）（可在控制菜单中重新绑定）即时切换你的个人磁场开或关。
• 聊天命令：/magnet toggle 或 /ig_magnet toggle
• 持久状态：你的个人开关保存在玩家数据中，在死亡、维度切换和服务器重启后依然有效。
• 动作栏反馈：切换时会显示简洁的 HUD 覆盖层，确认你的磁铁状态。

⚡ 即时传送拾取模式

启用 ig:magnet_instant true 以完全跳过飞行动画——物品进入你的磁力半径的瞬间直接传送到你的物品栏。

✨ 装饰性粒子轨迹与卡顿防护

粒子轨迹追踪被磁化物品的飞行路径

粒子轨迹追踪被磁化战利品的飞行路径（默认：每个物品每 tick 1 个粒子，最多 5 个同时粒子源）。粒子数量和最大源数均可通过 GameRule 调整，以防止繁忙服务器卡顿。

🔍 高级视线配置

微调哪些方块会阻挡视线射线检测：

| 设置 | 默认 | 描述 |
| :— | :—: | :— |
| ig:magnet_los_only | true | 需要视线才能吸引物品 |
| ig:magnet_keep_moving_if_unseen | true | 如果视线在飞行中途中断，物品保持动量 |
| ig:magnet_blocked_by_transparent | false | 玻璃和透明方块阻挡视线 |
| ig:magnet_blocked_by_flora | false | 草和花阻挡视线 |
| ig:magnet_blocked_by_block_entities | false | 箱子和方块实体阻挡视线 |

---

🎮 GameRule 参考

在游戏内使用 /gamerule <key> <value> 配置磁铁。无需重启服务器。

| 游戏规则键 | 类型 | 默认值 | 描述 |
| :— | :—: | :—: | :— |
| ig:magnet_enabled | Boolean | true | 整个服务器的总开关 |
| ig:magnet_range | Integer | 12 | 磁铁吸引物品的方块半径 |
| ig:magnet_noclip | Boolean | true | 物品穿过固体方块 |
| ig:magnet_affects_xp | Boolean | true | 同时吸引经验球 |
| ig:magnet_instant | Boolean | false | 瞬间传送拾取（跳过飞行动画） |
| ig:magnet_speed | Integer | 80 | 物品飞向玩家的速度 |
| ig:magnet_acceleration | Integer | 10 | 物品达到最大速度的快慢 |
| ig:magnet_particles | Boolean | true | 在磁化物品上显示粒子轨迹 |
| ig:magnet_particle_count | Integer | 1 | 每个物品每 tick 生成的粒子数 |
| ig:magnet_max_particle_sources | Integer | 5 | 同时存在的最大粒子源数量（防卡顿保护） |
| ig:magnet_los_only | Boolean | true | 需要视线才能吸引物品 |
| ig:magnet_keep_moving_if_unseen | Boolean | true | 视线中断时物品保留动量 |
| ig:magnet_blocked_by_transparent | Boolean | false | 透明方块阻挡视线 |
| ig:magnet_blocked_by_flora | Boolean | false | 草和花阻挡视线 |
| ig:magnet_blocked_by_block_entities | Boolean | false | 方块实体阻挡视线 |

---

📦 安装

1. 安装 Fabric Loader 和 Fabric API。
2. 安装 Dasik Library >=1.11.0（必需的前置库）。
3. 将 ig_magnet-x.y.z+<version>.jar 放入你的 mods/ 文件夹并启动。
4. 磁铁对所有玩家默认开启。每位玩家可以用 \ 或 /magnet toggle 切换自己的个人状态。

命令

| 命令 | 描述 |
| :— | :— |
| /magnet toggle | 开启或关闭你的个人磁铁 |
| /magnet debug | 显示调试信息：范围、视线状态、附近物品 |
| /magnet debug log | 切换是否将详细调试日志写入 logs/ig_magnet_debug.log |
| /ig_magnet toggle | /magnet toggle 的别名 |

多人游戏说明

• 每位玩家的开关是独立的——你的磁铁状态不会影响他人。
• 服务器管理员通过游戏规则控制全局范围、速度、视线和经验吸引。
• 配置存储在 config/ig_magnet.json 中。安装 ModMenu + YetAnotherConfigLib 以获得游戏内 GUI。

---

🤝 推荐姊妹模组

• 🔵 Item Clumps——将散落的地面物品压缩成大堆叠，在磁铁吸走它们之前消除实体 tick 卡顿。
• ⛏️ Ore Amplifier——倍增矿脉产量，让你的挖矿之旅收获满满。
• 📦 Stack Size Adjuster——调整物品栏槽位上限，让你在吸取掉落物时物品栏永远不会满。

---

🤝 支持与社区

我是一名独立单人开发者，制作尊重你时间的轻量级原版增强模组。如果 Magnet 拯救了你的战利品，欢迎支持未来的开发：

[!TIP]

🇮🇩 印度尼西亚的支持者可以通过 Saweria 或 SocioBuzz 使用 GoPay、OVO、Dana、QRIS 或 LinkAja！

加入我的官方 Discord 社区，获取实时开发动态、抢先测试版本和支持：

• 💬 Discord： https://discord.gg/EV99bgAFqb

---

🗒️ 元数据与权限

| 属性 | 值 |
| :— | :— |
| 模组名称 | Magnet, Let me get that! |
| 命名空间 / 模组 ID | ig_magnet |
| 许可证 | GNU General Public License v3.0 (GPLv3) |
| 端安全 | 服务端与客户端 |
| 必需前置 | Dasik Library >=1.11.0 |
| 可选 | ModMenu、YetAnotherConfigLib（游戏内 GUI） |
| 源代码 | GitHub 仓库 |
| 问题追踪 | GitHub Issues |

[!IMPORTANT]

📦 整合包权限： 欢迎将此模组加入任何整合包！模组文件必须通过 Modrinth 或 CurseForge 直接下载。严禁将 JAR 重新上传或分发到第三方网站。

🔑 许可证与分支指南： 以 GNU GPLv3 开源。欢迎创建分支并进行真正的修改——但请保持你的项目以 GPLv3 开源并注明出处。禁止零改动重新上传。

---