RallyRefer
将现有玩家转化为推广者,同时避免向一次性小号发放即时奖励。
RallyRefer 是一款轻量级的 Paper 和 Folia 推荐插件。只有当被邀请玩家达到可配置的在线时长阈值并通过实用的反作弊检查后,才会发放奖励。
什么是 RallyRefer?
每位玩家的名称即为其推荐码。新玩家在加入后不久运行 /rally refer <name>。当该新玩家停留足够长时间后,双方都会获得其配置的奖励。
功能特性
- 游戏内物品编辑器 — 使用
/rally refer edit 编辑新玩家和邀请人的物品奖励。自定义名称、附魔、模型数据、NBT 以及填充的潜影盒均会保留。
- 达标后才发放奖励,而非注册时 — 被邀请玩家必须实际进行游戏,之后才会发放任何奖励。
- 同 IP 保护 — 可以阻止明显的同一地址推荐。
- 每日邀请人上限 — 限制每个玩家每天可以领取多少推荐奖励。
- 领取窗口 — 防止已建立账号的玩家在加入很久之后才指定推荐人。
- 双方均有奖励 — 提供物品、Vault 货币以及任意控制台命令。
- 离线邀请人队列 — 处于离线状态的邀请人在下次登录时将收到当前的奖励。
- 兼容 Folia — 基于会话时间测量在线时长,无需 ticking tasks。
- PlaceholderAPI 支持 — 显示推荐码、数量、推荐人及资格状态。
- 简易存储 — 单个扁平 YAML 文件,无需数据库设置。
工作原理
- 现有玩家分享其名称作为推荐码。
- 新玩家在领取窗口期间运行
/rally refer <code>。
- 新玩家达到所需的在线时长。
- 检查反作弊规则,然后为两名玩家发放奖励。
命令
| 命令 |
描述 |
权限 |
/rally refer |
显示你的推荐码 |
vouch.use |
/rally refer <code> |
设置谁推荐了你 |
vouch.use |
/rally refer edit |
编辑两条物品奖励路线 |
vouch.admin |
/rally refer reload |
重新加载配置 |
vouch.admin |
/rally refer stats <player> |
检查推荐统计信息 |
vouch.admin |
当未安装 RallyDaily 时,独立别名 /vouch 和 /vouchadmin 仍然可用。
占位符
%vouch_code% · %vouch_referrals% · %vouch_referred_by% · %vouch_qualified%
要求
- Paper、Purpur 或 Folia 1.20+
- Java 21
- 可选:PlaceholderAPI、Vault 和经济类插件
安装方法
- 将 RallyRefer JAR 放入服务器的
plugins 文件夹中。
- 重启服务器。
- 在
plugins/RallyRefer/config.yml 中设置资格时间、领取窗口、同 IP 规则和每日上限。
- 运行
/rally refer edit 在游戏内构建两条物品奖励路线。
- 在公开启用之前,使用两个玩家账号测试完整流程。
重要行为说明
如果推荐未能通过反作弊检查,它将被标记为已处理且不支付任何奖励。离线邀请人的奖励在交付时使用当前配置的奖励。如果背包已满,剩余的物品将安全地掉落至玩家脚下。
RallyRefer 是 Rally 互动套件的一部分,与 RallyDaily 和 RallyVote 配合使用。每个插件均可独立工作。
许可证
可免费下载并在 Minecraft 服务器上使用。保留所有权利;禁止重新分发、转售和修改后的重新上传。
RallyRefer
Turn current players into recruiters without paying instant rewards to disposable alt accounts.
RallyRefer is a lightweight Paper and Folia referral plugin. A reward is paid only after the invited
player reaches a configurable playtime threshold and passes practical anti-abuse checks.
What is RallyRefer?
Each player's name is their referral code. A new player runs /rally refer <name> shortly after
joining. When that new player stays long enough, both sides receive their configured reward.
Features
- In-game item editor — use
/rally refer edit to edit the new-player and inviter item rewards.
Custom names, enchantments, model data, NBT, and filled shulkers are preserved.
- Reward on qualification, not signup — invited players must actually play before anyone is paid.
- Same-IP protection — obvious same-address referrals can be blocked.
- Daily inviter cap — limit how many referrals one player can cash out per day.
- Claim window — prevent established accounts from assigning a referrer long after joining.
- Rewards for both sides — give items, Vault money, and any console command.
- Offline inviter queue — an inviter who is offline receives the current reward on their next join.
- Folia-ready — playtime is measured from session time without ticking tasks.
- PlaceholderAPI support — show referral codes, counts, referrers, and qualification status.
- Simple storage — one flat YAML file, no database setup.
How it works
- An existing player shares their name as a referral code.
- A new player runs
/rally refer <code> during the claim window.
- The new player reaches the required playtime.
- Anti-abuse rules are checked, then both players are rewarded.
Commands
| Command |
Description |
Permission |
/rally refer |
Show your referral code |
vouch.use |
/rally refer <code> |
Set who referred you |
vouch.use |
/rally refer edit |
Edit the two item reward tracks |
vouch.admin |
/rally refer reload |
Reload the configuration |
vouch.admin |
/rally refer stats <player> |
Inspect referral statistics |
vouch.admin |
When RallyDaily is not installed, the standalone aliases /vouch and /vouchadmin remain available.
Placeholders
%vouch_code% · %vouch_referrals% · %vouch_referred_by% · %vouch_qualified%
Requirements
- Paper, Purpur, or Folia 1.20+
- Java 21
- Optional: PlaceholderAPI, Vault, and an economy plugin
Installation
- Put the RallyRefer JAR in your server's
plugins folder.
- Restart the server.
- Set the qualification time, claim window, same-IP rule, and daily cap in
plugins/RallyRefer/config.yml.
- Run
/rally refer edit to build both item reward tracks in-game.
- Test the complete flow with two player accounts before launching it publicly.
Important behavior
If a referral fails an anti-abuse check, it is marked as processed and pays nothing. Offline inviter
rewards use the current configured reward when delivered. If an inventory is full, only leftover
items are dropped safely at the player's feet.
RallyRefer is part of the Rally engagement suite with RallyDaily and RallyVote. Each plugin works
on its own.
License
Free to download and use on Minecraft servers. All rights reserved; redistribution, resale, and
modified reuploads are not permitted.
评论 0
登录后参与评分
还没有评论,来抢沙发吧