CapsulaX

插件

· 作者 DeLaRosaPlay

CapsulaX 是一个 Minecraft 插件,允许玩家将生物捕获到特殊的胶囊中,并随时释放它们。

0 本站下载 0 关注 更新于 1 年前

最新 1.0.1 · 1.21.10 · Bukkit / Paper

一键开服(送7天)

CapsulaX 是一款 Minecraft 插件,允许玩家将生物捕获到特殊的胶囊(蛋)中,并在需要时释放它们。类似于《宝可梦》的机制,玩家可以向怪物投掷胶囊来捕获它们,将其存储在物品栏中,并在稍后释放。

主要功能

  • ✅ 捕获任意生物 - 支持超过 100 种不同的生物类型
  • ✅ 可配置的捕获概率 - 可根据生物类别自定义捕获率
  • ✅ 合成系统 - 玩家可以制作自己的胶囊
  • ✅ 经济集成 - 通过 Vault 买卖胶囊
  • ✅ 世界管理 - 控制胶囊可以在哪些地方使用
  • ✅ 视觉效果 - 捕获时显示粒子效果和声音
  • ✅ 多语言支持 - 支持英语和西班牙语(可扩展)
  • ✅ 权限控制 - 针对每种生物类型进行细粒度控制

? 安装指南

环境要求

  • 服务器类型: Paper、Spigot 或任何基于 Paper/Spigot 的分支版本
  • Minecraft 版本: 1.21.4 或更高版本
  • Java 版本: 17 或更高版本

可选依赖项

  • Vault - 用于经济功能(购买胶囊)
  • WorldGuard - 用于区域保护(计划中)
  • MythicMobs - 用于自定义生物支持(计划中)

安装步骤

  1. 下载 CapsulaX.jar 文件(从发布页面获取)
  2. 停止 你的服务器
  3. 放置 .jar 文件到你的 plugins/ 文件夹中
  4. 启动 服务器
  5. 配置 插件设置,位于 plugins/CapsulaX/config.yml
  6. 重载 插件,执行命令 /capsulax reload

? 快速上手

初始步骤

安装 CapsulaX 后,请按照以下步骤操作:

  1. 给自己一个胶囊:

    /capsulax give <你的用户名> 10
    
  2. 查看可用的生物列表:

    /capsulax list
    
  3. 在世界中找到一只生物

  4. 将胶囊扔向该生物或对其右键点击

  5. 如果成功,该生物将被捕获,你会获得一个已装满生物的胶囊

  6. 手持已装满生物的胶囊右键点击以释放该生物


? 制作胶囊

默认配方

玩家可以使用以下配方制作捕获胶囊:

[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

玩家只能通过指令或经济系统获取胶囊。


? 如何使用胶囊

捕获生物

有两种方法可以捕获生物:

方法一:投掷胶囊(推荐)

  1. 手持 空胶囊
  2. 瞄准 你想要捕获的生物
  3. 投掷 胶囊(右键点击)
  4. 胶囊会飞向目标生物
  5. 如果击中 生物,开始尝试捕获

优势:

  • ✅ 更安全 - 可以从远处捕获
  • ✅ 适用于快速或危险的生物
  • ✅ 游戏沉浸感更强

方法二:直接点击

  1. 手持 空胶囊
  2. 直接右键点击 生物
  3. 立即开始尝试捕获

优势:

  • ✅ 更精准
  • ✅ 在狭窄空间中效果更好
  • ✅ 如果捕获失败,不会消耗胶囊

捕获成功或失败

当你尝试捕获生物时:

✅ 成功:

  • 生物消失
  • 你获得一个装有该生物的已满胶囊
  • 播放成功音效并显示粒子效果
  • 记录捕获统计数据

❌ 失败:

  • 生物逃脱
  • 胶囊被消耗
  • 播放失败音效
  • 生物可能会随机移动

释放生物

要释放捕获的生物:

  1. 手持 已装满生物的胶囊
  2. 在空中或方块上右键点击
  3. 生物将在你的位置生成
  4. 你将收回一个空胶囊

注意:

  • 生成的生物拥有与捕获时相同的生命值和属性
  • 幼年生物保持幼年状态,驯服的狼保持驯服状态,等等
  • 如果配置了保护世界,则无法在被保护的世界中释放生物

? 捕获概率系统

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

如何查找准确的世界名称:

  1. 查看服务器根目录文件夹
  2. 世界文件夹名即为世界名称
  3. 如果使用 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>

默认行为: 如果玩家拥有捕获某生物的权限,他们自动拥有释放该生物的权限。这很合乎逻辑——既然你能抓住它,就应该能释放它!

权限层级:

  1. capsulax.capture.<mob> → 自动授予释放权限
  2. capsulax.spawn.<mob> → 显式释放权限
  3. 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

? 故障排除

胶囊在任何世界中都不生效

解决方案:

  1. 检查 config.yml 中的 worlds.mode
  2. 如果使用 WHITELIST(白名单),请确保你的世界已列出
  3. 更改后使用 /capsulax reload
  4. 检查控制台是否有错误

胶囊在不应该生效的世界中生效了

解决方案:

  1. 验证世界名称拼写是否正确(区分大小写)
  2. 如果使用 BLACKLIST(黑名单),请确保该世界在 disabled-worlds 列表中
  3. 更改后使用 /capsulax reload

捕获总是失败

解决方案:

  1. 检查 config.yml 中的捕获概率
  2. 增加 base-capture-chance
  3. 确保生物不在受保护的区域
  4. 检查权限:capsulax.capture.<mob>

合成配方不生效

解决方案:

  1. 检查配置中的 crafting.enabled: true
  2. 验证玩家是否拥有权限:capsulax.crafting.capsule
  3. 确保材料正确
  4. 尝试 /capsulax reload

经济功能不生效

解决方案:

  1. 安装 Vault 插件
  2. 安装经济插件(如 EssentialsX 等)
  3. 检查配置中的 economy.enabled: true
  4. 安装 Vault 后重启服务器

插件未加载

解决方案:

  1. 检查 Minecraft 版本(需要 1.21.4+)
  2. 检查 Java 版本(需要 Java 17+)
  3. 查看控制台中的错误信息
  4. 确保你使用的是 Paper 或 Spigot
  5. 检查是否存在冲突的插件

❓ 常见问题

我能捕获玩家拥有的马/宠物吗?

可以,但前提是玩家拥有相应的权限。被驯服的动物在捕获和释放时会保留其所有者身份。


怪物在被捕获后会保留装备吗?

是的!所有怪物数据都会被保留:

  • 装备(盔甲、武器)
  • 自定义名称
  • 药水效果
  • 幼年/成年状态
  • 村民职业
  • 以及更多!

我能捕获 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 - 全部收服!?

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源