ВЕРСИИ (1)

# 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 1. 下载 `TimedOnlineRewards-1.0.0.jar` 文件 2. 将文件放入服务器的 `plugins` 文件夹 3. 重启服务器 4. 插件将自动生成默认配置文件 5. 使用 `/tr` 命令开始配置奖励计划 ### 推荐配置 / Recommended Configuration ```yaml # config.yml 推荐设置 prefix: "&6[定时奖励] " debug-mode: false rewards: offline-handling: "keep" # 推荐使用保留模式 storage: auto-backup: true backup-interval: 24 # 24小时自动备份一次 ``` ### 依赖插件 / 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，支持第三方插件集成： ```java // 获取插件实例 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 1. **安装插件 / Install Plugin** ```bash # 下载并放入plugins文件夹，重启服务器 # Download and place in plugins folder, restart server ``` 2. **创建第一个奖励计划 / Create First Reward Plan** ``` 1. 使用 /tr 打开GUI界面 2. 点击"创建奖励计划" 3. 设置计划名称: "每日签到奖励" 4. 设置时间: 每日 12:00:00 5. 添加奖励: 钻石 x5, 金币 x100 6. 点击"创建计划" ``` 3. **验证配置 / Verify Configuration** ``` 使用 /tr list 查看创建的奖励计划 检查下次执行时间是否正确 ``` 4. **测试功能 / Test Functionality** ``` 等待执行时间到达，或使用管理命令手动触发 检查奖励是否正确发放给在线玩家 ``` ### 常用配置模板 / Common Configuration Templates #### 每日签到奖励 / Daily Check-in Reward ```yaml 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 ```yaml 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% 获得了特殊奖励！" ```