Bukkit DreamTeam-梦想组队·新一代组队插件 1.0

梦想组队
提供队伍创建、邀请、权限管理、跨世界传送、共享仓库、经验共享、
自定义PVP状态和队伍图标等功能。
本插件支持PlaceholderAPI，可以在聊天、计分板等地方显示队伍信息。

## 一、基本命令

插件的主命令为 `/dts`，别名包括 `/dreamteam`、`/dt` 和 `/team`。

### 1. 基础命令
- `/dts` - 打开主菜单
- `/dts help` - 显示帮助信息
- `/dts reload` - 重新加载配置文件（需要管理员权限）

### 2. 队伍创建与管理
- `/dts create <队伍名称> [最大人数]` - 创建一个新队伍
- `/dts disband` - 解散当前队伍（仅队长可用）
- `/dts info` - 查看当前队伍信息
- `/dts list` - 查看可加入的队伍列表

### 3. 成员操作
- `/dts invite <玩家名>` - 邀请玩家加入队伍
- `/dts join <队长名>` - 申请加入指定队长的队伍
- `/dts leave` - 离开当前队伍
- `/dts kick <玩家名>` - 将玩家踢出队伍（仅队长可用）
- `/dts kickban <玩家名>` - 将玩家踢出队伍并加入黑名单（仅队长可用）
- `/dts leader <玩家名>` - 将队长转让给指定玩家（仅队长可用）

### 4. 邀请与请求操作
- `/dts accept <玩家名>` - 接受来自指定玩家的邀请
- `/dts reject <玩家名>` - 拒绝来自指定玩家的邀请
- `/dts acceptrequest <玩家名>` - 接受玩家的加入请求（仅队长可用）
- `/dts rejectrequest <玩家名>` - 拒绝玩家的加入请求（仅队长可用）

### 5. 队伍设置
- `/dts pvp` - 切换队伍PVP状态（仅队长可用）
- `/dts joinable` - 切换队伍是否可加入状态（仅队长可用）
- `/dts follow` - 切换是否跟随队长传送
- `/dts icon` - 打开队伍图标选择菜单（仅队长可用）
- `/dts storage` - 打开队伍共享仓库

## 二、GUI界面

### 1. 主菜单
通过 `/dts` 命令打开主菜单，根据玩家状态显示不同选项：
- 未加入队伍：显示创建队伍、查看队伍列表选项
- 队长：显示队长菜单
- 队员：显示队员菜单

### 2. 队长菜单
队长可以在此菜单中进行以下操作：
- 查看队伍信息（人数、在线状态、跟随状态、PVP状态等）
- 管理队员（踢出、设为队长）
- 队伍设置（PVP、加入权限、队伍图标）
- 发送邀请
- 访问共享仓库
- 设置跟随传送
- 解散队伍

### 3. 队员菜单
队员可以在此菜单中进行以下操作：
- 查看队伍信息
- 查看队员列表
- 设置跟随传送
- 访问共享仓库
- 离开队伍

### 4. 队伍列表
显示所有可加入的队伍，包含以下信息：
- 队伍名称
- 队长名称及在线状态
- 当前人数/最大人数
- PVP状态
- 跟随状态
- 队伍成员列表（最多显示5名，超过则显示省略号）
- 点击申请加入队伍

### 5. 队员管理
队长可以查看所有队员的详细信息：
- 在线状态（在线/离线）
- 跟随状态（开启/关闭）
- 所在世界（如果在线）
- 生命值（如果在线）
- 左键点击：踢出队伍
- 右键点击：设为新队长

### 6. 队伍设置
队长可以在此菜单中修改队伍设置：
- 切换PVP状态
- 切换是否可加入状态
- 更改队伍图标

### 7. 图标选择
队长可以选择不同的物品作为队伍图标，显示在队伍列表和菜单中。

## 三、功能详解

### 1. 队伍传送系统
- **自动跟随传送**：当队长切换世界时，开启了跟随功能的队员会自动传送到队长所在的世界
- **距离传送**：当队员与队长距离超过设定值时，会自动传送到队长附近
- **加入传送**：当队员加入队伍或上线时，会自动传送到队长所在的位置
- **传送设置**：
- 队员可以通过 `/dts follow` 命令或GUI菜单开启/关闭跟随功能
- 传送时会有音效和提示信息
- 传送位置会在队长周围随机分散，避免玩家堆叠

### 2. 共享系统
- **经验共享**：队长获得的经验会自动分享给在线队员
- **共享仓库**：队伍拥有一个27格的共享仓库，所有队员都可以访问

### 3. PVP控制
- 队长可以控制队伍内PVP状态
- 当PVP关闭时，队员之间无法互相伤害

### 4. 队伍加入机制
- **直接邀请**：队长可以邀请玩家加入队伍
- **申请加入**：玩家可以申请加入队伍，需要队长同意
- **黑名单系统**：被踢出并加入黑名单的玩家无法再次申请加入该队伍

### 5. 队伍持久化
- 队伍数据会保存到配置文件中，服务器重启后仍然保留
- 包括队伍信息、成员列表、共享仓库内容、黑名单等

### 6. PlaceholderAPI支持
插件支持PlaceholderAPI，可以在聊天、计分板等地方显示队伍信息：
- `%dreamteam_name%` - 显示队伍名称
- `%dreamteam_leader%` - 显示队长名称
- `%dreamteam_members%` - 显示队伍成员数量
- `%dreamteam_maxsize%` - 显示队伍最大人数
- `%dreamteam_pvp%` - 显示队伍PVP状态
- `%dreamteam_joinable%` - 显示队伍是否可加入

## 四、权限节点

- `dreamteam.use` - 允许使用基本命令（默认所有玩家拥有）
- `dreamteam.admin` - 允许使用管理员命令（默认OP拥有）

## 五、配置文件

### 1. config.yml
主配置文件，包含以下设置：
- 功能开关（PVP控制、经验共享、传送等）
- 传送设置（距离阈值、分散半径、音效等）
- GUI设置（填充玻璃颜色、按钮材质、名称、描述等）

### 2. messages.yml
消息配置文件，可以自定义所有插件消息。

### 3. teams.yml
队伍数据文件，存储所有队伍信息，包括：
- 队伍ID、名称、队长
- 成员列表
- 最大人数、PVP状态、加入状态
- 队伍图标
- 跟随状态
- 黑名单
- 创建时间
- 共享仓库内容