SponsorVouch
一款由社区驱动的 Minecraft 服务器赞助、信任与玩家进度系统。
SponsorVouch 用一套以信任、问责和社区成长为核心的系统取代了传统的白名单管理。
无需手动为每位新玩家授予访问权限,资深成员可以赞助新人并对他们邀请的人负责。
新玩家通过赞助和游戏时长逐步获得特权,而服务器工作人员则保留对进度、管理和访问的控制权。
工作原理
SponsorVouch 使用三种玩家状态:
| 状态 |
描述 |
| Immigrant(移民) |
尚未完成赞助流程的新人。访问权限和特权可能受到限制。 |
| Resident(居民) |
已获赞助的玩家,可访问服务器的常规功能。最终可获得赞助特权。 |
| Citizen(公民) |
已达到所需进度阈值的资深成员,拥有更高的独立性。 |
赞助流程
- 创始人建立社区。 管理员将受信任的玩家指定为“种子”(seeds),使他们能够赞助新人。
- 玩家获得赞助。 符合条件的赞助商通过赞助系统为新人的身份背书。
- 新人确认。 确认后,玩家从 Immigrant 升级为 Resident。
- 信任随时间积累。 游戏时长和可配置的要求会解锁更多特权和进度。
- 责任至关重要。 根据服务器规则,针对被赞助玩家的某些处罚也会影响到其赞助商。
结果是一个通过个人关系而非无限制的白名单来获得访问权限的社区。
功能
赞助与信任
- 玩家间赞助,具有持久的赞助者–被赞助者关系。
- Seed 玩家,可建立初始赞助网络。
- 通过玩家命令处理赞助请求和确认。
- 可配置的赞助上限,以防止无限邀请。
- 基于玩家状态和游戏时长的资格要求。
- 带有管理控制的撤销和重新赞助。
- 信任树,用于检查赞助关系。
- 持久化的赞助历史,在服务器重启后仍保留。
玩家进度
玩家通过 Immigrant → Resident → Citizen 进行进度提升。
SponsorVouch 提供:
- 基于游戏时长的进度要求。
- 可配置的赞助资格阈值。
- 适用时的自动状态进度推进。
- 通过命令和菜单查看状态信息。
- 与 LuckPerms 集成以管理组和权限。
- 跨重启的持久化进度。
服务器所有者可以根据社区需求调整要求,而无需更改插件的核心机制。
管理与问责
SponsorVouch 将玩家管理与赞助责任联系起来。
- 警告跟踪与赞助者问责。
- 可配置的处罚后果。
- 临时和永久封禁的处理。
- 保留临时封禁的到期日期。
- 防止意外缩短现有的赞助者封禁。
- 针对赞助者处罚传播的公民特定例外。
- 用于调查赞助关系的管理工具。
- 保护期和赞助撤销控制。
赞助者对他们引入的玩家负责,但管理工作仍由管理员控制。
管理与服务器管理
- 用于管理种子、状态和赞助的管理命令。
- 用于访问插件功能的内置 GUI。
- 权限控制的操作。
- 可配置的加入和白名单策略。
- SQLite 存储,无需单独的数据库服务器。
- 数据库完整性检查。
- 一致的数据库事务和安全迁移。
- SQLite 备份和恢复支持。
- 配置重载功能。
要求
| 组件 |
要求 |
| 服务器软件 |
Paper 26.3 |
| Java |
Java 25 |
| 数据库 |
SQLite(包含) |
| LuckPerms |
可选 |
| 代理 |
不需要 |
兼容性: SponsorVouch 3.2.0 针对现代 Paper 26.3 服务器。此版本不支持较旧的 Paper 1.21.x 和 Java 21 环境。
其他服务器分支和 Folia 未经独立验证。
安装
- 下载最新兼容的 SponsorVouch
.jar 文件。
- 将文件放入服务器的
plugins/ 目录中。
- 启动服务器以生成插件配置和数据库。
- 打开
plugins/SponsorVouch/config.yml。
- 调整设置以匹配服务器的规则。
- 重启服务器以应用初始配置。
可选: 安装 LuckPerms 以管理进度组和赞助权限。
首次设置
安装 SponsorVouch 后,指定您最初的受信任成员。
1. 允许您的创始人加入服务器,以便他们的玩家记录可用。
2. 分配种子状态:
/svadmin addseed <player>
3. 查看注册的种子:
/svadmin listseeds
4. 在 config.yml 中配置您的准入规则,特别是 whitelist 部分。
您的初始赞助者现在可以开始构建社区的信任网络。
命令
玩家命令
| 命令 |
描述 |
/vouch <player> |
赞助符合条件的玩家。 |
/vouch request <player> |
使用赞助请求工作流程。 |
/vouch confirm |
确认待处理的赞助。 |
/unvouch |
查看关于撤销赞助的信息。 |
/svmenu |
打开 SponsorVouch 菜单。 |
/svstatus [player] |
查看玩家的状态和进度。 |
/trusttree [player] |
检查赞助关系。 |
管理与行政
| 命令 |
描述 |
/svwarn <player> <reason> |
向玩家发出警告。 |
/svadmin addseed <player> |
授予种子身份。 |
/svadmin removeseed <player> |
移除种子身份。 |
/svadmin listseeds |
列出已注册的种子。 |
/svadmin revoke ... |
管理赞助撤销。 |
/svadmin setstatus ... |
更改玩家的进度状态。 |
/svadmin info ... |
检查管理员的玩家信息。 |
/svadmin banchain ... |
检查处罚关系。 |
/svadmin whitelist ... |
管理白名单相关设置。 |
/svadmin integrity |
运行数据库完整性检查。 |
/svadmin backup |
创建数据库备份。 |
/svadmin reload |
重载插件配置。 |
使用 /svadmin 查看可用的管理子命令及其参数。
权限
| 权限 |
用途 |
sv.vouch |
访问赞助功能。 |
sv.warn |
与警告相关的命令。 |
sv.admin |
管理功能。 |
sv.admin.revoke |
管理赞助撤销。 |
sv.trusttree |
信任树访问。 |
sv.seed |
种子赞助特权。 |
sv.bypass |
绕过适用的限制。 |
权限可以通过 LuckPerms 或其他兼容的权限管理系统进行管理。
配置
SponsorVouch 包含针对准入、进度和赞助政策的可配置设置。
一些主要设置包括:
| 设置项 |
用途 |
seed-limit |
控制与种子相关的赞助限制。 |
vouch-unlock-hours |
解锁赞助特权所需的游玩时间。 |
max-active-vouches |
最大活跃赞助数量。 |
citizen-hours |
公民进阶所需的游玩时间阈值。 |
grace-period-hours |
赞助相关保护期的持续时间。 |
rate-limit.* |
限制重复操作。 |
whitelist.* |
控制服务器准入行为。 |
配置文件位于:
plugins/SponsorVouch/config.yml
在现有服务器上启用限制性加入策略之前,请仔细检查您的配置。
可选集成
LuckPerms
SponsorVouch 支持使用 LuckPerms 来管理与进阶相关的用户组和权限。
已验证的集成行为包括:
- 分配和移除种子权限。
- 同步公民用户组成员身份。
- 更新赞助特权。
- 在服务器重启期间保留权限更改。
SponsorVouch 可以在没有 LuckPerms 的情况下运行。 当依赖项不可用时,可选集成功能将被禁用。
数据存储与备份
SponsorVouch 使用 SQLite 存储玩家进阶进度、赞助关系和管理信息。
该插件包含:
- 持久化的玩家和赞助记录。
- 重要操作的事务性更新。
- 数据库模式迁移支持。
- 一致的 SQLite 快照。
- 备份完整性验证。
- 面向恢复的数据库处理。
标准安装无需外部数据库服务器。
在升级现有服务器之前,请备份您的 SponsorVouch 数据并查阅随发布版本提供的迁移说明。
为什么选择 SponsorVouch?
传统的白名单只回答一个问题:谁被允许加入?
SponsorVouch 增加了另一个问题:谁愿意为他们担保?
通过连接访问权限、进度追踪与责任归属,服务器社区可以构建更结构化的新手引导流程,而无需管理员手动审核每一位玩家。
SponsorVouch 专为重视玩家信任与长期会员制的私人社区、生存服务器及其他 Minecraft 服务器设计。
许可证
SponsorVouch 采用 Apache License 2.0 许可证授权。
完整许可条款请参阅项目中的 LICENSE 文件。
SponsorVouch
A community-driven sponsorship, trust, and player progression system for Minecraft servers.
SponsorVouch replaces traditional whitelist management with a system built around trust, accountability, and community growth.
Instead of granting access to every new player manually, established members can sponsor newcomers and take responsibility for the people they invite.
New players gradually earn privileges through sponsorship and playtime, while server staff retain control over progression, moderation, and access.
How It Works
SponsorVouch uses three player statuses:
| Status |
Description |
| Immigrant |
A newcomer who has not yet completed the sponsorship process. Access and privileges may be restricted. |
| Resident |
A sponsored player with access to the server's regular features. Can eventually earn sponsorship privileges. |
| Citizen |
An established member who has reached the required progression threshold and gained greater independence. |
The Sponsorship Process
- Founders establish the community. Administrators designate trusted players as seeds, allowing them to sponsor newcomers.
- A player receives sponsorship. An eligible sponsor vouches for a newcomer through the sponsorship system.
- The newcomer confirms. Once confirmed, the player progresses from Immigrant to Resident.
- Trust develops over time. Playtime and configurable requirements unlock further privileges and progression.
- Responsibility matters. Certain punishments against sponsored players can also affect their sponsors, according to the server's rules.
The result is a community where access is earned through personal connections rather than an unrestricted whitelist.
Features
Sponsorship & Trust
- Player-to-player sponsorship with persistent sponsor–ward relationships.
- Seed players who can establish the initial sponsorship network.
- Sponsorship requests and confirmations through player commands.
- Configurable sponsorship limits to prevent unlimited invitations.
- Eligibility requirements based on player status and playtime.
- Revocation and re-sponsorship with administrative controls.
- Trust tree for inspecting sponsorship relationships.
- Persistent sponsorship history stored across server restarts.
Player Progression
Players progress through Immigrant → Resident → Citizen.
SponsorVouch provides:
- Playtime-based progression requirements.
- Configurable thresholds for sponsorship eligibility.
- Automatic status progression where applicable.
- Status information through commands and menus.
- Integration with LuckPerms for groups and permissions.
- Persistent progression across restarts.
Server owners can adjust the requirements to fit their community without changing the plugin's core mechanics.
Moderation & Accountability
SponsorVouch connects player moderation with sponsorship responsibility.
- Warning tracking and sponsor accountability.
- Configurable punishment consequences.
- Temporary and permanent ban handling.
- Preservation of temporary ban expiration dates.
- Protection against unintentionally shortening existing sponsor bans.
- Citizen-specific exceptions to sponsor punishment propagation.
- Administrative tools for investigating sponsorship relationships.
- Protection periods and sponsorship revocation controls.
Sponsors are responsible for the players they introduce, but moderation remains under administrator control.
Administration & Server Management
- Administrative commands for managing seeds, statuses, and sponsorships.
- In-game GUI for accessing plugin functionality.
- Permission-controlled operations.
- Configurable join and whitelist policies.
- SQLite storage with no separate database server required.
- Database integrity checks.
- Consistent database transactions and safe migrations.
- SQLite backup and restore support.
- Configuration reload functionality.
Requirements
| Component |
Requirement |
| Server software |
Paper 26.3 |
| Java |
Java 25 |
| Database |
SQLite (included) |
| LuckPerms |
Optional |
| Proxy |
Not required |
Compatibility: SponsorVouch 3.2.0 targets modern Paper 26.3 servers. Older Paper 1.21.x and Java 21 environments are not supported by this build.
Other server forks and Folia have not been independently validated.
Installation
- Download the latest compatible SponsorVouch
.jar.
- Place the file inside your server's
plugins/ directory.
- Start the server to generate the plugin configuration and database.
- Open
plugins/SponsorVouch/config.yml.
- Adjust the settings to match your server's rules.
- Restart the server to apply your initial configuration.
Optional: Install LuckPerms to manage progression groups and sponsorship permissions.
First-Time Setup
After installing SponsorVouch, designate your initial trusted members.
1. Allow your founders to join the server so their player records are available.
2. Assign seed status:
/svadmin addseed <player>
3. View registered seeds:
/svadmin listseeds
4. Configure your admission rules in config.yml, particularly the whitelist section.
Your initial sponsors can now begin building the community's trust network.
Commands
Player Commands
| Command |
Description |
/vouch <player> |
Sponsor an eligible player. |
/vouch request <player> |
Use the sponsorship request workflow. |
/vouch confirm |
Confirm a pending sponsorship. |
/unvouch |
View information about sponsorship revocation. |
/svmenu |
Open the SponsorVouch menu. |
/svstatus [player] |
View a player's status and progression. |
/trusttree [player] |
Inspect sponsorship relationships. |
Moderation & Administration
| Command |
Description |
/svwarn <player> <reason> |
Issue a player warning. |
/svadmin addseed <player> |
Grant seed status. |
/svadmin removeseed <player> |
Remove seed status. |
/svadmin listseeds |
List registered seeds. |
/svadmin revoke ... |
Manage sponsorship revocation. |
/svadmin setstatus ... |
Change a player's progression status. |
/svadmin info ... |
Inspect administrative player information. |
/svadmin banchain ... |
Inspect punishment relationships. |
/svadmin whitelist ... |
Manage whitelist-related settings. |
/svadmin integrity |
Run database integrity checks. |
/svadmin backup |
Create a database backup. |
/svadmin reload |
Reload plugin configuration. |
Use /svadmin for the available administrative subcommands and their arguments.
Permissions
| Permission |
Purpose |
sv.vouch |
Access to sponsorship functionality. |
sv.warn |
Warning-related commands. |
sv.admin |
Administrative functionality. |
sv.admin.revoke |
Administrative sponsorship revocation. |
sv.trusttree |
Trust tree access. |
sv.seed |
Seed sponsorship privileges. |
sv.bypass |
Bypass applicable restrictions. |
Permissions can be managed through LuckPerms or another compatible permission management system.
Configuration
SponsorVouch includes configurable settings for admission, progression, and sponsorship policies.
Some of the main settings include:
| Setting |
Purpose |
seed-limit |
Controls seed-related sponsorship limits. |
vouch-unlock-hours |
Playtime required to unlock sponsorship privileges. |
max-active-vouches |
Maximum number of active sponsorships. |
citizen-hours |
Playtime threshold for Citizen progression. |
grace-period-hours |
Duration of sponsorship-related protection periods. |
rate-limit.* |
Limits repeated actions. |
whitelist.* |
Controls server admission behavior. |
Configuration is located at:
plugins/SponsorVouch/config.yml
Review your configuration before enabling restrictive join policies on an existing server.
Optional Integration
LuckPerms
SponsorVouch supports LuckPerms for managing progression-related groups and permissions.
Verified integration behavior includes:
- Assigning and removing seed permissions.
- Synchronizing Citizen group membership.
- Updating sponsorship privileges.
- Preserving permission changes across server restarts.
SponsorVouch can operate without LuckPerms. Optional integration behavior is disabled when the dependency is unavailable.
Data Storage & Backups
SponsorVouch stores player progression, sponsorship relationships, and moderation information using SQLite.
The plugin includes:
- Persistent player and sponsorship records.
- Transactional updates for important operations.
- Database schema migration support.
- Consistent SQLite snapshots.
- Backup integrity verification.
- Recovery-oriented database handling.
No external database server is required for the standard installation.
Before upgrading an existing server, back up your SponsorVouch data and review the migration instructions included with the release.
Why SponsorVouch?
Traditional whitelists answer one question: Who is allowed to join?
SponsorVouch adds another: Who is willing to vouch for them?
By connecting access, progression, and accountability, server communities can build a more structured onboarding process without requiring administrators to approve every individual player manually.
SponsorVouch is designed for private communities, survival servers, and other Minecraft servers where player trust and long-term membership matter.
License
SponsorVouch is licensed under the Apache License 2.0.
See the project's LICENSE file for the complete license terms.
评论 0
登录后参与评分
还没有评论,来抢沙发吧