SponsorVouch

插件

· 作者 t91a60

一个由社区驱动的 Paper 服务器赞助与信任系统。邀请并担保新玩家加入,从移民逐步晋升为居民再到公民,并确保赞助商对其引入社区的成员负责。

0 本站下载 0 关注 更新于 4 周前

最新 3.4.0 · 26.3 · Paper

一键开服(送7天)

SponsorVouch

一款由社区驱动的 Minecraft 服务器赞助、信任与玩家进度系统。

SponsorVouch 用一套以信任、问责和社区成长为核心的系统取代了传统的白名单管理。

无需手动为每位新玩家授予访问权限,资深成员可以赞助新人并对他们邀请的人负责。

新玩家通过赞助和游戏时长逐步获得特权,而服务器工作人员则保留对进度、管理和访问的控制权。


工作原理

SponsorVouch 使用三种玩家状态:

状态 描述
Immigrant(移民) 尚未完成赞助流程的新人。访问权限和特权可能受到限制。
Resident(居民) 已获赞助的玩家,可访问服务器的常规功能。最终可获得赞助特权。
Citizen(公民) 已达到所需进度阈值的资深成员,拥有更高的独立性。

赞助流程

  1. 创始人建立社区。 管理员将受信任的玩家指定为“种子”(seeds),使他们能够赞助新人。
  2. 玩家获得赞助。 符合条件的赞助商通过赞助系统为新人的身份背书。
  3. 新人确认。 确认后,玩家从 Immigrant 升级为 Resident。
  4. 信任随时间积累。 游戏时长和可配置的要求会解锁更多特权和进度。
  5. 责任至关重要。 根据服务器规则,针对被赞助玩家的某些处罚也会影响到其赞助商。

结果是一个通过个人关系而非无限制的白名单来获得访问权限的社区。


功能

赞助与信任

  • 玩家间赞助,具有持久的赞助者–被赞助者关系。
  • 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 未经独立验证。


安装

  1. 下载最新兼容的 SponsorVouch .jar 文件。
  2. 将文件放入服务器的 plugins/ 目录中。
  3. 启动服务器以生成插件配置和数据库。
  4. 打开 plugins/SponsorVouch/config.yml。
  5. 调整设置以匹配服务器的规则。
  6. 重启服务器以应用初始配置。

可选: 安装 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 文件。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源