# CiYuanQQLogin

**Repository Path**: jack_shi/CiYuanQQLogin

## Basic Information

- **Project Name**: CiYuanQQLogin
- **Description**: Minecraft插件:次元QQ登录
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-11-28
- **Last Updated**: 2026-02-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# CiYuanQQLogin

## 项目简介

CiYuanQQLogin 是一个 Minecraft 服务器 QQ 登录验证插件，支持 BungeeCord 和 Spigot 服务端。通过集成 QQ 登录验证，为 Minecraft 服务器提供额外的安全验证机制。

## 主要功能

- **QQ 登录验证**：玩家加入服务器时需要通过 QQ 进行身份验证
- **多平台支持**：同时支持 BungeeCord 和 Spigot 服务端
- **IP 超时检测**：防止 IP 冒用，确保登录安全性
- **黑名单管理**：可配置的黑名单踢出功能
- **配置灵活**：多种配置选项，满足不同服务器需求
- **自动更新检查**：插件可自动检查更新

## 支持的服务端

- **BungeeCord**：群组服核心，支持多服务器管理
- **Spigot**：单机服务器，支持 1.12.2 版本

## 快速开始

### 环境要求

- Java 8 或更高版本
- BungeeCord 或 Spigot 1.12.2 服务端

### 安装方法

1. 下载插件 JAR 文件
2. 将文件放入服务器的 `plugins` 目录
3. 重启服务器
4. 根据需要编辑配置文件

### 配置文件说明

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

- **CheckLoginURL**：登录验证接口地址
- **KickMessage**：踢出玩家时显示的消息
- **StopInteractMessage**：停止交互时显示的消息
- **KickBlackMessage**：踢出黑名单玩家时显示的消息
- **ServerName**：服务器名称
- **SuccessMsg**：验证成功时显示的消息
- **OnlyKickBlack**：是否只踢出黑名单玩家
- **CheckLinkUpdate**：是否检查链接更新
- **IpTimeoutSeconds**：IP 超时时间（秒）

## 使用说明

### 核心功能

1. **玩家登录流程**：
   - 玩家加入服务器
   - 系统记录玩家 IP 和登录时间
   - 发送验证请求到配置的登录验证接口
   - 根据验证结果允许或拒绝玩家登录

2. **IP 验证机制**：
   - 系统会记录玩家的 IP 地址
   - 每次登录时检查 IP 是否匹配
   - 可设置 IP 超时时间防止冒用

3. **黑名单管理**：
   - 可配置是否只踢出黑名单玩家
   - 黑名单玩家会被拒绝登录

### 命令使用

插件提供命令支持，可通过游戏内命令或控制台执行操作。

## 数据存储

插件会自动在数据文件夹中存储以下信息：

- **player_ip.json**：记录玩家 IP 地址信息
- **player_login_time.json**：记录玩家登录时间信息

## 开发相关

### 项目结构

```
CiYuanQQLogin/
├── src/ciyuan/
│   ├── QQLogin.java           # 主类，处理登录逻辑
│   ├── Updater.java           # 更新检查器
│   ├── Utils.java             # 工具类
│   ├── dataStore/
│   │   ├── Config.java        # 配置管理
│   │   ├── PlayerIp.java     # 玩家 IP 数据存储
│   │   └── PlayerLoginTime.java # 玩家登录时间存储
│   └── wrap/
│       ├── Wrapper.java       # 抽象包装类
│       ├── BCMain.java       # BungeeCord 主类
│       ├── BCWrap.java       # BungeeCord 包装实现
│       ├── BKMain.java       # Spigot 主类
│       └── BKWrap.java       # Spigot 包装实现
├── plugin.yml                 # 插件配置文件
├── bungee.yml                # BungeeCord 配置
└── LICENSE                   # 许可证文件
```

### 核心类说明

- **QQLogin.java**：插件主类，包含登录验证核心逻辑
- **Wrapper.java**：抽象包装类，提供统一的 API 接口
- **BCMain/BKMain**：分别对应 BungeeCord 和 Spigot 的事件处理类

## 许可证

本项目采用 MIT 许可证开源。

## 更新日志

插件支持自动检查更新功能，可通过配置选项开启或关闭。

## 贡献者

感谢所有为这个项目做出贡献的人！

## 联系方式

如有问题或建议，欢迎通过 Gitee 仓库提交 Issue 或 Pull Request。