feat(save): 新增定时自动保存功能。

feat(command): 添加了指令权限判断与重载时的奖励数量反馈

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+
+custom: ['https://donate.carm.cc']

.github/ISSUE_TEMPLATE/bugs_report.md

@@ -0,0 +1,32 @@
+---
+name: 问题提交
+about: 提交并描述问题，帮助我们对其进行检查与修复。
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**问题简述**
+<!--用简短的话语描述一下大概问题。-->
+
+**问题来源**
+<!--
+描述一下通过哪些操作才发现的问题，如：
+1. 打开 '...'
+2. 点击了 '....'
+3. 出现了报错 '....'
+-->
+
+**预期结果**(可选)
+<!--如果问题不发生，应该是什么情况-->
+
+**问题截图/问题报错**
+<!--如果有报错或输出，请提供截图。-->
+
+**操作环境**
+<!--请在后台输入 `version` 并复制相关输出。-->
+
+
+**其他补充**
+<!--如有其他补充，可以在这里描述。-->

.github/ISSUE_TEMPLATE/feature_issues.md

@@ -0,0 +1,20 @@
+---
+name: 功能需求
+about: 希望我们提供更多的功能。
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**功能简述**
+<!--简单的描述一下你想要的功能-->
+
+**需求来源**
+<!--简单的描述一下为什么需要这个功能。-->
+
+**功能参考**(可选)
+<!--如果有相关功能的参考，如文本、截图，请提供给我们。-->
+
+**附加内容**
+<!--如果有什么小细节需要重点注意，请在这里告诉我们。-->

.github/workflows/maven.yml

@@ -14,9 +14,9 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: "Set up JDK"
-        uses: actions/setup-java@v2
+        uses: actions/setup-java@v4
         with:
           java-version: '8'
           distribution: 'adopt'
@@ -35,10 +35,10 @@ jobs:
         run: |
           mkdir artifacts
           cp -vrf target/ artifacts/target/
-          cp -vrf asset/*.jar artifacts
+          cp -vrf .asset/*.jar artifacts
 
       - name: "Upload artifact"
-        uses: actions/upload-artifact@v2
+        uses: actions/upload-artifact@v4
         with:
           name: Artifact
           path: artifacts

.github/workflows/release.yml

@@ -12,10 +12,10 @@ jobs:
 
     steps:
       - name: "Checkout"
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: "Set up JDK"
-        uses: actions/setup-java@v2
+        uses: actions/setup-java@v4
         with:
           java-version: '8'
           distribution: 'adopt'
@@ -37,5 +37,5 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           upload_url: ${{ github.event.release.upload_url }}
-          asset_path: asset/*.jar
+          asset_path: ".asset/*.jar"
           asset_content_type: application/java-archive

README.md

@@ -1,33 +1,53 @@
 ```text
   _______                ____                              __
-|_   _(_)              | ___ \                         | |
+ /_  __(_)___ ___  ___  / __ \___ _      ______ __________/ /
-  | |  _ _ __ ___   ___| |_/ /_____      ____ _ _ __ __| |
+  / / / / __ `__ \/ _ \/ /_/ / _ \ | /| / / __ `/ ___/ __  / 
-  | | | | '_ ` _ \ / _ \    // _ \ \ /\ / / _` | '__/ _` |
+ / / / / / / / / /  __/ _, _/  __/ |/ |/ / /_/ / /  / /_/ /  
-  | | | | | | | | |  __/ |\ \  __/\ V  V / (_| | | | (_| |
+/_/ /_/_/ /_/ /_/\___/_/ |_|\___/|__/|__/\__,_/_/   \__,_/   
-  \_/ |_|_| |_| |_|\___\_| \_\___| \_/\_/ \__,_|_|  \__,_|
 ```
 
 # TimeReward
 
-[![workflow](https://github.com/CarmJos/TimeReward/actions/workflows/maven.yml/badge.svg?branch=master)](https://github.com/CarmJos/TimeReward/actions/workflows/maven.yml)
+![CodeSize](https://img.shields.io/github/languages/code-size/carm-outsource/TimeReward)
-![Support](https://img.shields.io/badge/Minecraft-Java%201.12--Latest-yellow)
+[![Download](https://img.shields.io/github/downloads/carm-outsource/TimeReward/total)](https://github.com/carm-outsource/TimeReward/releases)
+[![Java CI with Maven](https://github.com/CarmJos/TimeReward/actions/workflows/maven.yml/badge.svg?branch=master)](https://github.com/CarmJos/TimeReward/actions/workflows/maven.yml)
+![Support](https://img.shields.io/badge/Minecraft-Java%201.8--Latest-yellow)
 ![](https://visitor-badge.glitch.me/badge?page_id=TimeReward.readme)
 
-在线时长自动领奖插件，通过指令发放奖励，基于EasyPlugin实现。
+使用数据库存储的在线时长自动领奖插件，通过指令发放奖励，基于EasyPlugin实现。
 
-## 插件依赖
+## 功能
+
+- 基于数据库存储的用户在线时长统计。
+- **高效算法。** 在线时间不受服务器卡顿(如果有)影响。
+- **异步存取。** 数据读取与存储均为异步操作，不影响服务器性能。
+- **接口全面。** 提供插件用户数据访问接口与变量，便于其他插件进行读取判断。
+- **轻量插件。** 适合小型服务器使用，配置简单方便。
+- **规范开发。** 插件架构符合开发规范，适合新手开发者学习。
+
+## [依赖](https://github.com/CarmJos/TimeReward/network/dependencies)
 
 - **[必须]** 插件本体基于 [Spigot-API](https://hub.spigotmc.org/stash/projects/SPIGOT) 、[BukkitAPI](http://bukkit.org/) 实现。
 - **[自带]** 插件功能基于 [EasyPlugin](https://github.com/CarmJos/EasyPlugin) 实现。
 - **[自带]** 数据功能基于 [EasySQL](https://github.com/CarmJos/EasySQL) 实现。
+- **[自带]** 消息格式基于 [MineDown](https://github.com/Phoenix616/MineDown) 实现。
+    - 所有 messages.yml 均支持 MineDown 语法。
+- **[推荐]** 变量部分基于 [PlaceholderAPI](https://www.spigotmc.org/resources/6245/) 实现。
 
-详细依赖列表可见 [Dependencies](https://github.com/CarmJos/timereward/network/dependencies) 。
+详细依赖列表可见 [Dependencies](https://github.com/CarmJos/TimeReward/network/dependencies) 。
 
-## 插件指令
+## [指令](src/main/resources/plugin.yml)
 
-指令主指令为 `/TimeReward`
+以下指令的主指令为 `/TimeReward` 或 `/tr`。
+
+- 必须参数 `<参数>`
 
 ```text
+# claim [奖励ID]
+@ 玩家指令 (TimeReward.claim)
+- 为自己手动领取对应奖励。
+- 若不填写奖励ID，则自动领取全部可领取的奖励。
+
 # reload
 @ 管理指令 (TimeReward.admin)
 - 重载插件配置文件。
@@ -45,48 +65,55 @@
 - 测试执行奖励配置的指令。
 ```
 
-## 插件权限
+## 变量 (PlaceholderAPI)
+
+安装 PlaceholderAPI 后，可以输入 /papi info TimeReward 查看相关变量。
+
+变量如下:
 
 ```text
+# %TimeReward_<单位>_<时间类型>%
+- 得到玩家的在线时长。
+- 单位可选 seconds, minutes, hours, days.
+- 时间类型可选 TOTAL, DAILY, WEEKLY, MONTHLY 。
 
-# TimeReward.admin
-- 建筑魔杖的管理权限。
 
-```
-
-## 插件变量
-
-```text
-# %TimeReward_time%
-- 得到玩家总共的在线时长(秒)。
 
 # %TimeReward_reward_<奖励ID>%
 - 得到某个奖励配置的名称。
 
 # %TimeReward_claimed_<奖励ID>%
-- 得到玩家是否已经领取了某个奖励。
+- 得到玩家是否已经领取过某个奖励。
-- * 也可以代表玩家是否可以领取某个奖励 
+? 若奖励为循环奖励（即每在线X小时即可领取一次)，
-- * 因为一旦可以领取就会自动领取，变为已领取状态
+? 但玩家曾经领取过，该变量仍为 true 。
+? 因此，需使用 %TimeReward_claimable_<奖励ID>% 判断是否可领取。
 
+# %TimeReward_claimable_<奖励ID>%
+- 得到玩家是否可以领取某个奖励 
 ```
 
 ## 配置文件
 
-### 插件配置文件 ([config.yml](src/main/resources/config.yml))
+### 插件配置文件 ([config.yml](src/main/java/cc/carm/plugin/timereward/conf/PluginConfig.java))
-
-详见源文件。
-
-### 消息配置文件 ([messages.yml](src/main/java/cc/carm/plugin/timereward/configuration/PluginMessages.java))
 
 详见代码源文件，将在首次启动时生成配置。
 
+### 消息配置文件 ([messages.yml](src/main/java/cc/carm/plugin/timereward/conf/PluginMessages.java))
+
+支持 [MineDown 语法](https://wiki.phoenix616.dev/library:minedown:syntax)，详见代码源文件，将在首次启动时生成配置。
+
+## 使用统计
+
+[![bStats](https://bstats.org/signatures/bukkit/TimeReward.svg)](https://bstats.org/plugin/bukkit/TimeReward/14505)
+
 ## 支持与捐赠
 
-若您觉得本插件做的不错，您可以捐赠支持我！
+若您觉得本插件做的不错，您可以捐赠支持我，感谢您成为开源项目的支持者！
 
-感谢您成为开源项目的支持者！
+万分感谢 [egg_拿]() 与 [ayoiz](https://github.com/ayoi2) 赞助本项目的开发与维护！
 
-<img height=25% width=25% src="https://raw.githubusercontent.com/CarmJos/CarmJos/main/img/donate-code.jpg"  alt=""/>
+Many thanks to Jetbrains for kindly providing a license for me to work on this and other open-source projects.  
+[![](https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg)](https://www.jetbrains.com/?from=https://github.com/CarmJos/UserPrefix)
 
 ## 开源协议
 本项目源码采用 [GNU General Public License v3.0](https://opensource.org/licenses/GPL-3.0) 开源协议。

pom.xml

@@ -5,20 +5,23 @@
     <modelVersion>4.0.0</modelVersion>
 
     <properties>
-        <java.version>8</java.version>
+        <project.jdk.version>8</project.jdk.version>
-        <maven.compiler.source>${java.version}</maven.compiler.source>
+        <maven.compiler.source>${project.jdk.version}</maven.compiler.source>
-        <maven.compiler.target>${java.version}</maven.compiler.target>
+        <maven.compiler.target>${project.jdk.version}</maven.compiler.target>
-        <easyplugin.version>1.3.9</easyplugin.version>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-        <easysql.version>0.3.8</easysql.version>
+        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
+
+        <deps.easyplugin.version>1.5.12</deps.easyplugin.version>
+        <deps.easysql.version>0.4.7</deps.easysql.version>
+        <deps.mineconfig.version>3.1.1</deps.mineconfig.version>
     </properties>
 
     <groupId>cc.carm.plugin</groupId>
     <artifactId>timereward</artifactId>
-    <version>1.3.0</version>
+    <version>3.1.4</version>
-    <packaging>jar</packaging>
 
     <name>TimeReward</name>
-    <description>区域保护插件，将不符合条件的玩家弹出区域，基于EasyPlugin实现。</description>
+    <description>在线时长自动领奖插件，通过指令发放奖励，基于EasyPlugin实现。</description>
     <url>https://github.com/CarmJos/TimeReward</url>
 
     <issueManagement>
@@ -31,10 +34,6 @@
         <url>https://github.com/CarmJos/TimeReward/actions/workflows/maven.yml</url>
     </ciManagement>
 
-    <distributionManagement>
-        <downloadUrl>https://github.com/CarmJos/TimeReward/releases</downloadUrl>
-    </distributionManagement>
-
     <developers>
         <developer>
             <id>CarmJos</id>
@@ -45,15 +44,20 @@
     </developers>
 
     <repositories>
+        <repository>
+            <id>carm-repo</id>
+            <name>Carm's Repo</name>
+            <url>https://repo.carm.cc/repository/maven-public/</url>
+        </repository>
 
         <repository>
             <id>github</id>
             <name>GitHub Packages</name>
-            <url>https://maven.pkg.github.com/CarmJos/*</url>
+            <url>https://maven.pkg.github.com/CarmJos/${project.name}</url>
         </repository>
 
         <repository>
-            <id>central</id>
+            <id>maven-central</id>
             <url>https://repo1.maven.org/maven2/</url>
         </repository>
 
@@ -61,21 +65,22 @@
             <id>nexus</id>
             <url>https://mvn.lumine.io/repository/maven-public/</url>
         </repository>
-
-        <repository>
-            <id>carm-repo</id>
-            <name>Carm's Repo</name>
-            <url>https://repo.carm.cc/repository/maven-public/</url>
-        </repository>
-
     </repositories>
 
-    <dependencies>
+    <distributionManagement>
+        <downloadUrl>https://github.com/CarmJos/TimeReward/releases</downloadUrl>
+        <repository>
+            <id>github</id>
+            <name>GitHub Packages</name>
+            <url>https://maven.pkg.github.com/CarmJos/${project.name}</url>
+        </repository>
+    </distributionManagement>
 
+    <dependencies>
         <dependency>
             <groupId>cc.carm.lib</groupId>
-            <artifactId>easysql-beecp</artifactId>
+            <artifactId>mineconfiguration-bukkit</artifactId>
-            <version>${easysql.version}</version>
+            <version>${deps.mineconfig.version}</version>
             <scope>compile</scope>
             <optional>true</optional>
         </dependency>
@@ -83,23 +88,56 @@
         <dependency>
             <groupId>cc.carm.lib</groupId>
             <artifactId>easyplugin-main</artifactId>
-            <version>${easyplugin.version}</version>
+            <version>${deps.easyplugin.version}</version>
             <scope>compile</scope>
             <optional>true</optional>
         </dependency>
 
         <dependency>
             <groupId>cc.carm.lib</groupId>
-            <artifactId>easyplugin-configuration</artifactId>
+            <artifactId>easyplugin-user</artifactId>
-            <version>${easyplugin.version}</version>
+            <version>${deps.easyplugin.version}</version>
             <scope>compile</scope>
             <optional>true</optional>
         </dependency>
 
         <dependency>
             <groupId>cc.carm.lib</groupId>
-            <artifactId>githubreleases4j</artifactId>
+            <artifactId>easyplugin-command</artifactId>
-            <version>1.3.1</version>
+            <version>${deps.easyplugin.version}</version>
+            <scope>compile</scope>
+            <optional>true</optional>
+        </dependency>
+
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>easyplugin-placeholderapi</artifactId>
+            <version>${deps.easyplugin.version}</version>
+            <scope>compile</scope>
+            <optional>true</optional>
+        </dependency>
+
+        <!--suppress VulnerableLibrariesLocal -->
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>easyplugin-githubchecker</artifactId>
+            <version>${deps.easyplugin.version}</version>
+            <scope>compile</scope>
+            <optional>true</optional>
+        </dependency>
+
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>easysql-beecp</artifactId>
+            <version>${deps.easysql.version}</version>
+            <scope>compile</scope>
+            <optional>true</optional>
+        </dependency>
+
+        <dependency>
+            <groupId>de.themoep</groupId>
+            <artifactId>minedown</artifactId>
+            <version>1.7.1-SNAPSHOT</version>
             <scope>compile</scope>
             <optional>true</optional>
         </dependency>
@@ -107,12 +145,11 @@
         <dependency>
             <groupId>org.bstats</groupId>
             <artifactId>bstats-bukkit</artifactId>
-            <version>3.0.0</version>
+            <version>3.1.0</version>
             <scope>compile</scope>
             <optional>true</optional>
         </dependency>
 
-
         <dependency>
             <groupId>org.spigotmc</groupId>
             <artifactId>spigot-api</artifactId>
@@ -120,21 +157,13 @@
             <scope>provided</scope>
         </dependency>
 
-        <dependency>
-            <groupId>org.spigotmc</groupId>
-            <artifactId>spigot</artifactId>
-            <version>1.12.2-R0.1-SNAPSHOT</version>
-            <scope>provided</scope>
-        </dependency>
-
         <dependency>
             <groupId>me.clip</groupId>
             <artifactId>placeholderapi</artifactId>
-            <version>2.10.9</version>
+            <version>2.11.6</version>
             <scope>provided</scope>
         </dependency>
 
-
         <dependency>
             <groupId>junit</groupId>
             <artifactId>junit</artifactId>
@@ -145,23 +174,24 @@
         <dependency>
             <groupId>org.jetbrains</groupId>
             <artifactId>annotations</artifactId>
-            <version>23.0.0</version>
+            <version>26.0.2</version>
             <scope>provided</scope>
         </dependency>
-
     </dependencies>
 
 
     <build>
+        <defaultGoal>clean package</defaultGoal>
+
         <plugins>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-clean-plugin</artifactId>
-                <version>2.5</version>
+                <version>3.4.1</version>
                 <configuration>
                     <filesets>
                         <fileset>
-                            <directory>${project.basedir}/asset/</directory>
+                            <directory>${project.basedir}/.asset/</directory>
                             <useDefaultExcludes>true</useDefaultExcludes>
                             <includes>
                                 <include>**/*</include>
@@ -177,34 +207,29 @@
                     </filesets>
                 </configuration>
             </plugin>
-            <plugin>
+
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-surefire-plugin</artifactId>
-                <version>2.22.1</version>
-                <configuration>
-                    <useSystemClassLoader>false</useSystemClassLoader>
-                </configuration>
-            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-compiler-plugin</artifactId>
-                <version>3.8.1</version>
+                <version>3.14.0</version>
                 <configuration>
-                    <source>${java.version}</source>
+                    <source>${project.jdk.version}</source>
-                    <target>${java.version}</target>
+                    <target>${project.jdk.version}</target>
                     <encoding>UTF-8</encoding>
                     <compilerArgument>-parameters</compilerArgument>
                 </configuration>
             </plugin>
+
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-jar-plugin</artifactId>
-                <version>3.2.0</version>
+                <version>3.4.2</version>
             </plugin>
+
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-source-plugin</artifactId>
-                <version>3.2.0</version>
+                <version>3.3.1</version>
                 <executions>
                     <execution>
                         <phase>package</phase>
@@ -214,30 +239,41 @@
                     </execution>
                 </executions>
             </plugin>
+
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                <version>3.2.3</version>
+                <version>3.6.0</version>
                 <executions>
                     <execution>
                         <phase>package</phase>
                         <goals>
                             <goal>shade</goal>
                         </goals>
-                        <configuration>
-                            <createDependencyReducedPom>false</createDependencyReducedPom>
-                        </configuration>
                     </execution>
                 </executions>
                 <configuration>
                     <finalName>${project.name}-${project.version}</finalName>
-                    <outputDirectory>${project.basedir}/asset</outputDirectory>
+                    <outputDirectory>${project.basedir}/.asset/</outputDirectory>
-                    <minimizeJar>true</minimizeJar>
+                    <createDependencyReducedPom>false</createDependencyReducedPom>
+                    <filters>
+                        <filter>
+                            <artifact>*:*</artifact>
+                            <excludes>
+                                <exclude>META-INF/MANIFEST.MF</exclude>
+                                <exclude>META-INF/*.txt</exclude>
+                            </excludes>
+                        </filter>
+                    </filters>
                     <relocations>
                         <relocation>
                             <pattern>cc.carm.lib</pattern>
                             <shadedPattern>cc.carm.plugin.timereward.lib</shadedPattern>
                         </relocation>
+                        <relocation>
+                            <pattern>de.themoep.minedown</pattern>
+                            <shadedPattern>cc.carm.plugin.moeteleport.lib.minedown</shadedPattern>
+                        </relocation>
                         <relocation>
                             <pattern>org.bstats</pattern>
                             <shadedPattern>cc.carm.plugin.timereward.lib.bstats</shadedPattern>
@@ -247,18 +283,19 @@
                             <shadedPattern>cc.carm.plugin.timereward.lib.json</shadedPattern>
                         </relocation>
                     </relocations>
-                    <filters>
+                </configuration>
-                        <filter>
+            </plugin>
-                            <artifact>*:*</artifact>
+
-                            <excludes>
+            <plugin>
-                                <exclude>META-INF/MANIFEST.MF</exclude>
+                <groupId>org.apache.maven.plugins</groupId>
-                                <exclude>META-INF/*.txt</exclude>
+                <artifactId>maven-surefire-plugin</artifactId>
-                            </excludes>
+                <version>3.5.3</version>
-                        </filter>
+                <configuration>
-                    </filters>
+                    <useSystemClassLoader>false</useSystemClassLoader>
                 </configuration>
             </plugin>
         </plugins>
+
         <resources>
             <resource>
                 <directory>src/main/resources</directory>

renovate.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended"
+  ]
+}

src/main/java/cc/carm/plugin/timereward/Main.java

@@ -1,125 +1,146 @@
 package cc.carm.plugin.timereward;
 
+import cc.carm.lib.configuration.source.ConfigurationHolder;
 import cc.carm.lib.easyplugin.EasyPlugin;
-import cc.carm.lib.easyplugin.i18n.EasyPluginMessageProvider;
+import cc.carm.lib.easyplugin.updatechecker.GHUpdateChecker;
 import cc.carm.lib.easyplugin.utils.MessageUtils;
-import cc.carm.plugin.timereward.command.TimeRewardCommand;
+import cc.carm.lib.mineconfiguration.bukkit.source.BukkitConfigFactory;
-import cc.carm.plugin.timereward.configuration.PluginConfig;
+import cc.carm.plugin.timereward.command.MainCommand;
-import cc.carm.plugin.timereward.database.DataManager;
+import cc.carm.plugin.timereward.conf.PluginConfig;
-import cc.carm.plugin.timereward.hooker.GHUpdateChecker;
+import cc.carm.plugin.timereward.conf.PluginMessages;
+import cc.carm.plugin.timereward.conf.RewardsConfig;
 import cc.carm.plugin.timereward.hooker.PAPIExpansion;
 import cc.carm.plugin.timereward.listener.UserListener;
-import cc.carm.plugin.timereward.manager.ConfigManager;
 import cc.carm.plugin.timereward.manager.RewardManager;
 import cc.carm.plugin.timereward.manager.UserManager;
-import cc.carm.plugin.timereward.util.JarResourceUtils;
+import cc.carm.plugin.timereward.storage.database.MySQLStorage;
 import org.bstats.bukkit.Metrics;
 import org.bukkit.Bukkit;
+import org.bukkit.entity.Entity;
+import org.bukkit.scheduler.BukkitRunnable;
+
+import java.io.File;
 
 public class Main extends EasyPlugin {
     private static Main instance;
 
-    public Main() {
+    protected ConfigurationHolder<?> configProvider;
-        super(new EasyPluginMessageProvider.zh_CN());
+    protected ConfigurationHolder<?> messageProvider;
-        instance = this;
+    protected ConfigurationHolder<?> rewardProvider;
-    }
 
-    private GHUpdateChecker checker;
+    protected MySQLStorage storage;
-
-    protected DataManager dataManager;
-    protected ConfigManager configManager;
     protected UserManager userManager;
     protected RewardManager rewardManager;
 
-    @Override
+    protected BukkitRunnable autoSaveTask;
-    public boolean initialize() {
+
-        log("加载插件配置文件...");
+    public Main() {
-        this.configManager = new ConfigManager();
+        instance = this;
-        if (!this.configManager.initConfig()) {
-            error("插件配置文件初始化失败，请检查文件权限。");
-            return false;
     }
 
-        info("初始化数据管理器...");
+    @Override
-        this.dataManager = new DataManager();
+    protected void load() {
-        if (!dataManager.initialize()) {
+        log("加载插件配置文件...");
-            severe("初始化数据库失败，请检查配置文件。");
+        this.configProvider = BukkitConfigFactory.from(new File(getDataFolder(), "config.yml")).build();
-            dataManager.shutdown();
+        this.configProvider.initialize(PluginConfig.class);
+
+        this.messageProvider = BukkitConfigFactory.from(new File(getDataFolder(), "messages.yml")).build();
+        this.messageProvider.initialize(PluginMessages.class);
+
+        this.rewardProvider = BukkitConfigFactory.from(new File(getDataFolder(), "rewards.yml")).build();
+        this.rewardProvider.initialize(RewardsConfig.class);
+    }
+
+    @Override
+    protected boolean initialize() {
+        log("初始化数据管理器...");
+        this.storage = new MySQLStorage();
+        try {
+            storage.initialize();
+        } catch (Exception e) {
+            severe("初始化存储失败，请检查配置文件。");
+            setEnabled(false);
             return false; // 初始化失败，不再继续加载
         }
 
         log("加载用户管理器...");
-        this.userManager = new UserManager();
+        this.userManager = new UserManager(this);
-        if (Bukkit.getOnlinePlayers().size() > 0) {
+        if (!Bukkit.getOnlinePlayers().isEmpty()) {
-            log("   加载当前在线用户数据...");
+            log("加载现有用户数据...");
-            this.userManager.loadAll();
+            this.userManager.loadOnline(Entity::getUniqueId);
         }
 
         log("加载奖励管理器...");
-        this.rewardManager = new RewardManager();
+        this.rewardManager = new RewardManager(this);
-        log("   加载了 " + this.rewardManager.listRewards().size() + " 个奖励配置");
+        log("成功加载了 " + this.rewardManager.listRewards().size() + " 个奖励配置。");
-        this.rewardManager.initialize();
 
         log("注册监听器...");
-        regListener(new UserListener());
+        registerListener(new UserListener());
 
         log("注册指令...");
-        registerCommand("TimeReward", new TimeRewardCommand());
+        registerCommand("TimeReward", new MainCommand(this));
-
 
         if (MessageUtils.hasPlaceholderAPI()) {
             log("注册变量...");
-            new PAPIExpansion(this).register();
+            new PAPIExpansion(this, "TimeReward").register();
         } else {
-            log("检测到未安装PlaceholderAPI，跳过变量注册。");
+            log("未安装PlaceholderAPI，跳过变量注册...");
         }
 
-        if (PluginConfig.METRICS.get()) {
+        if (PluginConfig.METRICS.getNotNull()) {
             info("启用统计数据...");
-            Metrics metrics = new Metrics(this, 14505);
+            new Metrics(this, 14505);
         }
 
-        if (PluginConfig.CHECK_UPDATE.get()) {
+        if (PluginConfig.CHECK_UPDATE.getNotNull()) {
             info("开始检查更新...");
-            this.checker = new GHUpdateChecker("CarmJos", "TimeReward");
+            getScheduler().runAsync(GHUpdateChecker.runner(this));
-            getScheduler().runAsync(() -> this.checker.checkUpdate(Main.this.getDescription().getVersion()));
         } else {
             info("已禁用检查更新，跳过。");
         }
 
+        if (PluginConfig.AUTO_SAVE.resolve() > 0) {
+            long period = PluginConfig.AUTO_SAVE.resolve() * 20L;
+            this.autoSaveTask = new BukkitRunnable() {
+                int i = 0;
+
+                @Override
+                public void run() {
+                    i = i == Integer.MAX_VALUE ? 0 : i + 1;
+                    debugging("第" + i + "次自动保存用户在线数据...");
+                    userManager.saveAll();
+                }
+            };
+            this.autoSaveTask.runTaskTimerAsynchronously(this, period, period);
+        }
+
         return true;
     }
 
     @Override
     protected void shutdown() {
 
-        info("终止发奖励进程...");
+        if (this.autoSaveTask != null && !this.autoSaveTask.isCancelled()) {
-        this.rewardManager.shutdown();
+            this.autoSaveTask.cancel();
+            this.autoSaveTask = null;
+        }
 
-        info("卸载监听器...");
+        info("终止奖励发放进程...");
-        Bukkit.getServicesManager().unregisterAll(this);
+        this.rewardManager.shutdown();
 
         info("保存用户数据...");
         this.userManager.unloadAll(true);
 
-        info("结束数据库进程...");
+        info("终止数据库进程...");
-        getDataManager().shutdown();
+        getStorage().shutdown();
 
+        info("卸载监听器...");
+        Bukkit.getServicesManager().unregisterAll(this);
     }
 
     @Override
     public boolean isDebugging() {
-        return PluginConfig.DEBUG.get();
+        return PluginConfig.DEBUG.getNotNull();
-    }
-
-    @Override
-    public void outputInfo() {
-        String[] pluginInfo = JarResourceUtils.readResource(this.getResource("PLUGIN_INFO"));
-        if (pluginInfo != null) Main.info(pluginInfo);
-    }
-
-    public static Main getInstance() {
-        return instance;
     }
 
     public static void info(String... messages) {
@@ -134,8 +155,23 @@ public class Main extends EasyPlugin {
         getInstance().debug(messages);
     }
 
-    public static DataManager getDataManager() {
+    public static Main getInstance() {
-        return getInstance().dataManager;
+        return instance;
     }
 
+    public static MySQLStorage getStorage() {
+        return getInstance().storage;
+    }
+
+    public ConfigurationHolder<?> getConfigProvider() {
+        return configProvider;
+    }
+
+    public ConfigurationHolder<?> getMessageProvider() {
+        return messageProvider;
+    }
+
+    public ConfigurationHolder<?> getRewardProvider() {
+        return rewardProvider;
+    }
 }

src/main/java/cc/carm/plugin/timereward/TimeRewardAPI.java

@@ -2,7 +2,6 @@ package cc.carm.plugin.timereward;
 
 import cc.carm.lib.easyplugin.utils.ColorParser;
 import cc.carm.lib.easyplugin.utils.MessageUtils;
-import cc.carm.plugin.timereward.manager.ConfigManager;
 import cc.carm.plugin.timereward.manager.RewardManager;
 import cc.carm.plugin.timereward.manager.UserManager;
 import org.bukkit.Bukkit;
@@ -12,12 +11,11 @@ import java.util.List;
 
 public class TimeRewardAPI {
 
-    public static UserManager getUserManager() {
+    private TimeRewardAPI() {
-        return Main.getInstance().userManager;
     }
 
-    public static ConfigManager getConfigManager() {
+    public static UserManager getUserManager() {
-        return Main.getInstance().configManager;
+        return Main.getInstance().userManager;
     }
 
     public static RewardManager getRewardManager() {
@@ -39,5 +37,4 @@ public class TimeRewardAPI {
         return MessageUtils.setPlaceholders(player, ColorParser.parse(command));
     }
 
-
 }

src/main/java/cc/carm/plugin/timereward/command/MainCommand.java

@@ -0,0 +1,37 @@
+package cc.carm.plugin.timereward.command;
+
+import cc.carm.lib.easyplugin.command.CommandHandler;
+import cc.carm.plugin.timereward.command.sub.*;
+import cc.carm.plugin.timereward.conf.PluginMessages;
+import org.bukkit.command.CommandSender;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+
+public class MainCommand extends CommandHandler {
+
+    public MainCommand(@NotNull JavaPlugin plugin) {
+        super(plugin);
+
+        registerSubCommand(new ClaimCommand(this, "claim"));
+        registerSubCommand(new ListCommand(this, "list"));
+        registerSubCommand(new UserCommand(this, "user"));
+        registerSubCommand(new TestCommand(this, "test"));
+        registerSubCommand(new ReloadCommand(this, "reload"));
+    }
+
+    @Override
+    public Void noArgs(CommandSender sender) {
+        if (sender.hasPermission("TimeReward.admin")) {
+            PluginMessages.USAGE.ADMIN.sendTo(sender);
+        } else {
+            PluginMessages.USAGE.USER.sendTo(sender);
+        }
+        return null;
+    }
+
+    @Override
+    public Void noPermission(CommandSender sender) {
+        PluginMessages.NO_PERMISSION.sendTo(sender);
+        return null;
+    }
+}

src/main/java/cc/carm/plugin/timereward/command/TimeRewardCommand.java

@@ -1,134 +0,0 @@
-package cc.carm.plugin.timereward.command;
-
-import cc.carm.plugin.timereward.TimeRewardAPI;
-import cc.carm.plugin.timereward.configuration.PluginMessages;
-import cc.carm.plugin.timereward.data.RewardContents;
-import cc.carm.plugin.timereward.data.TimeRewardUser;
-import org.bukkit.Bukkit;
-import org.bukkit.command.Command;
-import org.bukkit.command.CommandExecutor;
-import org.bukkit.command.CommandSender;
-import org.bukkit.command.TabCompleter;
-import org.bukkit.entity.HumanEntity;
-import org.bukkit.entity.Player;
-import org.bukkit.util.StringUtil;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.ArrayList;
-import java.util.Collection;
-import java.util.List;
-import java.util.stream.Collectors;
-
-public class TimeRewardCommand implements CommandExecutor, TabCompleter {
-
-    private boolean help(CommandSender sender) {
-        PluginMessages.COMMAND_USAGE.send(sender);
-        return true;
-    }
-
-
-    @Override
-    public boolean onCommand(CommandSender sender, Command command, String alias, String[] args) {
-        if (args.length < 1) return help(sender);
-        String aim = args[0];
-
-        if (aim.equalsIgnoreCase("reload")) {
-            sender.sendMessage("§7正在重载配置文件...");
-            try {
-                TimeRewardAPI.getConfigManager().reload();
-                sender.sendMessage("§a配置文件重载完成！");
-            } catch (Exception e) {
-                sender.sendMessage("§c配置文件重载失败，错误信息：" + e.getMessage() + " (详见后台");
-                e.printStackTrace();
-            }
-            return true;
-        } else if (aim.equalsIgnoreCase("list")) {
-            Collection<RewardContents> awards = TimeRewardAPI.getRewardManager().listRewards().values();
-            PluginMessages.List.HEADER.send(sender, awards.size());
-            for (RewardContents reward : awards) {
-                if (reward.getPermission() != null) {
-                    PluginMessages.List.OBJECT_PERM.send(sender,
-                            reward.getRewardID(), reward.getDisplayName(),
-                            reward.getTime(), reward.getPermission()
-                    );
-                } else {
-                    PluginMessages.List.OBJECT.send(sender,
-                            reward.getRewardID(), reward.getDisplayName(), reward.getTime()
-                    );
-                }
-            }
-            return true;
-        } else if (aim.equalsIgnoreCase("test")) {
-            if (args.length < 2) return help(sender);
-            if (!(sender instanceof Player)) {
-                sender.sendMessage("§c您不是玩家，无法使用此命令！");
-                return true;
-            }
-
-            RewardContents contents = TimeRewardAPI.getRewardManager().getReward(args[1]);
-            if (contents == null) {
-                PluginMessages.NOT_EXISTS.send(sender, args[1]);
-                return true;
-            }
-
-            PluginMessages.COMMAND_LIST.send(sender, contents.getRewardID());
-
-            TimeRewardAPI.getRewardManager().executeCommand((Player) sender, contents);
-
-            return true;
-        } else if (aim.equalsIgnoreCase("user")) {
-            if (args.length < 2) return help(sender);
-            Player player = Bukkit.getPlayer(args[1]);
-            if (player == null) {
-                PluginMessages.NOT_ONLINE.send(sender, args[1]);
-                return true;
-            }
-
-            TimeRewardUser user = TimeRewardAPI.getUserManager().get(player);
-            PluginMessages.USER_INFO.send(sender,
-                    player.getName(), user.getAllSeconds(),
-                    user.getClaimedRewards().size(), String.join("&8, &f", user.getClaimedRewards())
-            );
-
-            return true;
-        }
-
-        return help(sender);
-    }
-
-    @Nullable
-    @Override
-    public List<String> onTabComplete(
-            @NotNull CommandSender sender, @NotNull Command command,
-            @NotNull String alias, @NotNull String[] args) {
-        List<String> allCompletes = new ArrayList<>();
-        // 玩家指令部分
-        if (sender.hasPermission("TimeReward.admin")) {
-            switch (args.length) {
-                case 1: {
-                    allCompletes.add("reload");
-                    allCompletes.add("user");
-                    allCompletes.add("list");
-                    if (sender instanceof Player) allCompletes.add("test");
-
-                    break;
-                }
-                case 2: {
-                    String aim = args[0];
-                    if (aim.equalsIgnoreCase("test") && sender instanceof Player) {
-                        allCompletes = new ArrayList<>(TimeRewardAPI.getRewardManager().listRewards().keySet());
-                    } else if (aim.equalsIgnoreCase("user")) {
-                        allCompletes = Bukkit.getOnlinePlayers().stream().map(HumanEntity::getName).collect(Collectors.toList());
-                    }
-                    break;
-                }
-            }
-        }
-
-        return allCompletes.stream()
-                .filter(s -> StringUtil.startsWithIgnoreCase(s, args[args.length - 1]))
-                .limit(10).collect(Collectors.toList());
-    }
-
-}

src/main/java/cc/carm/plugin/timereward/command/sub/ClaimCommand.java

@@ -0,0 +1,68 @@
+package cc.carm.plugin.timereward.command.sub;
+
+import cc.carm.lib.easyplugin.command.SubCommand;
+import cc.carm.plugin.timereward.TimeRewardAPI;
+import cc.carm.plugin.timereward.command.MainCommand;
+import cc.carm.plugin.timereward.conf.PluginMessages;
+import cc.carm.plugin.timereward.data.RewardContents;
+import cc.carm.plugin.timereward.manager.RewardManager;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+public class ClaimCommand extends SubCommand<MainCommand> {
+
+    public ClaimCommand(@NotNull MainCommand parent, String identifier, String... aliases) {
+        super(parent, identifier, aliases);
+    }
+
+    @Override
+    public Void execute(JavaPlugin plugin, CommandSender sender, String[] args) {
+        if (!(sender instanceof Player)) {
+            PluginMessages.NOT_PLAYER.sendTo(sender);
+            return null;
+        }
+
+        Player player = (Player) sender;
+        RewardManager manager = TimeRewardAPI.getRewardManager();
+
+        @Nullable String rewardID = args.length > 0 ? args[0] : null;
+        if (rewardID == null) {
+
+            List<RewardContents> unclaimedRewards = manager.getUnclaimedRewards(player);
+            if (unclaimedRewards.isEmpty()) {
+                PluginMessages.NO_UNCLAIMED_REWARD.sendTo(sender);
+                return null;
+            }
+
+            // 为玩家发放奖励
+            manager.claimRewards(player, unclaimedRewards, false);
+        } else {
+
+            RewardContents reward = manager.getReward(rewardID);
+            if (reward == null) {
+                PluginMessages.NOT_EXISTS.sendTo(sender, rewardID);
+                return null;
+            }
+
+            if (!manager.isClaimable(player, reward)) {
+                PluginMessages.NOT_CLAIMABLE.sendTo(sender, reward.getDisplayName());
+                return null;
+            }
+
+            // 为玩家发放奖励
+            manager.claimReward(player, reward, false);
+        }
+        return null;
+    }
+
+    @Override
+    public boolean hasPermission(@NotNull CommandSender sender) {
+        return sender.hasPermission("TimeReward.claim");
+    }
+    
+}

src/main/java/cc/carm/plugin/timereward/command/sub/ListCommand.java

@@ -0,0 +1,46 @@
+package cc.carm.plugin.timereward.command.sub;
+
+import cc.carm.lib.easyplugin.command.SubCommand;
+import cc.carm.plugin.timereward.TimeRewardAPI;
+import cc.carm.plugin.timereward.command.MainCommand;
+import cc.carm.plugin.timereward.conf.PluginMessages;
+import cc.carm.plugin.timereward.data.RewardContents;
+import org.bukkit.command.CommandSender;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.Collection;
+
+public class ListCommand extends SubCommand<MainCommand> {
+
+    public ListCommand(@NotNull MainCommand parent, String identifier, String... aliases) {
+        super(parent, identifier, aliases);
+    }
+
+    @Override
+    public Void execute(JavaPlugin plugin, CommandSender sender, String[] args) {
+        Collection<RewardContents> awards = TimeRewardAPI.getRewardManager().listRewards().values();
+        PluginMessages.LIST.HEADER.sendTo(sender, awards.size());
+
+        for (RewardContents reward : awards) {
+            if (reward.getPermission() != null) {
+                PluginMessages.LIST.OBJECT_PERM.prepare(
+                        reward.getRewardID(), reward.getDisplayName(), reward.getType().name(),
+                        reward.getTime(), reward.getPermission()
+                ).to(sender);
+            } else {
+                PluginMessages.LIST.OBJECT_PERM.prepare(
+                        reward.getRewardID(), reward.getDisplayName(),
+                        reward.getType().name(), reward.getTime()
+                ).to(sender);
+            }
+        }
+        return null;
+    }
+
+    @Override
+    public boolean hasPermission(@NotNull CommandSender sender) {
+        return sender.hasPermission("TimeReward.admin");
+    }
+
+}

src/main/java/cc/carm/plugin/timereward/command/sub/ReloadCommand.java

@@ -0,0 +1,45 @@
+package cc.carm.plugin.timereward.command.sub;
+
+import cc.carm.lib.easyplugin.command.SubCommand;
+import cc.carm.plugin.timereward.Main;
+import cc.carm.plugin.timereward.TimeRewardAPI;
+import cc.carm.plugin.timereward.command.MainCommand;
+import cc.carm.plugin.timereward.conf.PluginMessages;
+import org.bukkit.command.CommandSender;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+
+public class ReloadCommand extends SubCommand<MainCommand> {
+
+    public ReloadCommand(@NotNull MainCommand parent, String identifier, String... aliases) {
+        super(parent, identifier, aliases);
+    }
+
+    @Override
+    public Void execute(JavaPlugin plugin, CommandSender sender, String[] args) throws Exception {
+
+        long s1 = System.currentTimeMillis();
+        PluginMessages.RELOAD.START.sendTo(sender);
+
+        try {
+            Main.getInstance().getConfigProvider().reload();
+            Main.getInstance().getMessageProvider().reload();
+            Main.getInstance().getRewardProvider().reload();
+
+            PluginMessages.RELOAD.COMPLETE.prepare(
+                    System.currentTimeMillis() - s1,
+                    TimeRewardAPI.getRewardManager().listRewards().size()
+            ).to(sender);
+        } catch (Exception e) {
+            PluginMessages.RELOAD.ERROR.sendTo(sender);
+            e.printStackTrace();
+        }
+        return null;
+    }
+
+    @Override
+    public boolean hasPermission(@NotNull CommandSender sender) {
+        return sender.hasPermission("TimeReward.admin");
+    }
+
+}

src/main/java/cc/carm/plugin/timereward/command/sub/TestCommand.java

@@ -0,0 +1,55 @@
+package cc.carm.plugin.timereward.command.sub;
+
+import cc.carm.lib.easyplugin.command.SimpleCompleter;
+import cc.carm.lib.easyplugin.command.SubCommand;
+import cc.carm.plugin.timereward.TimeRewardAPI;
+import cc.carm.plugin.timereward.command.MainCommand;
+import cc.carm.plugin.timereward.conf.PluginMessages;
+import cc.carm.plugin.timereward.data.RewardContents;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.List;
+
+public class TestCommand extends SubCommand<MainCommand> {
+
+    public TestCommand(@NotNull MainCommand parent, String identifier, String... aliases) {
+        super(parent, identifier, aliases);
+    }
+
+    @Override
+    public Void execute(JavaPlugin plugin, CommandSender sender, String[] args) throws Exception {
+        if (args.length < 1) return getParent().noArgs(sender);
+        if (!(sender instanceof Player)) {
+            PluginMessages.NOT_PLAYER.sendTo(sender);
+            return null;
+        }
+
+        RewardContents contents = TimeRewardAPI.getRewardManager().getReward(args[0]);
+        if (contents == null) {
+            PluginMessages.NOT_EXISTS.sendTo(sender, args[0]);
+            return null;
+        }
+
+        PluginMessages.COMMAND_LIST.sendTo(sender, contents.getRewardID());
+
+        TimeRewardAPI.getRewardManager().executeCommand((Player) sender, contents);
+        return null;
+    }
+
+    @Override
+    public List<String> tabComplete(JavaPlugin plugin, CommandSender sender, String[] args) {
+        if (args.length == 1) {
+            return SimpleCompleter.text(args[args.length - 1], TimeRewardAPI.getRewardManager().listRewards().keySet());
+        } else return null;
+    }
+
+    @Override
+    public boolean hasPermission(@NotNull CommandSender sender) {
+        return sender.hasPermission("TimeReward.admin");
+    }
+
+
+}

src/main/java/cc/carm/plugin/timereward/command/sub/UserCommand.java

@@ -0,0 +1,69 @@
+package cc.carm.plugin.timereward.command.sub;
+
+import cc.carm.lib.easyplugin.command.SimpleCompleter;
+import cc.carm.lib.easyplugin.command.SubCommand;
+import cc.carm.plugin.timereward.TimeRewardAPI;
+import cc.carm.plugin.timereward.command.MainCommand;
+import cc.carm.plugin.timereward.conf.PluginMessages;
+import cc.carm.plugin.timereward.data.IntervalType;
+import cc.carm.plugin.timereward.user.UserRewardData;
+import org.bukkit.Bukkit;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+
+import java.time.format.DateTimeFormatter;
+import java.util.List;
+
+public class UserCommand extends SubCommand<MainCommand> {
+
+    public UserCommand(@NotNull MainCommand parent, String identifier, String... aliases) {
+        super(parent, identifier, aliases);
+    }
+
+    @Override
+    public Void execute(JavaPlugin plugin, CommandSender sender, String[] args) throws Exception {
+        if (args.length < 1) return getParent().noArgs(sender);
+
+        Player player = Bukkit.getPlayer(args[0]);
+        if (player == null) {
+            PluginMessages.NOT_ONLINE.sendTo(sender, args[0]);
+            return null;
+        }
+
+        UserRewardData user = TimeRewardAPI.getUserManager().get(player);
+        if (user == null) {
+            PluginMessages.LOADING.sendTo(sender, args[0]);
+            return null;
+        }
+
+        PluginMessages.USER_INFO.prepare(
+                player.getName(),
+                user.getOnlineDuration(IntervalType.DAILY).getSeconds(),
+                user.getOnlineDuration(IntervalType.WEEKLY).getSeconds(),
+                user.getOnlineDuration(IntervalType.MONTHLY).getSeconds(),
+                user.getOnlineDuration(IntervalType.TOTAL).getSeconds(),
+                user.getClaimedRewards().size()
+        ).to(sender);
+
+        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
+        user.getClaimedRewards().forEach((id, time) -> {
+            PluginMessages.USER_RECEIVED.sendTo(sender, id, time.format(formatter));
+        });
+
+        return null;
+    }
+
+    @Override
+    public List<String> tabComplete(JavaPlugin plugin, CommandSender sender, String[] args) {
+        if (args.length == 1) return SimpleCompleter.onlinePlayers(args[0]);
+        else return null;
+    }
+
+    @Override
+    public boolean hasPermission(@NotNull CommandSender sender) {
+        return sender.hasPermission("TimeReward.admin");
+    }
+
+}

src/main/java/cc/carm/plugin/timereward/conf/PluginConfig.java

@@ -0,0 +1,45 @@
+package cc.carm.plugin.timereward.conf;
+
+import cc.carm.lib.configuration.Configuration;
+import cc.carm.lib.configuration.annotation.ConfigPath;
+import cc.carm.lib.configuration.annotation.HeaderComments;
+import cc.carm.lib.configuration.value.standard.ConfiguredValue;
+
+import java.time.DayOfWeek;
+
+@ConfigPath(root = true)
+public interface PluginConfig extends Configuration {
+
+    ConfiguredValue<Boolean> DEBUG = ConfiguredValue.of(Boolean.class, false);
+
+    @HeaderComments({
+            "统计数据设定",
+            "该选项用于帮助开发者统计插件版本与使用情况，且绝不会影响性能与使用体验。",
+            "当然，您也可以选择在这里关闭，或在plugins/bStats下的配置文件中关闭。"
+    })
+    ConfiguredValue<Boolean> METRICS = ConfiguredValue.of(Boolean.class, true);
+
+    @HeaderComments({
+            "检查更新设定",
+            "该选项用于插件判断是否要检查更新，若您不希望插件检查更新并提示您，可以选择关闭。",
+            "检查更新为异步操作，绝不会影响性能与使用体验。"
+    })
+    ConfiguredValue<Boolean> CHECK_UPDATE = ConfiguredValue.of(Boolean.class, true);
+    
+    @HeaderComments({
+            "自动保存设定，用于设置自动保存的时间间隔，单位为秒（小于等于0则关闭）。",
+            "一般来说，玩家会在退出游戏时进行保存。",
+            "但如果您希望额外的定期保存数据以避免数据丢失，可以选择开启。",
+    })
+    ConfiguredValue<Long> AUTO_SAVE = ConfiguredValue.of(Long.class, 60L);
+
+    @HeaderComments("周起始日，用于判断周度奖励的结算日期。")
+    ConfiguredValue<DayOfWeek> WEEK_FIRST_DAY = ConfiguredValue.builderOf(DayOfWeek.class)
+            .from(Integer.class)
+            .parse((v, d) -> DayOfWeek.of(d))
+            .serialize(DayOfWeek::getValue)
+            .defaults(DayOfWeek.MONDAY).build();
+
+}
+
+

src/main/java/cc/carm/plugin/timereward/conf/PluginMessages.java

@@ -0,0 +1,152 @@
+package cc.carm.plugin.timereward.conf;
+
+
+import cc.carm.lib.configuration.Configuration;
+import cc.carm.lib.configuration.annotation.ConfigPath;
+import cc.carm.lib.configuration.annotation.HeaderComments;
+import cc.carm.lib.easyplugin.utils.ColorParser;
+import cc.carm.lib.mineconfiguration.bukkit.value.ConfiguredMessage;
+import de.themoep.minedown.MineDown;
+import me.clip.placeholderapi.PlaceholderAPI;
+import net.md_5.bungee.api.chat.BaseComponent;
+import org.bukkit.command.CommandSender;
+import org.bukkit.command.ConsoleCommandSender;
+import org.bukkit.entity.Player;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.function.BiFunction;
+
+
+@HeaderComments({
+        "TimeReward 在线奖励插件的消息配置文件",
+        "如特定的消息不需要任何提示，可直接留下单行空内容消息。",
+        "支持 &+颜色代码(原版颜色)、&(#XXXXXX)(RGB颜色) 与 &<#XXXXXX>(前后标注RGB颜色渐变)。",
+        " "
+})
+@ConfigPath(root = true)
+public interface PluginMessages extends Configuration {
+
+    static ConfiguredMessage.@NotNull Builder<BaseComponent[]> list() {
+        return ConfiguredMessage.create(getParser())
+                .dispatcher((sender, message) -> {
+                    if (sender instanceof ConsoleCommandSender) {
+                        message.forEach(m -> sender.sendMessage(BaseComponent.toLegacyText(m)));
+                        return;
+                    }
+                    Player player = (Player) sender;
+                    message.forEach(m -> player.spigot().sendMessage(m));
+                });
+    }
+
+    static @NotNull BiFunction<CommandSender, String, BaseComponent[]> getParser() {
+        return (sender, message) -> {
+            if (sender instanceof Player) message = PlaceholderAPI.setPlaceholders((Player) sender, message);
+            return MineDown.parse(ColorParser.parse(message));
+        };
+    }
+
+    interface USAGE extends Configuration {
+
+        ConfiguredMessage<BaseComponent[]> ADMIN = list().defaults(
+                "&6&l在线奖励 &f管理员指令帮助",
+                "&8#&f claim &6[奖励ID]",
+                "&8-&7 为自己手动领取对应奖励。",
+                "&8-&7 若不填写奖励ID，则自动领取全部可领取的奖励。",
+                "&8#&f reload",
+                "&8-&7 重载插件配置文件。",
+                "&8#&f user &6<玩家>",
+                "&8-&7 查看用户的在线时长信息与奖励领取情况。",
+                "&8#&f list",
+                "&8-&7 列出所有奖励与条件。",
+                "&8#&f test &6<奖励ID>",
+                "&8-&7 测试执行奖励配置的指令。"
+        ).build();
+
+        ConfiguredMessage<BaseComponent[]> USER = list().defaults(
+                "&6&l在线奖励 &f您可以输入 &e/tr claim &6[奖励ID] &f领取对应奖励。"
+        ).build();
+    }
+
+    ConfiguredMessage<BaseComponent[]> NO_PERMISSION = list().defaults(
+            "&c&l抱歉！&f但您没有足够的权限使用该指令。"
+    ).build();
+
+    ConfiguredMessage<BaseComponent[]> NOT_PLAYER = list().defaults(
+            "&f该指令请以玩家身份执行。"
+    ).build();
+
+    ConfiguredMessage<BaseComponent[]> NOT_ONLINE = list().defaults(
+            "&f玩家 &e%(player) &f并不在线。"
+    ).params("player").build();
+
+    ConfiguredMessage<BaseComponent[]> LOADING = list().defaults(
+            "&e&l请稍候... &f您的在线数据正在加载中。"
+    ).params("player").build();
+
+    ConfiguredMessage<BaseComponent[]> NOT_EXISTS = list().defaults(
+            "&f奖励 &e%(award) &f并不存在。"
+    ).params("award").build();
+
+    ConfiguredMessage<BaseComponent[]> NOT_CLAIMABLE = list().defaults(
+            "&c&l抱歉！&f但您暂时未满足领取奖励 &e%(award) &f的条件。"
+    ).params("award").build();
+
+    ConfiguredMessage<BaseComponent[]> NO_UNCLAIMED_REWARD = list().defaults(
+            "&f您暂时没有未领取的奖励。"
+    ).build();
+
+    ConfiguredMessage<BaseComponent[]> USER_INFO = list().defaults(
+            "&f玩家 &6%(player) &f的在线时间数据：",
+            "&f  本日在线 &e%(daily)&f秒，本周在线 &e%(weekly)&f秒，",
+            "&f  本月在线 &e%(monthly)&f秒，累积在线 &e%(total)&f秒。",
+            "&7已领取了 &f%(amount) &7种奖励，如下所示："
+    ).params("player", "daily", "weekly", "monthly", "total", "amount").build();
+
+    ConfiguredMessage<BaseComponent[]> USER_RECEIVED = list().defaults(
+            "&7- &e%(reward) &7于 &f%(time) &7领取"
+    ).params("reward", "time").build();
+
+    ConfiguredMessage<BaseComponent[]> COMMAND_LIST = list().defaults(
+            "&f正在执行奖励 %(award) 的指令列表..."
+    ).params("award").build();
+
+    interface LIST extends Configuration {
+
+        ConfiguredMessage<BaseComponent[]> HEADER = list().defaults(
+                "&6&l在线奖励 &f奖励列表 &7(共%(amount)个)"
+        ).params("amount").build();
+
+        ConfiguredMessage<BaseComponent[]> OBJECT = list().defaults(
+                "&8# &f%(id)",
+                "&8- &7奖励名称 &f%(name)",
+                "&8- &7奖励类型 &f%(type)",
+                "&8- &7领取时间 &f&e%(time)&f秒"
+        ).params("id", "name", "type", "time").build();
+
+        ConfiguredMessage<BaseComponent[]> OBJECT_PERM = list().defaults(
+                "&8# &f%(id)",
+                "&8- &7奖励名称 &f%(name)",
+                "&8- &7奖励类型 &f%(type)",
+                "&8- &7领取时间 &f&e%(time)&f秒",
+                "&8- &7需要权限 &f%(permission)"
+        ).params("id", "name", "type", "time", "permission").build();
+
+    }
+
+    interface RELOAD extends Configuration {
+
+        ConfiguredMessage<BaseComponent[]> START = list().defaults(
+                "&f正在重载配置文件..."
+        ).build();
+
+        ConfiguredMessage<BaseComponent[]> ERROR = list().defaults(
+                "&f配置文件&c重载失败！&f详细原因详见后台输出。"
+        ).build();
+
+        ConfiguredMessage<BaseComponent[]> COMPLETE = list().defaults(
+                "&f配置文件重载完成！耗时 &d%(time)&fms，共加载了 &d%(count) &f个奖励配置。"
+        ).params("time", "count").build();
+
+    }
+
+}

src/main/java/cc/carm/plugin/timereward/conf/RewardsConfig.java

@@ -0,0 +1,91 @@
+package cc.carm.plugin.timereward.conf;
+
+import cc.carm.lib.configuration.Configuration;
+import cc.carm.lib.configuration.annotation.ConfigPath;
+import cc.carm.lib.configuration.annotation.HeaderComments;
+import cc.carm.lib.configuration.source.section.ConfigureSection;
+import cc.carm.lib.configuration.value.standard.ConfiguredValue;
+import cc.carm.plugin.timereward.data.RewardContents;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+@HeaderComments({"奖励相关设定，包含以下设定：",
+        " [id] 配置键名即奖励ID，支持英文、数字与下划线。",
+        "  | 确定后请不要更改，因为该键值用于存储玩家是否领取的数据",
+        "  | 如果更改，原先领取过该奖励的玩家将会自动再领取一次！",
+        " [type] 奖励的类型序号",
+        "  | “0”代表总计时间奖励，“1”代表每日在线奖励，",
+        "  | “2”代表每周在线奖励，“3”代表每月在线奖励。",
+        " [time] 奖励发放要求的时间(秒）",
+        " [loop] 奖励是否按循环时间发放",
+        "  | 可以填入 true 或 false",
+        "  | 若启用，则在规定的周期内，每满足指定时间一次则发放一次奖励",
+        "  | 如 类型为 “每周在线奖励” 时间为 “12小时” ",
+        "  | 则 代表 代表在这周内每12小时发放一次奖励，下一周时间重新开始算",
+        " [name] 奖励的显示名称，可以是任意字符串",
+        "  | 可以在 commands 中使用 %(name) 来获取该奖励的名称",
+        "  | 也可以使用变量 %TimeReward_reward_<奖励ID>% 来获取对应奖励的名称",
+        " [permission] 领取奖励时后台执行的指令",
+        "  | 支持PlaceholderAPI变量，指令中可以使用 %(name) 来获取该奖励的名称。",
+        " [commands] 该奖励领取权限，可以不设置。",
+        "  | 若为空则所有人都可以领取；若不为空，则需要拥有该权限的玩家才能领取。",
+        " [auto] 该奖励是否自动领取，可以不设置，默认为true。",
+        "  | 若关闭自动领取，则需要玩家手动输入/tr claim 领取奖励。",
+})
+@ConfigPath(root = true)
+public interface RewardsConfig extends Configuration {
+
+    ConfiguredValue<RewardGroup> REWARDS = ConfiguredValue.builderOf(RewardGroup.class)
+            .fromSection()
+            .parse((v, d) -> RewardGroup.parse(d))
+            .serialize(RewardGroup::serialize)
+            .defaults(RewardGroup.defaults())
+            .build();
+
+    static Map<String, RewardContents> getContents() {
+        return REWARDS.getNotNull().getContents();
+    }
+
+    final class RewardGroup {
+        final @NotNull Map<String, RewardContents> contents;
+
+        public RewardGroup(@NotNull Map<String, RewardContents> contents) {
+            this.contents = contents;
+        }
+
+        public @NotNull Map<String, RewardContents> getContents() {
+            return contents;
+        }
+
+        public Map<String, Object> serialize() {
+            Map<String, Object> map = new LinkedHashMap<>();
+            for (Map.Entry<String, RewardContents> entry : contents.entrySet()) {
+                map.put(entry.getKey(), entry.getValue().serialize());
+            }
+            return map;
+        }
+
+        public static RewardGroup parse(@NotNull ConfigureSection section) {
+            Map<String, RewardContents> rewards = new LinkedHashMap<>();
+            for (String rewardID : section.getKeys(false)) {
+                ConfigureSection rewardSection = section.getSection(rewardID);
+                if (rewardSection == null) continue;
+
+                RewardContents c = RewardContents.parse(rewardID, rewardSection);
+                if (c == null) continue;
+                rewards.put(rewardID, c);
+            }
+            return new RewardGroup(rewards);
+        }
+
+        public static RewardGroup defaults() {
+            Map<String, RewardContents> rewards = new LinkedHashMap<>();
+            rewards.put("example", RewardContents.defaults("example"));
+            return new RewardGroup(rewards);
+        }
+
+    }
+
+}

src/main/java/cc/carm/plugin/timereward/configuration/PluginConfig.java

@@ -1,30 +0,0 @@
-package cc.carm.plugin.timereward.configuration;
-
-import cc.carm.lib.easyplugin.configuration.cast.ConfigSectionCast;
-import cc.carm.lib.easyplugin.configuration.values.ConfigValue;
-import cc.carm.plugin.timereward.TimeRewardAPI;
-import cc.carm.plugin.timereward.data.RewardContents;
-
-import java.util.HashMap;
-import java.util.LinkedHashMap;
-
-public class PluginConfig {
-
-    public static final ConfigValue<Boolean> DEBUG = new ConfigValue<>(
-            "debug", Boolean.class, false
-    );
-
-    public static final ConfigValue<Boolean> METRICS = new ConfigValue<>(
-            "metrics", Boolean.class, true
-    );
-
-    public static final ConfigValue<Boolean> CHECK_UPDATE = new ConfigValue<>(
-            "check-update", Boolean.class, true
-    );
-
-    public static final ConfigSectionCast<HashMap<String, RewardContents>> REWARDS = new ConfigSectionCast<>(
-            "rewards", TimeRewardAPI.getRewardManager()::readRewards, new LinkedHashMap<>()
-    );
-
-
-}

src/main/java/cc/carm/plugin/timereward/configuration/PluginMessages.java

@@ -1,64 +0,0 @@
-package cc.carm.plugin.timereward.configuration;
-
-import cc.carm.lib.easyplugin.configuration.language.EasyMessageList;
-import cc.carm.lib.easyplugin.configuration.language.MessagesRoot;
-
-
-public class PluginMessages extends MessagesRoot {
-
-    public static final EasyMessageList COMMAND_USAGE = new EasyMessageList(
-            "&6&l在线奖励 &f后台指令帮助",
-            "&8#&f reload",
-            "&8-&7 重载插件配置文件。",
-            "&8#&f user &6<玩家>",
-            "&8-&7 查看用户的在线时长信息与奖励领取情况。",
-            "&8#&f list",
-            "&8-&7 列出所有奖励与条件。",
-            "&8#&f test &6<奖励ID>",
-            "&8-&7 测试执行奖励配置的指令。"
-    );
-
-
-    public static class List {
-
-        public static final EasyMessageList HEADER = EasyMessageList.builder()
-                .contents("&6&l在线奖励 &f奖励列表 &7(共%(amount)个)")
-                .params("amount").build();
-
-        public static final EasyMessageList OBJECT = EasyMessageList.builder()
-                .contents(
-                        "&8# &f%(id)",
-                        "&8- &7奖励名称 &f%(name)",
-                        "&8- &7领取时间 &f&e%(time)&f秒"
-                ).params("id", "name", "time").build();
-
-        public static final EasyMessageList OBJECT_PERM = EasyMessageList.builder()
-                .contents(
-                        "&8# &f%(id)",
-                        "&8- &7奖励名称 &f%(name)",
-                        "&8- &7领取时间 &f&e%(time)&f秒",
-                        "&8- &7需要权限 &f%(permission)"
-                ).params("id", "name", "time", "permission").build();
-    }
-
-    public static final EasyMessageList USER_INFO = EasyMessageList.builder()
-            .contents(
-                    "&f玩家 &6%(player) &f已在线&e%(time)&f秒，共领取了 &e%(amount)&f 次奖励。",
-                    "&7已领取的奖励列表如下：&r%(rewards) &7。"
-            ).params("player", "time", "amount", "rewards").build();
-
-    public static final EasyMessageList COMMAND_LIST = EasyMessageList.builder()
-            .contents("&f正在执行奖励 %(award) 的指令列表...")
-            .params("award")
-            .build();
-
-    public static final EasyMessageList NOT_ONLINE = EasyMessageList.builder()
-            .contents("&f玩家 &e%(player) &f并不在线。")
-            .params("player")
-            .build();
-    public static final EasyMessageList NOT_EXISTS = EasyMessageList.builder()
-            .contents("&f奖励 &e%(award) &f并不存在。")
-            .params("award")
-            .build();
-
-}

src/main/java/cc/carm/plugin/timereward/data/DataTaskRunner.java

@@ -1,8 +0,0 @@
-package cc.carm.plugin.timereward.data;
-
-import cc.carm.plugin.timereward.database.DataManager;
-
-@FunctionalInterface
-public interface DataTaskRunner {
-    void run(TimeRewardUser user, DataManager dataManager) throws Exception;
-}

src/main/java/cc/carm/plugin/timereward/data/IntervalType.java

@@ -0,0 +1,101 @@
+package cc.carm.plugin.timereward.data;
+
+import org.jetbrains.annotations.NotNull;
+
+import java.time.Duration;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.function.BiFunction;
+import java.util.function.Predicate;
+
+public enum IntervalType {
+
+    TOTAL(
+            0, time -> false,
+            (timeRecord, join) -> Duration.between(join, LocalDateTime.now()).plus(timeRecord.getTotalTime())
+    ),
+
+    DAILY(
+            1, time -> time.isBefore(TimeRecord.getTodayStart()),
+            (timeRecord, join) -> {
+                LocalDateTime now = LocalDateTime.now();
+                if (now.toLocalDate().isEqual(timeRecord.getDate())) {
+                    // 和记录还在同一天
+                    return Duration.between(join, now).plus(timeRecord.getDailyTime());
+                } else if (now.toLocalDate().isEqual(join.toLocalDate())) {
+                    // 加入的时间和现在的时间在同一天
+                    return Duration.between(join, now);
+                } else {
+                    // 加入的时间和现在的时间不在同一天
+                    return Duration.between(TimeRecord.getTodayStart(), now);
+                }
+            }
+    ),
+    WEEKLY(
+            2, time -> time.isBefore(TimeRecord.getThisWeekStart()),
+            (timeRecord, join) -> {
+                LocalDateTime now = LocalDateTime.now();
+                if (TimeRecord.isSameWeek(timeRecord.getDate(), now)) {
+                    return Duration.between(join, now).plus(timeRecord.getWeeklyTime());
+                } else if (TimeRecord.isSameWeek(join, now)) {
+                    return Duration.between(join, now);
+                } else {
+                    return Duration.between(TimeRecord.getThisWeekStart(), now);
+                }
+            }
+    ),
+
+    MONTHLY(
+            3, time -> time.isBefore(TimeRecord.getThisMonthStart()),
+            (timeRecord, join) -> {
+                LocalDateTime now = LocalDateTime.now();
+                if (TimeRecord.isSameMonth(timeRecord.getDate(), now.toLocalDate())) {
+                    return Duration.between(join, now).plus(timeRecord.getMonthlyTime());
+                } else if (TimeRecord.isSameMonth(join.toLocalDate(), now.toLocalDate())) {
+                    return Duration.between(join, now);
+                } else {
+                    return Duration.between(TimeRecord.getThisMonthStart(), now);
+                }
+            }
+    );
+
+    private final int id;
+    private final @NotNull Predicate<LocalDateTime> periodChangePredicate;
+    private final @NotNull BiFunction<TimeRecord, LocalDateTime, Duration> calculator;
+
+    IntervalType(int id,
+                 @NotNull Predicate<LocalDateTime> periodChangePredicate,
+                 @NotNull BiFunction<TimeRecord, LocalDateTime, Duration> calculator) {
+        this.id = id;
+        this.periodChangePredicate = periodChangePredicate;
+        this.calculator = calculator;
+    }
+
+    public int getID() {
+        return id;
+    }
+
+    public @NotNull BiFunction<TimeRecord, LocalDateTime, Duration> getCalculator() {
+        return calculator;
+    }
+
+    public @NotNull Predicate<LocalDateTime> getPreiodChangePredicate() {
+        return periodChangePredicate;
+    }
+
+    public Duration calculate(@NotNull TimeRecord timeRecord, @NotNull LocalDateTime joinTime) {
+        return calculator.apply(timeRecord, joinTime);
+    }
+
+    public boolean isPeriodChanged(@NotNull LocalDateTime claimedDate) {
+        return periodChangePredicate.test(claimedDate);
+    }
+
+    public static IntervalType parse(String input) {
+        if (input == null) return null;
+        else return Arrays.stream(values())
+                .filter(t -> t.name().equalsIgnoreCase(input) || Integer.toString(t.id).equals(input))
+                .findFirst().orElse(null);
+    }
+
+}

src/main/java/cc/carm/plugin/timereward/data/RewardContents.java

@@ -1,37 +1,53 @@
 package cc.carm.plugin.timereward.data;
 
+import cc.carm.lib.configuration.source.section.ConfigureSection;
 import cc.carm.lib.easyplugin.utils.ColorParser;
+import cc.carm.plugin.timereward.Main;
 import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
-import java.util.List;
+import java.util.*;
-import java.util.Objects;
 
 public class RewardContents {
 
     public final @NotNull String id;
 
+    public final @NotNull IntervalType type;
     private final long time;
+    private final boolean loop;
+
     private final @Nullable String name;
     private final @Nullable String permission;
     private final @NotNull List<String> commands;
 
+    private final boolean auto;
 
-    public RewardContents(@NotNull String id, long time,
+    public RewardContents(@NotNull String id, @NotNull IntervalType type, long time, boolean loop,
                           @Nullable String name, @Nullable String permission,
-                          @NotNull List<String> commands) {
+                          @NotNull List<String> commands, boolean auto) {
         this.id = id;
+        this.type = type;
         this.time = time;
+        this.loop = loop;
         this.name = name;
         this.permission = permission;
         this.commands = commands;
+        this.auto = auto;
     }
 
-    public String getRewardID() {
+    public @NotNull String getRewardID() {
         return id;
     }
 
+    public @NotNull IntervalType getType() {
+        return type;
+    }
+
+    public boolean isLoop() {
+        return loop;
+    }
+
     public long getTime() {
         return time;
     }
@@ -41,7 +57,7 @@ public class RewardContents {
     }
 
     public @NotNull String getDisplayName() {
-        return ColorParser.parseColor(getName() == null ? getRewardID() : getName());
+        return ColorParser.parse(getName() == null ? getRewardID() : getName());
     }
 
     public @Nullable String getPermission() {
@@ -52,12 +68,53 @@ public class RewardContents {
         return commands;
     }
 
+    public boolean isAutoClaimed() {
+        return auto;
+    }
+
     public boolean checkPermission(@NotNull Player player) {
         return permission == null || player.hasPermission(permission);
     }
 
-    public boolean isTimeEnough(long requireSeconds) {
+    public Map<String, Object> serialize() {
-        return requireSeconds >= getTime();
+        Map<String, Object> map = new LinkedHashMap<>();
+        map.put("time", getTime());
+        map.put("type", getType().getID());
+        map.put("loop", isLoop());
+        if (getName() != null) map.put("name", getName());
+        if (getPermission() != null) map.put("permission", getPermission());
+        map.put("commands", getCommands());
+        map.put("auto", auto);
+        return map;
+    }
+
+    public static RewardContents parse(String id, @NotNull ConfigureSection section) {
+        long time = section.getLong("time", -1L);
+        if (time <= 0) {
+            Main.severe("奖励 " + id + " 的时间配置错误，请检查配置文件。");
+            return null;
+        }
+
+        IntervalType intervalType = IntervalType.parse(Objects.toString(section.get("type")));
+        if (intervalType == null) {
+            Main.severe("奖励 " + id + " 的类型配置错误，请检查配置文件。");
+            return null;
+        }
+
+        return new RewardContents(
+                id, intervalType, time, section.getBoolean("loop", false),
+                section.getString("name"), section.getString("permission"),
+                section.getStringList("commands"), section.getBoolean("auto", false)
+        );
+    }
+
+    public static RewardContents defaults(String id) {
+        return new RewardContents(
+                id, IntervalType.TOTAL, 7200, false,
+                "&f[初级奖励] &e总在线时长 2小时", "TimeReward.vip",
+                Collections.singletonList("say &f恭喜 &b%player_name% &f领取了奖励 &r%(name) &f！"),
+                true
+        );
     }
 
     @Override

src/main/java/cc/carm/plugin/timereward/data/TimeRecord.java

@@ -0,0 +1,113 @@
+package cc.carm.plugin.timereward.data;
+
+import cc.carm.plugin.timereward.conf.PluginConfig;
+import org.jetbrains.annotations.NotNull;
+
+import java.time.Duration;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.temporal.Temporal;
+import java.time.temporal.TemporalField;
+import java.time.temporal.WeekFields;
+
+public class TimeRecord {
+
+    public static TimeRecord empty() {
+        return new TimeRecord(LocalDate.now(), 0, 0, 0, 0);
+    }
+
+
+    protected final @NotNull LocalDate date;
+
+    protected final @NotNull Duration daily;
+    protected final @NotNull Duration weekly;
+    protected final @NotNull Duration monthly;
+
+    protected final @NotNull Duration total;
+
+    public TimeRecord(@NotNull LocalDate date, long daily, long weekly, long monthly, long total) {
+        this(date,
+                Duration.ofSeconds(daily), Duration.ofSeconds(weekly),
+                Duration.ofSeconds(monthly), Duration.ofSeconds(total)
+        );
+    }
+
+    public TimeRecord(@NotNull LocalDate date,
+                      @NotNull Duration daily, @NotNull Duration weekly,
+                      @NotNull Duration monthly, @NotNull Duration total) {
+        this.date = date;
+        this.daily = daily;
+        this.weekly = weekly;
+        this.monthly = monthly;
+        this.total = total;
+    }
+
+    public @NotNull LocalDate getDate() {
+        return date;
+    }
+
+    public @NotNull Duration getDailyTime() {
+        return daily;
+    }
+
+    public @NotNull Duration getWeeklyTime() {
+        return weekly;
+    }
+
+    public @NotNull Duration getMonthlyTime() {
+        return monthly;
+    }
+
+    public @NotNull Duration getTotalTime() {
+        return total;
+    }
+
+    public boolean isDayUpdated() {
+        return !LocalDate.now().equals(getDate());
+    }
+
+    public boolean isWeekUpdated() {
+        if (!isDayUpdated()) return false; // Same day always same week
+        return !isSameWeek(LocalDate.now(), getDate());
+    }
+
+    public boolean isMonthUpdated() {
+        if (!isDayUpdated()) return false; // Same day always same month
+
+        // Predicate current month is after the month of the date
+        return LocalDate.now().getMonth().compareTo(getDate().getMonth()) > 0;
+    }
+
+    public static boolean isSameWeek(Temporal a, Temporal b) {
+        TemporalField woy = WeekFields.of(PluginConfig.WEEK_FIRST_DAY.getNotNull(), 4).weekOfWeekBasedYear();
+        return a.get(woy) == b.get(woy);
+    }
+
+    public static boolean isSameMonth(LocalDate a, LocalDate b) {
+        return a.getMonth().equals(b.getMonth());
+    }
+
+    public static LocalDateTime getTodayStart() {
+        return LocalDate.now().atTime(0, 0);
+    }
+
+    public static LocalDateTime getThisWeekStart() {
+        TemporalField woy = WeekFields.of(PluginConfig.WEEK_FIRST_DAY.getNotNull(), 4).weekOfWeekBasedYear();
+        return LocalDate.now().with(woy, 1).atTime(0, 0);
+    }
+
+    public static LocalDateTime getThisMonthStart() {
+        return LocalDate.now().withDayOfMonth(1).atTime(0, 0);
+    }
+
+    @Override
+    public String toString() {
+        return "TimeRecord{" +
+                "date=" + date +
+                ", daily=" + daily +
+                ", weekly=" + weekly +
+                ", monthly=" + monthly +
+                ", total=" + total +
+                '}';
+    }
+}

src/main/java/cc/carm/plugin/timereward/data/TimeRewardUser.java

@@ -1,89 +0,0 @@
-package cc.carm.plugin.timereward.data;
-
-import org.jetbrains.annotations.NotNull;
-
-import java.util.LinkedHashSet;
-import java.util.Set;
-import java.util.UUID;
-import java.util.concurrent.TimeUnit;
-
-/**
- * 用户奖励数据，用于存储用户的奖励的领取情况。
- */
-public class TimeRewardUser {
-
-    UUID userUUID;
-
-    Set<@NotNull String> claimedRewards; //记录已领取的奖励ID
-
-    long storedSeconds; //记录已经游玩的时间
-    long joinMillis; // 记录本次加入的时间
-
-    public TimeRewardUser(UUID userUUID) {
-        this(userUUID, new LinkedHashSet<>(), 0);
-    }
-
-    public TimeRewardUser(UUID userUUID, Set<@NotNull String> claimedRewards,
-                          long storedSeconds) {
-        this(userUUID, claimedRewards, storedSeconds, System.currentTimeMillis());
-    }
-
-    public TimeRewardUser(UUID userUUID, Set<@NotNull String> claimedRewards,
-                          long storedSeconds, long joinMillis) {
-        this.userUUID = userUUID;
-        this.claimedRewards = claimedRewards;
-        this.storedSeconds = storedSeconds;
-        this.joinMillis = joinMillis;
-    }
-
-    public UUID getUserUUID() {
-        return userUUID;
-    }
-
-    public long getStoredSeconds() {
-        return storedSeconds;
-    }
-
-    /**
-     * 得到本次加入游戏的时间
-     *
-     * @return 本次加入游戏时间
-     */
-    public long getJoinMillis() {
-        return joinMillis;
-    }
-
-
-    /**
-     * 获取玩家本次加入服务器的时间 ，即为 当前时间-加入时间。
-     *
-     * @return 玩家本次加入服务器的时间
-     */
-    public long getCurrentSeconds() {
-        return TimeUnit.MILLISECONDS.toSeconds(System.currentTimeMillis() - getJoinMillis());
-    }
-
-    /**
-     * 获取 玩家在数据库中已经游玩的时间 + (当前时间-加入时间)
-     *
-     * @return 之前游玩的世界与本次游玩时间之和
-     */
-    public long getAllSeconds() {
-        return getStoredSeconds() + getCurrentSeconds();
-    }
-
-    public Set<String> getClaimedRewards() {
-        return claimedRewards;
-    }
-
-    public boolean isClaimed(@NotNull String rewardId) {
-        return this.claimedRewards.contains(rewardId);
-    }
-
-    public boolean addClaimedReward(@NotNull String rewardId) {
-        if (isClaimed(rewardId)) return false; // 已经领取过了
-        this.claimedRewards.add(rewardId);
-        return true;
-    }
-
-}

src/main/java/cc/carm/plugin/timereward/database/DBConfiguration.java

@@ -1,49 +0,0 @@
-package cc.carm.plugin.timereward.database;
-
-import cc.carm.lib.easyplugin.configuration.values.ConfigValue;
-
-public class DBConfiguration {
-
-    protected static final ConfigValue<String> DRIVER_NAME = new ConfigValue<>(
-            "database.driver", String.class,
-            "com.mysql.cj.jdbc.Driver"
-    );
-
-    protected static final ConfigValue<String> HOST = new ConfigValue<>(
-            "database.host", String.class,
-            "127.0.0.1"
-    );
-
-    protected static final ConfigValue<Integer> PORT = new ConfigValue<>(
-            "database.port", Integer.class,
-            3306
-    );
-
-    protected static final ConfigValue<String> DATABASE = new ConfigValue<>(
-            "database.database", String.class,
-            "minecraft"
-    );
-
-    protected static final ConfigValue<String> USERNAME = new ConfigValue<>(
-            "database.username", String.class,
-            "root"
-    );
-
-    protected static final ConfigValue<String> PASSWORD = new ConfigValue<>(
-            "database.password", String.class,
-            "password"
-    );
-
-    protected static final ConfigValue<String> ADDITIONAL = new ConfigValue<>(
-            "database.additional", String.class,
-            "?useSSL=false"
-    );
-
-    protected static String buildJDBC() {
-        return String.format("jdbc:mysql://%s:%s/%s%s",
-                HOST.get(), PORT.get(), DATABASE.get(), ADDITIONAL.get()
-        );
-    }
-
-
-}

src/main/java/cc/carm/plugin/timereward/database/DBTables.java

@@ -1,45 +0,0 @@
-package cc.carm.plugin.timereward.database;
-
-import cc.carm.lib.easyplugin.configuration.values.ConfigValue;
-
-public class DBTables {
-
-    protected static class UserOnlineTime {
-
-        protected static final ConfigValue<String> TABLE_NAME = new ConfigValue<>(
-                "database.tables.time", String.class,
-                "tr_user_times"
-        );
-
-        protected static final String[] TABLE_COLUMNS = new String[]{
-                "`uuid` VARCHAR(36) NOT NULL PRIMARY KEY COMMENT '用户UUID'", // 用户的UUID
-                "`time` INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '用户在线秒数'",// 用户在线时间(秒)
-                "`update` DATETIME NOT NULL " +
-                        "DEFAULT CURRENT_TIMESTAMP " +
-                        "ON UPDATE CURRENT_TIMESTAMP " +
-                        " COMMENT '最后更新时间'"
-        };
-
-    }
-
-    protected static class UserClaimedReward {
-
-        protected static final ConfigValue<String> TABLE_NAME = new ConfigValue<>(
-                "database.tables.claimed", String.class,
-                "tr_user_claimed"
-        );
-
-        protected static final String[] TABLE_COLUMNS = new String[]{
-                "`id` INT UNSIGNED NOT NULL AUTO_INCREMENT UNIQUE KEY", // 排序键
-                "`uuid` VARCHAR(36) NOT NULL PRIMARY KEY COMMENT '用户UUID'", // 用户的UUID 主键
-                "`value` MEDIUMTEXT", // 已领取的奖励ID
-                "`update` DATETIME NOT NULL " +
-                        "DEFAULT CURRENT_TIMESTAMP " +
-                        "ON UPDATE CURRENT_TIMESTAMP " +
-                        " COMMENT '最后更新时间'"
-        };
-
-    }
-
-
-}

src/main/java/cc/carm/plugin/timereward/database/DataManager.java

@@ -1,117 +0,0 @@
-package cc.carm.plugin.timereward.database;
-
-import cc.carm.lib.easysql.EasySQL;
-import cc.carm.lib.easysql.api.SQLManager;
-import cc.carm.plugin.timereward.Main;
-import com.google.gson.Gson;
-import com.google.gson.JsonElement;
-import com.google.gson.JsonParser;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.sql.ResultSet;
-import java.sql.SQLException;
-import java.util.LinkedHashSet;
-import java.util.Set;
-import java.util.UUID;
-
-public class DataManager {
-    protected static final Gson GSON = new Gson();
-    protected static final JsonParser PARSER = new JsonParser();
-    private SQLManager sqlManager;
-
-    public boolean initialize() {
-        try {
-            Main.info("	尝试连接到数据库...");
-            this.sqlManager = EasySQL.createManager(
-                    DBConfiguration.DRIVER_NAME.get(), DBConfiguration.buildJDBC(),
-                    DBConfiguration.USERNAME.get(), DBConfiguration.PASSWORD.get()
-            );
-//            this.sqlManager.setDebugMode(() -> Main.getInstance().isDebugging());
-        } catch (Exception exception) {
-            Main.severe("无法连接到数据库，请检查配置文件。");
-            exception.printStackTrace();
-            return false;
-        }
-
-        try {
-            Main.info("	创建插件所需表...");
-            getSQLManager().createTable(DBTables.UserOnlineTime.TABLE_NAME.get())
-                    .setColumns(DBTables.UserOnlineTime.TABLE_COLUMNS)
-                    .build().execute();
-
-            getSQLManager().createTable(DBTables.UserClaimedReward.TABLE_NAME.get())
-                    .setColumns(DBTables.UserClaimedReward.TABLE_COLUMNS)
-                    .build().execute();
-
-        } catch (SQLException exception) {
-            Main.severe("无法创建插件所需的表，请检查数据库权限。");
-            exception.printStackTrace();
-            return false;
-        }
-
-        return true;
-    }
-
-    public void shutdown() {
-        Main.info("	关闭数据库连接...");
-        EasySQL.shutdownManager(getSQLManager());
-        this.sqlManager = null;
-    }
-
-    public SQLManager getSQLManager() {
-        return sqlManager;
-    }
-
-    public @Nullable Long getPlayTime(@NotNull UUID userUUID) throws SQLException {
-        return getSQLManager().createQuery().inTable(DBTables.UserOnlineTime.TABLE_NAME.get())
-                .selectColumns("uuid", "time")
-                .addCondition("uuid", userUUID.toString())
-                .setLimit(1).build().executeFunction(query -> {
-                    ResultSet resultSet = query.getResultSet();
-                    return resultSet.next() ? resultSet.getLong("time") : 0L;
-                });
-    }
-
-    public @NotNull Set<String> getClaimedData(@NotNull UUID userUUID) throws SQLException {
-        return getSQLManager().createQuery().inTable(DBTables.UserClaimedReward.TABLE_NAME.get())
-                .selectColumns("uuid", "value")
-                .addCondition("uuid", userUUID.toString())
-                .setLimit(1).build().executeFunction(query -> {
-                    ResultSet resultSet = query.getResultSet();
-                    if (!resultSet.next()) return new LinkedHashSet<>();
-                    String json = resultSet.getString("value");
-                    if (json == null) return new LinkedHashSet<>();
-                    JsonElement element = PARSER.parse(json);
-                    if (!element.isJsonArray()) return new LinkedHashSet<>();
-                    Set<String> ids = new LinkedHashSet<>();
-                    for (JsonElement e : element.getAsJsonArray()) {
-                        ids.add(e.getAsString());
-                    }
-                    return ids;
-                }, new LinkedHashSet<>());
-    }
-
-
-    public void saveClaimedData(@NotNull UUID userUUID, @Nullable Set<String> claimedRewards) throws SQLException {
-        if (claimedRewards == null) {
-            getSQLManager().createDelete(DBTables.UserClaimedReward.TABLE_NAME.get())
-                    .addCondition("uuid", userUUID.toString())
-                    .setLimit(1).build().execute();
-        } else {
-            getSQLManager().createReplace(DBTables.UserClaimedReward.TABLE_NAME.get())
-                    .setColumnNames("uuid", "value")
-                    .setParams(userUUID.toString(), GSON.toJson(claimedRewards))
-                    .execute();
-        }
-    }
-
-    public void savePlayTime(@NotNull UUID userUUID, long time) throws SQLException {
-        getSQLManager().createReplace(DBTables.UserOnlineTime.TABLE_NAME.get())
-                .setColumnNames("uuid", "time").setParams(userUUID.toString(), time)
-                .execute();
-    }
-
-
-}
-

src/main/java/cc/carm/plugin/timereward/hooker/GHUpdateChecker.java

@@ -1,34 +0,0 @@
-package cc.carm.plugin.timereward.hooker;
-
-import cc.carm.lib.githubreleases4j.GithubReleases4J;
-import cc.carm.plugin.timereward.Main;
-
-public class GHUpdateChecker {
-
-    private final String owner;
-    private final String repo;
-
-    public GHUpdateChecker(String owner, String repo) {
-        this.owner = owner;
-        this.repo = repo;
-    }
-
-    public void checkUpdate(String currentVersion) {
-        Integer behindVersions = GithubReleases4J.getVersionBehind(owner, repo, currentVersion);
-        String downloadURL = GithubReleases4J.getReleasesURL(owner, repo);
-        if (behindVersions == null) {
-            Main.severe("检查更新失败，请您定期查看插件是否更新，避免安全问题。");
-            Main.severe("下载地址 " + downloadURL);
-        } else if (behindVersions == 0) {
-            Main.info("检查完成，当前已是最新版本。");
-        } else if (behindVersions > 0) {
-            Main.info("发现新版本! 目前已落后 " + behindVersions + " 个版本。");
-            Main.info("最新版下载地址 " + downloadURL);
-        } else {
-            Main.severe("检查更新失败! 当前版本未知，请您使用原生版本以避免安全问题。");
-            Main.severe("最新版下载地址 " + downloadURL);
-        }
-    }
-
-
-}

src/main/java/cc/carm/plugin/timereward/hooker/PAPIExpansion.java

@@ -1,88 +1,88 @@
 package cc.carm.plugin.timereward.hooker;
 
+import cc.carm.lib.easyplugin.papi.EasyPlaceholder;
+import cc.carm.lib.easyplugin.papi.handler.PlaceholderHandler;
 import cc.carm.plugin.timereward.TimeRewardAPI;
+import cc.carm.plugin.timereward.data.IntervalType;
 import cc.carm.plugin.timereward.data.RewardContents;
-import cc.carm.plugin.timereward.data.TimeRewardUser;
+import cc.carm.plugin.timereward.user.UserRewardData;
-import me.clip.placeholderapi.expansion.PlaceholderExpansion;
 import org.bukkit.entity.Player;
 import org.bukkit.plugin.java.JavaPlugin;
 import org.jetbrains.annotations.NotNull;
 
-import java.util.Arrays;
+import java.time.Duration;
-import java.util.List;
+import java.util.Collections;
+import java.util.function.BiFunction;
+import java.util.function.Function;
+import java.util.function.ToLongFunction;
 
-public class PAPIExpansion extends PlaceholderExpansion {
+public class PAPIExpansion extends EasyPlaceholder {
 
-    private static final List<String> PLACEHOLDERS = Arrays.asList(
+    public PAPIExpansion(@NotNull JavaPlugin plugin, @NotNull String rootIdentifier) {
-            "%TimeReward_time%",
+        super(plugin, rootIdentifier);
-            "%TimeReward_reward_<奖励ID>%",
+
-            "%TimeReward_claimed_<奖励ID>%"
+        handle("seconds", timeHandler(Duration::getSeconds), Collections.singletonList("<时间类型>"), "time");
+        handle("minutes", timeHandler(Duration::toMinutes), Collections.singletonList("<时间类型>"));
+        handle("hours", timeHandler(Duration::toHours), Collections.singletonList("<时间类型>"));
+        handle("days", timeHandler(Duration::toDays), Collections.singletonList("<时间类型>"));
+
+        handle("reward",
+                rewardHandler(RewardContents::getDisplayName),
+                Collections.singletonList("<奖励ID>")
         );
 
-    private final JavaPlugin plugin;
+        handle("claimed", userHandler((user, args) -> {
+            if (args.length < 1) return "请填写奖励ID";
 
-    public PAPIExpansion(JavaPlugin plugin) {
+            RewardContents reward = TimeRewardAPI.getRewardManager().getReward(args[0]);
-        this.plugin = plugin;
+            if (reward == null) return "奖励不存在";
+
+            return user.isClaimed(reward);
+        }), Collections.singletonList("<奖励ID>"));
+
+        handle("claimable", (offlinePlayer, args) -> {
+            if (offlinePlayer == null || !offlinePlayer.isOnline()) return "加载中...";
+            if (args.length < 1) return "请填写奖励ID";
+
+            RewardContents reward = TimeRewardAPI.getRewardManager().getReward(args[0]);
+            if (reward == null) return "奖励不存在";
+
+            return TimeRewardAPI.getRewardManager().isClaimable((Player) offlinePlayer, reward);
+        }, Collections.singletonList("<奖励ID>"));
+
+        handle("version", (player, args) -> getVersion());
     }
 
-    @Override
+    protected <R> PlaceholderHandler userHandler(Function<UserRewardData, R> userFunction) {
-    public @NotNull List<String> getPlaceholders() {
+        return userHandler((user, args) -> userFunction.apply(user));
-        return PLACEHOLDERS;
     }
 
-    @Override
+    protected <R> PlaceholderHandler userHandler(BiFunction<UserRewardData, String[], R> userFunction) {
-    public boolean canRegister() {
+        return (player, args) -> {
-        return true;
+            if (player == null || !player.isOnline()) return "加载中...";
+            UserRewardData data = TimeRewardAPI.getUserManager().get((Player) player);
+            if (data == null) return "加载中...";
+            return userFunction.apply(data, args);
+        };
     }
 
-    @Override
+    protected PlaceholderHandler timeHandler(ToLongFunction<Duration> timeFunction) {
-    public @NotNull String getAuthor() {
+        return userHandler((user, args) -> {
-        return plugin.getDescription().getAuthors().toString();
+            if (args.length < 1) return "请填写时间类型";
+            IntervalType type = IntervalType.parse(args[0]);
+            if (type == null) return "时间类型不存在";
+            return timeFunction.applyAsLong(user.getOnlineDuration(type));
+        });
     }
 
-    @Override
+    protected <R> PlaceholderHandler rewardHandler(Function<RewardContents, R> function) {
-    public @NotNull String getIdentifier() {
+        return (player, args) -> {
-        return plugin.getDescription().getName();
+            if (args.length < 1) return "请填写奖励ID";
-    }
+            String rewardName = args[0];
-
-    @Override
-    public @NotNull String getVersion() {
-        return plugin.getDescription().getVersion();
-    }
-
-    @Override
-    public String onPlaceholderRequest(Player player, @NotNull String identifier) {
-        if (player == null) return "加载中...";
-        String[] args = identifier.split("_");
-
-        if (args.length < 1) {
-            return "Error Params";
-        }
-
-        TimeRewardUser user = TimeRewardAPI.getUserManager().get(player);
-
-        switch (args[0].toLowerCase()) {
-            case "time": {
-                return Long.toString(user.getAllSeconds());
-            }
-            case "reward": {
-                if (args.length < 2) return "请填写奖励ID";
-                String rewardName = args[1];
             RewardContents contents = TimeRewardAPI.getRewardManager().getReward(rewardName);
             if (contents == null) return "奖励不存在";
-                return contents.getDisplayName();
+            return function.apply(contents);
-            }
+        };
-            case "claimed": {
-                if (args.length < 2) return "请填写奖励ID";
-                return Boolean.toString(user.isClaimed(args[1]));
-            }
-            case "version": {
-                return getVersion();
-            }
-            default: {
-                return "参数错误";
-            }
-        }
     }
 
 }

src/main/java/cc/carm/plugin/timereward/listener/UserListener.java

@@ -2,21 +2,38 @@ package cc.carm.plugin.timereward.listener;
 
 import cc.carm.plugin.timereward.Main;
 import cc.carm.plugin.timereward.TimeRewardAPI;
+import org.bukkit.entity.Player;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.Listener;
 import org.bukkit.event.player.PlayerJoinEvent;
 import org.bukkit.event.player.PlayerQuitEvent;
+import org.jetbrains.annotations.Nullable;
 
 public class UserListener implements Listener {
 
     @EventHandler
     public void onJoin(PlayerJoinEvent event) {
-        Main.getInstance().getScheduler().runAsync(() -> TimeRewardAPI.getUserManager().load(event.getPlayer().getUniqueId()));
+        @Nullable Player player = event.getPlayer();
+        // Delayed load to avoid async error
+        Main.getInstance().getScheduler().runLater(20L, () -> {
+            if (player == null || !player.isOnline()) return;
+            TimeRewardAPI.getUserManager()
+                    .load(event.getPlayer().getUniqueId(), true)
+                    .thenAccept(data -> {
+                        if (!player.isOnline()) {  // 不在线自动卸载
+                            TimeRewardAPI.getUserManager().unload(data.getUserUUID(), false);
+                        }
+                    }).exceptionally(ex -> {
+                        Main.severe("加载用户在线时长数据失败: " + event.getPlayer().getName());
+                        ex.printStackTrace();
+                        return null;
+                    });
+        });
     }
 
     @EventHandler
     public void onQuit(PlayerQuitEvent event) {
-        Main.getInstance().getScheduler().runAsync(() -> TimeRewardAPI.getUserManager().unload(event.getPlayer().getUniqueId()));
+        TimeRewardAPI.getUserManager().unload(event.getPlayer().getUniqueId());
     }
 
 }

src/main/java/cc/carm/plugin/timereward/manager/ConfigManager.java

@@ -1,49 +0,0 @@
-package cc.carm.plugin.timereward.manager;
-
-
-import cc.carm.lib.easyplugin.configuration.file.FileConfig;
-import cc.carm.lib.easyplugin.configuration.language.MessagesConfig;
-import cc.carm.lib.easyplugin.configuration.language.MessagesInitializer;
-import cc.carm.plugin.timereward.Main;
-import cc.carm.plugin.timereward.configuration.PluginMessages;
-
-public class ConfigManager {
-
-    private FileConfig pluginConfiguration;
-    private MessagesConfig messageConfiguration;
-
-    public boolean initConfig() {
-        try {
-            pluginConfiguration = new FileConfig(Main.getInstance(), "config.yml");
-            messageConfiguration = new MessagesConfig(Main.getInstance(), "messages.yml");
-
-            FileConfig.pluginConfiguration = () -> pluginConfiguration;
-            FileConfig.messageConfiguration = () -> messageConfiguration;
-
-            MessagesInitializer.initialize(messageConfiguration, PluginMessages.class);
-
-            return true;
-        } catch (Exception ex) {
-            return false;
-        }
-    }
-
-    public FileConfig getPluginConfig() {
-        return FileConfig.pluginConfiguration.get();
-    }
-
-    public FileConfig getMessageConfig() {
-        return FileConfig.messageConfiguration.get();
-    }
-
-    public void reload() throws Exception {
-        getPluginConfig().reload();
-        getMessageConfig().reload();
-    }
-
-    public void saveConfig() throws Exception {
-        getPluginConfig().save();
-        getMessageConfig().save();
-    }
-
-}

src/main/java/cc/carm/plugin/timereward/manager/RewardManager.java

@@ -3,102 +3,132 @@ package cc.carm.plugin.timereward.manager;
 import cc.carm.lib.easyplugin.utils.MessageUtils;
 import cc.carm.plugin.timereward.Main;
 import cc.carm.plugin.timereward.TimeRewardAPI;
-import cc.carm.plugin.timereward.configuration.PluginConfig;
+import cc.carm.plugin.timereward.conf.RewardsConfig;
+import cc.carm.plugin.timereward.data.IntervalType;
 import cc.carm.plugin.timereward.data.RewardContents;
-import cc.carm.plugin.timereward.data.TimeRewardUser;
+import cc.carm.plugin.timereward.user.UserRewardData;
 import org.bukkit.Bukkit;
-import org.bukkit.configuration.ConfigurationSection;
 import org.bukkit.entity.Player;
 import org.bukkit.scheduler.BukkitRunnable;
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+import org.jetbrains.annotations.Unmodifiable;
 
-import java.util.HashMap;
+import java.time.Duration;
-import java.util.List;
+import java.time.LocalDateTime;
-import java.util.Map;
+import java.util.*;
+import java.util.concurrent.CompletableFuture;
 import java.util.stream.Collectors;
 
 public class RewardManager {
 
-    private BukkitRunnable rewardChecker;
+    protected BukkitRunnable runnable;
 
-    public void initialize() {
+    public RewardManager(Main main) {
-        this.rewardChecker = new BukkitRunnable() {
+        this.runnable = new BukkitRunnable() {
             @Override
             public void run() {
                 if (Bukkit.getOnlinePlayers().isEmpty()) return;
 
                 for (Player player : Bukkit.getOnlinePlayers()) {
-                    List<RewardContents> unclaimedRewards = getUnclaimedRewards(player);
+                    List<RewardContents> rewards = getUnclaimedRewards(player).stream()
-                    if (unclaimedRewards.isEmpty()) continue;
+                            .filter(RewardContents::isAutoClaimed)
+                            .collect(Collectors.toList());
+                    if (rewards.isEmpty()) continue;
 
-                    Main.getInstance().getScheduler().run(() -> unclaimedRewards.forEach(
+                    //为玩家发放奖励
-                            // 在同步进程中为玩家发放奖励
+                    claimRewards(player, rewards, true); // 二次检查避免重复发奖
-                            unclaimedReward -> claimReward(player, unclaimedReward, false)
-                    ));
                 }
-
             }
         };
-
+        this.runnable.runTaskTimerAsynchronously(main, 100L, 20L);
-        this.rewardChecker.runTaskTimerAsynchronously(Main.getInstance(), 100L, 20L);
     }
 
     public void shutdown() {
-        this.rewardChecker.cancel();
+        this.runnable.cancel();
-        this.rewardChecker = null;
+        this.runnable = null;
     }
 
-    public HashMap<String, RewardContents> readRewards(@NotNull ConfigurationSection section) {
+    protected Map<String, RewardContents> getRewards() {
-        HashMap<String, RewardContents> rewards = new HashMap<>();
+        return RewardsConfig.getContents();
-        for (String rewardID : section.getKeys(false)) {
-            ConfigurationSection rewardSection = section.getConfigurationSection(rewardID);
-            if (rewardSection == null) continue;
-            long time = rewardSection.getLong("time", -1);
-            if (time <= 0) {
-                Main.severe("奖励 " + rewardID + " 的时间配置错误，请检查配置文件。");
-                continue;
     }
 
-            rewards.put(rewardID, new RewardContents(
+    public @Nullable RewardContents getReward(String rewardID) {
-                    rewardID, time,
+        return getRewards().get(rewardID);
-                    rewardSection.getString("name"),
-                    rewardSection.getString("permission"),
-                    rewardSection.getStringList("commands")
-            ));
-        }
-        return rewards;
     }
 
     public Map<String, RewardContents> listRewards() {
-        return new HashMap<>(getRewardsMap());
+        return Collections.unmodifiableMap(RewardsConfig.getContents());
     }
 
-    public RewardContents getReward(String rewardID) {
+    @Unmodifiable
-        return getRewardsMap().get(rewardID);
+    public @NotNull List<RewardContents> getUnclaimedRewards(@NotNull Player player) {
-    }
-
-    protected HashMap<String, RewardContents> getRewardsMap() {
-        return PluginConfig.REWARDS.getOptional().orElse(new HashMap<>());
-    }
-
-    public List<RewardContents> getUnclaimedRewards(Player player) {
-        TimeRewardUser user = TimeRewardAPI.getUserManager().get(player);
         return listRewards().values().stream()
-                .filter(reward -> reward.isTimeEnough(user.getAllSeconds())) // 时间足够
+                .filter(reward -> isClaimable(player, reward))
-                .filter(reward -> !user.isClaimed(reward.getRewardID())) // 未曾领取
-                .filter(reward -> reward.checkPermission(player)) // 满足权限
                 .collect(Collectors.toList());
     }
 
-    public boolean claimReward(Player player, RewardContents reward, boolean check) {
+    public boolean isClaimable(Player player, RewardContents reward) {
-        TimeRewardUser user = TimeRewardAPI.getUserManager().get(player);
+        if (!reward.checkPermission(player)) return false; // 满足权限
-        if (check && user.isClaimed(reward.getRewardID())) return false;
+
-        if (check && !reward.isTimeEnough(user.getAllSeconds())) return false;
+        UserRewardData user = TimeRewardAPI.getUserManager().get(player);
-        if (check && !reward.checkPermission(player)) return false;
+        if (user == null) return false; // 玩家数据加载中
+
+        IntervalType intervalType = reward.getType();
+        LocalDateTime lastClaimed = user.getClaimedDate(reward);
+
+        if (reward.isLoop()) { // 循环奖励
+            if (lastClaimed == null || intervalType.isPeriodChanged(lastClaimed)) {
+                // 无上次领取记录或上次领取的时间不在一个周期内，则直接判断时间是否足够一次循环领取的时间
+                return user.getOnlineDuration(intervalType).getSeconds() > reward.getTime();
+            } else {
+                // 有上次领取记录，且在同一周期内，则直接判断相隔时间是否满足一个周期
+                return Duration.between(lastClaimed, LocalDateTime.now()).getSeconds() > reward.getTime();
+            }
+        } else { // 非循环奖励
+            if (lastClaimed == null || intervalType.isPeriodChanged(lastClaimed)) { // 无上次领取记录，则直接判断时间是否足够领取的时间
+                return user.getOnlineDuration(intervalType).getSeconds() > reward.getTime();
+            } else return false; // 有同一周期内的领取记录，则玩家不得重复领取了
+        }
+    }
+
+    public CompletableFuture<Boolean> claimReward(Player player, RewardContents reward, boolean check) {
+        return claimRewards(player, Collections.singletonList(reward), check);
+    }
+
+    public CompletableFuture<Boolean> claimRewards(Player player, Collection<RewardContents> rewards, boolean check) {
+        Set<RewardContents> contents = rewards.stream()
+                .filter(r -> !check || isClaimable(player, r))
+                .collect(Collectors.toSet());
+
+        Map<String, LocalDateTime> map = new LinkedHashMap<>();
+        contents.forEach(reward -> map.put(reward.getRewardID(), LocalDateTime.now()));
+
+        return Main.getInstance().supplyAsync(() -> {
+            try {
+
+                UserRewardData user = TimeRewardAPI.getUserManager().get(player);
+                if (user == null) return false; // 玩家数据加载中
+                
+                Main.getStorage().addClaimedData(player.getUniqueId(), map);
+                contents.forEach(user::updateClaimed);
 
-        user.addClaimedReward(reward.getRewardID());
-        executeCommand(player, reward);
                 return true;
+            } catch (Exception ex) {
+                Main.severe("为玩家 " + player.getName() + " 领取奖励时发生错误。");
+                ex.printStackTrace();
+                return false;
+            }
+        }).thenCompose(result -> {
+            if (result) {
+                return Main.getInstance().supplySync(() -> {
+                    rewards.forEach(reward -> executeCommand(player, reward));
+                    return true;
+                });
+            } else {
+                return CompletableFuture.completedFuture(false);
+            }
+        });
     }
 
     public void executeCommand(Player player, RewardContents reward) {
@@ -109,9 +139,4 @@ public class RewardManager {
         TimeRewardAPI.executeCommands(player, finalCommands); // 执行命令
     }
 
-    public boolean claimReward(Player player, RewardContents reward) {
-        return claimReward(player, reward, true);
-    }
-
-
 }

src/main/java/cc/carm/plugin/timereward/manager/UserManager.java

@@ -1,134 +1,64 @@
 package cc.carm.plugin.timereward.manager;
 
+import cc.carm.lib.easyplugin.EasyPlugin;
+import cc.carm.lib.easyplugin.user.UserDataManager;
 import cc.carm.plugin.timereward.Main;
-import cc.carm.plugin.timereward.data.DataTaskRunner;
+import cc.carm.plugin.timereward.data.IntervalType;
-import cc.carm.plugin.timereward.data.TimeRewardUser;
+import cc.carm.plugin.timereward.data.TimeRecord;
-import cc.carm.plugin.timereward.database.DataManager;
+import cc.carm.plugin.timereward.storage.database.MySQLStorage;
-import org.bukkit.Bukkit;
+import cc.carm.plugin.timereward.user.LockedRewardData;
+import cc.carm.plugin.timereward.user.UserRewardData;
 import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.Unmodifiable;
 
-import java.util.HashMap;
+import java.time.Duration;
-import java.util.Map;
+import java.time.LocalDate;
-import java.util.Set;
+import java.util.LinkedHashMap;
 import java.util.UUID;
 
-public class UserManager {
+public class UserManager extends UserDataManager<UUID, UserRewardData> {
 
-    private final HashMap<UUID, TimeRewardUser> userDataMap;
+    public UserManager(@NotNull EasyPlugin plugin) {
-
+        super(plugin);
-    public UserManager() {
-        this.userDataMap = new HashMap<>();
     }
 
-    @NotNull
+    public @Nullable UserRewardData get(Player player) {
-    public TimeRewardUser read(UUID userUUID) {
+        return getNullable(player.getUniqueId());
-        try {
-            long start = System.currentTimeMillis();
-            DataManager storage = Main.getDataManager();
-
-            Long playTime = storage.getPlayTime(userUUID);
-            Set<String> claimedRewards = storage.getClaimedData(userUUID);
-
-            if (playTime == null && claimedRewards.isEmpty()) {
-                Main.debugging("当前还不存在玩家 " + userUUID + " 的数据，视作新档。");
-                return new TimeRewardUser(userUUID);
     }
 
-            Main.debugging("读取 " + userUUID + " 的用户数据完成， 耗时 " + (System.currentTimeMillis() - start) + "ms。");
+    @Override
-            return new TimeRewardUser(userUUID, claimedRewards, playTime == null ? 0L : playTime);
+    protected @Nullable UserRewardData loadData(@NotNull UUID key) throws Exception {
-        } catch (Exception e) {
+        return Main.getStorage().loadData(key);
-            Main.severe("无法正常读取玩家数据，玩家操作将不会被保存，请检查数据配置！");
-            Main.severe("Could not load user's data, please check the data configuration!");
-            e.printStackTrace();
-            return new TimeRewardUser(userUUID);
-        }
     }
 
-    public void save(TimeRewardUser user) {
+    @Override
-        try {
+    public void saveData(@NotNull UserRewardData data) throws Exception {
-            long start = System.currentTimeMillis();
+        if (data instanceof LockedRewardData) return; // 不保存
-            DataManager dataManager = Main.getDataManager();
 
-            Main.debugging("正在保存 " + user.getUserUUID() + " 的用户数据...");
+        MySQLStorage storage = Main.getStorage();
-            dataManager.saveClaimedData(user.getUserUUID(), user.getClaimedRewards());
-            dataManager.savePlayTime(user.getUserUUID(), user.getAllSeconds());
-            Main.debugging("保存 " + user.getUserUUID() + " 的用户数据完成，耗时 " + (System.currentTimeMillis() - start) + "ms。");
 
-        } catch (Exception e) {
+        @Nullable UserRewardData current = loadData(data.getUserUUID()); // 考虑读取时间差，优先利用数据库的当前数据计算
-            Main.severe("无法正常保存玩家数据，请检查数据配置！");
+        TimeRecord oldRecord = current == null ? data.getTimeRecord() : current.getTimeRecord();
-            Main.severe("Could not save user's data, please check the data configuration!");
+
-            e.printStackTrace();
+        // 只需要保存游玩时间数据，领取数据已经实时保存了
-        }
+        Duration daily = IntervalType.DAILY.calculate(oldRecord, data.getJoinTime());
+        Duration weekly = IntervalType.WEEKLY.calculate(oldRecord, data.getJoinTime());
+        Duration monthly = IntervalType.MONTHLY.calculate(oldRecord, data.getJoinTime());
+        Duration total = IntervalType.TOTAL.calculate(oldRecord, data.getJoinTime());
+        TimeRecord newRecord = new TimeRecord(LocalDate.now(), daily, weekly, monthly, total);
+
+        storage.savePlayTime(data.getUserUUID(), newRecord);
     }
 
-    public void load(UUID userUUID) {
+    @Override
-        getUsersMap().put(userUUID, read(userUUID));
+    public @NotNull UserRewardData emptyUser(@NotNull UUID key) {
+        return new UserRewardData(key, TimeRecord.empty(), new LinkedHashMap<>());
     }
 
-    public void unload(UUID userUUID) {
+    @Override
-        unload(userUUID, true);
+    public @NotNull UserRewardData errorUser(@NotNull UUID key) {
-    }
+        return new LockedRewardData(key); // 避免影响数据存储
-
-    public void unload(UUID userUUID, boolean save) {
-        TimeRewardUser data = get(userUUID);
-        if (data == null) return;
-        if (save) save(data);
-        getUsersMap().remove(userUUID);
-    }
-
-    public void loadAll() {
-        for (Player player : Bukkit.getOnlinePlayers()) {
-            if (getUsersMap().containsKey(player.getUniqueId())) continue;
-            load(player.getUniqueId());
-        }
-    }
-
-    public void saveAll() {
-        getUsersMap().values().forEach(this::save);
-    }
-
-    public void unloadAll(boolean save) {
-        if (save) saveAll();
-        getUsersMap().clear();
-    }
-
-    @Nullable
-    public TimeRewardUser get(UUID userUUID) {
-        return getUsersMap().get(userUUID);
-    }
-
-    @NotNull
-    public TimeRewardUser get(Player player) {
-        return getUsersMap().get(player.getUniqueId());
-    }
-
-    public void editData(@NotNull UUID uuid, @NotNull DataTaskRunner task) {
-        TimeRewardUser user = get(uuid);
-        if (user == null) user = read(uuid); // 不在线则加载数据
-        try {
-            task.run(user, Main.getDataManager());
-        } catch (Exception exception) {
-            Main.severe("无法正常更改玩家数据，请检查数据配置！");
-            Main.severe("Could not edit user's data, please check the data configuration!");
-            exception.printStackTrace();
-        }
-    }
-
-    public void editDataAsync(@NotNull UUID uuid, @NotNull DataTaskRunner task) {
-        Main.getInstance().getScheduler().runAsync(() -> editData(uuid, task));
-    }
-
-    @NotNull
-    @Unmodifiable
-    public Map<UUID, TimeRewardUser> list() {
-        return new HashMap<>(getUsersMap());
-    }
-
-    protected @NotNull HashMap<UUID, TimeRewardUser> getUsersMap() {
-        return userDataMap;
     }
 
 }

src/main/java/cc/carm/plugin/timereward/storage/database/DatabaseConfig.java

@@ -0,0 +1,36 @@
+package cc.carm.plugin.timereward.storage.database;
+
+import cc.carm.lib.configuration.Configuration;
+import cc.carm.lib.configuration.annotation.ConfigPath;
+import cc.carm.lib.configuration.annotation.HeaderComments;
+import cc.carm.lib.configuration.value.standard.ConfiguredValue;
+
+@HeaderComments("数据库相关设定")
+@ConfigPath(value = "storage.database", root = true)
+public class DatabaseConfig implements Configuration {
+
+    @ConfigPath("driver")
+    protected static final ConfiguredValue<String> DRIVER_NAME = ConfiguredValue.of(
+            String.class, "com.mysql.jdbc.Driver"
+    );
+
+    protected static final ConfiguredValue<String> HOST = ConfiguredValue.of(String.class, "127.0.0.1");
+    protected static final ConfiguredValue<Integer> PORT = ConfiguredValue.of(Integer.class, 3306);
+    protected static final ConfiguredValue<String> DATABASE = ConfiguredValue.of(String.class, "minecraft");
+    protected static final ConfiguredValue<String> USERNAME = ConfiguredValue.of(String.class, "root");
+    protected static final ConfiguredValue<String> PASSWORD = ConfiguredValue.of(String.class, "password");
+    protected static final ConfiguredValue<String> EXTRA = ConfiguredValue.of(String.class, "?useSSL=false");
+
+    @HeaderComments("插件相关表的名称")
+    public static final class TABLES implements Configuration {
+        public static final ConfiguredValue<String> USER_TIMES = ConfiguredValue.of(String.class, "tr_user_times");
+        public static final ConfiguredValue<String> USER_CLAIMED = ConfiguredValue.of(String.class, "tr_user_claimed");
+    }
+
+    protected static String buildJDBC() {
+        return String.format("jdbc:mysql://%s:%s/%s%s",
+                HOST.getNotNull(), PORT.getNotNull(), DATABASE.getNotNull(), EXTRA.getNotNull()
+        );
+    }
+
+}

src/main/java/cc/carm/plugin/timereward/storage/database/DatabaseTables.java

@@ -0,0 +1,76 @@
+package cc.carm.plugin.timereward.storage.database;
+
+import cc.carm.lib.configuration.value.standard.ConfiguredValue;
+import cc.carm.lib.easysql.api.SQLManager;
+import cc.carm.lib.easysql.api.SQLTable;
+import cc.carm.lib.easysql.api.builder.TableCreateBuilder;
+import cc.carm.lib.easysql.api.enums.IndexType;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.sql.SQLException;
+import java.util.function.Consumer;
+
+public enum DatabaseTables implements SQLTable {
+
+    /**
+     * 用于记录用户在线时间的表
+     */
+    USER_TIMES(DatabaseConfig.TABLES.USER_TIMES, table -> {
+        table.addColumn("uuid", "CHAR(36) NOT NULL PRIMARY KEY"); // 用户的UUID
+        table.addColumn("date", "DATE NOT NULL"); // 日期
+
+        table.addColumn("daily_time", "MEDIUMINT UNSIGNED NOT NULL DEFAULT 0"); // 用户日在线时间(秒)
+        table.addColumn("weekly_time", "MEDIUMINT UNSIGNED NOT NULL DEFAULT 0"); // 用户周在线时间(秒)
+        table.addColumn("monthly_time", "INT UNSIGNED NOT NULL DEFAULT 0"); // 用户月在线时间(秒)
+        table.addColumn("total_time", "INT UNSIGNED NOT NULL DEFAULT 0"); // 用户总在线时间(秒)
+
+        table.addColumn("update",
+                "DATETIME NOT NULL " +
+                        "DEFAULT CURRENT_TIMESTAMP " +
+                        "ON UPDATE CURRENT_TIMESTAMP"
+        );
+
+    }),
+
+    /**
+     * 用于记录用户奖励领取情况的表
+     */
+    USER_CLAIMED(DatabaseConfig.TABLES.USER_CLAIMED, (table) -> {
+        table.addColumn("uuid", "CHAR(36) NOT NULL"); // 用户的UUID 主键
+        table.addColumn("reward", "VARCHAR(64) NOT NULL"); // 已领取的奖励ID
+
+        table.addColumn("time", "DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP"); // 领取时间
+
+        table.setIndex(IndexType.PRIMARY_KEY, "pk_timereward_user", "uuid", "reward");
+    });
+
+    private final Consumer<TableCreateBuilder> builder;
+    private final ConfiguredValue<String> name;
+    private @Nullable SQLManager manager;
+
+    DatabaseTables(ConfiguredValue<String> name,
+                   Consumer<TableCreateBuilder> builder) {
+        this.name = name;
+        this.builder = builder;
+    }
+
+    @Override
+    public @Nullable SQLManager getSQLManager() {
+        return this.manager;
+    }
+
+    @Override
+    public @NotNull String getTableName() {
+        return this.name.getNotNull();
+    }
+
+    @Override
+    public boolean create(SQLManager sqlManager) throws SQLException {
+        if (this.manager == null) this.manager = sqlManager;
+
+        TableCreateBuilder tableBuilder = sqlManager.createTable(getTableName());
+        if (builder != null) builder.accept(tableBuilder);
+        return tableBuilder.build().executeFunction(l -> l > 0, false);
+    }
+}

src/main/java/cc/carm/plugin/timereward/storage/database/MySQLStorage.java

@@ -0,0 +1,141 @@
+package cc.carm.plugin.timereward.storage.database;
+
+import cc.carm.lib.easysql.EasySQL;
+import cc.carm.lib.easysql.api.SQLManager;
+import cc.carm.plugin.timereward.Main;
+import cc.carm.plugin.timereward.data.TimeRecord;
+import cc.carm.plugin.timereward.user.UserRewardData;
+import com.google.gson.Gson;
+import com.google.gson.JsonParser;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.sql.ResultSet;
+import java.sql.SQLException;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.*;
+import java.util.stream.Collectors;
+
+public class MySQLStorage {
+    protected static final Gson GSON = new Gson();
+    protected static final JsonParser PARSER = new JsonParser();
+    private SQLManager sqlManager;
+
+    public void initialize() throws Exception {
+        Main.info("加载数据库配置...");
+        Main.getInstance().getConfigProvider().initialize(DatabaseConfig.class);
+
+        try {
+            Main.info("尝试连接到数据库...");
+            this.sqlManager = EasySQL.createManager(
+                    DatabaseConfig.DRIVER_NAME.getNotNull(), DatabaseConfig.buildJDBC(),
+                    DatabaseConfig.USERNAME.getNotNull(), DatabaseConfig.PASSWORD.getNotNull()
+            );
+            this.sqlManager.setDebugMode(() -> Main.getInstance().isDebugging());
+        } catch (Exception exception) {
+            throw new Exception("无法连接到数据库，请检查配置文件。", exception);
+        }
+
+        try {
+            Main.info("创建插件所需表...");
+            for (DatabaseTables value : DatabaseTables.values()) {
+                value.create(this.sqlManager);
+            }
+        } catch (SQLException exception) {
+            throw new Exception("无法创建插件所需的表，请检查数据库权限。", exception);
+        }
+    }
+
+    public void shutdown() {
+        Main.info("关闭数据库连接...");
+        EasySQL.shutdownManager(getSQLManager());
+        this.sqlManager = null;
+    }
+
+    public SQLManager getSQLManager() {
+        return sqlManager;
+    }
+
+    public @Nullable UserRewardData loadData(@NotNull UUID uuid) throws Exception {
+        TimeRecord recordDate = loadTimeRecord(uuid);
+        Map<String, LocalDateTime> claimedData = loadClaimedData(uuid);
+        return new UserRewardData(uuid, recordDate, claimedData);
+    }
+
+    public TimeRecord loadTimeRecord(@NotNull UUID uuid) throws Exception {
+        return DatabaseTables.USER_TIMES.createQuery()
+                .addCondition("uuid", uuid).setLimit(1).build()
+                .executeFunction(query -> {
+                    ResultSet rs = query.getResultSet();
+                    if (rs == null || !rs.next()) return TimeRecord.empty();
+
+                    LocalDate date = rs.getDate("date").toLocalDate();
+                    long daily = rs.getLong("daily_time");
+                    long weekly = rs.getLong("weekly_time");
+                    long monthly = rs.getLong("monthly_time");
+                    long total = rs.getLong("total_time");
+
+                    return new TimeRecord(date, daily, weekly, monthly, total);
+                }, TimeRecord.empty());
+    }
+
+    @NotNull
+    public Map<String, LocalDateTime> loadClaimedData(@NotNull UUID uuid) throws Exception {
+        return DatabaseTables.USER_CLAIMED.createQuery()
+                .addCondition("uuid", uuid).build()
+                .executeFunction(query -> {
+                    ResultSet rs = query.getResultSet();
+                    Map<String, LocalDateTime> map = new LinkedHashMap<>();
+
+                    while (rs.next()) {
+                        String rewardID = rs.getString("reward");
+                        LocalDateTime time = rs.getTimestamp("time").toLocalDateTime();
+                        map.put(rewardID, time);
+                    }
+
+                    return map;
+                }, new LinkedHashMap<>());
+    }
+
+    public void addClaimedData(@NotNull UUID uuid, String reward) throws Exception {
+        HashMap<String, LocalDateTime> time = new HashMap<>();
+        time.put(reward, LocalDateTime.now());
+        addClaimedData(uuid, time);
+    }
+
+    public void addClaimedData(@NotNull UUID uuid, @NotNull Map<String, LocalDateTime> data) throws Exception {
+        if (!data.isEmpty()) {
+            List<Object[]> values = data.entrySet().stream()
+                    .map(entry -> new Object[]{uuid.toString(), entry.getKey(), entry.getValue()})
+                    .collect(Collectors.toList());
+            DatabaseTables.USER_CLAIMED.createReplaceBatch()
+                    .setColumnNames("uuid", "reward", "time")
+                    .setAllParams(values).execute();
+        } else {
+            DatabaseTables.USER_CLAIMED.createDelete()
+                    .addCondition("uuid", uuid).setLimit(1)
+                    .build().execute();
+        }
+    }
+
+    public void savePlayTime(@NotNull UUID uuid, @Nullable TimeRecord newRecord) throws Exception {
+        if (newRecord != null) {
+            DatabaseTables.USER_TIMES.createReplace()
+                    .setColumnNames("uuid", "date", "daily_time", "weekly_time", "monthly_time", "total_time")
+                    .setParams(
+                            uuid.toString(), newRecord.getDate(),
+                            newRecord.getDailyTime().getSeconds(),
+                            newRecord.getWeeklyTime().getSeconds(),
+                            newRecord.getMonthlyTime().getSeconds(),
+                            newRecord.getTotalTime().getSeconds()
+                    ).execute();
+        } else {
+            DatabaseTables.USER_TIMES.createDelete()
+                    .addCondition("uuid", uuid).setLimit(1)
+                    .build().execute();
+        }
+    }
+
+}
+

src/main/java/cc/carm/plugin/timereward/user/LockedRewardData.java

@@ -0,0 +1,36 @@
+package cc.carm.plugin.timereward.user;
+
+import cc.carm.plugin.timereward.data.IntervalType;
+import cc.carm.plugin.timereward.data.RewardContents;
+import cc.carm.plugin.timereward.data.TimeRecord;
+import org.jetbrains.annotations.NotNull;
+
+import java.time.Duration;
+import java.util.Collections;
+import java.util.UUID;
+
+public class LockedRewardData extends UserRewardData {
+    public LockedRewardData(@NotNull UUID userUUID) {
+        super(userUUID, TimeRecord.empty(), Collections.emptyMap());
+    }
+
+    @Override
+    public Duration getOnlineDuration(@NotNull IntervalType type) {
+        return Duration.ZERO;
+    }
+
+    @Override
+    public boolean isClaimed(@NotNull RewardContents reward) {
+        return false;
+    }
+
+    @Override
+    public boolean isTimeEnough(RewardContents reward) {
+        return false;
+    }
+
+    @Override
+    public void updateClaimed(@NotNull RewardContents reward) {
+    }
+
+}

src/main/java/cc/carm/plugin/timereward/user/UserRewardData.java

@@ -0,0 +1,84 @@
+package cc.carm.plugin.timereward.user;
+
+import cc.carm.lib.easyplugin.user.UserData;
+import cc.carm.plugin.timereward.data.IntervalType;
+import cc.carm.plugin.timereward.data.RewardContents;
+import cc.carm.plugin.timereward.data.TimeRecord;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.time.Duration;
+import java.time.LocalDateTime;
+import java.util.Map;
+import java.util.UUID;
+
+/**
+ * 用户奖励数据，用于存储用户的奖励的领取情况。
+ */
+public class UserRewardData extends UserData<UUID> {
+
+    private final @NotNull Map<String, LocalDateTime> claimedRewards; // 记录已领取的奖励ID
+
+    private final @NotNull TimeRecord recordTime;
+    private final @NotNull LocalDateTime joinTime;
+
+    public UserRewardData(@NotNull UUID userUUID, @NotNull TimeRecord timeRecord, @NotNull Map<String, LocalDateTime> claimedRewards) {
+        this(userUUID, claimedRewards, timeRecord, LocalDateTime.now());
+    }
+
+    public UserRewardData(@NotNull UUID userUUID, @NotNull Map<String, LocalDateTime> claimedRewards,
+                          @NotNull TimeRecord recordTime, @NotNull LocalDateTime joinTime) {
+        super(userUUID);
+        this.claimedRewards = claimedRewards;
+        this.recordTime = recordTime;
+        this.joinTime = joinTime;
+    }
+
+    public @NotNull UUID getUserUUID() {
+        return getKey();
+    }
+
+    /**
+     * @return 数据库中的时间记录
+     */
+    public @NotNull TimeRecord getTimeRecord() {
+        return recordTime;
+    }
+
+    /**
+     * 得到本次加入游戏的时间
+     *
+     * @return 本次加入游戏时间
+     */
+    public @NotNull LocalDateTime getJoinTime() {
+        return joinTime;
+    }
+
+    /**
+     * @return 玩家的在线时间周期，需指定周期类型{@link IntervalType}
+     */
+    public Duration getOnlineDuration(@NotNull IntervalType type) {
+        return type.calculate(getTimeRecord(), getJoinTime());
+    }
+
+    public boolean isTimeEnough(RewardContents reward) {
+        return getOnlineDuration(reward.getType()).getSeconds() >= reward.getTime();
+    }
+
+    public @NotNull Map<String, LocalDateTime> getClaimedRewards() {
+        return claimedRewards;
+    }
+
+    public @Nullable LocalDateTime getClaimedDate(@NotNull RewardContents reward) {
+        return claimedRewards.get(reward.getRewardID());
+    }
+
+    public boolean isClaimed(@NotNull RewardContents reward) {
+        return claimedRewards.containsKey(reward.getRewardID());
+    }
+
+    public void updateClaimed(@NotNull RewardContents reward) {
+        this.claimedRewards.put(reward.getRewardID(), LocalDateTime.now());
+    }
+
+}

src/main/java/cc/carm/plugin/timereward/util/DataTaskRunner.java

@@ -0,0 +1,8 @@
+package cc.carm.plugin.timereward.util;
+
+import cc.carm.plugin.timereward.storage.database.MySQLStorage;
+
+@FunctionalInterface
+public interface DataTaskRunner {
+    void run(MySQLStorage mySQLStorage) throws Exception;
+}

src/main/java/cc/carm/plugin/timereward/util/JarResourceUtils.java

@@ -1,106 +0,0 @@
-package cc.carm.plugin.timereward.util;
-
-import org.jetbrains.annotations.Nullable;
-
-import java.io.*;
-import java.net.URI;
-import java.net.URISyntaxException;
-import java.nio.charset.StandardCharsets;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.Scanner;
-import java.util.zip.ZipEntry;
-import java.util.zip.ZipInputStream;
-
-@SuppressWarnings("ResultOfMethodCallIgnored")
-public class JarResourceUtils {
-    public static final char JAR_SEPARATOR = '/';
-
-    public static @Nullable String[] readResource(@Nullable InputStream resourceStream) {
-        if (resourceStream == null) return null;
-        try (Scanner scanner = new Scanner(resourceStream, StandardCharsets.UTF_8.name())) {
-            List<String> contents = new ArrayList<>();
-            while (scanner.hasNextLine()) {
-                contents.add(scanner.nextLine());
-            }
-            return contents.toArray(new String[0]);
-        } catch (Exception e) {
-            return null;
-        }
-    }
-
-    public static void copyFolderFromJar(String folderName, File destFolder, CopyOption option)
-            throws IOException {
-        copyFolderFromJar(folderName, destFolder, option, null);
-    }
-
-    public static void copyFolderFromJar(String folderName, File destFolder,
-                                         CopyOption option, PathTrimmer trimmer) throws IOException {
-        if (!destFolder.exists())
-            destFolder.mkdirs();
-
-        byte[] buffer = new byte[1024];
-
-        File fullPath;
-        String path = JarResourceUtils.class.getProtectionDomain().getCodeSource().getLocation().getPath();
-        if (trimmer != null)
-            path = trimmer.trim(path);
-        try {
-            if (!path.startsWith("file"))
-                path = "file://" + path;
-
-            fullPath = new File(new URI(path));
-        } catch (URISyntaxException e) {
-            e.printStackTrace();
-            return;
-        }
-
-        ZipInputStream zis = new ZipInputStream(new FileInputStream(fullPath));
-
-        ZipEntry entry;
-        while ((entry = zis.getNextEntry()) != null) {
-            if (!entry.getName().startsWith(folderName + JAR_SEPARATOR))
-                continue;
-
-            String fileName = entry.getName();
-
-            if (fileName.charAt(fileName.length() - 1) == JAR_SEPARATOR) {
-                File file = new File(destFolder + File.separator + fileName);
-                if (file.isFile()) {
-                    file.delete();
-                }
-                file.mkdirs();
-                continue;
-            }
-
-            File file = new File(destFolder + File.separator + fileName);
-            if (option == CopyOption.COPY_IF_NOT_EXIST && file.exists())
-                continue;
-
-            if (!file.getParentFile().exists())
-                file.getParentFile().mkdirs();
-
-            if (!file.exists())
-                file.createNewFile();
-            FileOutputStream fos = new FileOutputStream(file);
-
-            int len;
-            while ((len = zis.read(buffer)) > 0) {
-                fos.write(buffer, 0, len);
-            }
-            fos.close();
-        }
-
-        zis.closeEntry();
-        zis.close();
-    }
-
-    public enum CopyOption {
-        COPY_IF_NOT_EXIST, REPLACE_IF_EXIST
-    }
-
-    @FunctionalInterface
-    public interface PathTrimmer {
-        String trim(String original);
-    }
-}

src/main/resources/PLUGIN_INFO

@@ -1,6 +1,5 @@
-&e _____ _               &6______                           _
+&e  _______              &6  ____                              __
-&e|_   _(_)              &6| ___ \                         | |
+&e /_  __(_)___ ___  ___ &6 / __ \___ _      ______ __________/ /
-&e  | |  _ _ __ ___   ___&6| |_/ /_____      ____ _ _ __ __| |
+&e  / / / / __ `__ \/ _ \&6/ /_/ / _ \ | /| / / __ `/ ___/ __  /
-&e  | | | | '_ ` _ \ / _ \&6    // _ \ \ /\ / / _` | '__/ _` |
+&e / / / / / / / / /  __&6/ _, _/  __/ |/ |/ / /_/ / /  / /_/ /
-&e  | | | | | | | | |  __/&6 |\ \  __/\ V  V / (_| | | | (_| |
+&e/_/ /_/_/ /_/ /_/\___/&6_/ |_|\___/|__/|__/\__,_/_/   \__,_/
-&e  \_/ |_|_| |_| |_|\___\&6_| \_\___| \_/\_/ \__,_|_|  \__,_|

src/main/resources/config.yml

@@ -1,57 +0,0 @@
-# ${project.name} - ${project.description}
-# 项目地址: ${project.url}
-# 下载地址: ${project.distributionManagement.downloadUrl}
-version: ${project.version}
-
-debug: false
-
-# 统计数据设定
-# 该选项用于帮助开发者统计插件版本与使用情况，且绝不会影响性能与使用体验。
-# 当然，您也可以选择在这里关闭，或在plugins/bStats下的配置文件中关闭。
-metrics: true
-
-# 检查更新设定
-# 该选项用于插件判断是否要检查更新，若您不希望插件检查更新并提示您，可以选择关闭。
-# 检查更新为异步操作，绝不会影响性能与使用体验。
-check-update: true
-
-
-database:
-  # 数据库驱动路径，默认为 MySQL
-  driver: "com.mysql.cj.jdbc.Driver"
-  # 数据库连接配置
-  host: "127.0.0.1"
-  port: 3306
-  database: "minecraft"
-  username: "username"
-  password: "password"
-  additional: "?useSSL=false"
-  # 插件相关表的名称
-  tables:
-    claimed: "tr_user_claimed" # 用于记录用户奖励领取情况的表
-    time: "tr_user_times" # 用于记录用户在线时间的表
-
-# 奖励相关配置
-rewards:
-
-  # 配置键名即奖励ID，支持英文、数字与下划线。
-  # 确定后请不要更改，因为该键值用于存储玩家是否领取的数据
-  # 如果更改，原先领取过该奖励的玩家将会自动再领取一次！
-  "example":
-
-    # 奖励的显示名称，可以是任意字符串
-    # 可以在commands 中使用 %(name) 来获取该奖励的名称
-    # 也可以使用变量 %TimeReward_reward_<奖励ID>% 来获取对应奖励的名称
-    name: "&f[初级奖励] &e总在线时长 2小时"
-
-    # 该奖励自动领取需要的在线时长，单位为秒
-    time: 7200
-
-    # 该奖励领取权限，可以不设置。
-    # 若为空则所有人都可以领取；若不为空，则需要拥有该权限的玩家才能领取。
-    permission: "servername.vip"
-
-    # 领取奖励时后台执行的指令
-    # 支持PlaceholderAPI变量，指令中可以使用 %(name) 来获取该奖励的名称
-    commands:
-      - "say &f恭喜 &b%player_name% &f领取了奖励 &r%(name) &f！ "

src/main/resources/messages.yml

@@ -1,5 +0,0 @@
-# ${project.name} - ${project.description}
-# 项目地址: ${project.url}
-# 下载地址: ${project.distributionManagement.downloadUrl}
-
-version: ${project.version}

src/main/resources/plugin.yml

@@ -1,26 +1,28 @@
 main: cc.carm.plugin.timereward.Main
 name: TimeReward
-
 version: ${project.version}
-description: ${project.description}
-website: ${project.url}
-
 authors:
   - CarmJos
+  - Yurinann
+website: ${project.url}
+description: ${project.description}
+
+api-version: 1.13
 
 softdepend:
   - PlaceholderAPI
 
-api-version: 1.13
-
-commands:
-  "TimeReward":
-    permission: "TimeReward.admin"
-    description: "在线自动领奖的基础指令。"
-    usage: "/TimeReward help"
-
 permissions:
-
   "TimeReward.admin":
     description: "在线自动领奖的管理员权限。"
     default: op
+  "TimeReward.claim":
+    description: "使用领奖指令的权限，若关闭则玩家不得直接通过指令领取奖励。"
+    default: true
+
+commands:
+  "TimeReward":
+    description: "在线自动领奖的基础指令。"
+    usage: "/TimeReward help"
+    aliases:
+      - tr

src/test/java/TimeTest.java

@@ -0,0 +1,57 @@
+import org.jetbrains.annotations.NotNull;
+import org.junit.Test;
+
+import java.time.DayOfWeek;
+import java.time.LocalDate;
+import java.time.temporal.TemporalField;
+import java.time.temporal.WeekFields;
+
+public class TimeTest {
+
+    LocalDate date = LocalDate.of(2023, 8, 30);
+
+    @Test
+    public void test() {
+
+        LocalDate date1 = LocalDate.of(2023, 9, 2);
+        LocalDate date2 = LocalDate.of(2023, 8, 28);
+        LocalDate date3 = LocalDate.of(2023, 8, 27);
+
+        System.out.println(isDayUpdated(date1));
+        System.out.println(isWeekUpdated(date1));
+        System.out.println(isMonthUpdated(date1));
+
+        System.out.println(isDayUpdated(date2));
+        System.out.println(isWeekUpdated(date2));
+        System.out.println(isMonthUpdated(date2));
+
+        System.out.println(isDayUpdated(date3));
+        System.out.println(isWeekUpdated(date3));
+        System.out.println(isMonthUpdated(date3));
+
+        System.out.println(isDayUpdated(date));
+
+    }
+
+    public @NotNull LocalDate getDate() {
+        return date;
+    }
+
+    public boolean isDayUpdated(LocalDate d) {
+        return !d.equals(getDate());
+    }
+
+    public boolean isWeekUpdated(LocalDate d) {
+        if (!isDayUpdated(d)) return false; // Same day always same week
+
+        TemporalField woy = WeekFields.of(DayOfWeek.MONDAY, 4).weekOfWeekBasedYear();
+        return getDate().get(woy) != d.get(woy);
+    }
+
+    public boolean isMonthUpdated(LocalDate d) {
+        if (!isDayUpdated(d)) return false; // Same day always same month
+
+        // Predicate current month is after the month of the date
+        return d.getMonth().compareTo(getDate().getMonth()) > 0;
+    }
+}