playtime reward

插件

· 作者 Yenith

一款强大且灵活的在线时长奖励插件,自动为玩家在服务器上的停留时间发放奖励!

0 本站下载 0 关注 更新于 1 年前

最新 1.0.0 · 1.21.9 · Paper

一键开服(送7天)

一款灵活的在线时长奖励插件,自动为在服务器上花费时间的玩家发放奖励!

? 功能

核心功能

  • ⏰ 基于时长的奖励 - 根据玩家的在线时长自动发放奖励
  • ? 完全可配置 - 自定义所有内容:物品、数量、间隔、消息
  • ? 智能存储系统 - 当背包已满时,将奖励存储起来以便稍后领取
  • ? 玩家追踪 - 追踪总在线时长、单次会话时长和奖励历史
  • ? 丰富的视觉反馈 - 自定义消息、音效、粒子效果和动作栏倒计时
  • ?️ 管理员工具 - 全面的命令用于管理和监控玩家奖励
  • ? 性能优化 - 高效的追踪与自动保存系统
  • ? 基于权限的控制 - 控制谁可以获得奖励以及谁拥有管理员权限

高级功能

  • 背包满保护 - 绝不错失奖励!它们会自动存储
  • 自定义物品支持 - 任何带有自定义名称和描述的物品
  • 动作栏倒计时 - 玩家会在动作栏看到倒计时
  • 欢迎消息 - 玩家加入时显示在线时长信息的问候语
  • 防挂机机制 - 必须满足最低在线时长要求才能开始获取奖励
  • 最大存储限制 - 可配置的存储上限以防止滥用
  • 数据持久化 - 所有数据自动保存并跨重启保留
  • Tab 补全 - 所有命令都支持 Tab 补全,提供更好的用户体验

? 安装

前置条件

  • 运行 Minecraft 1.21+ 的 Paper 或 Spigot 服务器
  • 服务器上已安装 Java 17 或更高版本

步骤

  1. 下载 最新的 PlaytimeReward-1.0.0.jar 文件
  2. 停止 你的 Minecraft 服务器
  3. 将 JAR 文件放置到服务器的 plugins 文件夹中
  4. 启动 你的服务器
  5. 插件将创建一个包含默认配置的 PlaytimeReward 文件夹
  6. 通过编辑 plugins/PlaytimeReward/config.yml 配置插件
  7. 使用 /ptr reload 重载插件或重启服务器

验证

安装后,验证插件是否正常工作:

> plugins
[10:00:00 INFO]: Plugins (1): PlaytimeReward

⚙️ 配置

插件会在 plugins/PlaytimeReward/ 目录下生成一个 config.yml 文件,其中包含广泛的自定义选项。

基本配置

奖励设置

reward:
  # 每次奖励之间的时间间隔(秒)
  interval: 300  # 5分钟(300秒)
  
  # 作为奖励给予的物品(使用 Minecraft 材质名称)
  # 示例:DIAMOND, EMERALD, GOLD_INGOT, IRON_INGOT, NETHERITE_INGOT
  item: DIAMOND
  
  # 每次奖励给予的物品数量
  amount: 1
  
  # 奖励物品的自定义显示名称(可选)
  # 使用 & 表示颜色代码 (&a = 绿色, &b = 蓝色, 等等)
  display-name: "&b&l在线时长奖励"
  
  # 奖励物品的描述(可选)
  lore:
    - "&7感谢游玩!"
    - "&7来自在线时长的奖励"

消息自定义

所有消息均支持 Minecraft 颜色代码(& 格式):

messages:
  # 玩家获得奖励时的消息
  reward-received: "&a&l✦ &a你因在线游玩获得了 &e{amount}x {item} &a!"
  
  # 背包已满时的消息
  inventory-full: "&c&l⚠ &c你的背包已满!&7奖励已保存。使用 &e/ptr claim &7稍后领取。"
  
  # 领取存储奖励时的消息
  rewards-claimed: "&a&l✦ &a你领取了 &e{amount} &a个存储的奖励!"
  
  # 没有可领取奖励时的消息
  no-rewards: "&c&l✦ &c你没有存储的奖励!"
  
  # 下次奖励倒计时的消息
  next-reward: "&b&l⏰ &b下次奖励将在:&e{time}"
  
  # 加入时的欢迎消息
  welcome: "&a&l✦ &a欢迎回来!你将每 &e{interval} &a的在线时长获得奖励!"

功能开关

features:
  # 玩家加入时发送欢迎消息
  welcome-message: true
  
  # 在动作栏显示距离下次奖励的时间
  actionbar-countdown: true
  
  # 获得奖励时播放音效
  reward-sound: true
  sound: ENTITY_PLAYER_LEVELUP
  
  # 给予奖励时启用粒子效果
  reward-particles: true
  particle: TOTEM_OF_UNDYING

高级设置

advanced:
  # 自动保存玩家数据(分钟)
  auto-save-interval: 5
  
  # 在服务器重启时重置在线时长(不推荐)
  reset-on-restart: false
  
  # 每个玩家的最大存储奖励数量(防止滥用)
  max-stored-rewards: 100
  
  # 开始赚取奖励所需的最低在线时长(秒)
  # 防止出生点挂机农民
  minimum-online-time: 60

配置示例

示例 1:每 10 分钟给予 3 个绿宝石

reward:
  interval: 600
  item: EMERALD
  amount: 3

示例 2:每小时给予 1 个下界合金锭

reward:
  interval: 3600
  item: NETHERITE_INGOT
  amount: 1
  display-name: "&6&l⭐ &e高级小时奖励 &6&l⭐"
  lore:
    - "&7你已经在线游玩了 1 小时!"
    - "&e感谢你的投入"

示例 3:快速测试奖励(30 秒)

reward:
  interval: 30
  item: DIAMOND
  amount: 5

可用物品

你可以使用任何有效的 Minecraft 材质名称。常见示例:

  • DIAMOND, EMERALD, GOLD_INGOT, IRON_INGOT
  • NETHERITE_INGOT, ANCIENT_DEBRIS
  • ENCHANTED_GOLDEN_APPLE, GOLDEN_APPLE
  • ELYTRA, TOTEM_OF_UNDYING
  • EXPERIENCE_BOTTLE, BEACON

有关所有可用材质的列表,请参阅 Spigot Material List。


? 命令

所有命令均使用 /ptr 前缀(/playtimereward 的别名)。

玩家命令

命令 描述 权限
/ptr info 显示你的游戏时长统计信息 无(默认)
/ptr claim 领取你存储的奖励 无(默认)

管理员命令

命令 描述 权限
/ptr reload 重新加载配置文件 PlaytimeReward.admin
/ptr check <player> 查看玩家的游戏时长数据 PlaytimeReward.admin
/ptr reset <player> 重置玩家的游戏时长数据 PlaytimeReward.admin
/ptr save 手动保存所有玩家数据 PlaytimeReward.admin

命令详情

/ptr info

显示你的个人游戏时长信息:

  • 总游戏时长
  • 当前会话时长
  • 距离下一次奖励的时间
  • 已存储的奖励数量(如果有)

示例输出:

=== Your Playtime Info ===
Total Playtime: 2 hours 45 minutes 30 seconds
Current Session: 15 minutes 10 seconds
Next Reward: 4 minutes 30 seconds
Stored Rewards: 3 (Use /ptr claim)

/ptr claim

领取因背包已满而自动存储的所有奖励。

示例输出:

✦ You claimed 5 stored reward(s)!

/ptr reload

在不重启服务器的情况下重新加载插件配置。

使用场景: 编辑 config.yml 之后

/ptr check <player>

查看任意玩家的详细统计数据。

示例输出:

=== Steve's Playtime Data ===
Total Playtime: 2 hours 45 minutes 30 seconds
Time Since Last Reward: 4 minutes 20 seconds
Stored Rewards: 3
Current Session: 15 minutes 10 seconds

/ptr reset <player>

⚠️ 警告: 永久重置某位玩家的所有游戏时长数据。此操作不可撤销!

/ptr save

强制立即将所有玩家数据保存到磁盘。

使用场景: 服务器维护前或手动编辑文件前


? 权限

权限节点 描述 默认值
PlaytimeReward.receive 允许接收游戏时长奖励 true(所有人)
PlaytimeReward.admin 允许使用管理员命令 op(仅管理员)

权限示例

给 Moderator 分配管理员权限:

# Using LuckPerms
/lp user Moderator permission set PlaytimeReward.admin true

移除某玩家的接收权限:

# Using LuckPerms
/lp user Player permission set PlaytimeReward.receive false

在权限插件中设置组权限:

groups:
  default:
    permissions:
      - PlaytimeReward.receive
  moderator:
    permissions:
      - PlaytimeReward.admin

? 使用指南

对于玩家

加入服务器

当你加入时,会看到欢迎消息(如果已启用):

✦ Welcome back! You'll earn rewards every 5 minutes of playtime!

获取奖励

只需在服务器上游玩即可!每隔设定的时间间隔(默认 5 分钟),你将自动获得奖励:

✦ You received 1x diamond for playing!
[Sound and particle effects play]

背包已满

如果你的背包已满,奖励将自动存储:

⚠ Your inventory is full! Reward saved. Use /ptr claim to claim it later.

查看进度

使用 /ptr info 查看:

  • 距离下一次奖励还有多久
  • 你的总游戏时长
  • 任何待领取的存储奖励

领取存储的奖励

当你的背包有空位时,使用 /ptr claim 一次性领取所有存储的奖励。

对于管理员

监控玩家

查看任意玩家的统计数据:

/ptr check PlayerName

测试系统

给自己发放一个测试奖励:

/ptr check YourName  # Check your current data
# (Wait for automatic reward or adjust config for testing)

更改配置

  1. 编辑 plugins/PlaytimeReward/config.yml
  2. 运行 /ptr reload
  3. 更改立即生效

管理玩家数据

  • 查看数据: /ptr check <player>
  • 重置玩家: /ptr reset <player>(谨慎使用)
  • 强制保存: /ptr save(维护前)

? 数据存储

创建的文件

plugins/
└── PlaytimeReward/
    ├── config.yml       # 插件配置
    └── playerdata.yml   # 玩家游戏时长数据

玩家数据结构

playerdata.yml 文件存储:

  • 基于 UUID 的玩家标识
  • 总游戏时长(以秒为单位)
  • 上次奖励的时间戳
  • 已存储(未领取)的奖励
  • 会话信息

数据持久化

玩家数据会自动保存:

  • 当玩家断开连接时
  • 每 5 分钟(可配置)
  • 当服务器停止时
  • 执行 /ptr save 时

? 故障排除

常见问题

问题:玩家未收到奖励

解决方案:

  1. 检查玩家是否拥有 PlaytimeReward.receive 权限
  2. 验证配置中的间隔设置:运行 /ptr reload
  3. 检查玩家数据:运行 /ptr check <player>
  4. 确保满足 minimum-online-time 要求

问题:控制台出现无效材质错误

解决方案:

  1. 检查 config.yml 中的 reward.item 设置
  2. 使用有效的 Minecraft 1.21+ 材质名称
  3. 参见 材质列表
  4. 重新加载配置:运行 /ptr reload

问题:命令无法使用

解决方案:

  1. 验证权限设置是否正确
  2. 检查控制台是否有错误
  3. 确保玩家在线(针对 check/reset 命令)
  4. 尝试使用完整命令:/playtimereward 而不是 /ptr

问题:数据未保存

解决方案:

  1. 检查服务器上的文件权限
  2. 查看控制台中是否有错误
  3. 手动触发保存:运行 /ptr save
  4. 验证插件文件夹是否存在且可写

问题:奖励发放频率过高或过低

解决方案:

  1. 检查 config.yml 中的 reward.interval(值为秒数)
  2. 更改后运行 /ptr reload
  3. 示例:300 = 5 分钟,600 = 10 分钟,3600 = 1 小时

获取帮助

如果你需要额外支持:

  1. 检查控制台日志中的错误信息
  2. 验证你的配置是否为有效的 YAML 语法
  3. 加入我们的 Discord 服务器:

? 性能表现

资源占用

  • 内存: 极低(典型服务器下 <5MB)
  • CPU: 非常轻量(每秒仅执行一个异步任务)
  • 磁盘: 小型数据文件(YAML 格式)
  • 网络: 无网络操作

优化建议

  1. 根据在线玩家数量调整 auto-save-interval
  2. 设置合适的 max-stored-rewards 上限
  3. 使用 minimum-online-time 减少不必要的检查
  4. 对于高人口服务器,考虑使用更长的间隔时间

测试性能

  • ✅ 在 100+ 并发玩家下高效运行
  • ✅ 对 TPS 无明显影响
  • ✅ 数据保存速度快(<100ms)
  • ✅ 内存占用极小

? 路线图

未来版本可能包含的功能:

  • 基于总游戏时间的多级奖励体系
  • 里程碑 Discord Webhook 集成
  • MySQL/PostgreSQL 数据库支持
  • PlaceholderAPI 集成
  • 按世界配置奖励
  • 活动/增益效果下的奖励倍率
  • 用于查看统计数据的 GUI
  • 奖励历史记录追踪

? 支持

Bug 报告

如果您发现 bug,请附带以下信息提交报告:

  • 插件版本
  • 服务端软件及版本
  • 复现步骤
  • 控制台错误日志(如有)

功能请求

有新想法?请分享并详细说明:

  • 您希望实现什么功能
  • 该功能如何惠及用户
  • 具体用例示例

Discord 社区

加入我们的 Discord 服务器以获取支持、更新资讯和社区讨论:


? 许可证

本插件可免费用于您的服务器。

条款

  • ✅ 允许在任何服务器上使用该插件
  • ❌ 禁止出于个人目的修改本插件
  • ❌ 禁止重新分发,即使注明出处
  • ❌ 禁止商业转售
  • ❌ 不提供任何保修或保证

?‍? 作者

Yenith


⭐ 感谢您的支持!

感谢您使用 PlaytimeReward!如果您喜欢这款插件:

  • 分享给其他服务器管理员
  • 留下反馈和建议
  • 报告 bug 以帮助改进它
  • 考虑支持未来的开发工作
  • 加入我们的 Discord 社区:

为 Minecraft 社区 ❤️ 打造

最后更新:2025 年 10 月 6 日

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源