CapsulaX 是一款 Minecraft 插件,允许玩家将生物捕获到特殊的胶囊(蛋)中,并在需要时释放它们。类似于《宝可梦》的机制,玩家可以向怪物投掷胶囊来捕获它们,将其存储在物品栏中,并在稍后释放。
主要功能
- ✅ 捕获任意生物 - 支持超过 100 种不同的生物类型
- ✅ 可配置的捕获概率 - 可根据生物类别自定义捕获率
- ✅ 合成系统 - 玩家可以制作自己的胶囊
- ✅ 经济集成 - 通过 Vault 买卖胶囊
- ✅ 世界管理 - 控制胶囊可以在哪些地方使用
- ✅ 视觉效果 - 捕获时显示粒子效果和声音
- ✅ 多语言支持 - 支持英语和西班牙语(可扩展)
- ✅ 权限控制 - 针对每种生物类型进行细粒度控制
? 安装指南
环境要求
- 服务器类型: Paper、Spigot 或任何基于 Paper/Spigot 的分支版本
- Minecraft 版本: 1.21.4 或更高版本
- Java 版本: 17 或更高版本
可选依赖项
- Vault - 用于经济功能(购买胶囊)
- WorldGuard - 用于区域保护(计划中)
- MythicMobs - 用于自定义生物支持(计划中)
安装步骤
- 下载 CapsulaX.jar 文件(从发布页面获取)
- 停止 你的服务器
- 放置 .jar 文件到你的
plugins/ 文件夹中
- 启动 服务器
- 配置 插件设置,位于
plugins/CapsulaX/config.yml
- 重载 插件,执行命令
/capsulax reload
? 快速上手
初始步骤
安装 CapsulaX 后,请按照以下步骤操作:
-
给自己一个胶囊:
/capsulax give <你的用户名> 10
-
查看可用的生物列表:
/capsulax list
-
在世界中找到一只生物
-
将胶囊扔向该生物或对其右键点击
-
如果成功,该生物将被捕获,你会获得一个已装满生物的胶囊
-
手持已装满生物的胶囊右键点击以释放该生物
? 制作胶囊
默认配方
玩家可以使用以下配方制作捕获胶囊:
[I] [I] [I]
[I] [G] [I]
[I] [I] [I]
I = 铁锭 (Iron Ingot)
G = 玻璃块 (Glass Block)
结果: 8 个捕获胶囊
配方详情
- 图案: 3x3 工作台
- 中心位置: 1 个玻璃块
- 周围位置: 8 个铁锭
- 产出: 8 个空胶囊
自定义配方
你可以在 config.yml 中更改配方:
crafting:
enabled: true
pattern:
- "III"
- "IGI"
- "III"
ingredients:
I: "IRON_INGOT"
G: "GLASS"
result-amount: 8
示例 - 钻石配方:
crafting:
enabled: true
pattern:
- "DDD"
- "DGD"
- "DDD"
ingredients:
D: "DIAMOND"
G: "GLASS"
result-amount: 4
禁用合成
在 crafting 部分设置 enabled: false:
crafting:
enabled: false
玩家只能通过指令或经济系统获取胶囊。
? 如何使用胶囊
捕获生物
有两种方法可以捕获生物:
方法一:投掷胶囊(推荐)
- 手持 空胶囊
- 瞄准 你想要捕获的生物
- 投掷 胶囊(右键点击)
- 胶囊会飞向目标生物
- 如果击中 生物,开始尝试捕获
优势:
- ✅ 更安全 - 可以从远处捕获
- ✅ 适用于快速或危险的生物
- ✅ 游戏沉浸感更强
方法二:直接点击
- 手持 空胶囊
- 直接右键点击 生物
- 立即开始尝试捕获
优势:
- ✅ 更精准
- ✅ 在狭窄空间中效果更好
- ✅ 如果捕获失败,不会消耗胶囊
捕获成功或失败
当你尝试捕获生物时:
✅ 成功:
- 生物消失
- 你获得一个装有该生物的已满胶囊
- 播放成功音效并显示粒子效果
- 记录捕获统计数据
❌ 失败:
- 生物逃脱
- 胶囊被消耗
- 播放失败音效
- 生物可能会随机移动
释放生物
要释放捕获的生物:
- 手持 已装满生物的胶囊
- 在空中或方块上右键点击
- 生物将在你的位置生成
- 你将收回一个空胶囊
注意:
- 生成的生物拥有与捕获时相同的生命值和属性
- 幼年生物保持幼年状态,驯服的狼保持驯服状态,等等
- 如果配置了保护世界,则无法在被保护的世界中释放生物
? 捕获概率系统
CapsulaX 使用基于多种因素的复杂概率系统:
基础捕获几率
默认值:70%(可在 config.yml 中配置)
capsules:
base-capture-chance: 0.7 # 70%
生物分类
不同类型的生物具有不同的捕获倍率:
1. 被动生物(基础值的 100%)
倍率: 1.0 → 70% 捕获率
- 牛、猪、羊、鸡
- 马、驴、骆驼
- 猫、狼、兔子
- 村民、铁傀儡
- 狐狸、熊猫、蜜蜂
2. 敌对生物(基础值的 70%)
倍率: 0.7 → 49% 捕获率
- 僵尸、骷髅、苦力怕
- 蜘蛛、洞穴蜘蛛
- 末影人、女巫、烈焰人
- 恶魂、史莱姆、幻翼
- 掠夺者、卫道士、唤魔者
3. 水生生物(基础值的 60%)
倍率: 0.6 → 42% 捕获率
- 鱿鱼、发光鱿鱼
- 海豚、海龟
- 守卫者、远古守卫者
- 鱼类(鳕鱼、鲑鱼、热带鱼、河豚)
- 美西螈
4. 下界生物(基础值的 40%)
倍率: 0.4 → 28% 捕获率
- 猪灵、猪灵蛮兵
- 疣猪兽、疣猪兽僵尸
- 僵尸猪灵
- 凋灵骷髅
- 岩浆怪、漫步者
5. 末地生物(基础值的 30%)
倍率: 0.3 → 21% 捕获率
6. Boss 生物(基础值的 10% - 默认禁用)
倍率: 0.1 → 7% 捕获率
基于生命值的倍率
生物的当前生命值会影响捕获几率:
公式:
生命值倍率 = 1.0 - (当前生命值 / 最大生命值) × 0.5
示例:
- 怪物生命值为 100%:乘数 = 0.5(捕获率为 50%)
- 怪物生命值为 50%:乘数 = 0.75(捕获率为 75%)
- 怪物生命值为 10%:乘数 = 0.95(捕获率为 95%)
- 怪物生命值为 1 HP:乘数 = 0.99(捕获率为 99%)
? 策略: 在捕获前对怪物造成伤害,以提高成功率!
最终计算
最终的捕获几率为:
最终几率 = 基础几率 × 类别乘数 × 生命值乘数
示例 1 - 健康的牛:
- 基础:70%
- 类别(被动生物):100%
- 生命值:50%
- 最终:35%
示例 2 - 受伤的僵尸:
- 基础:70%
- 类别(敌对生物):70%
- 生命值:75%(怪物剩余 50% 生命值)
- 最终:36.75%
示例 3 - 濒临死亡的苦力怕:
- 基础:70%
- 类别(敌对生物):70%
- 生命值:95%(怪物剩余 10% 生命值)
- 最终:46.55%
自定义覆盖
您可以覆盖特定怪物的概率:
capsules:
overrides:
CREEPER: 0.9 # 苦力怕的捕获率为 90%
ZOMBIE: 0.5 # 僵尸的捕获率为 50%
ENDER_DRAGON: 0.01 # 末影龙的捕获率为 1%
⚙️ 配置指南
主配置文件位于:plugins/CapsulaX/config.yml
常规设置
general:
language: es # 语言:'es' 或 'en'
update-check: true # 启动时检查更新
胶囊设置
capsules:
item: EGG # 胶囊的物品类型(EGG、SNOWBALL 等)
display-name: "&6Capture Capsule"
lore:
- "&7将此胶囊投掷到生物身上"
- "&7以尝试捕获它。"
- ""
- "&eCatch 'em all!"
projectile-type: EGG # 投掷时的投射物类型
base-capture-chance: 0.7 # 70% 的基础几率
音效
sounds:
enabled: true
capture-success: ENTITY_PLAYER_LEVELUP # 成功时的音效
capture-fail: ENTITY_ENDERMAN_TELEPORT # 失败时的音效
volume: 1.0
pitch: 1.0
可用音效列表:
粒子效果
particles:
enabled: true
capture-particle: HEART # 粒子类型
amount: 10 # 粒子数量
radius: 1.0 # 扩散半径
可用粒子列表:
存储设置
storage:
type: YAML # YAML、MYSQL 或 SQLITE
# MySQL 设置(如果 type: MYSQL)
mysql:
host: localhost
port: 3306
database: minecraft
username: user
password: password
table-prefix: capsulax_
# SQLite 设置(如果 type: SQLITE)
sqlite:
filename: capsulax.db
调试设置
debug:
verbose-logging: false # 详细的控制台日志
log-captures: true # 记录捕获尝试
log-releases: true # 记录释放生物
? 世界管理
CapsulaX 包含一个灵活的世界管理系统,提供三种模式:
模式 1:ALL(允许所有世界)
默认模式 - 胶囊在所有世界中均可使用
worlds:
mode: ALL
适用场景: 简单服务器、原版玩法
模式 2:白名单(允许特定世界)
仅允许在列出的世界中生成胶囊。
worlds:
mode: WHITELIST
enabled-worlds:
- world
- world_nether
- world_the_end
- custom_survival
- resource_world
使用场景:
- 拥有大量世界的服务器
- 需要严格管控
- 希望默认阻止新世界的胶囊生成
优势:
- ✅ 新世界的胶囊生成自动被阻止
- ✅ 最大程度的控制力
- ✅ 非常适合大型服务器
模式 3:黑名单(阻止特定世界)
允许在所有世界中生成胶囊,除非列出的例外世界。
worlds:
mode: BLACKLIST
disabled-worlds:
- lobby
- spawn
- hub
- creative_world
- minigames
使用场景:
- 大多数世界都允许胶囊生成
- 只需阻止特定世界(如大厅、出生点等)
- 希望新世界的胶囊生成默认为开启状态
优势:
- ✅ 新世界的胶囊生成自动允许
- ✅ 减少配置维护工作
- ✅ 适合不断成长的服务器
世界名称
⚠️ 重要提示: 世界名称区分大小写!
- 正确示例:
world, world_nether, MyCustomWorld
- 错误示例:
World, WORLD_NETHER, mycustomworld
如何查找准确的世界名称:
- 查看服务器根目录文件夹
- 世界文件夹名即为世界名称
- 如果使用 Multiverse 插件,可使用
/mv list 命令
? 经济系统
需安装 Vault 插件。
配置
economy:
enabled: true
capsule-price: 100.0 # 每个胶囊的价格
# 捕获稀有生物获得的奖励
capture-rewards:
ENDER_DRAGON: 10000.0
WITHER: 5000.0
ELDER_GUARDIAN: 3000.0
WARDEN: 2500.0
购买胶囊
玩家可以使用游戏内货币购买胶囊:
/capsulax buy [amount]
示例:
/capsulax buy → 花费 $100 购买 1 个胶囊
/capsulax buy 5 → 花费 $500 购买 5 个胶囊
/capsulax buy 64 → 花费 $6400 购买 64 个胶囊
捕获奖励
当玩家捕获稀有生物时(如果已配置),他们将获得金钱奖励:
- 末影龙:$10,000
- 凋灵:$5,000
- 远古守卫者:$3,000
- 监守者:$2,500
在 config.yml 的 economy.capture-rewards 下自定义奖励。
? 命令
主命令
/capsulax [subcommand]
别名: /cx, /capsula
可用子命令
1. 给予胶囊
/capsulax give <player> [mob] [amount]
权限: capsulax.command.give
示例:
# 给 Steve 10 个空胶囊
/capsulax give Steve 10
# 给 Steve 5 个空胶囊
/capsulax give Steve 5
# 给 Steve 1 个装有牛的胶囊
/capsulax give Steve COW 1
# 给 Alex 3 个装有苦力怕的胶囊
/capsulax give Alex CREEPER 3
2. 列出可捕获的生物
/capsulax list [page]
权限: capsulax.command.list
示例:
/capsulax list # 显示第 1 页
/capsulax list 2 # 显示第 2 页
/capsulax list 5 # 显示第 5 页
显示所有可以被捕获的生物及其捕获率。
3. 购买胶囊
/capsulax buy [数量]
权限: capsulax.command.buy
依赖: Vault + 经济插件
示例:
/capsulax buy # 购买 1 个胶囊
/capsulax buy 10 # 购买 10 个胶囊
/capsulax buy 64 # 购买 64 个胶囊(上限)
4. 重载配置
/capsulax reload
权限: capsulax.command.reload
无需重启服务器即可重新加载所有配置文件。
重新加载内容:
- config.yml
- 消息文件
- 合成配方
- 世界设置
5. 帮助
/capsulax help
权限: capsulax.command
根据你的权限显示所有可用命令。
? 权限说明
基础权限
| 权限 |
描述 |
默认状态 |
capsulax.command |
使用 /capsulax 命令 |
所有人 |
capsulax.command.give |
向玩家发放胶囊 |
OP |
capsulax.command.reload |
重载配置 |
OP |
capsulax.command.list |
列出可捕获的生物 |
所有人 |
capsulax.command.buy |
购买胶囊 |
所有人 |
捕获权限
控制玩家可以捕获哪些生物:
单个生物权限
capsulax.capture.<mob_name>
示例:
# 允许捕获特定生物
permissions:
- capsulax.capture.cow
- capsulax.capture.pig
- capsulax.capture.chicken
- capsulax.capture.zombie
- capsulax.capture.creeper
通配符权限
capsulax.capture.*
允许捕获所有生物(如果启用了 Boss,则包括 Boss)
释放权限
控制玩家可以释放哪些生物:
capsulax.spawn.<mob_name>
默认行为: 如果玩家拥有捕获某生物的权限,他们自动拥有释放该生物的权限。这很合乎逻辑——既然你能抓住它,就应该能释放它!
权限层级:
capsulax.capture.<mob> → 自动授予释放权限
capsulax.spawn.<mob> → 显式释放权限
capsulax.spawn.* → 释放所有生物(默认:开启)
示例:
# 拥有捕获权限的玩家可自动释放
permissions:
- capsulax.capture.cow # 可以捕获和释放牛
# 或者使用显式的生成权限
permissions:
- capsulax.spawn.cow # 可以释放牛
- capsulax.spawn.zombie # 可以释放僵尸
- capsulax.spawn.* # 可以释放所有生物(默认)
重要提示: capsulax.spawn.* 权限对所有玩家默认启用,因此普通玩家可以释放他们捕获的任何生物。
合成权限
capsulax.crafting.capsule
默认: 仅 OP
玩家需要此权限才能合成胶囊。
权限组示例
适用于 LuckPerms:
# 普通玩家 - 只能捕获被动生物
lp group default permission set capsulax.command true
lp group default permission set capsulax.command.list true
lp group default permission set capsulax.capture.cow true
lp group default permission set capsulax.capture.pig true
lp group default permission set capsulax.capture.sheep true
# VIP - 可以捕获被动 + 敌对生物
lp group vip permission set capsulax.capture.zombie true
lp group vip permission set capsulax.capture.skeleton true
lp group vip permission set capsulax.capture.creeper true
# 管理员 - 可以捕获一切
lp group admin permission set capsulax.capture.* true
lp group admin permission set capsulax.command.give true
lp group admin permission set capsulax.command.reload true
? 自定义配置
示例 1:高捕获率(简单模式)
capsules:
base-capture-chance: 0.95 # 95% 基础概率
capture-settings:
passive:
multiplier: 1.0
hostile:
multiplier: 0.9
bosses:
enabled: true
multiplier: 0.5 # Boss 为 50%
示例 2:困难模式(具有挑战性)
capsules:
base-capture-chance: 0.3 # 30% 基础概率
capture-settings:
passive:
multiplier: 0.8
hostile:
multiplier: 0.4
bosses:
enabled: true
multiplier: 0.05 # Boss 为 5%
示例 3:仅 Boss 服务器
capsules:
base-capture-chance: 0.1
capture-settings:
passive:
enabled: false
hostile:
enabled: false
bosses:
enabled: true
multiplier: 1.0
示例 4:自定义生物概率
capsules:
base-capture-chance: 0.7
overrides:
# 容易捕获
CHICKEN: 1.0
COW: 1.0
PIG: 1.0
# 中等难度
ZOMBIE: 0.5
SKELETON: 0.5
# 难以捕获
CREEPER: 0.3
ENDERMAN: 0.2
# 极罕见
WITHER: 0.01
ENDER_DRAGON: 0.005
? 故障排除
胶囊在任何世界中都不生效
解决方案:
- 检查 config.yml 中的
worlds.mode
- 如果使用 WHITELIST(白名单),请确保你的世界已列出
- 更改后使用
/capsulax reload
- 检查控制台是否有错误
胶囊在不应该生效的世界中生效了
解决方案:
- 验证世界名称拼写是否正确(区分大小写)
- 如果使用 BLACKLIST(黑名单),请确保该世界在
disabled-worlds 列表中
- 更改后使用
/capsulax reload
捕获总是失败
解决方案:
- 检查 config.yml 中的捕获概率
- 增加
base-capture-chance
- 确保生物不在受保护的区域
- 检查权限:
capsulax.capture.<mob>
合成配方不生效
解决方案:
- 检查配置中的
crafting.enabled: true
- 验证玩家是否拥有权限:
capsulax.crafting.capsule
- 确保材料正确
- 尝试
/capsulax reload
经济功能不生效
解决方案:
- 安装 Vault 插件
- 安装经济插件(如 EssentialsX 等)
- 检查配置中的
economy.enabled: true
- 安装 Vault 后重启服务器
插件未加载
解决方案:
- 检查 Minecraft 版本(需要 1.21.4+)
- 检查 Java 版本(需要 Java 17+)
- 查看控制台中的错误信息
- 确保你使用的是 Paper 或 Spigot
- 检查是否存在冲突的插件
❓ 常见问题
我能捕获玩家拥有的马/宠物吗?
可以,但前提是玩家拥有相应的权限。被驯服的动物在捕获和释放时会保留其所有者身份。
怪物在被捕获后会保留装备吗?
是的!所有怪物数据都会被保留:
- 装备(盔甲、武器)
- 自定义名称
- 药水效果
- 幼年/成年状态
- 村民职业
- 以及更多!
我能捕获 Mythic Mobs 吗?
对 MythicMobs 的支持计划中,但尚未实现。
如果我的背包已满怎么办?
装满的胶囊会掉落至你脚边的地面上。
装满的胶囊可以堆叠吗?
不可以,装满的胶囊无法堆叠。每个装满的胶囊都包含独特的怪物数据。
我可以出售装满的胶囊吗?
插件本身不直接支持出售,但玩家可以像交易其他物品一样正常交易它们。
这与 Multiverse 兼容吗?
是的!CapsulaX 可与任何世界管理插件配合使用。
我能捕获末影龙吗?
只有在配置文件中启用 Boss 捕获功能时才可以:
capsules:
capture-settings:
bosses:
enabled: true
如何提高捕获率?
编辑 config.yml 文件:
capsules:
base-capture-chance: 0.95 # 增加此数值
我可以在特定区域禁用胶囊吗?
WorldGuard 集成计划在后续版本中推出。目前,请使用世界管理插件来禁用整个世界。
被捕获的怪物是否计入怪物数量上限?
释放后的怪物会计入正常的怪物数量上限,与生成的怪物相同。
我可以自定义胶囊物品吗?
可以!更改物品类型:
capsules:
item: SNOWBALL # 或任何其他物品
projectile-type: SNOWBALL
? 感谢支持!
感谢您使用 CapsulaX!希望您和您的玩家在 Minecraft 中享受捕获和收集生物的乐趣。
CapsulaX v1.0.1 - 全部收服!?
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
- Download CapsulaX.jar from the release page
- Stop your server
- Place the .jar file in your
plugins/ folder
- Start your server
- Configure the plugin in
plugins/CapsulaX/config.yml
- Reload with
/capsulax reload
? Getting Started
First Steps
After installing CapsulaX, follow these steps:
-
Give yourself a capsule:
/capsulax give <your_name> 10
-
Check available mobs:
/capsulax list
-
Find a mob in your world
-
Throw the capsule at the mob or right-click on it
-
If successful, the mob will be captured and you'll receive a filled capsule
-
Right-click with the filled capsule to release the mob
? Crafting Capsules
Default Recipe
Players can craft capture capsules using the following recipe:
[I] [I] [I]
[I] [G] [I]
[I] [I] [I]
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:
crafting:
enabled: true
pattern:
- "III"
- "IGI"
- "III"
ingredients:
I: "IRON_INGOT"
G: "GLASS"
result-amount: 8
Example - Diamond Recipe:
crafting:
enabled: true
pattern:
- "DDD"
- "DGD"
- "DDD"
ingredients:
D: "DIAMOND"
G: "GLASS"
result-amount: 4
Disabling Crafting
Set enabled: false in the crafting section:
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)
- Hold an empty capsule in your hand
- Aim at the mob you want to capture
- Throw the capsule (right-click)
- The capsule will fly toward the mob
- 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
- Hold an empty capsule in your hand
- Right-click directly on the mob
- 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:
- Hold the filled capsule in your hand
- Right-click in the air or on a block
- The mob will spawn at your location
- 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)
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
- Ghast, Slime, Phantom
- Pillager, Vindicator, Evoker
3. Water Mobs (60% of base)
Multiplier: 0.6 → 42% capture rate
- Squid, Glow Squid
- Dolphin, Turtle
- Guardian, Elder Guardian
- Fish (Cod, Salmon, Tropical Fish, Pufferfish)
- Axolotl
4. Nether Mobs (40% of base)
Multiplier: 0.4 → 28% capture rate
- Piglin, Piglin Brute
- Hoglin, Zoglin
- Zombified Piglin
- Wither Skeleton
- Magma Cube, Strider
5. End Mobs (30% of base)
Multiplier: 0.3 → 21% capture rate
6. Boss Mobs (10% of base - Disabled by default)
Multiplier: 0.1 → 7% capture rate
- Ender Dragon
- Wither
- Elder Guardian
- Warden
Health-Based Multiplier
The mob's current health affects capture chance:
Formula:
Health Multiplier = 1.0 - (Current Health / Max Health) × 0.5
Examples:
- Mob at 100% health: multiplier = 0.5 (50% capture rate)
- Mob at 50% health: multiplier = 0.75 (75% capture rate)
- Mob at 10% health: multiplier = 0.95 (95% capture rate)
- Mob at 1 HP: multiplier = 0.99 (99% capture rate)
? Strategy: Damage mobs before capturing them for better success rates!
Final Calculation
The final capture chance is:
Final Chance = Base Chance × Category Multiplier × Health Multiplier
Example 1 - Healthy Cow:
- Base: 70%
- Category (Passive): 100%
- Health: 50%
- Final: 35%
Example 2 - Damaged Zombie:
- Base: 70%
- Category (Hostile): 70%
- Health: 75% (mob at 50% HP)
- Final: 36.75%
Example 3 - Nearly Dead Creeper:
- Base: 70%
- Category (Hostile): 70%
- Health: 95% (mob at 10% HP)
- Final: 46.55%
Custom Overrides
You can override specific mob probabilities:
capsules:
overrides:
CREEPER: 0.9 # 90% catch rate for Creepers
ZOMBIE: 0.5 # 50% catch rate for Zombies
ENDER_DRAGON: 0.01 # 1% catch rate for Dragon
⚙️ Configuration Guide
The main configuration file is located at: plugins/CapsulaX/config.yml
General Settings
general:
language: es # Language: 'es' or 'en'
update-check: true # Check for updates on startup
Capsule Settings
capsules:
item: EGG # Item type for capsules (EGG, SNOWBALL, etc.)
display-name: "&6Capture Capsule"
lore:
- "&7Throw this capsule at a creature"
- "&7to attempt to capture it."
- ""
- "&eCatch 'em all!"
projectile-type: EGG # Projectile type when thrown
base-capture-chance: 0.7 # 70% base chance
Sound Effects
sounds:
enabled: true
capture-success: ENTITY_PLAYER_LEVELUP # Sound on success
capture-fail: ENTITY_ENDERMAN_TELEPORT # Sound on failure
volume: 1.0
pitch: 1.0
Available sounds:
Particle Effects
particles:
enabled: true
capture-particle: HEART # Particle type
amount: 10 # Number of particles
radius: 1.0 # Spread radius
Available particles:
Storage Settings
storage:
type: YAML # YAML, MYSQL, or SQLITE
# MySQL settings (if type: MYSQL)
mysql:
host: localhost
port: 3306
database: minecraft
username: user
password: password
table-prefix: capsulax_
# SQLite settings (if type: SQLITE)
sqlite:
filename: capsulax.db
Debug Settings
debug:
verbose-logging: false # Detailed console logs
log-captures: true # Log capture attempts
log-releases: true # Log mob releases
? World Management
CapsulaX includes a flexible world management system with three modes:
Mode 1: ALL (Allow All Worlds)
Default mode - Capsules work in all worlds
worlds:
mode: ALL
Use case: Simple servers, vanilla gameplay
Mode 2: WHITELIST (Allow Specific Worlds)
Only allows capsules in listed worlds
worlds:
mode: WHITELIST
enabled-worlds:
- world
- world_nether
- world_the_end
- custom_survival
- resource_world
Use case:
- Servers with many worlds
- Strict control needed
- Want to block new worlds by default
Advantages:
- ✅ New worlds are automatically blocked
- ✅ Maximum control
- ✅ Ideal for large servers
Mode 3: BLACKLIST (Block Specific Worlds)
Allows capsules in all worlds EXCEPT listed ones
worlds:
mode: BLACKLIST
disabled-worlds:
- lobby
- spawn
- hub
- creative_world
- minigames
Use case:
- Most worlds allow capsules
- Only need to block specific worlds (lobby, spawn, etc.)
- Want new worlds to allow capsules by default
Advantages:
- ✅ New worlds automatically allow capsules
- ✅ Less configuration maintenance
- ✅ Flexible for growing servers
World Names
⚠️ Important: World names are case-sensitive!
- Correct:
world, world_nether, MyCustomWorld
- Wrong:
World, WORLD_NETHER, mycustomworld
How to find exact world names:
- Look in your server's root folder
- World folders = world names
- Or use
/mv list if using Multiverse
? Economy System
Requires Vault plugin installed.
Configuration
economy:
enabled: true
capsule-price: 100.0 # Price per capsule
# Rewards for capturing rare mobs
capture-rewards:
ENDER_DRAGON: 10000.0
WITHER: 5000.0
ELDER_GUARDIAN: 3000.0
WARDEN: 2500.0
Buying Capsules
Players can buy capsules with in-game money:
/capsulax buy [amount]
Examples:
/capsulax buy → Buy 1 capsule for $100
/capsulax buy 5 → Buy 5 capsules for $500
/capsulax buy 64 → Buy 64 capsules for $6400
Capture Rewards
When a player captures a rare mob (if configured), they receive money:
- Ender Dragon: $10,000
- Wither: $5,000
- Elder Guardian: $3,000
- Warden: $2,500
Customize rewards in config.yml under economy.capture-rewards.
? Commands
Main Command
/capsulax [subcommand]
Aliases: /cx, /capsula
Available Subcommands
1. Give Capsules
/capsulax give <player> [mob] [amount]
Permission: capsulax.command.give
Examples:
# Give 10 empty capsules to Steve
/capsulax give Steve 10
# Give 5 empty capsules to Steve
/capsulax give Steve 5
# Give 1 capsule with a Cow to Steve
/capsulax give Steve COW 1
# Give 3 capsules with Creepers to Alex
/capsulax give Alex CREEPER 3
2. List Capturable Mobs
/capsulax list [page]
Permission: capsulax.command.list
Examples:
/capsulax list # Show page 1
/capsulax list 2 # Show page 2
/capsulax list 5 # Show page 5
Shows all mobs that can be captured with their capture rates.
3. Buy Capsules
/capsulax buy [amount]
Permission: capsulax.command.buy
Requires: Vault + Economy plugin
Examples:
/capsulax buy # Buy 1 capsule
/capsulax buy 10 # Buy 10 capsules
/capsulax buy 64 # Buy 64 capsules (max)
4. Reload Configuration
/capsulax reload
Permission: capsulax.command.reload
Reloads all configuration files without restarting the server.
Reloads:
- config.yml
- messages files
- crafting recipes
- world settings
5. Help
/capsulax help
Permission: capsulax.command
Shows all available commands based on your permissions.
? Permissions
Basic Permissions
| Permission |
Description |
Default |
capsulax.command |
Use /capsulax command |
Everyone |
capsulax.command.give |
Give capsules to players |
OP |
capsulax.command.reload |
Reload configuration |
OP |
capsulax.command.list |
List capturable mobs |
Everyone |
capsulax.command.buy |
Buy capsules |
Everyone |
Capture Permissions
Control which mobs players can capture:
Individual Mob Permissions
capsulax.capture.<mob_name>
Examples:
# Allow capturing specific mobs
permissions:
- capsulax.capture.cow
- capsulax.capture.pig
- capsulax.capture.chicken
- capsulax.capture.zombie
- capsulax.capture.creeper
Wildcard Permission
capsulax.capture.*
Allows capturing all mobs (including bosses if enabled)
Release Permissions
Control which mobs players can release:
capsulax.spawn.<mob_name>
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!
Permission Hierarchy:
capsulax.capture.<mob> → Automatically grants release permission
capsulax.spawn.<mob> → Explicit release permission
capsulax.spawn.* → Release all mobs (default: true)
Examples:
# Player with capture permission can automatically release
permissions:
- capsulax.capture.cow # Can capture AND release cows
# Or use explicit spawn permission
permissions:
- capsulax.spawn.cow # Can release cows
- capsulax.spawn.zombie # Can release zombies
- capsulax.spawn.* # Can release all mobs (DEFAULT)
Important: The capsulax.spawn.* permission is enabled by default for all players, so normal players can release any mob they capture.
Crafting Permissions
capsulax.crafting.capsule
Default: OP only
Players need this permission to craft capsules.
Permission Groups Example
For LuckPerms:
# Basic player - can only capture passive mobs
lp group default permission set capsulax.command true
lp group default permission set capsulax.command.list true
lp group default permission set capsulax.capture.cow true
lp group default permission set capsulax.capture.pig true
lp group default permission set capsulax.capture.sheep true
# VIP - can capture passive + hostile mobs
lp group vip permission set capsulax.capture.zombie true
lp group vip permission set capsulax.capture.skeleton true
lp group vip permission set capsulax.capture.creeper true
# Admin - can capture everything
lp group admin permission set capsulax.capture.* true
lp group admin permission set capsulax.command.give true
lp group admin permission set capsulax.command.reload true
? Custom Configuration
Example 1: High Capture Rates (Easy Mode)
capsules:
base-capture-chance: 0.95 # 95% base rate
capture-settings:
passive:
multiplier: 1.0
hostile:
multiplier: 0.9
bosses:
enabled: true
multiplier: 0.5 # 50% for bosses
Example 2: Hard Mode (Challenging)
capsules:
base-capture-chance: 0.3 # 30% base rate
capture-settings:
passive:
multiplier: 0.8
hostile:
multiplier: 0.4
bosses:
enabled: true
multiplier: 0.05 # 5% for bosses
Example 3: Boss Only Server
capsules:
base-capture-chance: 0.1
capture-settings:
passive:
enabled: false
hostile:
enabled: false
bosses:
enabled: true
multiplier: 1.0
Example 4: Custom Mob Rates
capsules:
base-capture-chance: 0.7
overrides:
# Easy to catch
CHICKEN: 1.0
COW: 1.0
PIG: 1.0
# Medium difficulty
ZOMBIE: 0.5
SKELETON: 0.5
# Hard to catch
CREEPER: 0.3
ENDERMAN: 0.2
# Very rare
WITHER: 0.01
ENDER_DRAGON: 0.005
? Troubleshooting
Capsules don't work in any world
Solutions:
- Check
worlds.mode in config.yml
- If using WHITELIST, make sure your world is listed
- Use
/capsulax reload after changes
- Check console for errors
Capsules work in worlds they shouldn't
Solutions:
- Verify world name is spelled correctly (case-sensitive)
- If using BLACKLIST, make sure the world is in
disabled-worlds
- Use
/capsulax reload after changes
Capture always fails
Solutions:
- Check capture probabilities in config.yml
- Increase
base-capture-chance
- Make sure mob is not in a protected region
- Check permissions:
capsulax.capture.<mob>
Crafting recipe doesn't work
Solutions:
- Check
crafting.enabled: true in config
- Verify player has permission:
capsulax.crafting.capsule
- Make sure ingredients are correct
- Try
/capsulax reload
Economy features don't work
Solutions:
- Install Vault plugin
- Install an economy plugin (EssentialsX, etc.)
- Check
economy.enabled: true in config
- Restart server after installing Vault
Plugin doesn't load
Solutions:
- Check Minecraft version (1.21.4+ required)
- Check Java version (Java 17+ required)
- Look for errors in console
- Make sure you're using Paper or Spigot
- Check for conflicting plugins
❓ FAQ
Can I capture player-owned horses/pets?
Yes, but only if the player has the appropriate permissions. Tamed animals keep their owner when captured and released.
Do mobs keep their equipment when captured?
Yes! All mob data is preserved:
- Equipment (armor, weapons)
- Custom names
- Potion effects
- Baby/Adult state
- Villager professions
- And more!
Can I capture Mythic Mobs?
Support for MythicMobs is planned but not yet implemented.
What happens if my inventory is full?
The filled capsule will drop on the ground at your feet.
Can I stack filled capsules?
No, filled capsules cannot stack. Each filled capsule contains unique mob data.
Can I sell filled capsules?
Not directly through the plugin, but players can trade them normally.
Does this work with Multiverse?
Yes! CapsulaX works with any world management plugin.
Can I capture the Ender Dragon?
Only if you enable boss capturing in the config:
capsules:
capture-settings:
bosses:
enabled: true
How do I increase capture rates?
Edit config.yml:
capsules:
base-capture-chance: 0.95 # Increase this value
Can I disable capsules in specific regions?
WorldGuard integration is planned for future versions. Currently, use world management to disable entire worlds.
Do captured mobs count toward the mob cap?
Released mobs count toward the normal mob cap, same as spawned mobs.
Can I customize the capsule item?
Yes! Change the item type:
capsules:
item: SNOWBALL # or any other item
projectile-type: SNOWBALL
? Thank You!
Thank you for using CapsulaX! We hope you and your players enjoy capturing and collecting creatures in Minecraft.
CapsulaX v1.0.1 - Catch 'em all! ?
评论 0
登录后参与评分
还没有评论,来抢沙发吧