MobRepeller v1.0.0 - Initial Release

A lightweight Bukkit/Spigot plugin for Minecraft 1.12.2 that creates “Totem” no-spawn fields. Place a simple 2D cross (6 blocks) made of Clay/Coal/Hay/Iron/Gold/Diamond to block natural hostile spawns and gently repel hostiles that enter the field. Includes a first-join tutorial book, one-time build tips, and floating hologram labels.

Compatibility

• Minecraft: 1.12.2
• Java: 8 - jdk1.8.0_202 tested
• Forge on client/servers: 14.23.5.2859 - players can use modded clients; plugin runs on the server
• CatServer: git-CatServer-1.12.2-4168d848
• Paper/Spigot: Spigot 1.12.2 and most 1.12.2 Paper forks (Not Tested)

Friendly mod families supported via config:

• CustomNPCs,
• Citizens,
• MineColonies.

Hostile mod families supported via config:

• Advent of Ascension (AoA3),
• Ice & Fire,
• Lycanites Mobs,
• Twilight Forest,
• Mowzie’s Mobs,
• Grimoire of Gaia,
• Primitive Mobs,
• DivineRPG,
• The Betweenlands,
• Erebus,
• AbyssalCraft,
• Fossils & Archeology,
• Tropicraft.

What’s in v1.0.0

• Totem tiers & radius: Clay/Coal/Hay (25m), Iron (50m), Gold (100m), Diamond (150m).
• Repel engine: periodic push with optional hard-eject for lingerers inside the core.
• Spawn control: cancels natural-ish spawns (NATURAL, CHUNK_GEN, REINFORCEMENTS, NETHER_PORTAL). Spawners/eggs/commands/scripts unaffected.

Smart matching:

• Global hostile.default_monsters toggle.
• hostile.packages, hostile.types, and hostile.force_packages (forces hostile even if entity is Animals/Ambient/WaterMob).
• Per-mod allow/repel list modes (block all except allow, or only block listed).
• Strong whitelist for NPC frameworks, livestock, passives, and pets.
• UX: hologram label with configurable Y offset; one-time chat tutorial; first-join tutorial book; gentle hint sounds.

Commands:

• /mobrepeller ping | reload | count | list | register | remove | save | removehere | cleanup | cleanupall | refreshholo | debug.

Installation

• Drop MobRepeller-1.0.0.jar into your server’s plugins/ folder.
• Start once to generate config.yml.
• (Optional) Tweak radius, repel strength, hologram offset, hostile/whitelist rules, and per-mod sections.
• /mobrepeller reload to apply.

Known Notes

• Designed for server-side use; works fine with modded clients.
• If you tighten rules aggressively (e.g., block entire Lycanites), ensure any healer/utility mobs you want are added to allow.

License / Credits

• License: BSD-3-Clause (SPDX: BSD-3-Clause)
• Attribution required. Commercial redistribution of the plugin itself is not permitted.
• © 2025 Luc Bellefeuille

Enjoy peaceful bases!