🚀 ZeroInvite — Complete Referral & Rewards System

Invite Friends. Verify Referrals. Earn Rewards.

ZeroInvite is a powerful Minecraft referral, onboarding, verification, leaderboard, and reward management plugin designed for Spigot & Paper servers.

Grow your Minecraft community by rewarding players who invite their friends!

Players can share permanent invite codes or Minecraft usernames. New referrals are tracked, verified after configurable playtime, and rewarded with credits, custom items, commands, milestone rewards, and repeatable rewards.

✨ Features

• 🔗 Permanent invite codes for every player
• 👤 Invite friends using codes or usernames
• ✅ Configurable referral verification time
• 🎁 Per-referral, milestone, and repeatable rewards
• 💰 Spendable invite credits
• 🏆 Lifetime referral leaderboard
• 📜 Complete referral history
• 🖥️ Interactive Player and Admin GUIs
• ⚙️ First-time setup wizard
• 🛡️ Self-referral and duplicate protection
• 🌐 Configurable same-IP protection
• 💾 Built-in SQLite database
• 🔌 PlaceholderAPI integration
• 📦 Custom ItemStack reward kits
• 🔄 Safe player migration system
• 💾 Persistent setup drafts

📦 Installation Guide

Follow these steps to install ZeroInvite on your Minecraft server.

Step 1 — Download ZeroInvite

Download the latest compatible version from:

https://modrinth.com/plugin/zeroinvite

Step 2 — Check Requirements

• Server Software: Paper or Spigot
• Minecraft Version: 1.21.x
• Java Version: Java 21+
• PlaceholderAPI: Optional integration (verify against your installed build)

Step 3 — Install the Plugin

1. Stop your Minecraft server.
2. Open your server's plugins folder.
3. Upload the downloaded ZeroInvite .jar file.
4. Install PlaceholderAPI if you want to use its placeholders.
5. Start your server.

Example directory:

Minecraft Server/
├── plugins/
│   ├── ZeroInvite-1.0.0.jar
│   └── PlaceholderAPI.jar
├── server.properties
└── ...

Step 4 — Verify Installation

Join your server with operator permissions.

Execute:

/zi help

If ZeroInvite is installed successfully, the administrator commands should be available.

You can now configure the referral system!

⚙️ First-Time Server Setup

ZeroInvite includes a setup wizard to help administrators configure the plugin without manually editing configuration files.

Step 1 — Open Setup Wizard

Join your Minecraft server as an operator.

Run:

/zi setup

The setup wizard will guide you through the initial configuration.

Step 2 — Configure Player Onboarding

Choose how new players interact with the referral system.

REQUIRED

New players must complete referral onboarding before accessing normal gameplay, according to the configured restrictions.

OPTIONAL

Players are offered referral onboarding but can skip it using the available skip option.

DISABLED

Automatic onboarding is disabled. Players can still use supported referral commands manually.

Recommended: Use OPTIONAL for casual survival servers and REQUIRED for referral-focused communities.

Step 3 — Configure Verification Time

Set how long an invited player must play before their referral becomes verified.

Example:

Verification Time: 30 Minutes

Referral process:

Friend Joins → Redeems Code → Pending → Plays 30 Minutes → Verified

Once verified, eligible credits and rewards can be distributed.

Step 4 — Configure Referral Protection

Review the available security options:

• Self-referral prevention
• Duplicate redemption protection
• Referral eligibility requirements
• Redemption time window
• Same-IP protection

Same-IP protection modes can include:

BLOCK — Reject referrals from the same IP.

WARN — Flag a possible same-IP referral.

ALLOW — Allow the referral.

Choose settings appropriate for your server and community.

Step 5 — Configure Referral Rewards

Open the reward manager:

/zi rewards

ZeroInvite supports three main reward categories.

1. Per-Referral Rewards

Give a reward whenever an eligible referral becomes verified.

Example:

1 Verified Referral = 100 Invite Credits

You can configure item kits, console commands, or both.

2. Milestone Rewards

Reward players for reaching specific lifetime referral counts.

Example:

• 1 Verified Invite → Starter Kit
• 5 Verified Invites → Diamond Kit
• 10 Verified Invites → VIP Reward
• 25 Verified Invites → Legendary Reward

These are example rewards. Configure your own requirements and contents.

3. Repeatable Rewards

Allow players to spend earned invite credits on rewards multiple times.

Example:

• 100 Credits → Iron Kit
• 250 Credits → Diamond Kit
• 500 Credits → Custom Reward

Spending invite credits does not reduce lifetime verified referral statistics.

Step 6 — Configure Custom Reward Items

Use the reward editor to configure a custom item kit.

1. Open /zi rewards.
2. Select the appropriate reward management option.
3. Create or edit a reward.
4. Set its name and requirement.
5. Select the supported reward type.
6. Add the desired items through the kit editor.
7. Save the reward.

Reward configurations can include custom items and console commands.

Step 7 — Save Your Configuration

Complete the setup wizard and save your settings.

Need to leave before finishing?

Use Save Draft & Exit where available.

Closing the editor with ESC also preserves the current setup draft.

Saved drafts are stored in:

plugins/ZeroInvite/setup-drafts.yml

Run /zi setup again to resume your unfinished configuration.

Step 8 — Test Your Referral System

Before opening your server to the public:

1. Join with a test player account.
2. Run /invite code to view its invite code.
3. Join with another eligible test account.
4. Redeem the first account's code.
5. Confirm that the referral is marked Pending.
6. Complete the configured verification time.
7. Check whether the referral becomes Verified.
8. Verify that the configured rewards and credits are delivered.

✅ Setup Complete! Your ZeroInvite referral system is ready.

🎮 Player Guide — How to Use ZeroInvite

ZeroInvite is designed to be simple for regular Minecraft players.

Step 1 — Get Your Invite Code

Run:

/invite code

Every player receives a permanent invite code.

Step 2 — Share Your Code

Send your invite code or Minecraft username to a friend.

Your friend must join the server and complete the referral redemption process.

Step 3 — Redeem an Invite

A new eligible player runs:

/invite redeem <code|player>

Example:

/invite redeem Steve

Replace Steve with the referring player's actual username, or enter their invite code.

Step 4 — Complete Verification

The referral initially appears as Pending.

The invited player must meet the configured verification playtime.

After successful validation, the referral becomes Verified.

Step 5 — Receive Rewards

The inviter receives eligible credits and rewards according to the server configuration.

Step 6 — Open Player Menu

Run:

/invite

The player GUI provides access to:

• Invite Code
• Referral Statistics
• Invite Credits
• Available Rewards
• Lifetime Leaderboard
• Referral History

Players can also redeem available repeatable rewards using their earned credits.

🎁 Advanced Reward System

Per-Referral Rewards

Reward an inviter each time an eligible referral becomes verified.

Supported reward content includes:

• Custom item kits
• Console commands
• Combined item and command rewards

Milestone Rewards

Create progressive referral goals that encourage community growth.

Repeatable Rewards

Allow players to exchange invite credits for repeatable rewards.

Verified invite counts are tracked separately from spendable credit balances.

🛠️ Administrator Commands

Use /zi help to view available command arguments and supported actions.

🔒 Referral Protection

ZeroInvite includes multiple validation and protection mechanisms.

• Prevent self-referrals
• Reject duplicate redemptions
• Prevent changing inviters after redemption
• Enforce redemption windows
• Validate player eligibility
• Configure same-IP protection

Referral data is associated with Minecraft UUIDs to preserve relationships when usernames change.

💾 Safe Configuration & Storage

ZeroInvite uses a built-in SQLite database to store referral data.

The plugin also supports persistent configuration drafts.

Administrators can save unfinished setup progress and continue after restarting the server.

Safe Reward Deletion

Reward deletion includes a confirmation process:

Reward Detail → Delete → Yes, Delete

Historical reward claim records remain available for auditing.

🔌 PlaceholderAPI Integration

ZeroInvite supports PlaceholderAPI integration for compatible scoreboards, tab lists, and other supported plugins.

Available placeholders:

%zeroinvite_code%
%zeroinvite_credits%
%zeroinvite_invites%
%zeroinvite_verified%
%zeroinvite_pending%
%zeroinvite_rejected%
%zeroinvite_rank%
%zeroinvite_inviter%
%zeroinvite_onboarding%

Install PlaceholderAPI if your server uses these placeholders.

❓ Troubleshooting

ZeroInvite Commands Are Not Working

• Confirm the plugin JAR is in the correct folder.
• Check the server startup logs.
• Verify your Minecraft and Java versions.
• Ensure the plugin loaded successfully.
• Check operator status or command permissions.

Players Cannot Redeem Invite Codes

Check:

• Whether the player is eligible
• Whether the code or username is valid
• Whether the player already redeemed a referral
• Whether the redemption window has expired
• Whether anti-abuse protection is blocking the referral

Referrals Are Not Becoming Verified

Check the configured verification duration.

Ensure the invited player has completed the required playtime and satisfies the referral validation rules.

Rewards Are Not Being Delivered

Check the reward configuration, verification status, and any console commands used for reward delivery.

Setup Was Not Completed

Run:

/zi setup

Resume your saved setup draft and complete the remaining steps.

🚀 Quick Start

For experienced server owners:

1. Download ZeroInvite from Modrinth.
2. Place the JAR inside the plugins folder.
3. Start the server.
4. Join as an operator.
5. Execute /zi setup.
6. Configure onboarding and verification.
7. Configure invite credits and rewards.
8. Save the setup.
9. Test with two eligible accounts.
10. Let your players use /invite.

That's it! Your server now has a complete referral and reward system.

🔗 Links

Download: https://modrinth.com/plugin/zeroinvite

ZeroInvite — Invite friends. Verify referrals. Reward your community.

Developed by Zero Studio™