# ZP_Board

**Repository Path**: yr_binary/zp_board

## Basic Information

- **Project Name**: ZP_Board
- **Description**: Minecraft服务器排行榜插件
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-08
- **Last Updated**: 2025-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ZP_Board - Minecraft服务器排行榜插件

这是一个为Minecraft服务器（Paper 1.20.1）开发的计分板排行榜插件，提供美观且自动切换的多种榜单。

## 功能特色

- **美观的计分板设计**：彩色排名，装饰性边框，分类清晰
- **多种排行榜**：
  - 在线时长排行榜
  - 挖掘方块排行榜
  - 击杀排行榜
  - 死亡排行榜
  - 经验排行榜
- **自动切换**：定时自动在不同排行榜之间切换
- **高度可配置**：通过config.yml文件自定义各项设置
- **数据持久化**：所有玩家数据都会保存，服务器重启后依然有效

## 安装方法

1. 下载插件的JAR文件
2. 将JAR文件放入服务器的`plugins`文件夹
3. 重启服务器或使用插件管理器加载插件
4. 插件会自动创建配置文件，可按需修改

## 配置文件说明

插件的配置文件在`plugins/ZP_Board/config.yml`：

```yaml
# 计分板设置
scoreboard:
  # 计分板切换间隔（秒）
  switch_interval: 10
  
  # 是否启用各类排行榜
  enable_online_time: true
  enable_blocks_break: true
  enable_kills: true
  enable_deaths: true
  enable_experience: true
  
  # 排行榜显示的玩家数量
  display_players: 10
  
  # 计分板标题
  titles:
    online_time: "在线时长排行"
    blocks_break: "挖掘榜"
    kills: "击杀榜"
    deaths: "死亡榜"
    experience: "经验榜"

# 数据设置
data:
  # 数据保存间隔（分钟）
  save_interval: 5
  
  # 在线时间更新间隔（分钟）
  online_time_update_interval: 1
```

## 使用说明

插件安装后会自动工作，无需额外操作。玩家登录后会自动看到右侧的排行榜，并且排行榜会定时切换显示不同的榜单。

### 数据统计

- **在线时长**：玩家在服务器中的在线时间会被自动记录（以分钟为单位）
- **挖掘方块**：记录玩家挖掘的方块总数
- **击杀统计**：记录玩家击杀的实体数量（包括生物和其他玩家）
- **死亡统计**：记录玩家死亡的次数
- **经验统计**：记录玩家获得的总经验值

## 许可协议

由XYingSoft&&ZP开发，保留所有权利。