```text
_ __ __ ____
| | / /___ / /____ / __ \____ ___________
| | / / __ \/ __/ _ \/ /_/ / __ `/ ___/ ___/
| |/ / /_/ / /_/ __/ ____/ /_/ (__ |__ )
|___/\____/\__/\___/_/ \__,_/____/____/
```
README LANGUAGES [ [**English**](README.md) | [中文](README_CN.md) ]
[](https://github.com/ArtformGames/VotePass/releases)
[](https://github.com/ArtformGames/VotePass/actions/workflows/maven.yml)
# **VotePass**
> 你已经被 **“通过投票”** 了！
一个用于白名单服务器的高效且公平的验证插件，
支持玩家自行提交白名单请求
并由所有已通过的玩家进行审核。
> 此插件已发布在 [SpigotMC](https://www.spigotmc.org/resources/votepass.111846/) 和 [Modrinth](https://modrinth.com/plugin/votepass/)。
## 特点与优势
- **数据库同步！** 基于数据库存储，数据安全且同步。
- **易于配置！** 简单便捷的配置方法，所有内容都可以配置！
- **用户友好的 GUI！** 全局 UI 配置，玩家操作非常简单。
- **玩家参与！** 玩家可以参与服务器的管理，让他们更加投入。
## 截图
## 依赖
- **[推荐]** 基于 [PlaceholderAPI](https://www.spigotmc.org/resources/6245/) 的占位符。
关于开发依赖，请
参考 [Dependencies](https://github.com/ArtformGames/VotePass/network/dependencies) 。
## 扩展
> 你开发了与此插件相关的扩展插件吗？
> 欢迎将你的扩展插件提交到 [Issues](https://github.com/ArtformGames/VotePass/issues)
> 我们会将它添加到列表中！
### [**VotePass-Mailer**](https://github.com/ArtformGames/VotePass-Mailer)
支持在游戏服务器中通过电子邮件通知 VotePass。
### [**VotePass-QQNotify**](https://github.com/ArtformGames/VotePass-QQNotify)
支持在 Lobby 服务器中通过 QQ 通知 VotePass。
## 指令
主指令是 `/VotePass` 或 `/vp`。
### 门厅侧
```text
# request
@ 玩家指令
- 提交特定服务器的白名单请求。
- 如果服务器配置了规则，会在规则协议打开后；
- 如果没有，会直接弹出玩家填写问题的 GUI。
# accept
@ 玩家指令
- 同意指定服务器的规则并开始填写问题答案。
# deny
@ 玩家指令
- 拒绝指定服务器的规则。
# reload
@ 管理员指令
- 重新加载配置文件。
# toggle
@ 管理员指令
- 启用/禁用对应服务器的投票申请。
```
### 游戏侧
```text
# requests
@ 玩家指令
- 查看所有尚未参与的白名单请求。
# handle
@ 玩家指令
- (继续)处理指定的白名单请求。
# abstain
@ 玩家指令
- 启用/禁用自动弃权功能。
# manage
@ 管理员指令
- 打开管理员操作 GUI 以直接操作白名单。
# reload
@ 管理员指令
- 重新加载配置文件。
# sync
@ 管理员指令
- 将对应服务器的白名单同步到数据库。
# migrate
@ 管理员指令
- 将服务器的白名单从 "whitelist.json" 迁移。
# list
@ 管理员指令
- 列出所有白名单中的玩家。
# add
@ 管理员指令
- 将玩家添加到白名单。
- 玩家至少需要在服务器（例如Lobby）中加入过一次。
# remove
@ 管理员指令
- 从白名单中移除玩家。
```
## 配置
你可以找到配置翻译
在 [VotePass-Translations](https://github.com/ArtformGames/VotePass-Translations)。
### 插件配置 (`config.yml`)。
将在首次启动时生成。
### 消息配置 (`messages.yml`)
将在首次启动时生成。
### 服务器申请配置 ([`servers/*.yml`](lobby/plugin/src/main/resources/servers/survival.yml))
所有服务器的申请配置都采用单独的配置文件，
存储在门厅的 `/servers/` 以方便管理。
你可以在插件配置文件中编辑服务器配置文件的存储路径。
## 权限
```text
# VotePass.admin
- 所有管理员指令和功能的权限。
# VotePass.abstain
- 允许用户切换自动弃权功能的权限。
```
## 统计
[](https://bstats.org/plugin/bukkit/VotePass/18946)
## 开源许可
该项目的源代码采用 [GNU General Public License v3.0](https://opensource.org/licenses/GPL-3.0)。
## 支持
该项目主要由 [Artfrom Games](https://github.com/ArtformGames/) 开发。
衷心感谢 Jetbrains 慷慨地向我们提供许可，使我们能够在本项目和其他开源项目上工作。
[](https://www.jetbrains.com/?from=https://github.com/ArtformGames/VotePass)
