# zuoerairdrop - Minecraft空投插件
## 1. 插件概述
zuoerairdrop是一个轻量高效的Minecraft Spigot空投插件,专为1.20.1版本设计。支持多种空投类型、智能地形适应、粒子降落伞效果和多区域配置。
## 2. 核心功能
### 2.1 智能空投生成
- **多种类型**:可配置多种空投类型,每种类型有不同方块和掉落物
- **地形适应**:自动寻找开阔地降落,避免落在建筑物或树上
- **灵活生成**:支持区域内随机生成或手动指定坐标
- **高度可调**:可设置空投初始生成高度
### 2.2 视觉与音效
- **粒子降落伞**:红色粒子组成的降落伞效果(伞面+伞绳+连接点)
- **开关控制**:可启用/禁用粒子效果
- **发光提示**:落地后可配置发光效果和持续时间
- **落地音效**:可自定义落地音效
### 2.3 倒计时广播
- **多级提醒**:落地前10m、5m、3m、1m、30s、10s自动广播
- **实时坐标**:包含空投具体位置信息
- **消息自定义**:所有广播内容可配置
### 2.4 区域管理
- **多区域支持**:可创建多个空投生成区域
- **独立开关**:可单独启用/禁用区域
- **信息查看**:支持查看区域详细信息
### 2.5 便捷管理
- **动态重载**:无需重启服务器即可重载配置
- **指令补全**:支持所有指令的自动补全
- **自定义方块**:可设置空投使用的方块类型
- **自动消失**:可配置落地后自动消失时间
## 3. 配置文件
### 3.1 基本结构
```yaml
# 插件信息
name: zuoerairdrop
version: 1.0.0
# 空投类型
airdrops:
default:
block: minecraft:chest
drops:
enabled: true
min-items: 3
max-items: 8
items: [minecraft:diamond, minecraft:iron_ingot]
min-amount: 1
max-amount: 5
# 生成配置
spawn:
height: 100
fall-duration: 10
air-time: 600
parachute-particles: true
glow-on-ground: true
despawn-time: 60
# 区域配置
regions:
spawn:
world: world
x1: -100
z1: -100
x2: 100
z2: 100
enabled: true
# 消息配置
messages:
spawn: "&a[空投] 已在 &b%x%, %y%, %z% &a生成!"
land: "&a[空投] 已落地!"
```
## 4. 指令说明
### 4.1 主指令
```
/airdrop <子命令>
别名: /ad, /airdrops
```
### 4.2 常用指令
| 指令 | 描述 | 权限 |
|------|------|------|
| `/airdrop spawn [x y z] [type]` | 生成空投 | airdrop.spawn |
| `/airdrop reload` | 重载配置 | airdrop.reload |
| `/airdrop type list` | 查看空投类型 | airdrop.use |
| `/airdrop pos1/pos2` | 设置区域位置 | airdrop.admin |
| `/airdrop region add <name>` | 添加区域 | airdrop.admin |
| `/airdrop region list` | 查看区域 | airdrop.admin |
| `/airdrop region enable/disable <name>` | 开关区域 | airdrop.admin |
| `/airdrop help` | 查看帮助 | airdrop.use |
## 5. 安装使用
### 5.1 安装
1. 将`zuoerairdrop.jar`放入服务器`plugins`目录
2. 启动服务器,自动生成配置文件
3. 修改`plugins/zuoerairdrop/config.yml`
4. 使用`/airdrop reload`重载配置
### 5.2 快速开始
1. 使用`/airdrop pos1`和`/airdrop pos2`设置区域
2. 执行`/airdrop region add <name>`添加区域
3. 配置空投类型和生成参数
4. 使用`/airdrop spawn`生成空投
## 6. 高级功能
### 6.1 自定义空投方块
```
/airdrop setblock <block_type>
示例:/airdrop setblock minecraft:ender_chest
```
### 6.2 多空投类型
在`config.yml`中配置多种空投类型:
```yaml
airdrops:
common: # 普通空投
block: minecraft:chest
drops:
items: [minecraft:iron_ingot, minecraft:gold_ingot]
rare: # 稀有空投
block: minecraft:ender_chest
drops:
items: [minecraft:diamond, minecraft:netherite_ingot]
## 1. 插件概述
zuoerairdrop是一个轻量高效的Minecraft Spigot空投插件,专为1.20.1版本设计。支持多种空投类型、智能地形适应、粒子降落伞效果和多区域配置。
## 2. 核心功能
### 2.1 智能空投生成
- **多种类型**:可配置多种空投类型,每种类型有不同方块和掉落物
- **地形适应**:自动寻找开阔地降落,避免落在建筑物或树上
- **灵活生成**:支持区域内随机生成或手动指定坐标
- **高度可调**:可设置空投初始生成高度
### 2.2 视觉与音效
- **粒子降落伞**:红色粒子组成的降落伞效果(伞面+伞绳+连接点)
- **开关控制**:可启用/禁用粒子效果
- **发光提示**:落地后可配置发光效果和持续时间
- **落地音效**:可自定义落地音效
### 2.3 倒计时广播
- **多级提醒**:落地前10m、5m、3m、1m、30s、10s自动广播
- **实时坐标**:包含空投具体位置信息
- **消息自定义**:所有广播内容可配置
### 2.4 区域管理
- **多区域支持**:可创建多个空投生成区域
- **独立开关**:可单独启用/禁用区域
- **信息查看**:支持查看区域详细信息
### 2.5 便捷管理
- **动态重载**:无需重启服务器即可重载配置
- **指令补全**:支持所有指令的自动补全
- **自定义方块**:可设置空投使用的方块类型
- **自动消失**:可配置落地后自动消失时间
## 3. 配置文件
### 3.1 基本结构
```yaml
# 插件信息
name: zuoerairdrop
version: 1.0.0
# 空投类型
airdrops:
default:
block: minecraft:chest
drops:
enabled: true
min-items: 3
max-items: 8
items: [minecraft:diamond, minecraft:iron_ingot]
min-amount: 1
max-amount: 5
# 生成配置
spawn:
height: 100
fall-duration: 10
air-time: 600
parachute-particles: true
glow-on-ground: true
despawn-time: 60
# 区域配置
regions:
spawn:
world: world
x1: -100
z1: -100
x2: 100
z2: 100
enabled: true
# 消息配置
messages:
spawn: "&a[空投] 已在 &b%x%, %y%, %z% &a生成!"
land: "&a[空投] 已落地!"
```
## 4. 指令说明
### 4.1 主指令
```
/airdrop <子命令>
别名: /ad, /airdrops
```
### 4.2 常用指令
| 指令 | 描述 | 权限 |
|------|------|------|
| `/airdrop spawn [x y z] [type]` | 生成空投 | airdrop.spawn |
| `/airdrop reload` | 重载配置 | airdrop.reload |
| `/airdrop type list` | 查看空投类型 | airdrop.use |
| `/airdrop pos1/pos2` | 设置区域位置 | airdrop.admin |
| `/airdrop region add <name>` | 添加区域 | airdrop.admin |
| `/airdrop region list` | 查看区域 | airdrop.admin |
| `/airdrop region enable/disable <name>` | 开关区域 | airdrop.admin |
| `/airdrop help` | 查看帮助 | airdrop.use |
## 5. 安装使用
### 5.1 安装
1. 将`zuoerairdrop.jar`放入服务器`plugins`目录
2. 启动服务器,自动生成配置文件
3. 修改`plugins/zuoerairdrop/config.yml`
4. 使用`/airdrop reload`重载配置
### 5.2 快速开始
1. 使用`/airdrop pos1`和`/airdrop pos2`设置区域
2. 执行`/airdrop region add <name>`添加区域
3. 配置空投类型和生成参数
4. 使用`/airdrop spawn`生成空投
## 6. 高级功能
### 6.1 自定义空投方块
```
/airdrop setblock <block_type>
示例:/airdrop setblock minecraft:ender_chest
```
### 6.2 多空投类型
在`config.yml`中配置多种空投类型:
```yaml
airdrops:
common: # 普通空投
block: minecraft:chest
drops:
items: [minecraft:iron_ingot, minecraft:gold_ingot]
rare: # 稀有空投
block: minecraft:ender_chest
drops:
items: [minecraft:diamond, minecraft:netherite_ingot]