Blackhole - 我的世界黑洞

DonateCraft 是一款为 Minecraft 服务器增添宇宙级奇观的插件，它允许你创建并召唤具有强大引力的黑洞。这些黑洞会吸引附近的实体和方块，并在消失时产生壮观的“霍金辐射”爆炸，为游戏带来独特的物理效果和视觉体验。

💡核心特性

• 高效异步处理：优化性能，减少服务器卡顿。
• 吸引方块：黑洞的引力不仅能吸引实体，还能拉动附近的方块。
• 高度可定制：提供完整的配置文件，可调整黑洞的各项参数。
• 霍金辐射（蒸发）：黑洞消失时会产生爆炸，对周围造成伤害和击退效果。
• 平滑的吸引效果：实体和方块会被流畅地拉向黑洞中心。
• 创建自定义黑洞：支持在配置中创建属于你自己的独特黑洞。
• 暗色发光效果支持：可选依赖 GlowAPI，为黑洞添加深邃的发光效果。
• 多种召唤方式：支持通过命令直接召唤，或使用特殊的“物品蛋”进行召唤。
• 华丽的召唤过程：将召唤物品扔在地上即可触发黑洞生成动画。

🎮命令与权限

所需权限：blackhole.admin

**可用命令**

• /blackhole reload – 重载插件配置。
• /blackhole give <玩家> <黑洞名称> <数量> – 给予指定玩家召唤特定黑洞的物品。
• /blackhole list – 列出所有已配置的黑洞。
• /blackhole summon <黑洞名称> – 在当前位置直接召唤一个黑洞。

🔧依赖项

• GlowAPI（可选）：用于为黑洞实体添加黑色的发光效果。不安装此插件，黑洞将没有发光特效，但核心功能完全正常。

❓配置与使用帮助

配置文件概览 (`config.yml`)

配置文件主要包含两个部分：deadstar_item（召唤物品设置）和 blackholes（黑洞参数列表）。

**召唤物品设置示例**

deadstar_item:
  name: "&b&lDead Star &7- &cRessurect &f%n"
  lore:
    - "&7Drop on a ground to"
    - "&7see the beauty of the nature."
  material: COAL_BLOCK
  unaffected_entities:
    - "PLAYER"
    - "WOLF"
    - "CAT"

• %n 会在物品名中自动替换为对应的黑洞ID。
• unaffected_entities 列表中的实体类型将不会被黑洞引力影响。

**黑洞参数列表**

在 blackholes: 节点下，已预置了多个黑洞，例如 TON618、SaggitariusA 等。每个黑洞都有以下可调参数：

• duration: 黑洞持续时间（秒）。
• singularity_damage: 黑洞中心对实体造成的伤害。
• singularity_radius: 中心吸引区域的半径。
• singularity_pull_power: 中心区域的吸引力度。
• gravitational_pull_radius: 外层引力场的半径。
• gravitational_pull_power: 外层引力场的吸引力度。
• evaporation_damage: 黑洞蒸发（爆炸）时造成的伤害。
• evaporation_radius: 蒸发爆炸的影响半径。
• evaporation_push_power: 蒸发时击退实体的力度。

如何添加一个新的黑洞？

• 在配置文件 blackholes: 节点下，仿照现有格式添加一个新的配置块。
• 例如，添加一个名为 Tax 的黑洞：

blackholes:
  Tax:
    duration: 100          # 黑洞持续时间（秒）
    singularity_damage: 2      # 中心伤害
    singularity_radius: 10     # 中心吸引半径
    singularity_pull_power: 0.8    # 中心吸引力度
    gravitational_pull_radius: 100 # 外层引力场半径
    gravitational_pull_power: 0.12 # 外层引力场力度
    evaporation_damage: 1000   # 蒸发伤害
    evaporation_radius: 150    # 蒸发爆炸半径
    evaporation_push_power: 45 # 蒸发击退力度

• 保存并重载插件配置 (/blackhole reload) 即可生效。

如何使用物品召唤黑洞？

• 获取召唤物品：使用命令 /blackhole give <你的游戏名> <黑洞ID> <数量>。

例如：/blackhole give Gober Gargantua 2 会给予玩家 Gober 两个名为 “Gargantua” 的黑洞召唤物品。

• 召唤：将获得的 “Dead Star” 物品扔到地上。物品落地后，对应的黑洞便会开始生成并生效。