SimpleReferrals - 玩家邀请奖励插件

SimpleReferrals 是一款用于管理玩家邀请奖励的插件。它允许新玩家通过输入指令来指定邀请人，从而使邀请人获得预设的奖励，以此鼓励玩家为服务器邀请新成员。

💡核心功能

• 新玩家加入服务器后，可使用 /refer <玩家名> 来指定其邀请人。
• 被指定的邀请人（即老玩家）将立即获得可配置的奖励。
• 如果邀请人不在线，奖励将在其下次上线时发放。
• 可自定义所有提示信息与奖励内容。
• 支持在玩家首次加入时显示提示消息，引导其使用 /refer 指令。

🎮指令与权限

主要指令

• /refer <玩家名>

-   权限：`simplereferrals.refer`

-   功能：新玩家使用此指令来确认邀请人。成功后，邀请人将获得奖励。

管理指令

• /SimpleReferrals

-   功能：显示插件帮助信息。

• /SimpleReferrals Reload

-   权限：`simplereferrals.reload`

-   功能：重载插件的配置文件 (`config.yml`)。

🔧安装与配置

安装步骤

• 下载插件并将其放入服务器的 plugins 文件夹。
• 重启服务器以生成默认配置文件。
• 根据需求编辑 plugins/SimpleReferrals/config.yml 文件，自定义奖励和消息。
• 使用 /SimpleReferrals Reload 指令或在控制台输入 reload confirm 来应用配置更改。

配置文件详解

以下为 config.yml 的主要配置项示例，您可以根据注释进行修改：

# 消息配置
command-no-exist: '&3[ &9SimpleReferrals&3 ] &bThis command doesn''t exist'
no-permission: '&3[ &9SimpleReferrals&3 ] &bYou don''t have permission to use this command'
configs-reloaded: '&3[ &9SimpleReferrals&3 ] &bConfigs Reloaded'
already-redeemed: '&3[ &9SimpleReferrals&3 ] &bYou cannot use this command anymore'
enter-name: '&3[ &9SimpleReferrals&3 ] &bPlease the name of the player that referred you to the server'

# 奖励发放提示 (邀请人在线/离线)
online-given-rewards: '&3[ &9SimpleReferrals&3 ] &b%player% is online and has been given rewards...'
offline-given-rewards: '&3[ &9SimpleReferrals&3 ] &b%player% is offline but they will get their rewards when they are on...'

# 邀请人收到的奖励消息
reward-message:
  - '&3[ &9SimpleReferrals&3 ] &b'
  - '&bYou have been given rewards'
  - '&bfor referring players to the server'

# 奖励指令列表 (执行给邀请人)
reward-commands:
  - eco give %player% 100  # 示例：给予游戏币
  - give %player% diamond 16  # 示例：给予钻石

# 加入提示消息
enable-join-message: true  # 是否启用加入提示
join-message:
  - '&3[ &9SimpleReferrals&3 ] '
  - '&bDid someone invite you to this server?'
  - '&bType &n/Refer PLAYER&b for them to receive an award'
  - '&bYou can also invite players to this server and ask them to /Refer your name to receive an award'

# 帮助信息
simplereferrals-help:
  - '&3[ &9SimpleReferrals&3 ] '
  - '&bAuthor&7 : &3Discord iAngry#0932 - Spigot gregoryg'
  - '&bVersion&7 : &3%version%'
  - '&bCommands&7 : &3/SimpleReferrals'
  - '&bCommands&7 : &3/Refer'
  - '&bCommands&7 : &3/SimpleReferrals Reload'

❓使用示例

• 玩家 PlayerOne 邀请新玩家 PlayerGuest 加入服务器。
• PlayerGuest 首次进入服务器后，输入指令：/refer PlayerOne。
• 系统检查 PlayerOne 是否为有效玩家。
• 如果 PlayerOne 在线，他将立即获得 reward-commands 中配置的奖励（如游戏币和钻石），并收到 reward-message 提示。
• 如果 PlayerOne 离线，奖励会被记录，待其下次上线时自动发放。
• PlayerGuest 会收到一条消息，告知奖励已发放或已记录。

✨注意事项

• 每个新玩家只能成功使用一次 /refer 指令，重复使用会收到 already-redeemed 提示。
• 请确保 reward-commands 中配置的指令（如 eco give）所需的插件已正确安装并运行。
• 修改 config.yml 后，请务必使用 /SimpleReferrals Reload 重载配置。
• 插件的消息和奖励高度可定制，请根据您的服务器经济系统和需求进行调整。