MysticalReferral
一个功能丰富的 Minecraft Paper 服务器推荐与邀请奖励系统插件。
玩家可以生成邀请码,分享给朋友,当邀请码被使用时,双方都会获得可配置的奖励。
功能特性
- 邀请码生成 - 简短、唯一、易于分享的代码,支持点击复制
- 奖励系统 - 完全可配置的控制台命令,适用于邀请者和被邀请玩家
- 里程碑/阶梯奖励 - 在可配置的邀请阈值(5、10、25、50 等)时提供额外奖励
- 离线奖励队列 - 奖励会被排队,并在离线邀请者重新上线后发放
- 音效与标题特效 - 成功推荐时可配置音效和标题屏幕效果
- 推荐历史 - 玩家可以查看他们推荐了谁以及时间
- 排行榜 - 全服顶级推荐者排名
- 玩家统计 - 个人推荐统计数据
- 管理员命令 - 为服务器管理员提供 info、reset 和 setcode 命令
- 代码过期 - 可选的限时推荐码
- PlaceholderAPI 支持 - 将推荐数据暴露给记分板、聊天等
- 更新检查器 - 登录时通知管理员有新版本
- 防滥用保护:
- 防止自我推荐
- 每个玩家仅限使用一次
- 可配置的最小游戏时长要求
- 可选的 IP 地址检查以阻止小号滥用
- MySQL 存储 - 带有 HikariCP 连接池
- 自定义推荐码 - 拥有权限的玩家可以设置自己的专属代码
- 顶级推荐者定时奖励 - 按每日/每周计划自动奖励前 N 名推荐者
- 配置版本控制 - 添加新设置时自动迁移配置(无需手动删除)
- 完全可配置 - 消息、奖励、效果和设置均可配置
要求
- Minecraft 1.21.x
- Paper 服务器(或 Purpur 等分支)
- Java 21
- MySQL 8.0+ 数据库
可选依赖
- PlaceholderAPI - 用于聊天、记分板等的占位符支持
安装
- 下载
MysticalReferral-1.0.0.jar - 将 JAR 文件放入服务器的
plugins/文件夹中 - 启动服务器一次以生成
config.yml - 编辑
plugins/MysticalReferral/config.yml中的 MySQL 凭据 - 重启服务器或运行
/referral reload
从源代码构建
git clone https://github.com/your-org/MysticalReferral.git
cd MysticalReferral
mvn clean package
编译后的 JAR 文件位于 target/MysticalReferral-1.0.0.jar。
构建要求:Java 21, Maven 3.9+
配置
数据库
database:
host: localhost
port: 3306
name: mysticalreferral
username: root
password: password
pool:
maximum-pool-size: 10
minimum-idle: 2
connection-timeout: 30000
idle-timeout: 600000
max-lifetime: 1800000
请预先创建数据库:
CREATE DATABASE mysticalreferral;
设置
settings:
code-length: 5
min-playtime-minutes: 10
allow-ip-referrals: false
leaderboard-size: 10
code-expiration-days: 0
language: en
update-checker: true
奖励
奖励作为控制台命令执行。使用 %player% 作为玩家名称的占位符。
rewards:
inviter:
commands:
- "give %player% diamond 2"
- "eco give %player% 500"
invited:
commands:
- "give %player% diamond 1"
- "eco give %player% 100"
里程碑奖励
milestones:
5:
commands:
- "give %player% emerald 5"
message: "&a&l里程碑! &e你达到了 &b5 &e个邀请!"
10:
commands:
- "give %player% emerald 16"
- "eco give %player% 2000"
message: "&a&l里程碑! &e你达到了 &b10 &e个邀请!"
特效
effects:
sound:
enabled: true
type: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.0
title:
enabled: true
title: "&a&l推荐已使用!"
subtitle: "&7你和 &e%player% &7获得了奖励!"
inviter-title:
enabled: true
title: "&a&l新推荐!"
subtitle: "&e%player% &7使用了你的代码!"
自定义推荐码
custom-codes:
enabled: true
min-length: 3
max-length: 16
allowed-pattern: "^[A-Za-z0-9_]+$"
force-uppercase: true
顶级推荐者定时奖励
top-rewards:
enabled: false
interval-minutes: 1440
top-count: 3
broadcast: true
positions:
1:
commands:
- "give %player% netherite_ingot 3"
message: "#1 顶级推荐者!恭喜 %player%!"
命令
| 命令 | 描述 | 权限 |
|---|---|---|
/invite |
生成或查看你的推荐码(点击复制) | mysticalref.invite |
/invite set <code> |
设置自定义专属推荐码 | mysticalref.customcode |
/ref <code> |
使用推荐码 | mysticalref.use |
/referral stats |
查看你的推荐统计 | mysticalref.referral |
/referral top |
查看排行榜 | mysticalref.referral |
/referral history |
查看你推荐了谁 | mysticalref.referral |
/referral reload |
重载配置 | mysticalref.reload |
/referral admin info <player> |
查看玩家的推荐信息 | mysticalref.admin |
/referral admin reset <player> [confirm] |
重置玩家的推荐数据 | mysticalref.admin |
/referral admin setcode <player> <code> |
设置自定义推荐码 | mysticalref.admin |
许可证
本项目按原样提供,供 Minecraft 服务器使用。
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
46
Beds Always Explode
rabiesland
使床在所有维度中爆炸的模组
诅咒玩法机制
30
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
可自定义玩家模型
tom5454
自定义你的Minecraft头像!
装饰社交
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
评论 0
登录后参与评分
还没有评论,来抢沙发吧