原创 娱乐 【原创】MistWel | 一款支持贴图的玩家欢迎插件，让玩家感受VIP的尊贵体验！ 1.0

# MistWel - 高级玩家欢迎插件

## 插件介绍
MistWel 是一款专注于玩家欢迎效果的插件。它不仅能为普通玩家提供基础的欢迎消息，还能让 VIP、MVP 等特权玩家获得独特的欢迎效果！

## 功能特色
- 支持自定义图片血量条
- 支持自定义欢迎音效
- 支持多个权限等级
- 配置简单易用
- 支持变量替换

## 效果展示

### 1. 默认效果
- 简单的文字欢迎：`欢迎 Steve 加入服务器！`
- 白色的血量条
- 清脆的等级提升音效

### 2. VIP效果
- 尊贵的欢迎语：`欢迎尊贵的 Steve 加入服务器！`
- 金色的血量条，配有专属图片
- VIP专属的音效组合

### 3. MVP效果
- 豪华的欢迎语：`欢迎至尊玩家 Steve 降临服务器！`
- 渐变色血量条，配有高级动态图片
- 震撼的MVP专属音效

## 使用教程

### 基础配置
```yaml
welcome:
permissions:
default: # 默认效果
message:
enabled: true
content: "&7欢迎 &f%player% &7加入服务器！"
bossbar:
enabled: true
duration: 5
title: "龘 &7欢迎 &f%player% &7的到来"
color: "WHITE"
style: "SOLID"
sound:
enabled: true
type: "VANILLA"
vanilla:
name: "ENTITY_PLAYER_LEVELUP"
volume: 1.0
pitch: 1.0
```

### ItemsAdder 配置
```yaml
info:
namespace: mistwel

font_images:
龘: # 默认效果图片
path: "font/welcome_bar_default.png"
scale_ratio: 1
y_position: 8

sounds:
vip_welcome: # VIP音效
sound: "ENTITY_PLAYER_LEVELUP"
volume: 1.0
pitch: 1.2
```

### 变量使用
```yaml
# 基础消息
message:
content: "&7欢迎 &f%player% &7加入服务器！"

# 带称号和等级
message:
content: "&e[%luckperms_prefix%&e] &b%player% &7[等级 %player_level%]"

# 完整信息
message:
content:
- "&b[%server_name%&b] &e%luckperms_prefix%%player%"
- "&7▶ 等级: &b%player_level%"
- "&7▶ 金币: &b%vault_eco_balance_formatted%"
```

## 插件命令

### 管理员命令
需要 `mistwel.admin` 权限：
- `/mw reload` - 重载配置
- `/mw test` - 测试效果
- `/mw test [权限组]` - 测试指定权限组

### 信息查询
- `/mw info` - 查看插件信息
- `/mw groups` - 查看权限组

## 权限说明

### 管理权限
- `mistwel.admin` - 管理员权限
- `mistwel.reload` - 重载权限
- `mistwel.test` - 测试权限

### 玩家权限
- `mistwel.welcome.vip` - VIP效果
- `mistwel.welcome.mvp` - MVP效果
- `mistwel.welcome.svip` - SVIP效果

## 插件依赖

### 必需依赖
- Spigot/Paper 1.20+

### 可选依赖
- PlaceholderAPI - 变量支持
- ItemsAdder - 自定义图片和音效
- LuckPerms - 称号显示
- Vault - 金币显示

## 安装步骤

1. 基础安装
- 下载插件放入plugins文件夹
- 重启服务器
- 编辑配置文件

2. ItemsAdder配置（可选）
- 准备自定义图片（推荐128x32像素）
- 准备自定义音效（OGG格式）
- 配置welcome.yml
- 使用/iazip更新资源包

## 常见问题

### 1. 权限问题
Q: 如何给玩家设置VIP效果？
A: 使用权限插件给玩家添加 `mistwel.welcome.vip` 权限

Q: 玩家有多个权限怎么办？
A: 会自动使用最高级的效果

### 2. 显示问题
Q: 变量显示不出来？
A: 确保安装了PlaceholderAPI并下载了对应变量扩展

Q: 自定义图片不显示？
A: 检查图片格式和路径，使用/iazip更新资源包

### 3. 音效问题
Q: 音效太大声？
A: 在配置中调整volume值（0.0-1.0）

Q: 想用自定义音效？
A: 通过ItemsAdder添加OGG格式音效文件

爱发电：点击发电


## 联系方式

- 作者：ANiii
- 交流群：983387954

---
Copyright © 2024 雾里云端工作室. All rights reserved.