WelfareServerA 全服福利公告

📝 插件介绍
WelfareServerAnnouncement是一款简单实用的全服福利公告插件，当玩家进行充值或其他值得庆祝的活动时，可以通过该插件向全服在线玩家发放福利并进行公告。插件支持自定义多种不同类型的福利公告，每种类型可以配置不同的奖励内容（经验、金币、点券）和公告效果（声音、标题、烟花）。

✨ 主要功能
- 🔊 全服公告系统，支持聊天消息和标题显示
- 💰 自动向所有在线玩家发放金币奖励（需Vault）
- 💎 自动向所有在线玩家发放点券奖励（需PlayerPoints）
- 📊 自动向所有在线玩家发放经验奖励
- 🎆 在每个玩家头顶生成庆祝烟花效果
- 🎵 播放自定义声音效果增强氛围
- ⚙️ 完全可配置的公告类型和奖励内容

🔑 命令列表
| 命令 | 描述 | 权限 |
|------|------|------|
| `/wra <类型> <玩家名>` | 以指定玩家的名义发送指定类型的福利公告 | welfareserverannouncement.admin |

🔑 权限节点
| 权限 | 描述 | 默认 |
|------|------|------|
| `welfareserverannouncement.admin` | 允许管理员使用wra命令 | op |

📋 配置文件说明

config.yml 中的公告类型配置:
types:
每日首充:
sound: "ENTITY_PLAYER_LEVELUP"  # 播放的声音
exp: 0                          # 给予的经验值
money: 0                        # 给予的金币（需Vault）
points: 10                      # 给予的点券（需PlayerPoints）
message: "&a玩家 %p% 充值了每日首充180蓝宝石 &f你获得了 &b10 &f傶!"  # 聊天栏公告，%p%会被替换为玩家名
title: "&a全服发放福利"          # 屏幕中央主标题
subtitle: "&f你获得了 &b10 &f傶!" # 屏幕中央副标题


插件默认配置了多种充值类型:
- 每日首充: 奖励10点券
- 充值3200: 奖励30点券
- 充值6400: 奖励60点券
- 充值12800: 奖励120点券
- 充值25600: 奖励240点券
- 充值64800: 奖励480点券

🔄 使用方法

基本使用:
1. 安装插件及其依赖（Vault和PlayerPoints）
2. 确保服务器有经济插件（如Essentials）和点券插件（PlayerPoints）
3. 使用命令 `/wra <类型> <玩家名>` 发送福利公告

示例:
- `/wra 每日首充 Steve` - 以Steve的名义发送每日首充福利公告，全服玩家获得10点券
- `/wra 充值64800 Alex` - 以Alex的名义发送充值64800福利公告，全服玩家获得480点券

自定义公告类型:
1. 打开config.yml文件
2. 在types部分添加新的公告类型
3. 设置声音、经验、金币、点券、消息、标题和副标题
4. 保存文件并重载插件或重启服务器

💻 技术信息
- 支持版本: Paper 1.20.1+
- API版本: 1.20
- 依赖插件:
- Vault (经济系统支持)
- PlayerPoints (点券系统支持)
- 使用Java 17开发

🎮 效果展示
当管理员执行命令后:
1. 全服玩家会收到聊天栏公告消息
2. 全服玩家会看到屏幕中央的标题提示
3. 全服玩家会听到指定的声音效果
4. 全服玩家头顶会出现庆祝烟花
5. 全服玩家会获得配置的经验、金币和点券奖励

⚠️ 注意事项
- 插件需要Vault和PlayerPoints作为前置插件
- 如果缺少前置插件，相应的功能（金币或点券发放）将无法使用
- 声音效果需要使用Minecraft内置的声音名称
- 颜色代码使用&符号，如&a表示绿色，&b表示蓝色

---
感谢您选择WelfareServerAnnouncement插件！如有任何问题或建议，请随时联系我们。