Keeping Your Base Peaceful with MobRepeller
Every Minecraft player knows the frustration. You spend hours perfecting your base, laying out every block with care, only to have creepers waltz through your front door and undo all that work in a single hissing explosion. In heavily-modded worlds, the problem multiplies. Dragons from Ice and Fire, mutant monsters, and creatures from the Betweenlands all seem to have a personal vendetta against your carefully constructed sanctuary. Lighting helps, but it is never quite enough. What if there was a way to tell hostile mobs, politely but firmly, that they are simply not welcome?
MobRepeller answers that question with an elegant, server-friendly solution. This lightweight Bukkit and Spigot plugin transforms how you protect your territory, replacing frantic torch-spamming with a system of crafted Totems that radiate safety across configurable distances. It is designed to work seamlessly on Spigot, Paper, and hybrid servers like Mohist and Arclight, requiring only Java 17 or newer and Minecraft version 1.20.1.
What Exactly Is MobRepeller?
At its core, MobRepeller is a spawn-control plugin that gives players a tangible, buildable way to secure their bases. Instead of typing commands or toggling invisible flags, you physically construct a Totem — a simple 2D vertical cross made from six blocks of a single core material. Once the final block is placed, the Totem registers automatically, and a floating hologram appears to confirm its tier and protection radius. From that moment onward, natural hostile spawns within the field are cancelled, and any hostiles that wander inside are gently nudged back toward the perimeter.
The plugin is remarkably considerate of your world's other inhabitants. Villagers, Iron Golems, pets, horses, and neutral wildlife are never pushed or harmed. CustomNPCs, MineColonies citizens, and creatures from mods like Friends and Foes or Naturalist continue their routines undisturbed. MobRepeller draws a clear line between the monsters you want to keep out and the allies you want to keep close.
Building Your First Totem
Constructing a Totem is straightforward enough that even a brand-new player can manage it. The shape is a vertical cross: one central core block with arms extending one block in each cardinal direction, plus a block above and below the center. All six blocks must be the same material. Starter cores like Clay, Coal, and Hay Bales provide a modest 25-meter protection radius, perfect for a small homestead or temporary camp. As you progress and gather better resources, you can upgrade to Iron for 50 meters, Gold for 100 meters, or Diamond for a generous 150-meter field.
When a player places their first core block, the plugin delivers a one-time build tip to guide them through the process. A first-join guide book titled "MobRepeller" also lands in their inventory, ensuring nobody is left confused about how the system works. The moment the cross shape is completed, registration happens automatically. Break any block of the Totem, and the entire structure deregisters, with its hologram vanishing cleanly. A break-warning feature adds a layer of safety: breaking an arm block triggers a warning first, and you must break again within five seconds to confirm the removal.
Holograms and Visual Feedback
Each active Totem displays a floating hologram label showing its tier and exact range. The height of these holograms is configurable in the plugin's config.yml file, so server administrators can adjust them to suit their world's aesthetic. The visual feedback extends beyond simple labels. Running the /mobrepeller show command draws a glowing particle circle at the field edge for ten seconds, letting you see precisely where your protection ends. When multiple Totem fields overlap, shimmering particle beams connect their centers, creating a network of visible magical boundaries.
Ambient effects add an organic, enchanting atmosphere to protected zones. When players stand within five blocks of a Totem, inward-flowing enchantment particles drift toward the structure. Randomized enchanting sounds play at varying pitches, avoiding the mechanical repetition that plagues many plugin effects. Everything about the presentation feels deliberate and immersive, as though the Totem is genuinely radiating protective magic rather than simply enforcing a game rule.
Smart Spawn Control That Respects Your World
MobRepeller does not blindly delete every hostile entity in sight. It specifically cancels natural-ish spawn types: NATURAL, CHUNK_GEN, REINFORCEMENTS, NETHER_PORTAL, and PATROL. Spawners, spawn eggs, commands, and scripted spawns continue to function normally, so your custom dungeons and adventure maps remain fully operational. Hostiles that somehow find their way inside the field are nudged outward with configurable strength. Lingering mobs that refuse to leave can be hard-ejected or even killed after a configurable delay, defaulting to fifteen seconds.
This nuanced approach makes MobRepeller ideal for modded environments. The plugin ships with built-in recognition for hostile creatures from popular 1.20.1 mod packs, including Alex's Mobs, Ice and Fire: Dragons, Advent of Ascension, The Twilight Forest, Mowzie's Mobs, Grimoire of Gaia, The Betweenlands, L_Ender's Cataclysm, Mutant Monsters, Born in Chaos, and Creeper Overhaul. Each mod's protection can be toggled on or off at runtime using /mobrepeller modprotection, giving administrators fine-grained control without restarting the server. The hostile recognition system is also extendable through the hostile.packages and hostile.types sections in config.yml, so custom mods can be added easily.
For players who enjoy managing their modded experience through a streamlined interface, the plugin integrates smoothly with modern launcher solutions. Many server communities have found that installing and updating plugins like MobRepeller becomes effortless when using the foxygame.net launcher, a convenient and flexible platform where you can browse and download mods directly from the menu without juggling external files or manual configuration.
Commands and Permissions at a Glance
MobRepeller ships with a comprehensive command set that balances player accessibility with administrative power. Basic commands like /mobrepeller ping, /mobrepeller count, and /mobrepeller list are available to everyone by default, letting players check the plugin's status and see active Totems in their world. The /mobrepeller register command allows manual registration of a cross you are looking at, while /mobrepeller show visualizes the nearest Totem's radius.
Administrative commands require the mobrepeller.manage permission, granted to operators by default. These include powerful cleanup tools:
- /mobrepeller removehere — removes the nearest hologram and its associated Totem
- /mobrepeller cleanup — clears orphaned holograms within 24 meters
- /mobrepeller cleanupall — removes all holograms in the current world
- /mobrepeller nukeholo — a fallback command that removes all label-like armor stands
- /mobrepeller refreshholo — refreshes all hologram labels
- /mobrepeller reload — reloads the entire configuration, matcher, and hologram system
- /mobrepeller debug — displays plugin and manager diagnostics
An alias /repel is also available for quicker typing. The permission mobrepeller.* grants full access to every command.
Configuration and Server Compatibility
Every meaningful aspect of MobRepeller can be adjusted through its config.yml file, which generates with sensible defaults on the first run. Server owners can modify tier radii, repel strength, ambient effect behavior, per-player Totem limits (defaulting to five, with creative mode exempt), optional Totem decay timers, and hologram display height. The decay system, disabled by default, can be set to automatically expire Totems after a configurable duration, such as 48 hours, encouraging active base maintenance.
The plugin runs cleanly on Spigot, Paper, and hybrid servers like Mohist and Arclight, coexisting peacefully alongside Forge mods. Its lightweight design ensures minimal performance impact, even on servers with dozens of active Totems spread across multiple worlds. The BSD 3-Clause license permits commercial redistribution with proper attribution, making it a viable choice for server networks and mod packs alike.
Why MobRepeller Deserves a Spot on Your Server
MobRepeller strikes a rare balance between powerful functionality and immersive gameplay. It does not feel like a cheat or an invisible admin tool. Players physically build their protection, see it represented in the world, and understand its limits through clear visual feedback. The tiered progression from Clay to Diamond mirrors vanilla Minecraft's natural resource progression, rewarding players for advancing through the game rather than handing them unlimited safety from the start.
The plugin's respect for non-hostile entities sets it apart from cruder spawn-blocking solutions. Your villagers continue trading, your horses stay put, and your MineColonies citizens go about their work without interruption. The extensive mod compatibility means you do not have to choose between a protected base and a rich modded experience. Whether you are running a small survival server with friends or a large modded network, MobRepeller adapts to your needs through its configurable options and runtime toggles.
Designed and coded by Luc Bellefeuille, MobRepeller welcomes pull requests for additional mod presets, ensuring the plugin can grow alongside the ever-expanding Minecraft modding ecosystem. If you have ever watched a creeper destroy your storage room or a dragon incinerate your livestock, you know exactly why this plugin exists. Build your Totem, watch the hologram flicker to life, and finally enjoy the peace you have earned.