🧲 MineShield Magnet
我注意到没有人制作免费的 MineShield 插件。
所以我决定制作一个大家真正想要的插件,它来自流行的 MineShield 4 Season 服务器的磁力插件。如果你有任何问题或发现错误,请在 Discord 频道中留言。
📖 简介
一款适用于 Paper 或 Spigot Minecraft 服务器的免费插件,添加了磁铁——世界中将物品、玩家和实体向其吸引的点。灵感来源于流行的 MineShield 4 Season 服务器。
✨ 主要功能
- 在任何位置创建磁铁,使用
/magnetset
- 从建筑结构自动生成本体(磁铁矿 + 铁栏杆 / 氧化铜格栅)
- 吸引或排斥物品、玩家、矿车和盔甲架
- 磁性物品的 GUI — 5 页,最多 225 个物品,支持拖放
- 损坏的本体保存在
config.yml 中,跨服务器重启不丢失
- 配置中独立开关小本体和大本体的生成
- 独特的视觉效果用于吸引和排斥模式(粒子效果 + 音效)
📝 更新日志
🆕 新增
- 排斥模式 — 磁铁和本体现已可以排斥物体而非吸引。模式保存在
config.yml 中。
- 无需命令切换本体模式 — 按住 Shift + 右键点击 本体结构的任何方块,即可在吸引和排斥之间切换。需要权限
magnet.core.toggle。
- 不同的视觉效果:
- 排斥:火焰 (
FLAME) 和烟雾 (SMOKE)
- 吸引:电火花 (
ELECTRIC_SPARK) 和末影棒 (END_ROD)
- 损坏的本体保存 —
broken-magnets 列表现在写入 config.yml,重启后不会重置。
- 本体生成开关 — 在配置中可以单独启用/禁用小本体 (
structures.small.enabled) 和大本体 (structures.big.enabled) 的生成。
- 新命令:
/magnetall(对所有玩家施加吸引力)和 /magnetplayer(对特定玩家施加吸引力)。
🐞 修复
- 修复了在点击本体结构时阻止放置方块的问题(现在可以正常建造)。
- 修复了与 Paper 26.x 和 Java 25 的兼容性问题。
- 修复了导致在新版本上无法编译的陈旧 API 方法。
🎮 命令
| 命令 |
别名 |
描述 |
权限 |
/magnetreload |
/mreload |
重载插件配置 |
magnet.admin |
/magnetset |
/mset |
在你所在位置创建磁铁 |
magnet.admin |
/magnetdel |
/mdel |
按名称删除磁铁 |
magnet.admin |
/magnetlist |
/mlist |
显示所有已安装的磁铁 |
magnet.admin |
/magnetitems |
/mitems |
打开 GUI 管理磁性物品 |
magnet.admin |
/magnetpage |
/mpage |
打开 GUI 页面(1–5) |
magnet.admin |
/magnettoggle |
/mtoggle |
切换对自己施加吸引力 |
magnet.admin |
/magnetplayer |
/mplayer |
切换对其他玩家施加吸引力 |
magnet.admin |
/magnetall |
/mall |
切换对所有玩家施加吸引力 |
magnet.admin |
🔐 权限
| 权限 |
描述 |
默认值 |
magnet.admin |
访问所有命令 |
仅限操作员 |
magnet.core.toggle |
使用 Shift + 右键点击切换本体模式 |
仅限操作员 |
⚙️ 配置 (config.yml)
| 部分 |
描述 |
magnet-items |
计入为磁性物品的材料列表 |
defaults.radius |
默认吸引半径 |
defaults.height |
默认吸引高度 |
defaults.speed |
默认吸引速度 |
defaults.mode |
默认模式 (inventory — 仅持有物品时生效, all — 对所有人生效) |
defaults.repelled |
默认排斥 (true/false) |
structures.small.enabled |
允许从建筑结构创建小本体 |
structures.big.enabled |
允许从建筑结构创建大本体 |
broken-magnets |
损坏的本体列表(自动保存) |
sound |
吸引时的音效设置(启用、类型、音量、音高) |
collision.enabled |
撞击墙壁时造成伤害 |
config.yml 示例
magnet-items:
- IRON_INGOT
- GOLD_INGOT
- DIAMOND
defaults:
radius: 10.0
height: 5.0
speed: 0.5
mode: inventory
repelled: false
structures:
enabled: true
small:
enabled: true
radius: 25
height: 25
speed: 0.1
mode: inventory
big:
enabled: true
radius: 100
height: 100
speed: 0.1
mode: inventory
sound:
enabled: true
type: BLOCK_BEACON_AMBIENT
volume: 1.0
pitch: 1.0
collision:
enabled: true
🧱 如何创建本体
小本体
- 放置一个 Magnetite 方块( lodestone / 磁石)。
- 在三层(底部、侧面、顶部)以 3×3 的模式围绕它放置 Iron Bars(铁栏杆)。
- 本体将自动生成。

大本体
- 放置一个 Magnetite 方块。
- 在三层 3×3 的模式中,用 Oxidized Copper Grate(氧化铜格栅)和 Iron Bars(铁栏杆)围绕它。

一旦建成,本体就会开始吸引(或排斥)物品和玩家!
要更改模式,靠近 本体结构的任意方块,按住 Shift,然后按下 右键。
如果你发现错误或有任何建议,请在 Discord 中留言。
🧲 MineShield Magnet
I noticed that no one is making free plugins with MineShield.
So I decided to make a plugin that everyone really wants, and it's a magnet plugin from the popular MineShield 4 Season server. If you have any questions or find bugs, write in the Discord channel Discord
📖 About
A free plugin for Minecraft servers on Paper or Spigot that adds magnets — points in the world that pull items, players, and entities toward them. Inspired by the popular MineShield 4 Season server.
✨ Key features
- Create magnets anywhere with
/magnetset
- Automatic core generation from built structures (Magnetite + Iron Bars / Oxidized Copper Grate)
- Pull or push items, players, minecarts, and armor stands
- GUI for magnetic items — 5 pages, up to 225 items, drag and drop
- Broken cores saved in
config.yml between server restarts
- Separate toggles for small and large core creation in config
- Unique visual effects for pull and push modes (particles + sounds)
📝 Changelog
🆕 New
- Push mode — magnets and cores can now push objects instead of pulling them. Mode is saved in
config.yml.
- Switch core mode without commands — hold Shift + Right Click on any block of the core structure to toggle between pull and push. Requires permission
magnet.core.toggle.
- Different visual effects:
- Push: fire (
FLAME) and smoke (SMOKE)
- Pull: electric sparks (
ELECTRIC_SPARK) and ender rods (END_ROD)
- Broken cores saved — the
broken-magnets list is now written to config.yml and does not reset after restart.
- Core creation toggle — in config you can separately enable/disable small (
structures.small.enabled) and large (structures.big.enabled) core creation.
- New commands:
/magnetall (pull for all players) and /magnetplayer (pull for a specific player).
🐞 Fixes
- Fixed block placement being blocked when clicking core structures (you can build normally now).
- Fixed compatibility with Paper 26.x and Java 25.
- Fixed outdated API methods that prevented compilation on newer versions.
🎮 Commands
| Command |
Alias |
Description |
Permission |
/magnetreload |
/mreload |
Reload plugin config |
magnet.admin |
/magnetset |
/mset |
Create a magnet at your location |
magnet.admin |
/magnetdel |
/mdel |
Delete a magnet by name |
magnet.admin |
/magnetlist |
/mlist |
Show all installed magnets |
magnet.admin |
/magnetitems |
/mitems |
Open GUI to manage magnetic items |
magnet.admin |
/magnetpage |
/mpage |
Open GUI page (1–5) |
magnet.admin |
/magnettoggle |
/mtoggle |
Toggle pull for yourself |
magnet.admin |
/magnetplayer |
/mplayer |
Toggle pull for another player |
magnet.admin |
/magnetall |
/mall |
Toggle pull for all players |
magnet.admin |
🔐 Permissions
| Permission |
Description |
Default |
magnet.admin |
Access to all commands |
Operators only |
magnet.core.toggle |
Toggle core mode with Shift + Right Click |
Operators only |
⚙️ Configuration (config.yml)
| Section |
Description |
magnet-items |
List of materials that count as magnetic items |
defaults.radius |
Default pull radius |
defaults.height |
Default pull height |
defaults.speed |
Default pull speed |
defaults.mode |
Default mode (inventory — only with item, all — for everyone) |
defaults.repelled |
Push by default (true/false) |
structures.small.enabled |
Allow creating small cores from structures |
structures.big.enabled |
Allow creating large cores from structures |
broken-magnets |
List of broken cores (saved automatically) |
sound |
Sound settings when pulling (enabled, type, volume, pitch) |
collision.enabled |
Deal damage when hitting walls |
Example config.yml
magnet-items:
- IRON_INGOT
- GOLD_INGOT
- DIAMOND
defaults:
radius: 10.0
height: 5.0
speed: 0.5
mode: inventory
repelled: false
structures:
enabled: true
small:
enabled: true
radius: 25
height: 25
speed: 0.1
mode: inventory
big:
enabled: true
radius: 100
height: 100
speed: 0.1
mode: inventory
sound:
enabled: true
type: BLOCK_BEACON_AMBIENT
volume: 1.0
pitch: 1.0
collision:
enabled: true
🧱 How to create a core
Small core
- Place a Magnetite block (Lodestone).
- Surround it with Iron Bars in three layers (bottom, sides, top) in a 3×3 pattern.
- The core will create automatically.

Large core
- Place a Magnetite block.
- Surround it with Oxidized Copper Grate and Iron Bars in a three-layer 3×3 pattern.

Once built, the core will start pulling (or pushing) items and players!
To change the mode, approach any block of the core structure, hold Shift, and press Right Click.
If you find a bug or have a suggestion, write in Discord.
评论 0
登录后参与评分
还没有评论,来抢沙发吧