Throwable Creeper Eggs - 可投掷苦力怕蛋

这是一款可投掷的 Creeper Egg 插件，支持自定义爆炸时间、爆炸范围等选项，并提供兼容性与 API 支持，适合需要趣味投掷爆炸玩法的服务器使用。

💡版本支持

• 支持版本：1.7.2 - 1.20.4（version 2.3.0）
• Version 2.4.0+ 仅支持 1.21 及以上版本

⭐功能特点

• 可在 config 中配置：
• 爆炸倒计时
• 爆炸范围
• 更多行为选项
• 兼容：
• WildStacker
• CoreProtect
• 支持普通与 Charged Creeper Egg 的独立配置
• 支持投掷冷却
• 支持方块爆炸过滤
• 支持掉落配置
• 支持随机变为 Charged Creeper 的机制

✨致谢

• 感谢 Gus_198_ 制作了这个插件的精彩教程！（Gracias!）

🎮配置示例

`config.yml`

creeper-egg:
  glowing: false
  material: CREEPER_SPAWN_EGG
  # 针对不同 Minecraft 版本进行修改
  display-name: "&eThrowable Creeper Egg"
  lore:
    - "&8Sssssssssssss"
    - "&fLeft Click &7in the air"
    - "&7to throw this &aCreeper Egg"

creeper-egg-charged:
  explosion-radius: 10
  glowing: true
  material: CREEPER_SPAWN_EGG
  # 针对不同 Minecraft 版本进行修改
  display-name: "&bCharged &eThrowable Creeper Egg"
  lore:
    - "&8Sssssssssssss"
    - "&fLeft Click &7in the air"
    - "&7to throw this &aCharged Creeper Egg"

options:
  throw-requires-permission: true
  allow-placement-of-egg: false
  time-to-explode: 1
  explosion-radius: 5
  explosion-entity-damage-percentage: 100.0
  # 实体将受到的爆炸伤害百分比
  use-any-creeper-egg: false
  # 仅在 material 是 creeper spawn egg 时生效
  use-creeper-fuse-animation: false
  # 仅支持 1.15+，且当 "time-to-explode" 大于 2 时看起来会比较奇怪
  throwing-velocity-multiplier: 1.0
  explode-in-mid-air: true
  # 如果 "use-creeper-fuse-animation" 为 true，则该值会被忽略
  explosion-destroys-blocks: true
  # 该值会被 "include-spawners-in-explosion" 忽略
  explosion-damages-entities: true
  include-spawners-in-explosion: true
  # "explosion-radius" 需要为 2 或更高，刷怪笼才会被包含
  use-throwing-cooldown: true
  # 该值决定投掷 Creeper Egg 时是否有冷却
  throwing-cooldown-in-seconds: 5.0
  # 普通 throwable creeper eggs 的冷却时间（秒）
  throwing-charged-cooldown-enabled: false
  # 该值决定 charged throwable creeper eggs 是否使用单独冷却
  throwing-charged-cooldown-in-seconds: 10.0
  # charged throwable creeper eggs 的冷却时间（秒）
  hide-creeper-when-exploding: false
  # 在未加载区块中投掷时效果可能不佳

  # cobweb 交互共有四种类型：VANILLA, BOUNCE, DESTROY, EXCLUDE
  # "VANILLA"：不改变投掷蛋接触 cobweb 时的原版行为
  # "BOUNCE"：投掷蛋从侧面或底部接触 cobweb 时会弹开
  # "DESTROY"：投掷蛋接触 cobweb 时会被销毁
  # "EXCLUDE"：投掷蛋爆炸时不会破坏任何 cobweb
  cobweb-interaction-type: VANILLA

  # filter-type 有两种：INCLUDE, EXCLUDE
  # "EXCLUDE"：排除 "filtered-blocks" 列表中的方块，使其不被爆炸影响
  # "INCLUDE"：仅允许 "filtered-blocks" 列表中的方块被爆炸影响，
  #            其他未列出的方块将不会被爆炸影响
  block-explode-filter:
    enabled: false
    filter-type: EXCLUDE
    filtered-blocks:
      - DIAMOND_ORE
      - DIAMOND_BLOCK

messages:
  no-permission-cmd: "&7[&aTCE&7] &fYou're missing the permission to use this command!"
  no-permission-throw: "&7[&aTCE&7] &fYou're missing the permission to throw creeper eggs!"
  no-permission-place: "&7[&aTCE&7] &fYou're missing the permission to place creeper eggs!"
  egg-given: "&7[&aTCE&7] &fYou gave &7</amount>x &eThrowable Creeper Egg(s) &fto &e</player>&f!"
  invalid-player: "&7[&aTCE&7] &fThe player you're trying to give an egg to is not online!"
  invalid-cmd-usage: "&7[&aTCE&7] &fInvalid usage. Use &e/tce give <player> <type> <amount>&f!"
  invalid-argument: "&7[&aTCE&7] &fInvalid argument. Use &e/tce give &for &e/tce reload&f!"
  reloaded-config: "&7[&aTCE&7] &fSuccessfully reloaded the &econfig&f!"
  throwing-while-cooldown: "&7[&aTCE&7] &fYour eggs are on cooldown. You cannot throw eggs for another &e</remaining> &fsecond(s)."

compatibility:
  coreprotect:
    enabled: false
    log-format: "#thrown_creeper_egg_by_</player>"

# 你可以修改默认生物与百分比，或按相同格式在 "drop-chances" 中添加更多生物
# 百分比以 100 为满值。若随机生成的数字小于等于该百分比，则判定为掉落成功
# 如果 "affected-by-looting" 为 true，则使用抢夺剑时掉率会按一定数值提升
# 概率公式：
# ( looting level / ( looting level + 1.5 ) ) * looting multiplier
# 使用默认的 looting multiplier 15 时，最大概率提升为 10%
# ! 每次只会掉落一个 egg，即使使用抢夺剑也是如此 !
# | 仅当击杀者是玩家时才会掉落 |
drop-configuration:
  enabled: false
  affected-by-looting: false
  looting-multiplier: 15
  drop-chances:
    creeper: 3
    pillager: 1.5

# 如果启用，投掷出的 creeper egg 在爆炸时有一定概率变为 charged creeper
# 若 creeper 为 charged，则 "options" 中定义的爆炸半径会乘以
# "explosion-radius-multiplier"
randomly-charged:
  enabled: false
  charged-chance: 10
  explosion-radius-multiplier: 2

🔧命令

• /tce give <player> <type> <quantity>
• /tce reload

🎮权限

• tce.give
• 允许玩家将 throwable creeper eggs 发放给其他玩家
• tce.throw
• 允许玩家投掷 creeper eggs
• tce.reload
• 允许玩家重载配置文件

✨API

• API 访问路径：
• dev.pixelmania.throwablecreepereggs.TCEApi

可用方法

• getUniqueEggItem()
• 接收一个 int 参数，表示物品数量
• 返回一个 ItemStack
• 该物品是唯一的 Creeper Egg，也可通过 /tce give 获取

• itemIsUniqueEgg()
• 接收一个 ItemStack 参数
• 检查该物品是否为可通过 /tce give 发放的特殊 egg
• 返回一个 boolean

• isCreeperEgg()
• 接收一个 ItemStack 参数
• 检查该物品在 1.7 到 1.19 版本中是否属于 Creeper Egg
• 返回一个 boolean

• entityIsTCE()
• 接收一个 Entity 参数
• 检查该实体是否为 Throwable Creeper Egg 实体，例如被投掷的 Creeper Egg 或 Creeper 本体
• 返回一个 boolean

• getWhoThrewCreeperUUID()
• 接收一个 Creeper 或 Item 参数
• 返回投掷该 Creeper Egg 的玩家 UUID

• getWhoThrewCreeperName()
• 接收一个 Creeper 或 Item 参数
• 返回投掷该 Creeper Egg 的玩家名称 String

• isOnCooldown()
• 接收一个 Player 和 Cooldowns 参数
• 返回一个 boolean
• 用于判断玩家当前是否处于冷却中

• putOnCooldown()
• 接收一个 Player 和 Cooldowns 参数
• 将指定玩家加入冷却
• 返回一个 boolean
• 如果玩家已经在冷却中，则返回 false
• 成功加入冷却则返回 true

• getRemainingCooldownTime()
• 接收一个 Player 和 Cooldowns 参数
• 返回一个 double
• 表示玩家剩余冷却秒数
• 如果时间小于 0，则返回 0

• removeCooldown()
• 接收一个 Player 和 Cooldowns 参数
• 如果该玩家当前有冷却，则会被移除，之后可再次投掷 egg

⭐说明

• 已获得 1400+ downloads，感谢支持！
• 如果你发现任何 bug，请进入讨论区并提交相关信息，谢谢！
• 作者会尽快尝试修复所有已报告的问题。