TimedOnlineRewards v1.0.0 Release Notes

定时在线奖励插件 v1.0.0 发布说明

发布日期 / Release Date: 2025年8月6日 / August 6, 2025
版本类型 / Version Type: 正式版 / Stable Release
兼容性 / Compatibility: Minecraft 1.16+ | Java 17+ | Bukkit/Spigot/Paper

🎉 首次发布 / Initial Release

我们很高兴地宣布 TimedOnlineRewards 插件的首个正式版本发布！这是一个功能完整、稳定可靠的定时奖励管理系统，专为 Minecraft 服务器管理员设计。

We are excited to announce the first official release of the TimedOnlineRewards plugin! This is a feature-complete, stable and reliable timed reward management system designed specifically for Minecraft server administrators.

✨ 核心功能 / Core Features

🕒 灵活的时间管理系统 / Flexible Time Management System

多种时间模式 / Multiple Time Modes
- 每日奖励 (Daily) - 每天指定时间自动发放
- 每周奖励 (Weekly) - 每周指定星期几发放
- 每月奖励 (Monthly) - 每月指定日期发放
- 特定时间 (Specific) - 指定具体时间戳执行
- 相对时间 (Relative) - 基于相对时间间隔执行
精确时间控制 / Precise Time Control
- 支持时、分、秒级别的精确设置
- 自动计算下次执行时间
- 跨时区兼容性支持

🎁 丰富的奖励类型 / Rich Reward Types

物品奖励 / Item Rewards
- 支持任意 Minecraft 物品
- 自定义物品数量和属性
- 支持附魔物品和自定义NBT数据
经济奖励 / Economy Rewards
- 通过 Vault API 集成经济系统
- 支持主流经济插件 (EssentialsX, CMI等)
- 灵活的金额设置
经验奖励 / Experience Rewards
- 直接给予玩家经验值
- 支持大量经验发放
- 自动处理经验等级计算
命令奖励 / Command Rewards
- 执行自定义服务器命令
- 支持占位符 (%player%)
- 控制台权限执行，无权限限制
- 支持多命令组合执行

🖥️ 直观的GUI管理界面 / Intuitive GUI Management Interface

主管理界面 / Main Management Interface
- 一目了然的奖励计划概览
- 实时显示计划状态和下次执行时间
- 快速启用/禁用奖励计划
- 一键创建、编辑、删除功能
创建奖励计划向导 / Reward Plan Creation Wizard
- 分步骤引导创建流程
- 直观的时间设置界面
- 可视化奖励内容配置
- 实时预览和验证
高级编辑功能 / Advanced Editing Features
- 完整的奖励计划编辑器
- 支持复制和修改现有计划
- 批量操作支持
- 撤销/重做功能

👥 智能离线奖励处理 / Intelligent Offline Reward Processing

三种处理模式 / Three Processing Modes
- 保留模式 (Keep): 离线奖励保存，玩家上线后手动领取
- 延迟模式 (Delay): 玩家上线时自动发放所有离线奖励
- 跳过模式 (Skip): 直接跳过离线玩家，不保存奖励
完整的离线奖励管理 / Complete Offline Reward Management
- 持久化数据存储，跨服务器重启保持
- 详细的离线奖励记录和统计
- 灵活的领取方式 (单个/批量)
- 自动清理过期记录

⚙️ 强大的配置系统 / Powerful Configuration System

分层配置架构 / Layered Configuration Architecture
- 主配置文件 (config.yml) - 全局设置
- 奖励配置文件 (rewards.yml) - 奖励计划数据
- 自动配置验证和错误提示
热重载支持 / Hot Reload Support
- 无需重启服务器即可重载配置
- 实时应用配置更改
- 配置冲突检测和解决
自动备份机制 / Automatic Backup Mechanism
- 定时自动备份重要数据
- 可配置备份间隔和保留数量
- 一键恢复备份功能

🔐 完善的权限系统 / Comprehensive Permission System

细粒度权限控制 / Fine-grained Permission Control

timedrewards.admin     - 管理员权限 (包含所有权限)
timedrewards.create    - 创建奖励计划
timedrewards.edit      - 编辑奖励计划
timedrewards.delete    - 删除奖励计划
timedrewards.list      - 查看奖励计划列表
timedrewards.offline   - 管理离线奖励

权限继承机制 / Permission Inheritance
- 管理员权限自动包含所有子权限
- 支持权限组和用户级别设置
- 与主流权限插件完美兼容

🚀 技术特性 / Technical Features

高性能架构 / High-Performance Architecture

异步处理机制 / Asynchronous Processing
- 所有耗时操作异步执行
- 不阻塞服务器主线程
- 优化的内存使用和垃圾回收
智能调度系统 / Intelligent Scheduling System
- 高精度时间计算
- 自动处理时区转换
- 服务器重启后自动恢复调度

数据安全保障 / Data Security Assurance

多重数据保护 / Multiple Data Protection
- 原子性文件操作
- 数据完整性验证
- 自动错误恢复机制
兼容性保证 / Compatibility Guarantee
- 支持 Minecraft 1.16 到最新版本
- 兼容 Bukkit、Spigot、Paper 服务器
- 向后兼容性承诺

📋 完整命令列表 / Complete Command List

主要命令 / Main Commands

/tr                    - 打开主GUI界面
/tr help               - 显示帮助信息
/tr list               - 列出所有奖励计划
/tr toggle <计划ID>    - 启用/禁用奖励计划
/tr reload             - 重新加载配置文件

离线奖励命令 / Offline Reward Commands

/tr offline            - 查看离线奖励概览
/tr offline list       - 查看详细离线奖励列表
/tr offline claim      - 领取下一个离线奖励
/tr offline claim all  - 领取所有离线奖励
/tr offline clear      - 清空离线奖励记录 (管理员)

🛠️ 安装和配置 / Installation and Configuration

快速安装 / Quick Installation

下载 TimedOnlineRewards-1.0.0.jar 文件
将文件放入服务器的 plugins 文件夹
重启服务器
插件将自动生成默认配置文件
使用 /tr 命令开始配置奖励计划

依赖插件 / Dependencies

必需 / Required: 无 / None
可选 / Optional:
- Vault (用于经济奖励功能)
- 任意经济插件 (EssentialsX, CMI, 等)

🔧 开发者信息 / Developer Information

构建信息 / Build Information

Java版本 / Java Version: 17
Maven版本 / Maven Version: 3.8+
构建时间 / Build Time: 2025-08-06 13:00:00 UTC+8
Git提交 / Git Commit: a1b2c3d4

API支持 / API Support

插件提供完整的开发者API，支持第三方插件集成：

// 获取插件实例
TimedOnlineRewards plugin = TimedOnlineRewards.getInstance();

// 创建奖励计划
RewardPlan plan = new RewardPlan("daily_reward", "每日奖励");
plugin.getRewardManager().addRewardPlan(plan);

// 手动发放奖励
plugin.getRewardManager().giveReward(player, plan);

🐛 已知问题和限制 / Known Issues and Limitations

已知问题 / Known Issues

无重大已知问题 / No major known issues

使用限制 / Limitations

ActionBar消息功能需要 Spigot/Paper 服务器支持
经济奖励功能需要安装 Vault 和经济插件
命令奖励的执行结果不会返回给插件

兼容性说明 / Compatibility Notes

不支持 Minecraft 1.15 及以下版本
纯 Bukkit 服务器可能无法使用部分高级功能
某些过时的权限插件可能存在兼容性问题

🎯 快速开始指南 / Quick Start Guide

5分钟快速配置 / 5-Minute Quick Setup

安装插件 / Install Plugin

# 下载并放入plugins文件夹，重启服务器
# Download and place in plugins folder, restart server

创建第一个奖励计划 / Create First Reward Plan

1. 使用 /tr 打开GUI界面
2. 点击"创建奖励计划"
3. 设置计划名称: "每日签到奖励"
4. 设置时间: 每日 12:00:00
5. 添加奖励: 钻石 x5, 金币 x100
6. 点击"创建计划"

验证配置 / Verify Configuration

使用 /tr list 查看创建的奖励计划
检查下次执行时间是否正确

测试功能 / Test Functionality

等待执行时间到达，或使用管理命令手动触发
检查奖励是否正确发放给在线玩家

常用配置模板 / Common Configuration Templates

每日签到奖励 / Daily Check-in Reward

plans:
  daily_checkin:
    name: "每日签到奖励"
    enabled: true
    timeSettings:
      type: "daily"
      hour: 12
      minute: 0
      second: 0
    rewards:
      items:
        - type: DIAMOND
          amount: 5
      economy: 100.0
      experience: 50
    customMessage: "感谢 %player% 的每日签到！"

周末特殊奖励 / Weekend Special Reward

plans:
  weekend_special:
    name: "周末大礼包"
    enabled: true
    timeSettings:
      type: "weekly"
      dayOfWeek: 6  # 星期六
      hour: 20
      minute: 0
      second: 0
    rewards:
      items:
        - type: ENCHANTED_BOOK
          amount: 1
      economy: 500.0
      commands:
        - "effect give %player% minecraft:luck 3600 1"
    customMessage: "周末愉快！%player% 获得了特殊奖励！"

TimedOnlineRewards