=====================================
WEATHERPOWERS 插件 - 完整信息
=====================================
作者: XITER
版本: 1.0.0
平台: Minecraft (Bukkit/Spigot/Paper)
概述
========
WeatherPowers 是一个 Minecraft 插件，它赋予玩家各种元素天气亲和力，
允许他们 Harness 太阳、雨水、风暴和雪的力量。每种亲和力
都提供 3 个具有特殊效果和目标功能的独特能力。
天气亲和力
==================
玩家会自动被分配四种天气亲和力之一：
☀️ 太阳亲和力
- 主题: 火焰、热量、光线
- 颜色: 金色/黄色
- 优势: 持续伤害、区域封锁、失明
🌧️ 雨水亲和力
- 主题: 水、治疗、力量
- 颜色: 水蓝/蓝色
- 优势: 治疗、击退、临时武器
⚡ 风暴亲和力
- 主题: 闪电、风、混乱
- 颜色: 紫色/深蓝色
- 优势: 直接伤害、多次攻击、发射
❄️ 雪亲和力
- 主题: 冰、寒冷、控制
- 颜色: 白色/浅蓝色
- 优势: 控制人群、冰冻、区域效果
能力详解
===================
☀️ 太阳力量:
--------------
1. 太阳耀斑 (20 秒冷却)
- 使 7 个方块范围内的所有敌人失明 5 秒钟
- 创建爆炸粒子效果和雷声
- 信息: "太阳耀斑激活！使 X 名敌人失明。"
2. 热浪 (20 秒冷却)
- 蒸发 5 个方块半径内的水方块
- 点燃附近实体持续 2 秒钟
- 创建火焰粒子和熄灭火焰的声音
- 信息: "热浪激活！影响 X 个实体。"
3. 熔岩召唤 (20 秒冷却)
- 在目标方块位置召唤熔岩持续 3 秒钟
- 创建熔岩粒子和熔岩弹出的声音
- 信息: "熔岩在目标位置召唤出来！"
🌧️ 雨水力量:
---------------
1. 雨水祝福 (20 秒冷却)
- 治疗 8 个方块范围内的所有玩家 2 个心
- 创建水滴粒子和下雨的声音
- 信息: "雨水祝福激活！治疗 X 名玩家。"
2. 海啸 (20 秒冷却)
- 将 6 个方块范围内的所有实体推开
- 创建水泡粒子和倒桶的声音
- 信息: "海啸激活！推开 X 个实体。"
3. 雨剑 (20 秒冷却)
- 赋予带有 Sharpness 5 & Unbreaking 10 的 "雨刃" 铁剑
- 剑持续 10 秒然后自动消失
- 创建水滴粒子和三叉戟水涌的声音
- 信息: "雨刃显现！(10 秒)"
⚡ 风暴力量:
---------------
1. 雷鸣召唤 (20 秒冷却)
- 在目标方块的位置 (距离最远可达 50 个方块) 释放闪电
- 直接闪电攻击，造成全部伤害
- 信息: "雷鸣从天而降！"
2. 龙卷风 (20 秒冷却)
- 将 6 个方块范围内的所有实体直接向上发射 (2.5 个方块高)
- 创建云朵粒子和龙的拍打声音
- 信息: "龙卷风召唤出来！将 X 个实体发射到空中。"
3. 雷霆轰击 (20 秒冷却)
- 在目标区域释放 10 次闪电攻击，持续 1 秒
- 每个攻击略微随机偏移，以实现覆盖
- 信息: "雷霆轰击爆发！"
❄️ 雪亲和力:
---------------
1. 冰牢 (20 秒冷却)
- 将 4 个方块半径内的水方块冻结成冰
- 使附近实体减速 II 持续 5 秒钟
- 创建雪花粒子和玻璃破碎的声音
- 信息: "冰牢激活！困住 X 个实体。"
2. 暴风雪 (20 秒冷却)
- 使 6 个方块范围内的所有实体失明 3 秒钟
- 创建大量雪花粒子和下雨的声音
- 信息: "暴风雪爆发！使 X 个实体失明。"
3. 冰封 (20 秒冷却)
- 在目标位置放置冰块持续 5 秒钟
- 使附近实体减速 V 并防止跳跃
- 创建雪花粒子和放置玻璃的声音
- 信息: "冰封激活！目标被冰冻在冰中！"
目标能力 (右键点击敌人)
============================================
所有亲和力都具有带有 20 秒共享冷却的特殊目标能力：
☀️ 太阳目标 - 熔岩召唤
- 右键点击敌人召唤熔岩在他们下方持续 3 秒钟
- 造成 2 个心的伤害并使其着火 3 秒钟
- 创建熔岩粒子和熔岩弹出的声音
🌧️ 雨水目标 - 水爆
- 右键点击敌人造成巨大的击退效果，带有向上的力量
- 击退强度：5.0，向上力量：1.5
- 创建水花飞溅粒子和飞溅的声音
⚡ 风暴目标 - 闪电攻击
- 右键点击敌人攻击他们
- 直接闪电攻击，造成全部伤害
- 瞬间击中效果
❄️ 雪目标 - 冰绑定
- 右键点击敌人将他们冻结 5 秒钟
- 施加减速 V、缓慢挖掘，并防止跳跃
- 创建雪花粒子和玻璃破碎的声音
命令
========
玩家 COMMANDS:
/myaffinity
- 显示您当前的亲和力和能力
- 显示所有 3 个能力以及名称和冷却时间
- 用法: /myaffinity
/ability <1|2|3>
- 切换到指定的技能编号
- 确认切换技能名称
- 用法: /ability 2
/switchability
- 循环到下一个技能 (1→2→3→1)
- 显示带有新技能的确认消息
- 用法: /switchability
管理员 COMMANDS:
/setaffinity
- 设置玩家的亲和力
- 需要 weatherpowers.admin 权限
- 用法: /setaffinity PlayerName sun
/weatherpowers reload
- 重新加载插件配置
- 需要 weatherpowers.admin 权限
- 用法: /weatherpowers reload
控制
========
技能激活:
- 鼠标左键: 使用选定的技能
- Ctrl + 右键: 循环浏览技能 (1→2→3→1)
目标:
- 右键点击敌人: 使用目标技能 (需要视线)
- 对所有活着的实体有效（如果启用在 config 中）
动作条显示:
- 显示所有 3 个技能以及状态：[1. Solar ✓] | [2. Heat (15s)] | [3. Lava ✓]
- 绿色勾号 (✓) = 准备好使用
- 红色计时器 (Xs) = 正在冷却
- 选定的能力具有箭头指示器 (▶)
物品合成
================
所有力量水晶都使用一个 3x3 网格模式来填充整个合成表:
☀️ 太阳力量水晶
材料：8 个金块 + 1 个钻石方块
模式:
[GOLD] [GOLD] [GOLD]
[GOLD] [DIAM] [GOLD]
[GOLD] [GOLD] [GOLD]
🌧️ 雨水力量水晶
材料：8 个绿宝石方块 + 1 个钻石方块
模式:
[EMER] [EMER] [EMER]
[EMER] [DIAM] [EMER]
[EMER] [EMER] [EMER]
⚡ 风暴力量水晶
材料：8 个下界石方块 + 1 个钻石方块
模式:
[NETH] [NETH] [NETH]
[NETH] [DIAM] [NETH]
[NETH] [NETH] [NETH]
❄️ 雪力量水晶
材料：8 个石英方块 + 1 个钻石方块
模式:
[QRTZ] [QRTZ] [QRTZ]
[QRTZ] [DIAM] [QRTZ]
[QRTZ] [QRTZ] [QRTZ]
合成总结:
- 每个水晶需要 9 个物品总计
- 8 种材料块 + 1 个钻石方块中心
- 游戏平衡所需的非常稀有材料
- 插件启用时自动注册配方
权限
===========
玩家权限:
weatherpowers.use - 使用基本的插件功能 (默认: true)
weatherpowers.ability - 使用天气能力 (默认: true)
weatherpowers.craft - 合成力量水晶 (默认: true)
管理员权限:
weatherpowers.admin - 所有管理员命令 (默认: op)
weatherpowers.setaffinity - 设置玩家亲和力 (默认: op)
weatherpowers.reload - 重新加载插件配置 (默认: op)
配置
=============
关键 config.yml 设置:
常规:
- auto_assign_affinity: true (为新玩家分配随机亲和力)
- auto_give_power_items: true (自动给予力量水晶)
- debug_mode: false (控制台调试消息)
冷却时间:
- 所有技能：20 秒（用于平衡的统一冷却时间）
- 目标技能：20 秒（共享冷却时间）
效果:
- 能力范围、伤害值和持续时间
- 目标能力配置
- 粒子和声音效果设置
界面设置:
- 动作条显示时长和更新频率
- 用于就绪/冷却状态的符号自定义
游戏玩法特性
=================
平衡机制:
- 所有技能的统一 20 秒冷却时间
- 稀有方块所需的昂贵合成配方
- 目标的视线要求
- 目标能力的共享冷却时间
视觉反馈:
- 动作条显示所有 3 个技能以及实时冷却计时器
- 所有技能都有独特的主题的粒子效果
- 匹配每种亲和力的元素的音效
- 每种亲和力都具有颜色编码的消息
玩家进度:
- 新玩家自动分配亲和力
- 访问力量水晶合成配方
- 每种亲和力都有三个不同的技能，可以增加多样性
- 如果管理员启用，可以选择 PvP 目标
安装
===========
1. 从 builds 下载 WeatherPowers.jar
2. 放置在服务器的 plugins 文件夹中
3. 启动/重启服务器
4. 插件将自动生成 config.yml
5. 向玩家授予 weatherpowers.use 权限
6. 玩家在首次加入时将收到随机亲和力
故障排除
===============
常见问题:
- 技能无法使用：检查权限和冷却时间
- 配方未显示：验证 config 中 crafting.enable_recipes: true
- 动作条未显示：检查 config 中的 UI 设置
- 目标无法使用：确保允许 player_targeting 设置
支持:
- 检查控制台中的错误消息
- 在修改 config 后使用 /weatherpowers reload
- 验证所有依赖项是否已安装
- 如需更多支持，请联系 XITER
版本历史
===============
v1.0.0 - 初始发布
- 四种天气亲和力，每种亲和力有 3 个技能
- 带有右键点击敌人的目标系统
- 基于方块的昂贵合成配方
- 统一的 20 秒冷却时间
- 完整的动作条 UI 系统
- 全面的命令系统