SponsorVouch

SponsorVouch is a trust-based progression plugin for Purpur/Paper servers. It turns whitelist access into a social system built around sponsorship and accountability.

Players move through three statuses:

• Immigrant
• Resident
• Citizen

Progression, access, and punishment logic are connected through sponsor-ward relationships.

Supported Environment

• Purpur/Paper 1.21.11
• Java 21

Key Features

• Sponsor -> ward relationship model
• Entry gating for unsponsored players
• Mirrored punishment chain (ward sanctions can affect sponsor)
• Trust tree visualization and status tracking
• SQLite storage with backup support
• Optional integrations with popular server plugins

Installation (Precompiled Plugin)

1. Upload the plugin jar to your plugins folder.
2. Start the server once to generate the configuration file.
3. Edit plugins/SponsorVouch/config.yml.
4. Restart the server.

Quick Start (First-Time Setup)

1. Let your first players join so their records are created.
2. Assign seed players:

• /svadmin addseed <nick>

1. Verify the current seed list:

• /svadmin listseeds

1. Enable your target join policy in config.yml (whitelist.enabled).

Commands

• /vouch <player>
• /vouch confirm
• /unvouch (informational; revocation is admin-only)
• /svmenu
• /svstatus [player]
• /trusttree [player]
• /svwarn <player> <reason...>
• /svadmin <addseed|removeseed|listseeds|revoke|whitelist|setstatus|info|banchain|integrity|backup|reload> [args]

Permissions

• sv.vouch
• sv.warn
• sv.admin
• sv.trusttree
• sv.bypass
• sv.seed
• sv.admin.revoke

Optional Integrations

• LuckPerms
• PlaceholderAPI
• BlueMap
• CMI + CMILib
• CoreProtect / CoreProtect-CE

SponsorVouch works without these dependencies. Related features are disabled automatically when a dependency is missing.

Configuration

Most important config sections:

• seed-limit
• vouch-unlock-hours
• max-active-vouches
• citizen-hours
• grace-period-hours
• rate-limit.*
• whitelist.*

Why Use SponsorVouch

• Builds long-term trust loops in your playerbase
• Reduces alt abuse through relationship-based accountability
• Gives staff clear tools for moderation and audits
• Stays lightweight and production-friendly

Modrinth Metadata Suggestions

Recommended tags:

• Social
• Management
• Gameplay Mechanics

Recommended loader tags:

• Paper
• Purpur

Recommended game version:

• 1.21.11

Mark integrations as optional dependencies on the project page.

License

This project is licensed under Apache License 2.0. See LICENSE.