? ZeroInvite — 完整的推荐与奖励系统
邀请好友。验证推荐关系。获取奖励。
ZeroInvite 是一款专为 Spigot 和 Paper 服务器设计的强大 Minecraft 推荐、新手引导、身份验证、排行榜及奖励管理插件。
通过奖励邀请好友的玩家,壮大你的 Minecraft 社区!
玩家可以分享永久性的邀请码或 Minecraft 用户名。新的推荐关系会被追踪,在达到可配置的在线时长后完成验证,并奖励积分、自定义物品、指令、里程碑奖励以及可重复领取的奖励。
✨ 功能特性
- ? 为每位玩家生成永久性邀请码
- ? 使用邀请码或用户名邀请好友
- ✅ 可配置的推荐验证时间
- ? 按次推荐、里程碑及可重复领取的奖励
- ? 可消耗的邀请积分
- ? 终身推荐排行榜
- ? 完整的推荐历史记录
- ?️ 交互式玩家和管理员 GUI
- ⚙️ 首次设置向导
- ?️ 防自我推荐和重复兑换保护
- ? 可配置的同 IP 地址保护
- ? 内置 SQLite 数据库
- ? PlaceholderAPI 集成支持
- ? 自定义 ItemStack 奖励套件
- ? 安全的玩家数据迁移系统
- ? 持久化的设置草稿保存
? 安装指南
请按照以下步骤在您的 Minecraft 服务器上安装 ZeroInvite。
步骤 1 — 下载 ZeroInvite
从以下链接下载最新兼容版本:
步骤 2 — 检查需求
- 服务端软件: Paper 或 Spigot
- Minecraft 版本: 1.21.x
- Java 版本: Java 21+
- PlaceholderAPI: 可选集成(请根据您已安装的版本进行核对)
步骤 3 — 安装插件
- 停止您的 Minecraft 服务器。
- 打开服务器的
plugins 文件夹。
- 上传下载好的 ZeroInvite
.jar 文件。
- 如果您需要使用其占位符变量,请安装 PlaceholderAPI。
- 启动服务器。
目录结构示例:
Minecraft Server/
├── plugins/
│ ├── ZeroInvite-1.0.0.jar
│ └── PlaceholderAPI.jar
├── server.properties
└── ...
步骤 4 — 验证安装
以管理员权限加入您的服务器。
执行命令:
/zi help
如果 ZeroInvite 安装成功,管理员命令应该可用。
现在您可以配置推荐系统了!
⚙️ 首次服务器设置
ZeroInvite 包含一个设置向导,帮助管理员在不手动编辑配置文件的情况下配置插件。
步骤 1 — 打开设置向导
以管理员身份加入您的 Minecraft 服务器。
运行命令:
/zi setup
设置向导将引导您完成初始配置。
步骤 2 — 配置玩家新手引导
选择新玩家如何与推荐系统进行交互。
必填项 (REQUIRED)
根据配置的限制,新玩家在访问正常游戏内容之前必须完成推荐系统的新手引导。
选填项 (OPTIONAL)
向玩家提供推荐系统的新手引导,但可以使用可用的跳过选项跳过它。
禁用 (DISABLED)
自动新手引导已禁用。玩家仍可以手动使用支持的推荐指令。
建议: 休闲生存服务器使用“选填项”,专注于推荐的社区使用“必填项”。
步骤 3 — 配置验证时间
设置被邀请玩家必须在推荐关系变为“已验证”状态前游玩多久。
示例:
验证时间:30 分钟
推荐流程:
好友加入 → 兑换代码 → 待处理 → 游玩 30 分钟 → 已验证
一旦验证通过,符合条件的积分和奖励即可发放。
步骤 4 — 配置推荐保护
查看可用的安全选项:
- 防止自我推荐
- 防止重复兑换保护
- 推荐资格 requirements
- 兑换时间窗口
- 同 IP 地址保护
同 IP 地址保护模式包括:
阻止 (BLOCK) — 拒绝来自同一 IP 地址的推荐。
警告 (WARN) — 标记可能的同 IP 地址推荐。
允许 (ALLOW) — 允许该推荐。
选择适合您服务器和社区设置。
步骤 5 — 配置推荐奖励
打开奖励管理器:
/zi rewards
ZeroInvite 支持三种主要奖励类别。
1. 按次推荐奖励 (Per-Referral Rewards)
每当有一个符合条件的推荐关系变为“已验证”时给予奖励。
示例:
1 个已验证推荐 = 100 邀请积分
您可以配置物品套件、控制台指令或两者兼有。
2. 里程碑奖励 (Milestone Rewards)
奖励玩家达到特定的终身推荐数量。
示例:
- 1 个已验证邀请 → 新手套件
- 5 个已验证邀请 → 钻石套件
- 10 个已验证邀请 → VIP 奖励
- 25 个已验证邀请 → 传奇奖励
这些仅为示例奖励。配置您自己的要求和内容。
3. 可重复奖励 (Repeatable Rewards)
允许玩家多次花费赚取的邀请积分来兑换奖励。
示例:
- 100 积分 → 铁制套件
- 250 积分 → 钻石套件
- 500 积分 → 自定义奖励
花费邀请积分不会减少终身已验证推荐关系的统计数据。
步骤 6 — 配置自定义奖励物品
使用奖励编辑器配置自定义物品套件。
- 打开
/zi rewards。
- 选择适当的奖励管理选项。
- 创建或编辑一个奖励。
- 设置其名称和要求条件。
- 选择支持的奖励类型。
- 通过套件编辑器添加所需的物品。
- 保存奖励。
奖励配置可以包括自定义物品和控制台指令。
步骤 7 — 保存您的配置
完成设置向导并保存您的设置。
需要在完成之前离开?
在可用时使用 保存草稿并退出。
使用 ESC 关闭编辑器也会保留当前的设置草稿。
保存的草稿存储在:
plugins/ZeroInvite/setup-drafts.yml
再次运行 /zi setup 以恢复未完成的配置。
步骤 8 — 测试您的推荐系统
在向公众开放服务器之前:
- 使用测试玩家账号加入服务器。
- 运行
/invite code 查看邀请码。
- 使用另一个符合条件的测试账号加入。
- 兑换第一个账号的邀请码。
- 确认推荐状态显示为“待处理”(Pending)。
- 完成配置的验证时长要求。
- 检查推荐状态是否变为“已验证”(Verified)。
- 确认已发放配置的奖励和积分。
✅ 设置完成!您的 ZeroInvite 推荐系统已就绪。
? 玩家指南 — 如何使用 ZeroInvite
ZeroInvite 专为普通 Minecraft 玩家设计,操作简便。
第一步 — 获取邀请码
运行:
/invite code
每位玩家都会获得一个永久有效的邀请码。
第二步 — 分享你的邀请码
将你的邀请码或 Minecraft 用户名发送给好友。
你的好友必须加入服务器并完成推荐兑换流程。
第三步 — 兑换邀请
新玩家运行以下命令:
/invite redeem <code|player>
示例:
/invite redeem Steve
将 Steve 替换为推荐人的实际用户名,或直接输入其邀请码。
第四步 — 完成验证
被推荐人初始状态显示为 待处理(Pending)。
受邀玩家需满足配置的验证游戏时长要求。
验证成功后,推荐状态将变为 已验证(Verified)。
第五步 — 领取奖励
邀请人将根据服务器配置获得相应的积分和奖励。
第六步 — 打开玩家菜单
运行:
/invite
玩家图形界面提供以下功能入口:
- 邀请码
- 推荐统计
- 邀请积分
- 可用奖励
- 终身排行榜
- 推荐历史
玩家还可以使用获得的积分兑换可重复获得的奖励。
? 高级奖励系统
单次推荐奖励
每当有一个符合条件的推荐关系被验证时,向邀请人发放奖励。
支持的奖励内容包括:
里程碑奖励
创建渐进式的推荐目标,以鼓励社区增长。
可重复奖励
允许玩家使用邀请积分兑换可重复获得的奖励。
已验证的邀请数量与可消费的积分余额分开追踪。
?️ 管理员命令
| 命令 |
描述 |
/zi |
打开管理面板 |
/zi help |
查看管理员命令 |
/zi setup |
打开设置向导 |
/zi settings |
管理插件设置 |
/zi rewards |
管理推荐奖励 |
/zi player <player> |
管理玩家相关数据 |
/zi credits |
访问积分管理 |
/zi invites |
访问邀请管理 |
/zi referral |
访问推荐管理 |
/zi migrate |
管理数据迁移 |
/zi database |
数据库管理 |
/zi reload |
重载插件配置 |
使用 /zi help 查看可用的命令参数和支持的操作。
? 推荐保护
ZeroInvite 包含多种验证和保护机制。
- 防止自我推荐
- 拒绝重复兑换
- 防止在兑换后更改邀请人
- 强制实施兑换时间窗口
- 验证玩家资格
- 配置同 IP 地址保护
推荐数据与 Minecraft UUID 关联,以确保在用户名变更时保持关系不变。
? 安全配置与存储
ZeroInvite 使用内置的 SQLite 数据库来存储推荐数据。
该插件还支持持久化的配置草稿。
管理员可以保存未完成的设置进度,并在重启服务器后继续。
安全的奖励删除
奖励删除包含确认流程:
奖励详情 → 删除 → 是的,删除
历史的奖励领取记录仍可供审计查阅。
? PlaceholderAPI 集成
ZeroInvite 支持 PlaceholderAPI 集成,可用于兼容计分板、标签页列表及其他支持的插件。
可用的占位符:
%zeroinvite_code%
%zeroinvite_credits%
%zeroinvite_invites%
%zeroinvite_verified%
%zeroinvite_pending%
%zeroinvite_rejected%
%zeroinvite_rank%
%zeroinvite_inviter%
%zeroinvite_onboarding%
如果你的服务器使用了这些占位符,请安装 PlaceholderAPI。
❓ 故障排除
ZeroInvite 命令无法使用
- 确认插件 JAR 文件位于正确的文件夹中。
- 检查服务器启动日志。
- 验证 Minecraft 和 Java 版本。
- 确保插件已成功加载。
- 检查操作员权限或命令权限。
玩家无法兑换邀请码
请检查:
- 玩家是否符合资格
- 邀请码或用户名是否有效
- 玩家是否已经兑换过推荐
- 兑换窗口是否已过期
- 反滥用保护是否阻止了推荐
推荐未能变为已验证
检查配置的验证时长。
确保受邀玩家已完成所需的游戏时长并满足推荐验证规则。
奖励未发放
检查奖励配置、验证状态以及用于发放奖励的控制台指令。
未完成设置
运行:
/zi setup
恢复你保存的设置草稿并完成剩余步骤。
? 快速开始
针对经验丰富的服务器所有者:
- 从 Modrinth 下载 ZeroInvite。
- 将 JAR 文件放入
plugins 文件夹。
- 启动服务器。
- 以操作员身份加入。
- 执行
/zi setup。
- 配置引导流程和验证设置。
- 配置邀请积分和奖励。
- 保存设置。
- 使用两个符合条件的账号进行测试。
- 让你的玩家使用
/invite。
就是这样!你的服务器现在拥有了完整的推荐和奖励系统。
? 链接
下载:
ZeroInvite — 邀请朋友。验证推荐。奖励你的社区。
由 Zero Studio™ 开发
? 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:
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
- Stop your Minecraft server.
- Open your server's
plugins folder.
- Upload the downloaded ZeroInvite
.jar file.
- Install PlaceholderAPI if you want to use its placeholders.
- 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.
- Open
/zi rewards.
- Select the appropriate reward management option.
- Create or edit a reward.
- Set its name and requirement.
- Select the supported reward type.
- Add the desired items through the kit editor.
- 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:
- Join with a test player account.
- Run
/invite code to view its invite code.
- Join with another eligible test account.
- Redeem the first account's code.
- Confirm that the referral is marked Pending.
- Complete the configured verification time.
- Check whether the referral becomes Verified.
- 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
| Command |
Description |
/zi |
Open the admin panel |
/zi help |
View administrator commands |
/zi setup |
Open the setup wizard |
/zi settings |
Manage plugin settings |
/zi rewards |
Manage referral rewards |
/zi player <player> |
Manage player-related data |
/zi credits |
Access credit management |
/zi invites |
Access invite management |
/zi referral |
Access referral management |
/zi migrate |
Manage data migration |
/zi database |
Database management |
/zi reload |
Reload plugin configuration |
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:
- Download ZeroInvite from Modrinth.
- Place the JAR inside the
plugins folder.
- Start the server.
- Join as an operator.
- Execute
/zi setup.
- Configure onboarding and verification.
- Configure invite credits and rewards.
- Save the setup.
- Test with two eligible accounts.
- Let your players use
/invite.
That's it! Your server now has a complete referral and reward system.
? Links
Download:
ZeroInvite — Invite friends. Verify referrals. Reward your community.
Developed by Zero Studio™
评论 0
登录后参与评分
还没有评论,来抢沙发吧