zeroinvite

插件

· 作者 UrwahWajid

一款完整的 Minecraft 推荐与奖励插件,支持邀请码、验证、排行榜、邀请积分、里程碑以及可配置奖励,适用于 Spigot 和 Paper。

0 本站下载 0 关注 更新于 1 个月前

需要前置:文本占位符 API

最新 1.0.0 · 1.21.11 · Paper / Spigot

一键开服(送7天)

? 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 — 安装插件

  1. 停止您的 Minecraft 服务器。
  2. 打开服务器的 plugins 文件夹。
  3. 上传下载好的 ZeroInvite .jar 文件。
  4. 如果您需要使用其占位符变量,请安装 PlaceholderAPI。
  5. 启动服务器。

目录结构示例:

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 — 配置自定义奖励物品

使用奖励编辑器配置自定义物品套件。

  1. 打开 /zi rewards。
  2. 选择适当的奖励管理选项。
  3. 创建或编辑一个奖励。
  4. 设置其名称和要求条件。
  5. 选择支持的奖励类型。
  6. 通过套件编辑器添加所需的物品。
  7. 保存奖励。

奖励配置可以包括自定义物品和控制台指令。

步骤 7 — 保存您的配置

完成设置向导并保存您的设置。

需要在完成之前离开?

在可用时使用 保存草稿并退出。

使用 ESC 关闭编辑器也会保留当前的设置草稿。

保存的草稿存储在:

plugins/ZeroInvite/setup-drafts.yml

再次运行 /zi setup 以恢复未完成的配置。

步骤 8 — 测试您的推荐系统

在向公众开放服务器之前:

  1. 使用测试玩家账号加入服务器。
  2. 运行 /invite code 查看邀请码。
  3. 使用另一个符合条件的测试账号加入。
  4. 兑换第一个账号的邀请码。
  5. 确认推荐状态显示为“待处理”(Pending)。
  6. 完成配置的验证时长要求。
  7. 检查推荐状态是否变为“已验证”(Verified)。
  8. 确认已发放配置的奖励和积分。

✅ 设置完成!您的 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

恢复你保存的设置草稿并完成剩余步骤。


? 快速开始

针对经验丰富的服务器所有者:

  1. 从 Modrinth 下载 ZeroInvite。
  2. 将 JAR 文件放入 plugins 文件夹。
  3. 启动服务器。
  4. 以操作员身份加入。
  5. 执行 /zi setup。
  6. 配置引导流程和验证设置。
  7. 配置邀请积分和奖励。
  8. 保存设置。
  9. 使用两个符合条件的账号进行测试。
  10. 让你的玩家使用 /invite。

就是这样!你的服务器现在拥有了完整的推荐和奖励系统。


? 链接

下载:


ZeroInvite — 邀请朋友。验证推荐。奖励你的社区。

由 Zero Studio™ 开发

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源