# WhoI

**Repository Path**: eye-time/WhoI

## Basic Information

- **Project Name**: WhoI
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: EPL-1.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-03
- **Last Updated**: 2026-02-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WhoI (我是谁) - Minecraft猜图游戏插件

一个基于Spigot的Minecraft服务器插件，提供有趣的猜图游戏体验。玩家需要通过观察地图上的图像猜测正确的答案。

## 🎮 功能特性

- 🧠 **猜图游戏**: 玩家通过观察地图物品上的图像猜测正确答案
- ⏱️ **多阶段游戏机制**: 预游戏、游戏中、游戏结束三个阶段
- 🖼️ **自动图像加载**: 插件启动时自动从资源包加载图像文件
- 💬 **可配置的消息系统**: 支持自定义游戏消息
- 🔐 **权限系统**: 细粒度的命令权限控制
- ⚡ **事件驱动**: 提供丰富的游戏事件供其他插件扩展
- 📜 **命令系统**: 支持多种游戏命令（加入、离开、重载等）

## 🏗️ 技术架构

- 基于Spigot API 1.13.2开发
- 使用Maven进行项目构建
- 采用Lombok减少样板代码
- 使用JetBrains Annotations进行代码注解
- 遵循Bukkit插件开发最佳实践

## 🚀 安装说明

1. 将编译好的插件jar文件放入服务器的`plugins`目录
2. 重启服务器以生成配置文件
3. 根据需要修改配置文件
4. 再次重启服务器或使用重载命令使配置生效

## 📖 使用方法

### 基本命令

| 命令           | 描述       | 别名      |
|--------------|----------|---------|
| `/wi`        | 显示插件基本信息 | `/whoi` |
| `/wi help`   | 显示帮助信息   | -       |
| `/wi join`   | 加入当前游戏   | -       |
| `/wi leave`  | 离开当前游戏   | -       |
| `/wi reload` | 重载插件配置   | -       |

### 权限节点

| 权限节点                  | 描述     | 默认权限 |
|-----------------------|--------|------|
| `WhoI.command`        | 基本命令权限 | 所有玩家 |
| `WhoI.command.reload` | 重载命令权限 | 仅OP  |
| `WhoI.command.help`   | 帮助命令权限 | 所有玩家 |
| `WhoI.command.join`   | 加入命令权限 | 所有玩家 |
| `WhoI.command.leave`  | 离开命令权限 | 所有玩家 |
| `WhoI.debug`          | 调试权限   | 仅OP  |

## ⚙️ 配置说明

### config.yml

主要配置文件，包含以下配置项：

- `debug` - 是否启用调试模式
- `TimeConfig` - 游戏各阶段时间配置
    - `PreTime` - 预游戏阶段时间
    - `StartTime` - 游戏开始倒计时
    - `EndTime` - 游戏结束倒计时
- `GameConfig` - 游戏相关命令配置
    - `StartCommand` - 游戏开始时执行的命令列表
    - `EndCommand` - 游戏结束时执行的命令列表
    - `JoinCommand` - 玩家加入时执行的命令列表
    - `GuessRightCommand` - 玩家答对时执行的命令列表
    - `NoOneGuessRightCommand` - 无人答对时执行的命令列表
- `RewardConfig` - 奖励配置

### message.yml

消息配置文件，可自定义游戏中显示的各种消息。

### index.json

图像索引文件，定义游戏中使用的图像资源及其对应答案。

## 开发依赖

- Spigot API 1.13.2
- Lombok 1.18.34
- Gson 2.10.1
- JetBrains Annotations 26.0.1

## 构建说明

使用Maven进行项目构建：

```