AuthWithQq

An all-in-one QQ authentication plugin for Paper servers, featuring web dashboard, guest mode, and OneBot v11 integration.

37

Quick challenge

How far can you run before the mobs catch you?

AuthWithQq

AuthWithQq

Beta Release Java Paper License

Download install Issues

---

🌍 English Description

AuthWithQq is an all-in-one QQ authentication plugin designed for Paper servers. It requires players to bind their QQ accounts before playing, significantly enhancing server security and community engagement.

✨ Features

* 🌍 Multi-language: Supports verification codes, one-click web binding, multi-account limits per QQ, and mandatory group membership checks. * 🌍 Multi-language: Built-in HTTP service providing player profiles and an admin dashboard with customizable ports. * 🌍 Multi-language: Reverse WebSocket integration allows users to bind, unbind, and query accounts directly via QQ groups or private messages. * 🌍 Multi-language: Restricts movement, interaction, and teleportation for unverified players. Supports custom allowed commands and potion effects. * 🌍 Multi-language: Allows legitimate players to bind multiple bots (dummies) with name prefix validation. * 🌍 Multi-language: Native support for English, Simplified Chinese, and Traditional Chinese.

📥 Requirements

* Server: JDK 21+ * Server: Paper 1.20.x, 1.20.5+, or 1.21.x

🚀 Installation

1. Download the latest `AuthWithQq-xxx.jar` from Releases. 2. Place the JAR file into your server's `plugins/` folder. 3. Restart the server. The plugin will automatically generate the `plugins/AuthWithQq/` configuration and language files.

---

🏮 中文说明

AuthWithQq 是一款面向 Paper 服务端的一体化 QQ 认证插件。玩家需绑定 QQ 后才能正常游戏，有效提升服务器安全性与玩家社交联络。

✨ 功能概览

* 🌍 多语言：支持验证码绑定、网页一键绑定；支持一 QQ 多账号限制及强制入群校验。 * 🌍 多语言：内置 HTTP 服务，提供玩家资料页与管理后台，支持自定义端口。 * 🌍 多语言：反向 WebSocket 接入，支持在 QQ 群/私聊中执行绑定、解绑、查询等指令。 * 🌍 多语言：未绑定玩家将被限制移动、交互、跨世界传送，可自定义允许的命令与药水效果。 * 🌍 多语言：允许真实玩家绑定多个假人（Bot），支持名称前缀校验。 * 🌍 多语言：原生支持简体中文、繁体中文及英文。

📥 环境要求

| 组件 | 最低要求 | 推荐版本 | | :--- | :--- | :--- | | 服务端 | JDK 21+ | JDK 21 | | 服务端 | Paper 1.20+ | 1.20.5+ / 1.21.x |

🚀 安装步骤

1. 从 Releases 下载最新的 `AuthWithQq-xxx.jar`。 2. 将 JAR 文件放入服务器的 `plugins/` 目录。 3. 重启服务器，插件会自动生成配置文件及语言文件。

---

📜 Commands / 命令手册

| Command / 命令 | Description (EN) | 说明 (CN) | | :--- | :--- | :--- | | `/bind` | Get verification code / Bind bots | 获取验证码 / 绑定假人 | | `/auth reload` | Reload configuration | 重载插件配置 | | `/auth bind <Player> <QQ>` | Force manual binding | 强制手动绑定 | | `/auth unbind <Player>` | Unbind a player | 解除绑定关系 |

---

Made with ❤️ by Cc_Cece

ADS