⚠️ UPDATE NOTICE: This mod has been rewritten and currently ONLY supports version 1.2.0. For version 1.1.0, please check the GitHub repository. Versions below 1.1.0 are no longer supported.

---

🚀 How It Works & Core Features

The Logic System

Mobs Blocker intercepts every entity spawn attempt and checks rules in this specific order:

1. Specific Rules: Is there a rule for this exact Entity ID? (e.g., minecraft:zombie)
2. Preset Rules: If not, is there a rule for its Category? (e.g., monsters)
3. Global Rules: If not, is there a Global rule set?

Key Features

• Granular Control: Block mobs based on how they spawn (Natural, Spawners, Eggs, Commands).
• Smart Presets: Apply rules to entire categories (e.g., block all monsters or water_creatures).
• Global Settings: Apply a rule to every entity on the server instantly.
• In-Game Management: Full command system with auto-completion.
• Zero Lag: Uses optimized HashSet lookups and hooks into NeoForge events for minimal performance impact.
• Server-Side Only: Clients do not need to install this mod.

📜 The Rules System (Understanding Block Types)

When adding a rule, you define what to block. You can block specific sources or use "Inverse Mode" to allow only specific sources.

Rule Keyword	Effect
all	Blocks ALL spawns for this target.
natural	Blocks natural spawns (darkness, biome generation).
spawner	Blocks mob spawners (dungeons, trial spawners).
egg	Blocks spawn eggs and dispensers.
command	Blocks /summon or command block spawns.
!natural	Inverse: Blocks everything EXCEPT natural spawns.
!spawner	Inverse: Blocks everything EXCEPT spawners.
!command	Inverse: Blocks everything EXCEPT commands.

💻 Command Guide (Usage Examples)

All commands require OP Level 4.

1. Specific Mob Control (add)

Target a single entity type.

• Block Zombies completely:

  /spawnblocker add minecraft:zombie all
  

• Block Creepers from spawning naturally (but allow spawners/eggs):

  /spawnblocker add minecraft:creeper natural
  

• Allow Skeletons ONLY from Spawners (Inverse Mode):

  /spawnblocker add minecraft:skeleton !spawner
  

2. Category Presets (preset)

Apply rules to groups of mobs.
Available categories: monsters, creatures, ambient, water, misc.

• Block all Monsters from spawning naturally:

  /spawnblocker preset monsters natural
  

• Disable all ambient creatures (Bats, etc.):

  /spawnblocker preset ambient all
  

3. Global Settings (global)

Apply a fallback rule to the entire server.

• Disable Natural Spawning server-wide (Adventure mode style):

  /spawnblocker global natural
  

4. Management & Utilities

• Remove a rule:

  /spawnblocker remove minecraft:zombie
  /spawnblocker remove preset monsters
  

• List active rules:

  /spawnblocker list
  

• Reload Config (from disk):

  /spawnblocker reload
  

• Reset Everything (Wipe Config):

  /spawnblocker reset
  

📂 Configuration File (Manual Editing)

The configuration is saved automatically to config/spawnblocker.json. You can edit this file manually if the server is stopped.

Example spawnblocker.json:

{
  "minecraft:phantom": [
    "all"
  ],
  "preset:monsters": [
    "natural"
  ],
  "minecraft:zombie": [
    "!spawner"
  ],
  "global_settings": [
    "command"
  ]
}