MysticalReferral

插件

· 作者 mysticalcraft-ancientvipers

一款功能丰富的推荐和邀请奖励系统插件,适用于 Minecraft Paper 服务器。

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

最新 1.0.0 · 1.21.11 · Paper

一键开服(送7天)

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 - 用于聊天、记分板等的占位符支持

安装

  1. 下载 MysticalReferral-1.0.0.jar
  2. 将 JAR 文件放入服务器的 plugins/ 文件夹中
  3. 启动服务器一次以生成 config.yml
  4. 编辑 plugins/MysticalReferral/config.yml 中的 MySQL 凭据
  5. 重启服务器或运行 /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 服务器使用。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源