- 版权类型
- 原创
- 插件中文名称
- 网页IP白名单
- 插件英文名称
- WebIPWhiteList
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- 语言支持
- 中文(简体)
- 前置组件
- #
- 适配版本(Java)
- 最新版本
- 26.x
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
[MD]
# WebWhitelist
一个 Minecraft 服务器 Web 白名单系统插件,玩家可通过网页自助注册、登录并获取白名单。
## 功能特性
- 🌐 **Web 界面** - 美观的现代化网页界面,支持深色/浅色主题切换
- 🔐 **多种验证码** - 支持图片验证码、数学题验证码、Canvas 验证码、Cloudflare Turnstile
- 📦 **开箱即用** - 内置嵌入式 Tomcat 服务器,无需额外配置 Web 服务器
- 💾 **双数据库** - 支持 SQLite(默认)和 MySQL 数据库
- 🎨 **高度自定义** - 支持自定义标题、背景图、Logo、Favicon
- ⚡ **IP 白名单** - 基于 IP 地址的白名单机制,支持过期自动清理
- 🔧 **管理命令** - 提供丰富的游戏内管理命令
## 界面观赏
[/MD]
[MD] ## 快速开始 ### 安装要求 - Minecraft 服务器(Spigot/Paper 1.17+) - Java 17+ ### 安装步骤 1. 下载最新版本的 `WebWhitelist-x.x.x.jar` 2. 将 jar 文件放入服务器的 `plugins` 目录 3. 启动服务器,插件会自动生成配置文件 4. 根据需要修改 `plugins/WebWhitelist/config.yml` 5. 重启服务器或执行 `/wladmin reload` 重载配置 ## 配置说明 ### 基础配置 ```yaml # 网站标题 title: main: "WebWhitelist" subtitle: "服务器白名单系统" colorful: true # 炫彩字体效果 # Web 服务器 web: port: 8080 # Web 端口 context-path: "/" # 上下文路径 external-url: "" # 外部访问地址(可选) ``` ### 数据库配置 ```yaml database: type: sqlite # sqlite 或 mysql sqlite: file: "whitelist.db" mysql: host: "localhost" port: 3306 database: "webwhitelist" username: "root" password: "your_password" ``` ### 验证码配置 ```yaml captcha: enabled: true type: CANVAS # IMAGE / MATH / CANVAS / TURNSTILE # Canvas 验证码(推荐,无需字体库) canvas: length: 4 width: 200 height: 60 # Cloudflare Turnstile turnstile: site-key: "your-site-key" secret-key: "your-secret-key" ``` ### 白名单配置 ```yaml whitelist: mode: all # all 或 selective expire-days: 30 # 过期天数 key-length: 8 # 密钥长度 auto-cleanup: true # 自动清理过期白名单 cleanup-interval: 60 # 清理间隔(分钟) strict-ip-check: false # 严格 IP 检查 auto-add-to-vanilla: true # 自动添加到原版白名单 ``` ## 管理命令 | 命令 | 描述 | 权限 | |------|------|------| | `/wladmin reset <玩家>` | 重置玩家账号 | `webwhitelist.reset` | | `/wladmin revoke <玩家>` | 撤销玩家白名单 | `webwhitelist.revoke` | | `/wladmin info <玩家>` | 查看玩家信息 | `webwhitelist.info` | | `/wladmin list [页码]` | 列出所有用户 | `webwhitelist.list` | | `/wladmin cleanup` | 手动清理过期白名单 | `webwhitelist.cleanup` | | `/wladmin reload` | 重新加载配置 | `webwhitelist.reload` | 命令别名:`/wl`、`/wla` ## 页面说明 - **首页 (`/`)** - 白名单状态查询 - **注册页 (`/register`)** - 玩家注册获取密钥 - **登录页 (`/login`)** - 玩家使用密钥登录获取白名单 ## 自定义界面 ### 背景图片 ```yaml background: url: "https://example.com/background.jpg" # 也支持放在插件数据目录 img 目录下,例如 "/img/background.webp" ``` ### 自定义 Logo 和 Favicon ```yaml brand: logo-url: "/img/logo.png" # 放在插件数据目录的 img 文件夹下 favicon-url: "/img/favicon.ico" ``` ## 获取插件 1.点击右上角按钮购买 2.加群或者等待我的回复(推荐加群联系群主,群号:734527894) [/MD]
[MD] ## 快速开始 ### 安装要求 - Minecraft 服务器(Spigot/Paper 1.17+) - Java 17+ ### 安装步骤 1. 下载最新版本的 `WebWhitelist-x.x.x.jar` 2. 将 jar 文件放入服务器的 `plugins` 目录 3. 启动服务器,插件会自动生成配置文件 4. 根据需要修改 `plugins/WebWhitelist/config.yml` 5. 重启服务器或执行 `/wladmin reload` 重载配置 ## 配置说明 ### 基础配置 ```yaml # 网站标题 title: main: "WebWhitelist" subtitle: "服务器白名单系统" colorful: true # 炫彩字体效果 # Web 服务器 web: port: 8080 # Web 端口 context-path: "/" # 上下文路径 external-url: "" # 外部访问地址(可选) ``` ### 数据库配置 ```yaml database: type: sqlite # sqlite 或 mysql sqlite: file: "whitelist.db" mysql: host: "localhost" port: 3306 database: "webwhitelist" username: "root" password: "your_password" ``` ### 验证码配置 ```yaml captcha: enabled: true type: CANVAS # IMAGE / MATH / CANVAS / TURNSTILE # Canvas 验证码(推荐,无需字体库) canvas: length: 4 width: 200 height: 60 # Cloudflare Turnstile turnstile: site-key: "your-site-key" secret-key: "your-secret-key" ``` ### 白名单配置 ```yaml whitelist: mode: all # all 或 selective expire-days: 30 # 过期天数 key-length: 8 # 密钥长度 auto-cleanup: true # 自动清理过期白名单 cleanup-interval: 60 # 清理间隔(分钟) strict-ip-check: false # 严格 IP 检查 auto-add-to-vanilla: true # 自动添加到原版白名单 ``` ## 管理命令 | 命令 | 描述 | 权限 | |------|------|------| | `/wladmin reset <玩家>` | 重置玩家账号 | `webwhitelist.reset` | | `/wladmin revoke <玩家>` | 撤销玩家白名单 | `webwhitelist.revoke` | | `/wladmin info <玩家>` | 查看玩家信息 | `webwhitelist.info` | | `/wladmin list [页码]` | 列出所有用户 | `webwhitelist.list` | | `/wladmin cleanup` | 手动清理过期白名单 | `webwhitelist.cleanup` | | `/wladmin reload` | 重新加载配置 | `webwhitelist.reload` | 命令别名:`/wl`、`/wla` ## 页面说明 - **首页 (`/`)** - 白名单状态查询 - **注册页 (`/register`)** - 玩家注册获取密钥 - **登录页 (`/login`)** - 玩家使用密钥登录获取白名单 ## 自定义界面 ### 背景图片 ```yaml background: url: "https://example.com/background.jpg" # 也支持放在插件数据目录 img 目录下,例如 "/img/background.webp" ``` ### 自定义 Logo 和 Favicon ```yaml brand: logo-url: "/img/logo.png" # 放在插件数据目录的 img 文件夹下 favicon-url: "/img/favicon.ico" ``` ## 获取插件 1.点击右上角按钮购买 2.加群或者等待我的回复(推荐加群联系群主,群号:734527894) [/MD]