[MOVED] PlaytimeRewards - 在线时长奖励

PlaytimeRewards 是一款基于玩家在线时长发放奖励的插件。它能够追踪玩家的游戏时间，并在达到特定时长（例如 5 小时）时自动给予奖励，支持多种计时方式和高度自定义的奖励内容。

💡重要更新

• 已发布重制版，支持 MC 1.8 至 1.13。
• 重制版资源链接：https://www.spigotmc.org/resources/60266/

🎮核心功能

• 为特定游戏时长创建奖励。
• 奖励可被多次获取。
• 支持三种计时循环：实时（REALTIME）、游戏时间（PLAYTIME）和会话时间（SESSIONTIME）。
• 奖励可执行多条命令（可由玩家或控制台执行）。
• 奖励可给予玩家物品。
• 可自定义奖励消息（包括全服公告）。
• 可自定义领取奖励时的粒子与音效。
• 实时玩家时间计数器。
• 性能优化，无延迟。
• 用途广泛：可用于首次登录奖励、每日登录奖励、新手奖励或老玩家忠诚度奖励等。

🔧命令与权限

查看时间

• /pt 或 /playtime
• 权限：timerewards.seetime
• 功能：查看自己的游戏时长。

• /pt <player> 或 /playtime <player>
• 权限：timerewards.seetime.others
• 功能：查看其他玩家的游戏时长。

• /playtimetop 或 /pttop
• 权限：timerewards.seetop
• 功能：查看游戏时长最高的玩家排行榜。

管理奖励

• /pr reload 或 /PlaytimeRewards reload
• 权限：timerewards.reload
• 功能：重载 config.yml 和 rewards.yml 配置文件。

• /pr giveReward <RewardName> [Player]
• 权限：timerewards.giveRewards
• 功能：向指定玩家发放奖励（无视所需时长和权限）。

• /pr editItem <RewardName>
• 权限：timerewards.editItem
• 功能：修改指定奖励的物品。

• /pr listRewards
• 权限：timerewards.listRewards
• 功能：列出所有已创建的奖励。

• /pr seeRewards [Player]
• 权限：timerewards.seeRewards 或 timerewards.seeRewardsOthers
• 功能：查看指定玩家已获得的所有奖励。

权限汇总

• timerewards.*：授予本插件的所有权限。

✨配置文件详解

config.yml (主要配置)

# PlaytimeRewards 配置文件
Main:
  Version: 2.8 # 请勿修改
  ColorChar: '&' # 颜色代码前缀
  msgUnknownLoops: false # 玩家登录时若存在未知循环/奖励，是否在控制台通知
  MySQL: false # 是否启用 MySQL
  ForceCommands: true # 是否强制本插件命令优先于其他同名插件命令
  DataSaveInterval: 1800 # 自动保存数据间隔（秒），设为0禁用（不推荐）
  TopAmount: 10 # /pttop 显示的玩家人数

Notification:
  allowMessages: true # 是否允许插件开发者向控制台发送通知消息
  # searchUpdates: true # 是否检查更新（此版本中已注释）

MySQL: # MySQL 数据库配置
  Host: localhost
  Port: 3306
  User: minecraftuser
  Password:
  Database: minecraftserver
  useSSL: false

rewards.yml (奖励配置)

以下是一个名为 DailyLogin 的奖励示例，展示了所有可配置项：

Rewards:
  DailyLogin: # 奖励内部名称，不可重复
    PlaytimeNeeded: 86400 # 所需时间（秒）
    CountType: 'REALTIME' # 计时类型：REALTIME, PLAYTIME, SESSIONTIME
    GlobalNotification: false # 是否向全服发送公告
    PlayerNotification: true # 是否向玩家发送通知
    RewardName: '&3Daily &4Login' # 奖励显示名称
    RewardText: '&3Thank you for your Daily Login! Here is a Cookie!' # 发送给玩家的自定义文本
    RewardCommand: '' # 由玩家执行的命令列表
    RewardConsole: '' # 由控制台执行的命令列表，<player> 会被替换为玩家名

    RewardItem: # 奖励物品配置
      Item: 'COOKIE'
      Damage: 0
      Amount: 1
      DisplayName: '&4Cool &8Cookie&a!'
      Lore:
        - '&3A very good looking Cookie&7!'
    Enchantments: # 物品附魔
      DURABILITY: 10
      LUCK: 666
    Effects: # 音效与粒子效果
      SoundName: 'ENTITY_PLAYER_LEVELUP'
      SoundPitch: 1
      SoundVolume: 2
      ParticleName: 'LAVA'
      ParticleAmount: 20
      ParticleSpeed: 0.1
      ParticleOffsetX: 0.3
      ParticleOffsetY: 0.1
      ParticleOffsetZ: 0.3

    LoopOptions: # 循环/重复奖励配置
      EnableLoop: true # 是否启用循环
      WaitFirst: false # 是否先给予一次奖励，再开始循环计时（用于每日登录）
      MinPlaytime: 0 # 领取奖励所需的最小游戏时长（秒）
      MaxPlaytime: 0 # 领取奖励所允许的最大游戏时长（秒）
      PermissionNeeded: '' # 领取奖励所需的权限

❓常见问题与提示

关于循环计时 (`useServerTime`)

• 在旧版本配置中，useServerTime 值决定循环如何计时：
• true：基于现实时间（自上次触发后经过的真实时间）。适用于每日登录奖励。
• false：基于玩家的游戏时间（自上次触发后累计的在线时间）。适用于每在线X分钟给予奖励。

更新注意事项

• 插件在检测到新版本时会生成新的 config.yml。更新前请务必备份旧的配置文件，以便将原有配置值复制到新文件中。

版本兼容性

• 插件为 Minecraft 1.12 编写，但支持 1.7 及以上版本。
• 请注意，旧版本可能不支持所有功能（例如粒子效果）。

网页扩展

• 感谢 @CMSascha 制作的 PlaytimeRewards 网页扩展！
• 详情请见：https://www.spigotmc.org/resources/playtimerewards-webaddon.46160/

问题反馈

• 请将 Bug 或错误报告发布在讨论区或私信作者，而非评论中。

数据统计

• 本插件使用 bStats 收集匿名数据。详情：https://bstats.org/plugin/bukkit/PlaytimeRewards

⭐重制版预告

插件正在进行完全重写，旨在提升性能、优化代码，并增加新功能。部分已完成或计划中的新特性包括：

• AFK 识别与 AFK 时间奖励。
• 基于世界的奖励限制。
• 所有消息可通过 lang.yml 文件配置。
• 使用新的 GUI-API 和 Task-API 提升性能与易用性。
• 更灵活的条件奖励系统（支持 AND/OR 逻辑组合）。
• 新的 MySQL 连接池（HikariCP）。
• 配置自动合并更新，无需手动覆盖。

🔧使用本插件的服务器（部分）

• bdserver.fun
• play.mineglade.net
• shdilnetwork.ddns.net
• play.herondalemc.com
• play.divine-mc.com
• landofpixels.crafted.pro

希望您的服务器也出现在列表中？请将地址发送给作者！