MobCatcher - MarkusBordihn/BOs-Easy-Mob-Farm GitHub Wiki

🕸️ Mob Capture

Mob Capture Items allow players to capture various mobs based on specific conditions such as health, size, and item durability. Each Mob Capture Item is tailored for different mob types and gameplay strategies, making them essential tools in mob farming and management.

Mob Capture recipes can be disabled via the configuration, allowing players to exclusively use Mob Capture Cards to collect mobs. This adds an extra layer of customization for server administrators and players who prefer a more streamlined or challenging gameplay experience.

📦 List of Mob Catcher Items

  1. Enduring Capture Net
  2. Ironbound Containment Cage
  3. Mystic Binding Crystal
  4. Creative Mob Catcher

🥅 Enduring Capture Net

Enduring Capture Net

The Enduring Capture Net is a durable and versatile tool for capturing smaller mobs. Designed with moderate durability and size limits, it’s ideal for capturing average-sized mobs in the early to mid-game.

Crafting Recipe

Enduring Capture Net Recipe

  • Item ID: enduring_capture_net
  • Max Durability: 64
  • Capture Requirements:
    • Required Health: Mob must be at 50% health or below.
    • Max Entity Height: 1.4 blocks
    • Max Entity Width: 0.9 blocks

Tip: Use the Enduring Capture Net for capturing smaller passive or hostile mobs within these size constraints.

🛠️ Ironbound Containment Cage

Ironbound Containment Cage

The Ironbound Containment Cage offers a strong containment option for larger mobs with a tougher capture requirement. With a moderate durability level, it’s an effective choice for tougher or larger mobs but requires the target to be at low health.

Crafting Recipe

Ironbound Containment Cage Recipe

  • Item ID: ironbound_containment_cage
  • Max Durability: 32
  • Capture Requirements:
    • Required Health: Mob must be at 25% health or below.
    • Max Entity Height: 2.0 blocks
    • Max Entity Width: 1.5 blocks

Tip: Use this cage for capturing larger mobs with a significant health reduction requirement. Great for mid- to high-level mob capturing needs.

🔮 Mystic Binding Crystal

Mystic Binding Crystal

The Mystic Binding Crystal is a powerful and mystical capture item designed for very large or special mobs. It’s ideal for end-game players looking to capture challenging or unique mobs due to its large size allowance and low health requirement.

Crafting Recipe

Mystic Binding Crystal Recipe

  • Item ID: mystic_binding_crystal
  • Max Durability: 32
  • Capture Requirements:
    • Required Health: Mob must be at 25% health or below.
    • Max Entity Height: 4.0 blocks
    • Max Entity Width: 3.0 blocks

Tip: The Mystic Binding Crystal is perfect for capturing massive mobs or special boss-like entities. Due to its size limits, it can handle mobs that other capture items cannot.

🪢 Void Binding Chain

Void Binding Chain

The Void Binding Chain is a legendary capture tool forged with void energy, designed to subdue the largest and most powerful creatures in existence. This item is tailored for end-game players who need to capture colossal mobs or bosses that surpass ordinary size limits.

Crafting Recipe

Void Binding Chain Recipe

  • Item ID: void_binding_chain
  • Max Durability: 16
  • Capture Requirements:
    • Required Health: Mob must be at 10% health or below.
    • Max Entity Height: 6.0 blocks
    • Max Entity Width: 4.0 blocks

Tip: Use the Void Binding Chain strategically to capture massive mobs like the Netherite Monstrosity. Its durability is limited, so plan your captures carefully!

✨ Creative Mob Catcher

Creative Mob Catcher

The Creative Mob Catcher is an unlimited-use capture item intended for creative mode or administrative purposes. It bypasses all capture requirements, allowing players to instantly capture any mob without restrictions.

  • Item ID: creative_mob_catcher
  • Max Durability: Unlimited
  • Capture Requirements:
    • Required Health: No health requirement.
    • Max Entity Height: No height limit.
    • Max Entity Width: No width limit.
    • Durability Cost: None

Note: This item is available only in creative mode or through administrative commands and is perfect for map creators or administrators needing to manage mobs freely.

🛠️ Usage Instructions

  1. Equip the Mob Catcher Item of your choice.
  2. Right-click on a mob to attempt capture.
    • The mob’s health and size must meet the item’s requirements.
  3. Check Durability: If the item has durability, each capture attempt will consume durability based on the item’s specifications.

📜 Mob Catcher Configuration Settings

The Mob Catcher Configuration file allows players and server administrators to customize various settings for each Mob Catcher. From enabling or disabling specific recipes to fine-tuning capture parameters, this file offers flexibility to suit different gameplay styles.

📁 File Location:
config/easy_mob_farm/mob_catcher.cfg

⚙️ General Settings

Each Mob Catcher has its own configurable options, including:

  • Allow and Deny Lists:
    Define which mobs can or cannot be captured by specific Mob Catchers.

    • Adding mobs to the AllowList denies all others by default.
    • Mobs on the AllowList can be captured even if they exceed size limits.

    Examples:

    EnduringCaptureNet:AllowList=minecraft:cow,minecraft:sheep,minecraft:chicken
    VoidBindingChain:DenyList=minecraft:endermite,minecraft:ender_dragon,minecraft:wither
    
  • Capture Limits:
    Specify maximum size limits for mobs to be captured, including:

    • MaxEntityHeightToCapture
    • MaxEntityWidthToCapture
    • RequiredHealthPercentageToCapture – The minimum health percentage required for capture.
  • Durability:
    Each Mob Catcher has a durability value indicating how many uses it has before breaking.
    Example:

    EnduringCaptureNet:MaxDurability=64
    

🚫 Disabling Recipes

The Enabled option determines whether the crafting recipe for a Mob Catcher is available.

  • Setting Enabled=false disables the recipe for new crafting.

  • Existing items are not affected and can still be used, spawned via commands, or accessed in Creative Mode.

    Example:

    EnduringCaptureNet:Enabled=false
    

⚠️ Important Note: Disabling the recipe only prevents new crafting but does not remove the item entirely from the game. This allows flexibility for server admins and players to manage their resources dynamically.

📝 Full Example Configuration:

Below is an example configuration with default settings:

# Mob Catcher Configuration
#
# This configuration file allows you to define the general settings for the Mob Catcher.
#
# Thu Jan 23 15:31:55 CET 2025

EnduringCaptureNet:AllowList=minecraft:cow,minecraft:sheep,minecraft:chicken
EnduringCaptureNet:DenyList=
EnduringCaptureNet:Enabled=false
EnduringCaptureNet:MaxDurability=64
EnduringCaptureNet:MaxEntityHeightToCapture=1.4
EnduringCaptureNet:MaxEntityWidthToCapture=0.9
EnduringCaptureNet:RequiredHealthPercentageToCapture=0.5

IronboundContainmentCage:AllowList=
IronboundContainmentCage:DenyList=
IronboundContainmentCage:Enabled=true
IronboundContainmentCage:MaxDurability=32
IronboundContainmentCage:MaxEntityHeightToCapture=2.0
IronboundContainmentCage:MaxEntityWidthToCapture=1.5
IronboundContainmentCage:RequiredHealthPercentageToCapture=0.25

⚙️ Technical Properties

Item Max Durability Required Health (%) Max Entity Height Max Entity Width
Enduring Capture Net 64 50% 1.4 blocks 0.9 blocks
Ironbound Containment Cage 32 25% 2.0 blocks 1.5 blocks
Mystic Binding Crystal 32 25% 4.0 blocks 3.0 blocks
Void Binding Chain 16 20% 6.0 blocks 4.0 blocks
Creative Mob Catcher Unlimited None No limit No limit

⚡ Tips for Using Mob Capture Items

  • Use the Enduring Capture Net for smaller, weaker mobs early in the game.
  • Upgrade to the Ironbound Containment Cage when you need to capture tougher, larger mobs.
  • Unlock the full potential of the Mystic Binding Crystal to capture end-game or rare mobs.
  • Leverage the Creative Mob Catcher in map-making or admin scenarios where full control over mobs is required.
⚠️ **GitHub.com Fallback** ⚠️