**CapsulaX** is a Minecraft plugin that allows players to capture creatures in special capsules (eggs) and release them whenever they want. Similar to Pok\u00e9mon mechanics, players can throw capsules at mobs to capture them, store them in their inventory, and release them later.<\/p>\n
### Key Features<\/p>\n
– \u2705 **Capture any mob** – Over 100+ different creature types supported
\n– \u2705 **Configurable probabilities** – Customize capture rates by mob category
\n– \u2705 **Crafting system** – Players can craft their own capsules
\n– \u2705 **Economy integration** – Buy\/sell capsules with Vault
\n– \u2705 **World management** – Control where capsules can be used
\n– \u2705 **Visual effects** – Particles and sounds for captures
\n– \u2705 **Multilingual** – Supports English and Spanish (expandable)
\n– \u2705 **Permissions** – Granular control per mob type<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
### Requirements<\/p>\n
– **Server Type:** Paper, Spigot, or any Paper\/Spigot fork
\n– **Minecraft Version:** 1.21.4 or higher
\n– **Java Version:** 17 or higher<\/p>\n
### Optional Dependencies<\/p>\n
– **Vault** – For economy features (buying capsules)
\n– **WorldGuard** – For region protection (planned)
\n– **MythicMobs** – For custom mob support (planned)<\/p>\n
### Installation Steps<\/p>\n
1. **Download** CapsulaX.jar from the release page
\n2. **Stop** your server
\n3. **Place** the .jar file in your `plugins\/` folder
\n4. **Start** your server
\n5. **Configure** the plugin in `plugins\/CapsulaX\/config.yml`
\n6. **Reload** with `\/capsulax reload`<\/p>\n
—<\/p>\n
## \ud83d\ude80 Getting Started<\/p>\n
### First Steps<\/p>\n
After installing CapsulaX, follow these steps:<\/p>\n
1. **Give yourself a capsule:** 2. **Check available mobs:** 3. **Find a mob** in your world<\/p>\n 4. **Throw the capsule** at the mob or right-click on it<\/p>\n 5. **If successful**, the mob will be captured and you’ll receive a filled capsule<\/p>\n 6. **Right-click** with the filled capsule to release the mob<\/p>\n —<\/p>\n ## \ud83d\udd28 Crafting Capsules<\/p>\n ### Default Recipe<\/p>\n Players can craft capture capsules using the following recipe:<\/p>\n “` I = Iron Ingot **Result:** 8 Capture Capsules<\/p>\n ### Recipe Details<\/p>\n – **Pattern:** 3×3 crafting table ### Customizing the Recipe<\/p>\n You can change the recipe in `config.yml`:<\/p>\n “`yaml **Example – Diamond Recipe:** ### Disabling Crafting<\/p>\n Set `enabled: false` in the crafting section: Players will only be able to get capsules through commands or economy.<\/p>\n —<\/p>\n ## \ud83c\udfaf How to Use Capsules<\/p>\n ### Capturing Mobs<\/p>\n There are **two methods** to capture mobs:<\/p>\n #### Method 1: Throwing Capsules (Recommended)<\/p>\n 1. **Hold** an empty capsule in your hand **Advantages:** #### Method 2: Direct Click<\/p>\n 1. **Hold** an empty capsule in your hand **Advantages:** ### Capture Success or Failure<\/p>\n When you attempt to capture a mob:<\/p>\n **\u2705 Success:** **\u274c Failure:** ### Releasing Mobs<\/p>\n To release a captured mob:<\/p>\n 1. **Hold** the filled capsule in your hand **Notes:** —<\/p>\n ## \ud83d\udcca Capture Probability System<\/p>\n CapsulaX uses a sophisticated probability system based on several factors:<\/p>\n ### Base Capture Chance<\/p>\n Default: **70%** (configurable in `config.yml`)<\/p>\n “`yaml ### Mob Categories<\/p>\n Different mob types have different capture multipliers:<\/p>\n #### 1. Passive Mobs (100% of base) – Cow, Pig, Sheep, Chicken #### 2. Hostile Mobs (70% of base) – Zombie, Skeleton, Creeper #### 3. Water Mobs (60% of base) – Squid, Glow Squid #### 4. Nether Mobs (40% of base) – Piglin, Piglin Brute #### 5. End Mobs (30% of base) – Shulker #### 6. Boss Mobs (10% of base – Disabled by default) – Ender Dragon ### Health-Based Multiplier<\/p>\n The mob’s current health affects capture chance:<\/p>\n **Formula:** **Examples:** \ud83d\udca1 **Strategy:** Damage mobs before capturing them for better success rates!<\/p>\n ### Final Calculation<\/p>\n The final capture chance is:<\/p>\n “` **Example 1 – Healthy Cow:** **Example 2 – Damaged Zombie:** **Example 3 – Nearly Dead Creeper:** ### Custom Overrides<\/p>\n You can override specific mob probabilities:<\/p>\n “`yaml —<\/p>\n ## \u2699\ufe0f Configuration Guide<\/p>\n The main configuration file is located at: `plugins\/CapsulaX\/config.yml`<\/p>\n ### General Settings<\/p>\n “`yaml ### Capsule Settings<\/p>\n “`yaml ### Sound Effects<\/p>\n “`yaml Available sounds: https:\/\/hub.spigotmc.org\/javadocs\/spigot\/org\/bukkit\/Sound.html<\/p>\n ### Particle Effects<\/p>\n “`yaml Available particles: https:\/\/hub.spigotmc.org\/javadocs\/spigot\/org\/bukkit\/Particle.html<\/p>\n ### Storage Settings<\/p>\n “`yaml # MySQL settings (if type: MYSQL) # SQLite settings (if type: SQLITE) ### Debug Settings<\/p>\n “`yaml —<\/p>\n ## \ud83c\udf0d World Management<\/p>\n CapsulaX includes a flexible world management system with three modes:<\/p>\n ### Mode 1: ALL (Allow All Worlds)<\/p>\n **Default mode** – Capsules work in all worlds<\/p>\n “`yaml **Use case:** Simple servers, vanilla gameplay<\/p>\n —<\/p>\n ### Mode 2: WHITELIST (Allow Specific Worlds)<\/p>\n Only allows capsules in listed worlds<\/p>\n “`yaml **Use case:** **Advantages:** —<\/p>\n ### Mode 3: BLACKLIST (Block Specific Worlds)<\/p>\n Allows capsules in all worlds EXCEPT listed ones<\/p>\n “`yaml **Use case:** **Advantages:** —<\/p>\n ### World Names<\/p>\n \u26a0\ufe0f **Important:** World names are **case-sensitive**!<\/p>\n – Correct: `world`, `world_nether`, `MyCustomWorld` **How to find exact world names:** —<\/p>\n ## \ud83d\udcb0 Economy System<\/p>\n Requires **Vault** plugin installed.<\/p>\n ### Configuration<\/p>\n “`yaml # Rewards for capturing rare mobs ### Buying Capsules<\/p>\n Players can buy capsules with in-game money:<\/p>\n “` **Examples:** ### Capture Rewards<\/p>\n When a player captures a rare mob (if configured), they receive money:<\/p>\n – Ender Dragon: $10,000 Customize rewards in `config.yml` under `economy.capture-rewards`.<\/p>\n —<\/p>\n ## \ud83d\udcdc Commands<\/p>\n ### Main Command<\/p>\n “` **Aliases:** `\/cx`, `\/capsula`<\/p>\n —<\/p>\n ### Available Subcommands<\/p>\n #### 1. Give Capsules<\/p>\n “` **Permission:** `capsulax.command.give`<\/p>\n **Examples:** # Give 5 empty capsules to Steve # Give 1 capsule with a Cow to Steve # Give 3 capsules with Creepers to Alex —<\/p>\n #### 2. List Capturable Mobs<\/p>\n “` **Permission:** `capsulax.command.list`<\/p>\n **Examples:** Shows all mobs that can be captured with their capture rates.<\/p>\n —<\/p>\n #### 3. Buy Capsules<\/p>\n “` **Permission:** `capsulax.command.buy` **Examples:** —<\/p>\n #### 4. Reload Configuration<\/p>\n “` **Permission:** `capsulax.command.reload`<\/p>\n Reloads all configuration files without restarting the server.<\/p>\n **Reloads:** —<\/p>\n #### 5. Help<\/p>\n “` **Permission:** `capsulax.command`<\/p>\n Shows all available commands based on your permissions.<\/p>\n —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n ### Basic Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ### Capture Permissions<\/p>\n Control which mobs players can capture:<\/p>\n #### Individual Mob Permissions<\/p>\n “` **Examples:** #### Wildcard Permission<\/p>\n “` Allows capturing **all mobs** (including bosses if enabled)<\/p>\n —<\/p>\n ### Release Permissions<\/p>\n Control which mobs players can release:<\/p>\n “` **Default Behavior:** If a player has permission to **capture** a mob, they automatically have permission to **release** it. This is logical – if you can catch it, you should be able to release it!<\/p>\n **Permission Hierarchy:** **Examples:** # Or use explicit spawn permission **Important:** The `capsulax.spawn.*` permission is **enabled by default** for all players, so normal players can release any mob they capture.<\/p>\n —<\/p>\n ### Crafting Permissions<\/p>\n “` **Default:** OP only<\/p>\n Players need this permission to craft capsules.<\/p>\n —<\/p>\n ### Permission Groups Example<\/p>\n **For LuckPerms:**<\/p>\n “`bash # VIP – can capture passive + hostile mobs # Admin – can capture everything —<\/p>\n ## \ud83c\udfa8 Custom Configuration<\/p>\n ### Example 1: High Capture Rates (Easy Mode)<\/p>\n “`yaml —<\/p>\n ### Example 2: Hard Mode (Challenging)<\/p>\n “`yaml —<\/p>\n ### Example 3: Boss Only Server<\/p>\n “`yaml —<\/p>\n ### Example 4: Custom Mob Rates<\/p>\n “`yaml # Medium difficulty # Hard to catch # Very rare —<\/p>\n ## \ud83d\udd27 Troubleshooting<\/p>\n ### Capsules don’t work in any world<\/p>\n **Solutions:** —<\/p>\n ### Capsules work in worlds they shouldn’t<\/p>\n **Solutions:** —<\/p>\n ### Capture always fails<\/p>\n **Solutions:** —<\/p>\n ### Crafting recipe doesn’t work<\/p>\n **Solutions:** —<\/p>\n ### Economy features don’t work<\/p>\n **Solutions:** —<\/p>\n ### Plugin doesn’t load<\/p>\n **Solutions:** —<\/p>\n ## \u2753 FAQ<\/p>\n ### Can I capture player-owned horses\/pets?<\/p>\n Yes, but only if the player has the appropriate permissions. Tamed animals keep their owner when captured and released.<\/p>\n —<\/p>\n ### Do mobs keep their equipment when captured?<\/p>\n Yes! All mob data is preserved: —<\/p>\n ### Can I capture Mythic Mobs?<\/p>\n Support for MythicMobs is planned but not yet implemented.<\/p>\n —<\/p>\n ### What happens if my inventory is full?<\/p>\n The filled capsule will drop on the ground at your feet.<\/p>\n —<\/p>\n ### Can I stack filled capsules?<\/p>\n No, filled capsules cannot stack. Each filled capsule contains unique mob data.<\/p>\n —<\/p>\n ### Can I sell filled capsules?<\/p>\n Not directly through the plugin, but players can trade them normally.<\/p>\n —<\/p>\n ### Does this work with Multiverse?<\/p>\n Yes! CapsulaX works with any world management plugin.<\/p>\n —<\/p>\n ### Can I capture the Ender Dragon?<\/p>\n Only if you enable boss capturing in the config: —<\/p>\n ### How do I increase capture rates?<\/p>\n Edit `config.yml`: —<\/p>\n ### Can I disable capsules in specific regions?<\/p>\n WorldGuard integration is planned for future versions. Currently, use world management to disable entire worlds.<\/p>\n —<\/p>\n ### Do captured mobs count toward the mob cap?<\/p>\n Released mobs count toward the normal mob cap, same as spawned mobs.<\/p>\n —<\/p>\n ### Can I customize the capsule item?<\/p>\n Yes! Change the item type: ## \ud83c\udf89 Thank You!<\/p>\n Thank you for using CapsulaX! We hope you and your players enjoy capturing and collecting creatures in Minecraft.<\/p>\n **CapsulaX v1.0.1** – Catch ’em all! \ud83c\udfae<\/p>\n","protected":false},"excerpt":{"rendered":" CapsulaX is a Minecraft plugin that allows players to capture creatures in special capsules and then release them whenever they want.<\/p>\n","protected":false},"featured_media":36923,"template":"","meta":{"_minecraft_slug":"capsulax","_minecraft_project_id":"pcg844sH","_minecraft_author":"DeLaRosaPlay","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":70,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"capsulax.zip","_minecraft_size_bytes":124092,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:33:37.697329Z","_minecraft_date_created":"2025-10-12T07:08:03.659670Z","_minecraft_date_modified":"2025-10-12T23:54:09.332047Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/capsulax","_minecraft_icon_attachment_id":36923,"_minecraft_imported_at":"2026-06-01T18:32:43+00:00","_minecraft_import_hash":"fd25858325991bb370a09ea683167af2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,137,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-36922","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-mobs","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n “`
\n \/capsulax give
\n “`<\/p>\n
\n “`
\n \/capsulax list
\n “`<\/p>\n
\n[I] [I] [I]
\n[I] [G] [I]
\n[I] [I] [I]<\/p>\n
\nG = Glass Block
\n“`<\/p>\n
\n– **Center:** 1 Glass Block
\n– **Surrounding:** 8 Iron Ingots
\n– **Output:** 8 Empty Capsules<\/p>\n
\ncrafting:
\n enabled: true
\n pattern:
\n – “III”
\n – “IGI”
\n – “III”
\n ingredients:
\n I: “IRON_INGOT”
\n G: “GLASS”
\n result-amount: 8
\n“`<\/p>\n
\n“`yaml
\ncrafting:
\n enabled: true
\n pattern:
\n – “DDD”
\n – “DGD”
\n – “DDD”
\n ingredients:
\n D: “DIAMOND”
\n G: “GLASS”
\n result-amount: 4
\n“`<\/p>\n
\n“`yaml
\ncrafting:
\n enabled: false
\n“`<\/p>\n
\n2. **Aim** at the mob you want to capture
\n3. **Throw** the capsule (right-click)
\n4. The capsule will fly toward the mob
\n5. **If it hits** the mob, capture attempt begins<\/p>\n
\n– \u2705 Safer – capture from distance
\n– \u2705 Works on fast or dangerous mobs
\n– \u2705 More immersive gameplay<\/p>\n
\n2. **Right-click** directly on the mob
\n3. Capture attempt begins immediately<\/p>\n
\n– \u2705 More precise
\n– \u2705 Works better in tight spaces
\n– \u2705 Doesn’t consume capsule if capture fails<\/p>\n
\n– Mob disappears
\n– You receive a filled capsule with the mob inside
\n– Success sound and particles appear
\n– Capture statistics are recorded<\/p>\n
\n– Mob escapes
\n– Capsule is consumed
\n– Failure sound plays
\n– Mob may move randomly<\/p>\n
\n2. **Right-click** in the air or on a block
\n3. The mob will spawn at your location
\n4. You receive an empty capsule back<\/p>\n
\n– The mob spawns with the same health and attributes
\n– Baby mobs stay baby, tamed wolves stay tamed, etc.
\n– You cannot release mobs in protected worlds (if configured)<\/p>\n
\ncapsules:
\n base-capture-chance: 0.7 # 70%
\n“`<\/p>\n
\n**Multiplier:** 1.0 \u2192 **70% capture rate**<\/p>\n
\n– Horse, Donkey, Llama
\n– Cat, Wolf, Rabbit
\n– Villagers, Iron Golems
\n– Fox, Panda, Bee<\/p>\n
\n**Multiplier:** 0.7 \u2192 **49% capture rate**<\/p>\n
\n– Spider, Cave Spider
\n– Enderman, Witch, Blaze
\n– Ghast, Slime, Phantom
\n– Pillager, Vindicator, Evoker<\/p>\n
\n**Multiplier:** 0.6 \u2192 **42% capture rate**<\/p>\n
\n– Dolphin, Turtle
\n– Guardian, Elder Guardian
\n– Fish (Cod, Salmon, Tropical Fish, Pufferfish)
\n– Axolotl<\/p>\n
\n**Multiplier:** 0.4 \u2192 **28% capture rate**<\/p>\n
\n– Hoglin, Zoglin
\n– Zombified Piglin
\n– Wither Skeleton
\n– Magma Cube, Strider<\/p>\n
\n**Multiplier:** 0.3 \u2192 **21% capture rate**<\/p>\n
\n– Endermite<\/p>\n
\n**Multiplier:** 0.1 \u2192 **7% capture rate**<\/p>\n
\n– Wither
\n– Elder Guardian
\n– Warden<\/p>\n
\n“`
\nHealth Multiplier = 1.0 – (Current Health \/ Max Health) \u00d7 0.5
\n“`<\/p>\n
\n– Mob at 100% health: multiplier = 0.5 (50% capture rate)
\n– Mob at 50% health: multiplier = 0.75 (75% capture rate)
\n– Mob at 10% health: multiplier = 0.95 (95% capture rate)
\n– Mob at 1 HP: multiplier = 0.99 (99% capture rate)<\/p>\n
\nFinal Chance = Base Chance \u00d7 Category Multiplier \u00d7 Health Multiplier
\n“`<\/p>\n
\n– Base: 70%
\n– Category (Passive): 100%
\n– Health: 50%
\n– **Final: 35%**<\/p>\n
\n– Base: 70%
\n– Category (Hostile): 70%
\n– Health: 75% (mob at 50% HP)
\n– **Final: 36.75%**<\/p>\n
\n– Base: 70%
\n– Category (Hostile): 70%
\n– Health: 95% (mob at 10% HP)
\n– **Final: 46.55%**<\/p>\n
\ncapsules:
\n overrides:
\n CREEPER: 0.9 # 90% catch rate for Creepers
\n ZOMBIE: 0.5 # 50% catch rate for Zombies
\n ENDER_DRAGON: 0.01 # 1% catch rate for Dragon
\n“`<\/p>\n
\ngeneral:
\n language: es # Language: ‘es’ or ‘en’
\n update-check: true # Check for updates on startup
\n“`<\/p>\n
\ncapsules:
\n item: EGG # Item type for capsules (EGG, SNOWBALL, etc.)
\n display-name: “&6Capture Capsule”
\n lore:
\n – “&7Throw this capsule at a creature”
\n – “&7to attempt to capture it.”
\n – “”
\n – “&eCatch ’em all!”
\n projectile-type: EGG # Projectile type when thrown
\n base-capture-chance: 0.7 # 70% base chance
\n“`<\/p>\n
\nsounds:
\n enabled: true
\n capture-success: ENTITY_PLAYER_LEVELUP # Sound on success
\n capture-fail: ENTITY_ENDERMAN_TELEPORT # Sound on failure
\n volume: 1.0
\n pitch: 1.0
\n“`<\/p>\n
\nparticles:
\n enabled: true
\n capture-particle: HEART # Particle type
\n amount: 10 # Number of particles
\n radius: 1.0 # Spread radius
\n“`<\/p>\n
\nstorage:
\n type: YAML # YAML, MYSQL, or SQLITE<\/p>\n
\n mysql:
\n host: localhost
\n port: 3306
\n database: minecraft
\n username: user
\n password: password
\n table-prefix: capsulax_<\/p>\n
\n sqlite:
\n filename: capsulax.db
\n“`<\/p>\n
\ndebug:
\n verbose-logging: false # Detailed console logs
\n log-captures: true # Log capture attempts
\n log-releases: true # Log mob releases
\n“`<\/p>\n
\nworlds:
\n mode: ALL
\n“`<\/p>\n
\nworlds:
\n mode: WHITELIST
\n enabled-worlds:
\n – world
\n – world_nether
\n – world_the_end
\n – custom_survival
\n – resource_world
\n“`<\/p>\n
\n– Servers with many worlds
\n– Strict control needed
\n– Want to block new worlds by default<\/p>\n
\n– \u2705 New worlds are automatically blocked
\n– \u2705 Maximum control
\n– \u2705 Ideal for large servers<\/p>\n
\nworlds:
\n mode: BLACKLIST
\n disabled-worlds:
\n – lobby
\n – spawn
\n – hub
\n – creative_world
\n – minigames
\n“`<\/p>\n
\n– Most worlds allow capsules
\n– Only need to block specific worlds (lobby, spawn, etc.)
\n– Want new worlds to allow capsules by default<\/p>\n
\n– \u2705 New worlds automatically allow capsules
\n– \u2705 Less configuration maintenance
\n– \u2705 Flexible for growing servers<\/p>\n
\n– Wrong: `World`, `WORLD_NETHER`, `mycustomworld`<\/p>\n
\n1. Look in your server’s root folder
\n2. World folders = world names
\n3. Or use `\/mv list` if using Multiverse<\/p>\n
\neconomy:
\n enabled: true
\n capsule-price: 100.0 # Price per capsule<\/p>\n
\n capture-rewards:
\n ENDER_DRAGON: 10000.0
\n WITHER: 5000.0
\n ELDER_GUARDIAN: 3000.0
\n WARDEN: 2500.0
\n“`<\/p>\n
\n\/capsulax buy [amount]
\n“`<\/p>\n
\n“`
\n\/capsulax buy \u2192 Buy 1 capsule for $100
\n\/capsulax buy 5 \u2192 Buy 5 capsules for $500
\n\/capsulax buy 64 \u2192 Buy 64 capsules for $6400
\n“`<\/p>\n
\n– Wither: $5,000
\n– Elder Guardian: $3,000
\n– Warden: $2,500<\/p>\n
\n\/capsulax [subcommand]
\n“`<\/p>\n
\n\/capsulax give
\n“`<\/p>\n
\n“`bash
\n# Give 10 empty capsules to Steve
\n\/capsulax give Steve 10<\/p>\n
\n\/capsulax give Steve 5<\/p>\n
\n\/capsulax give Steve COW 1<\/p>\n
\n\/capsulax give Alex CREEPER 3
\n“`<\/p>\n
\n\/capsulax list [page]
\n“`<\/p>\n
\n“`bash
\n\/capsulax list # Show page 1
\n\/capsulax list 2 # Show page 2
\n\/capsulax list 5 # Show page 5
\n“`<\/p>\n
\n\/capsulax buy [amount]
\n“`<\/p>\n
\n**Requires:** Vault + Economy plugin<\/p>\n
\n“`bash
\n\/capsulax buy # Buy 1 capsule
\n\/capsulax buy 10 # Buy 10 capsules
\n\/capsulax buy 64 # Buy 64 capsules (max)
\n“`<\/p>\n
\n\/capsulax reload
\n“`<\/p>\n
\n– config.yml
\n– messages files
\n– crafting recipes
\n– world settings<\/p>\n
\n\/capsulax help
\n“`<\/p>\n
\n|————|————-|———|
\n| `capsulax.command` | Use \/capsulax command | Everyone |
\n| `capsulax.command.give` | Give capsules to players | OP |
\n| `capsulax.command.reload` | Reload configuration | OP |
\n| `capsulax.command.list` | List capturable mobs | Everyone |
\n| `capsulax.command.buy` | Buy capsules | Everyone |<\/p>\n
\ncapsulax.capture.
\n“`<\/p>\n
\n“`yaml
\n# Allow capturing specific mobs
\npermissions:
\n – capsulax.capture.cow
\n – capsulax.capture.pig
\n – capsulax.capture.chicken
\n – capsulax.capture.zombie
\n – capsulax.capture.creeper
\n“`<\/p>\n
\ncapsulax.capture.*
\n“`<\/p>\n
\ncapsulax.spawn.
\n“`<\/p>\n
\n1. `capsulax.capture.
\n2. `capsulax.spawn.
\n3. `capsulax.spawn.*` \u2192 Release all mobs (default: true)<\/p>\n
\n“`yaml
\n# Player with capture permission can automatically release
\npermissions:
\n – capsulax.capture.cow # Can capture AND release cows<\/p>\n
\npermissions:
\n – capsulax.spawn.cow # Can release cows
\n – capsulax.spawn.zombie # Can release zombies
\n – capsulax.spawn.* # Can release all mobs (DEFAULT)
\n“`<\/p>\n
\ncapsulax.crafting.capsule
\n“`<\/p>\n
\n# Basic player – can only capture passive mobs
\nlp group default permission set capsulax.command true
\nlp group default permission set capsulax.command.list true
\nlp group default permission set capsulax.capture.cow true
\nlp group default permission set capsulax.capture.pig true
\nlp group default permission set capsulax.capture.sheep true<\/p>\n
\nlp group vip permission set capsulax.capture.zombie true
\nlp group vip permission set capsulax.capture.skeleton true
\nlp group vip permission set capsulax.capture.creeper true<\/p>\n
\nlp group admin permission set capsulax.capture.* true
\nlp group admin permission set capsulax.command.give true
\nlp group admin permission set capsulax.command.reload true
\n“`<\/p>\n
\ncapsules:
\n base-capture-chance: 0.95 # 95% base rate
\n capture-settings:
\n passive:
\n multiplier: 1.0
\n hostile:
\n multiplier: 0.9
\n bosses:
\n enabled: true
\n multiplier: 0.5 # 50% for bosses
\n“`<\/p>\n
\ncapsules:
\n base-capture-chance: 0.3 # 30% base rate
\n capture-settings:
\n passive:
\n multiplier: 0.8
\n hostile:
\n multiplier: 0.4
\n bosses:
\n enabled: true
\n multiplier: 0.05 # 5% for bosses
\n“`<\/p>\n
\ncapsules:
\n base-capture-chance: 0.1
\n capture-settings:
\n passive:
\n enabled: false
\n hostile:
\n enabled: false
\n bosses:
\n enabled: true
\n multiplier: 1.0
\n“`<\/p>\n
\ncapsules:
\n base-capture-chance: 0.7
\n overrides:
\n # Easy to catch
\n CHICKEN: 1.0
\n COW: 1.0
\n PIG: 1.0<\/p>\n
\n ZOMBIE: 0.5
\n SKELETON: 0.5<\/p>\n
\n CREEPER: 0.3
\n ENDERMAN: 0.2<\/p>\n
\n WITHER: 0.01
\n ENDER_DRAGON: 0.005
\n“`<\/p>\n
\n1. Check `worlds.mode` in config.yml
\n2. If using WHITELIST, make sure your world is listed
\n3. Use `\/capsulax reload` after changes
\n4. Check console for errors<\/p>\n
\n1. Verify world name is spelled correctly (case-sensitive)
\n2. If using BLACKLIST, make sure the world is in `disabled-worlds`
\n3. Use `\/capsulax reload` after changes<\/p>\n
\n1. Check capture probabilities in config.yml
\n2. Increase `base-capture-chance`
\n3. Make sure mob is not in a protected region
\n4. Check permissions: `capsulax.capture.
\n1. Check `crafting.enabled: true` in config
\n2. Verify player has permission: `capsulax.crafting.capsule`
\n3. Make sure ingredients are correct
\n4. Try `\/capsulax reload`<\/p>\n
\n1. Install Vault plugin
\n2. Install an economy plugin (EssentialsX, etc.)
\n3. Check `economy.enabled: true` in config
\n4. Restart server after installing Vault<\/p>\n
\n1. Check Minecraft version (1.21.4+ required)
\n2. Check Java version (Java 17+ required)
\n3. Look for errors in console
\n4. Make sure you’re using Paper or Spigot
\n5. Check for conflicting plugins<\/p>\n
\n– Equipment (armor, weapons)
\n– Custom names
\n– Potion effects
\n– Baby\/Adult state
\n– Villager professions
\n– And more!<\/p>\n
\n“`yaml
\ncapsules:
\n capture-settings:
\n bosses:
\n enabled: true
\n“`<\/p>\n
\n“`yaml
\ncapsules:
\n base-capture-chance: 0.95 # Increase this value
\n“`<\/p>\n
\n“`yaml
\ncapsules:
\n item: SNOWBALL # or any other item
\n projectile-type: SNOWBALL
\n“`<\/p>\n