TimedOnlineRewards

# TimedOnlineRewards - 定时在线奖励插件 / Timed Online Rewards Plugin

[!(https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [!(https://img.shields.io/badge/minecraft-1. 16%2B-green.svg)](https://minecraft.net) [!(https://img.shields.io/badge/java-17%2B-orange.svg)](https://openjdk.java.net)

一个功能强大的Minecraft Bukkit/Spigot插件，为服务器提供灵活的定时奖励系统。支持多种时间模式、丰富的奖励类型和完善的离线奖励处理机制。

A powerful Minecraft Bukkit/Spigot plugin that provides a flexible timed reward system for servers. Supports multiple time modes, rich reward types, and comprehensive offline reward handling mechanisms.

## ✨ 主要特性 / Main Features

• 🕒 多种时间模式 / Multiple Time Modes - 支持每日、每周、每月、特定时间和相对时间 / Supports daily, weekly, monthly, specific time and relative time
• 🎁 丰富奖励类型 / Rich Reward Types - 物品、金币、经验、自定义命令 / Items, coins, experience, custom commands
• 👥 离线奖励处理 / Offline Reward Handling - 保留、延迟发放或跳过离线玩家奖励 / Keep, delay or skip offline player rewards
• 🖥️ 图形化管理界面 / Graphical Management Interface - 直观的GUI管理系统 / Intuitive GUI management system
• ⚙️ 灵活配置 / Flexible Configuration - 完全可自定义的配置文件 / Fully customizable configuration files
• 🔧 权限系统 / Permission System - 细粒度的权限控制 / Fine-grained permission control
• 💾 数据备份 / Data Backup - 自动备份重要数据 / Automatic backup of important data

## 📸 界面预览 / Interface Preview

### 主管理界面 / Main Management Interface  ) 主管理界面 - 查看和管理所有奖励计划 / Main management interface - View and manage all reward plans

### 创建奖励计划 / Create Reward Plan  ) 创建新的奖励计划 / Create new reward plans

### 时间设置界面 / Time Setting Interface  ) 灵活的时间配置选项 / Flexible time configuration options

### 奖励内容设置 / Reward Content Setting  ) 丰富的奖励类型配置 / Rich reward type configuration

## 🚀 快速开始 / Quick Start

### 系统要求 / System Requirements

• Minecraft 1. 16+
• Java 17+
• Bukkit/Spigot/Paper 服务器 / server
• Vault插件（可选，用于经济系统支持）/ Vault plugin (optional, for economy system support)

### 安装步骤 / Installation Steps

1. 下载最新版本的插件jar文件 / Download the latest plugin jar file 2. 将jar文件放入服务器的 `plugins` 文件夹 / Place the jar file in the server's `plugins` folder 3. 重启服务器 / Restart the server 4. 使用 `/tr` 命令打开管理界面 / Use `/tr` command to open the management interface

### 基本配置 / Basic Configuration

插件首次运行时会自动生成配置文件：/ The plugin will automatically generate configuration files on first run:

```yaml # config.yml - 主配置文件 / Main configuration file prefix: "§6[定时奖励] " debug-mode: false

rewards: offline-handling: "keep" # keep/delay/skip

messages: offline-welcome: "§e欢迎回来！您有 §a%count% §e个离线奖励待领取" offline-hint: "§7使用 §f/tr offline §7查看和领取离线奖励" ```

## 📋 命令列表 / Command List

| 命令 / Command | 描述 / Description | 权限 / Permission | |------|------|------| | `/tr` | 打开主管理界面 / Open main management interface | `timedrewards.admin` | | `/tr list` | 列出所有奖励计划 / List all reward plans | `timedrewards.list` | | `/tr toggle <计划ID>` | 启用/禁用奖励计划 / Enable/disable reward plan | `timedrewards.edit` | | `/tr reload` | 重新加载配置 / Reload configuration | `timedrewards.admin` | | `/tr offline` | 查看离线奖励 / View offline rewards | `timedrewards.offline` | | `/tr offline list` | 查看离线奖励详情 / View offline reward details | `timedrewards.offline` | | `/tr offline claim` | 领取离线奖励 / Claim offline rewards | `timedrewards.offline` | | `/tr help` | 显示帮助信息 / Show help information | - |

## 🔐 权限系统 / Permission System

| 权限节点 / Permission Node | 描述 / Description | 默认 / Default | |----------|------|------| | `timedrewards.admin` | 管理员权限 / Administrator permission | op | | `timedrewards.create` | 创建奖励计划 / Create reward plans | op | | `timedrewards.edit` | 编辑奖励计划 / Edit reward plans | op | | `timedrewards.delete` | 删除奖励计划 / Delete reward plans | op | | `timedrewards.list` | 查看奖励计划列表 / View reward plan list | true | | `timedrewards.offline` | 管理离线奖励 / Manage offline rewards | true |

## ⚙️ 配置说明 / Configuration Guide

### 时间模式配置 / Time Mode Configuration

```yaml timeSettings: type: "daily" # daily/weekly/monthly/specific/relative hour: 12 # 小时 (0-23) / Hour (0-23) minute: 0 # 分钟 (0-59) / Minute (0-59) second: 0 # 秒 (0-59) / Second (0-59) dayOfWeek: 1 # 星期几 (1-7, 仅weekly模式) / Day of week (1-7, weekly mode only) dayOfMonth: 1 # 每月第几天 (1-31, 仅monthly模式) / Day of month (1-31, monthly mode only) ```

### 奖励内容配置 / Reward Content Configuration

```yaml rewards: items: