Referral - 好友邀请奖励插件

💡简介

这是一个简单高效的推荐插件。其核心机制是：当一名新玩家被邀请加入服务器时，由新玩家自己声明是谁邀请了他/她。每位玩家只能进行一次这样的声明，从而确保推荐系统的唯一性和公平性。

🎮工作原理

• 当玩家被邀请加入服务器时，邀请者不需要执行任何命令。
• 由被邀请的新玩家使用命令来告诉服务器是谁邀请了他/她。
• 每位玩家只能成功声明一次推荐人，无法重复声明。

✨插件特性

• Referral V2：插件已完全重写并公开发布，性能更优。
• 流畅体验：采用异步数据库请求，有效防止服务器卡顿。
• 智能补全：命令拥有更好的自动补全功能。
• 多版本支持：全面支持从 1.7 到 1.18 的 Minecraft 版本。
• 数据库支持：支持 Local（本地）和 MySQL 数据库。

🔧命令列表

玩家命令

• /ref <player> - 声明指定玩家是你的推荐人，成功后双方可获得奖励。
• /ref total [player] - 查看自己（或指定玩家）的推荐总数。
• /ref accept <player> - 接受来自指定玩家的推荐请求（也可点击按钮操作）。
• /ref reject <player> - 拒绝来自指定玩家的推荐请求（也可点击按钮操作）。
• /ref top - 查看推荐排行榜。
• /ref help - 显示玩家可用的命令列表。

管理员命令

• /ref reload - 重载插件配置。
• /ref admin reset <player> - 重置指定玩家的推荐状态（使其可以再次被推荐）。
• /ref admin remove <player> - 将指定玩家从数据库中移除。

> 注意：在旧版本插件中，命令参数曾使用 <Player>，现已统一为 <player>。

⭐权限节点

• Referral.ReferPlayer - 允许使用 /ref <name>。
• Referral.RefAccept - 允许使用 /ref accept <name>。
• Referral.RefReject - 允许使用 /ref reject <name>。
• Referral.RefCount - 允许使用 /ref total。
• Referral.RefTop - 允许使用 /ref top。
• Referral.Reject - 允许使用 /ref reload。
• Referral.RefAdmin - 允许使用 /ref Admin 的管理功能（Reset, Remove）。

❓变量与依赖

PlaceholderAPI 变量

如果安装了 PlaceholderAPI，可以使用以下变量（需通过 /papi ecloud download Player 下载默认变量集）：

• %referral_total% - 显示玩家的推荐总数。
• %referral_refed% - 显示该玩家是否已被推荐过。

你可以在任何支持 Placeholder 的地方使用这些变量。

软依赖

• PlaceholderAPI：非必需，但安装后可启用变量功能以丰富显示。

🔧配置与支持

配置文件

完整的配置文件示例可在此查看：https://pastebin.com/eAuaGg8P

获取帮助

如果遇到任何问题，请不要在评论区提问，请加入我们的 Discord 服务器获取支持：

• Discord 邀请链接：https://discord.gg/teMrM7Z

🔧进阶需求？

如果你正在寻找一个功能更强大的推荐系统，它包含

• 用户界面 (UI)
• 离线玩家支持
• 随机奖励
• 推荐码功能
• 基于等级的奖励

请点击下方链接查看我们的高级版本。