CapsulaX

**CapsulaX** is a Minecraft plugin that allows players to capture creatures in special capsules (eggs) and release them whenever they want. Similar to Pokémon mechanics, players can throw capsules at mobs to capture them, store them in their inventory, and release them later. ### Key Features - ✅ **Capture any mob** - Over 100+ different creature types supported - ✅ **Configurable probabilities** - Customize capture rates by mob category - ✅ **Crafting system** - Players can craft their own capsules - ✅ **Economy integration** - Buy/sell capsules with Vault - ✅ **World management** - Control where capsules can be used - ✅ **Visual effects** - Particles and sounds for captures - ✅ **Multilingual** - Supports English and Spanish (expandable) - ✅ **Permissions** - Granular control per mob type --- ## 📦 Installation ### Requirements - **Server Type:** Paper, Spigot, or any Paper/Spigot fork - **Minecraft Version:** 1.21.4 or higher - **Java Version:** 17 or higher ### Optional Dependencies - **Vault** - For economy features (buying capsules) - **WorldGuard** - For region protection (planned) - **MythicMobs** - For custom mob support (planned) ### Installation Steps 1. **Download** CapsulaX.jar from the release page 2. **Stop** your server 3. **Place** the .jar file in your `plugins/` folder 4. **Start** your server 5. **Configure** the plugin in `plugins/CapsulaX/config.yml` 6. **Reload** with `/capsulax reload` --- ## 🚀 Getting Started ### First Steps After installing CapsulaX, follow these steps: 1. **Give yourself a capsule:** ``` /capsulax give <your_name> 10 ``` 2. **Check available mobs:** ``` /capsulax list ``` 3. **Find a mob** in your world 4. **Throw the capsule** at the mob or right-click on it 5. **If successful**, the mob will be captured and you'll receive a filled capsule 6. **Right-click** with the filled capsule to release the mob --- ## 🔨 Crafting Capsules ### Default Recipe Players can craft capture capsules using the following recipe: ``` I = Iron Ingot G = Glass Block ``` **Result:** 8 Capture Capsules ### Recipe Details - **Pattern:** 3x3 crafting table - **Center:** 1 Glass Block - **Surrounding:** 8 Iron Ingots - **Output:** 8 Empty Capsules ### Customizing the Recipe You can change the recipe in `config.yml`: ```yaml crafting: enabled: true pattern: - "III" - "IGI" - "III" ingredients: I: "IRON_INGOT" G: "GLASS" result-amount: 8 ``` **Example - Diamond Recipe:** ```yaml crafting: enabled: true pattern: - "DDD" - "DGD" - "DDD" ingredients: D: "DIAMOND" G: "GLASS" result-amount: 4 ``` ### Disabling Crafting Set `enabled: false` in the crafting section: ```yaml crafting: enabled: false ``` Players will only be able to get capsules through commands or economy. --- ## 🎯 How to Use Capsules ### Capturing Mobs There are **two methods** to capture mobs: #### Method 1: Throwing Capsules (Recommended) 1. **Hold** an empty capsule in your hand 2. **Aim** at the mob you want to capture 3. **Throw** the capsule (right-click) 4. The capsule will fly toward the mob 5. **If it hits** the mob, capture attempt begins **Advantages:** - ✅ Safer - capture from distance - ✅ Works on fast or dangerous mobs - ✅ More immersive gameplay #### Method 2: Direct Click 1. **Hold** an empty capsule in your hand 2. **Right-click** directly on the mob 3. Capture attempt begins immediately **Advantages:** - ✅ More precise - ✅ Works better in tight spaces - ✅ Doesn't consume capsule if capture fails ### Capture Success or Failure When you attempt to capture a mob: **✅ Success:** - Mob disappears - You receive a filled capsule with the mob inside - Success sound and particles appear - Capture statistics are recorded **❌ Failure:** - Mob escapes - Capsule is consumed - Failure sound plays - Mob may move randomly ### Releasing Mobs To release a captured mob: 1. **Hold** the filled capsule in your hand 2. **Right-click** in the air or on a block 3. The mob will spawn at your location 4. You receive an empty capsule back **Notes:** - The mob spawns with the same health and attributes - Baby mobs stay baby, tamed wolves stay tamed, etc. - You cannot release mobs in protected worlds (if configured) --- ## 📊 Capture Probability System CapsulaX uses a sophisticated probability system based on several factors: ### Base Capture Chance Default: **70%** (configurable in `config.yml`) ```yaml capsules: base-capture-chance: 0.7 # 70% ``` ### Mob Categories Different mob types have different capture multipliers: #### 1. Passive Mobs (100% of base) **Multiplier:** 1.0 → **70% capture rate** - Cow, Pig, Sheep, Chicken - Horse, Donkey, Llama - Cat, Wolf, Rabbit - Villagers, Iron Golems - Fox, Panda, Bee #### 2. Hostile Mobs (70% of base) **Multiplier:** 0.7 → **49% capture rate** - Zombie, Skeleton, Creeper - Spider, Cave Spider - Enderman, Witch, Blaze -