Added Scheduler Class

Author: TheRedMagic

.idea/compiler.xml

@@ -5,7 +5,7 @@
 
 UndefinedAPI is a papermc api to make the life of developers easier. This is a multi use library from small util classes to a GUI manager.
 
-# Imports
+## Imports
 
 Maven:
 ```<repositories>

README.md

@@ -1,4 +1,3 @@
-import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
 
 plugins {
     id 'java'
@@ -31,30 +30,7 @@ dependencies {
     implementation "org.reflections:reflections:0.9.11"
 }
 
-def targetJavaVersion = 17
-java {
-    def javaVersion = JavaVersion.toVersion(targetJavaVersion)
-    if (JavaVersion.current() < javaVersion) {
-        toolchain.languageVersion = JavaLanguageVersion.of(targetJavaVersion)
-    }
-}
-
-tasks.withType(JavaCompile).configureEach {
-    options.encoding = 'UTF-8'
 
-    if (targetJavaVersion >= 10 || JavaVersion.current().isJava10Compatible()) {
-        options.release.set(targetJavaVersion)
-    }
-}
-
-processResources {
-    def props = [version: version]
-    inputs.properties props
-    filteringCharset 'UTF-8'
-    filesMatching('plugin.yml') {
-        expand props
-    }
-}
 kotlin {
     jvmToolchain(17)
 }
@@ -66,3 +42,4 @@ tasks{
 }
 
 
+

build.gradle

@@ -2,6 +2,7 @@ package com.redmagic.undefinedapi
 
 import com.redmagic.undefinedapi.event.EventManager
 import com.redmagic.undefinedapi.menu.MenuManager
+import com.redmagic.undefinedapi.scheduler.repeatingTask
 import org.bukkit.Bukkit
 import org.bukkit.plugin.java.JavaPlugin
 import java.util.concurrent.TimeUnit
@@ -18,7 +19,6 @@ class UndefinedAPI(javaPlugin: JavaPlugin) {
     companion object{
         lateinit var plugin: JavaPlugin
     }
-
 }
 
 

src/main/java/com/redmagic/undefinedapi/UndefinedAPI.kt

@@ -0,0 +1,62 @@
+package com.redmagic.undefinedapi.scheduler
+
+import com.redmagic.undefinedapi.UndefinedAPI
+import org.bukkit.scheduler.BukkitRunnable
+import org.bukkit.scheduler.BukkitTask
+
+fun sync(runnable: BukkitRunnable.() -> Unit): BukkitTask = createRunnable(runnable).runTask(UndefinedAPI.plugin)
+fun async(runnable: BukkitRunnable.() -> Unit): BukkitTask = createRunnable(runnable).runTaskAsynchronously(UndefinedAPI.plugin)
+
+fun delay(ticks: Int, unit: TimeUnit = TimeUnit.TICKS, async: Boolean = false, runnable: BukkitRunnable.() -> Unit):BukkitTask{
+    return if (async){
+        createRunnable(runnable).runTaskLater(UndefinedAPI.plugin, unit.toTicks(ticks.toLong()))
+    }else{
+        createRunnable(runnable).runTaskLater(UndefinedAPI.plugin, unit.toTicks(ticks.toLong()))
+    }
+}
+
+fun delay(ticks: Int = 1, runnable: BukkitRunnable.() -> Unit): BukkitTask = delay(ticks, TimeUnit.TICKS, false, runnable)
+fun delay(ticks: Int = 1, async: Boolean, runnable: BukkitRunnable.() -> Unit): BukkitTask = delay(ticks, TimeUnit.TICKS, async, runnable)
+
+
+fun repeatingTask(delay: Int, period: Int, times: Int = -1, unit: TimeUnit = TimeUnit.TICKS, async: Boolean = false, runnable: BukkitRunnable.() -> Unit): BukkitTask{
+    return if (async){
+        createRunnable(times, runnable).runTaskTimerAsynchronously(UndefinedAPI.plugin, unit.toTicks(delay.toLong()), unit.toTicks(period.toLong()))
+    }else{
+        createRunnable(times ,runnable).runTaskTimer(UndefinedAPI.plugin, unit.toTicks(delay.toLong()), unit.toTicks(period.toLong()))
+    }
+}
+fun repeatingTask(ticks: Int = 1, runnable: BukkitRunnable.() -> Unit): BukkitTask = repeatingTask(0, ticks, -1, TimeUnit.TICKS, false, runnable)
+fun repeatingTask(ticks: Int = 1, times: Int = -1, runnable: BukkitRunnable.() -> Unit): BukkitTask = repeatingTask(0, ticks, times, TimeUnit.TICKS, false, runnable)
+fun repeatingTask(periodTicks: Int = 1, async: Boolean, runnable: BukkitRunnable.() -> Unit): BukkitTask = repeatingTask(periodTicks, periodTicks, -1, TimeUnit.TICKS, async, runnable)
+fun repeatingTask(periodTicks: Int = 1, async: Boolean, times: Int = -1, runnable: BukkitRunnable.() -> Unit): BukkitTask = repeatingTask(periodTicks, periodTicks, times, TimeUnit.TICKS, async, runnable)
+fun repeatingTask(period: Int, unit: TimeUnit, runnable: BukkitRunnable.() -> Unit): BukkitTask = repeatingTask(period, period, -1, unit, false, runnable)
+fun repeatingTask(period: Int, unit: TimeUnit, times: Int = -1, runnable: BukkitRunnable.() -> Unit): BukkitTask = repeatingTask(period, period, times, unit, false, runnable)
+fun repeatingTask(period: Int, unit: TimeUnit, async: Boolean, runnable: BukkitRunnable.() -> Unit): BukkitTask = repeatingTask(period, period, -1, unit, async, runnable)
+fun repeatingTask(period: Int, unit: TimeUnit, times: Int = -1, async: Boolean, runnable: BukkitRunnable.() -> Unit): BukkitTask = repeatingTask(period, period, times, unit, async, runnable)
+fun repeatingTask(delayTicks: Int, periodTicks: Int, async: Boolean, runnable: BukkitRunnable.() -> Unit): BukkitTask = repeatingTask(delayTicks, periodTicks, -1, TimeUnit.TICKS, async, runnable)
+fun repeatingTask(delayTicks: Int, periodTicks: Int, times: Int = -1, async: Boolean, runnable: BukkitRunnable.() -> Unit): BukkitTask = repeatingTask(delayTicks, periodTicks, times, TimeUnit.TICKS, async, runnable)
+fun repeatingTask(delay: Int, period: Int, unit: TimeUnit, runnable: BukkitRunnable.() -> Unit): BukkitTask = repeatingTask(delay, period, -1, unit, false, runnable)
+fun repeatingTask(delay: Int, period: Int, times: Int = -1, unit: TimeUnit, runnable: BukkitRunnable.() -> Unit): BukkitTask = repeatingTask(delay, period, times, unit, false, runnable)
+
+private fun createRunnable(runnable: BukkitRunnable.() -> Unit): BukkitRunnable{
+    return object : BukkitRunnable(){
+        override fun run() {
+            runnable()
+        }
+    }
+}
+
+private fun createRunnable(times: Int = -1, runnable: BukkitRunnable.() -> Unit): BukkitRunnable{
+    var amount = 0
+    return object : BukkitRunnable(){
+        override fun run() {
+            runnable()
+            if (times == -1) return
+            amount++
+            if (amount >= times) {
+                cancel()
+            }
+        }
+    }
+}

src/main/java/com/redmagic/undefinedapi/scheduler/Scheduler.kt

@@ -0,0 +1,86 @@
+package com.redmagic.undefinedapi.scheduler
+
+/**
+ * Provides an abstraction for representing various time units, including custom support for Minecraft ticks.
+ * It allows conversion between standard time units like DAYS, HOURS, MINUTES, SECONDS, and MILLISECONDS using the
+ * Java `java.util.concurrent.TimeUnit` along with custom conversions for Minecraft ticks.
+ *
+ * @author twilight
+ */
+enum class TimeUnit(private val javaTimeUnit: java.util.concurrent.TimeUnit?) {
+
+    DAYS(java.util.concurrent.TimeUnit.DAYS),
+    HOURS(java.util.concurrent.TimeUnit.HOURS),
+    MINUTES(java.util.concurrent.TimeUnit.MINUTES),
+    SECONDS(java.util.concurrent.TimeUnit.SECONDS),
+    TICKS(null),
+    MILLISECONDS(java.util.concurrent.TimeUnit.MILLISECONDS);
+
+    companion object {
+        private const val TICKS_PER_SECOND = 20
+        private const val TICKS_PER_MINUTE = TICKS_PER_SECOND * 60
+        private const val TICKS_PER_HOUR = TICKS_PER_MINUTE * 60
+        private const val TICKS_PER_DAY = TICKS_PER_HOUR * 24
+    }
+
+    /**
+     * Convert the given `duration` to days.
+     *
+     * @param duration The duration to be converted.
+     * @return The equivalent number of days.
+     */
+    fun toDays(duration: Long): Long {
+        return javaTimeUnit?.toDays(duration) ?: (duration / TICKS_PER_DAY)
+    }
+
+    /**
+     * Convert the given `duration` to hours.
+     *
+     * @param duration The duration to be converted.
+     * @return The equivalent number of hours.
+     */
+    fun toHours(duration: Long): Long {
+        return javaTimeUnit?.toHours(duration) ?: (duration / TICKS_PER_HOUR)
+    }
+
+    /**
+     * Convert the given `duration` to minutes.
+     *
+     * @param duration The duration to be converted.
+     * @return The equivalent number of minutes.
+     */
+    fun toMinutes(duration: Long): Long {
+        return javaTimeUnit?.toMinutes(duration) ?: (duration / TICKS_PER_MINUTE)
+    }
+
+    /**
+     * Convert the given `duration` to seconds.
+     *
+     * @param duration The duration to be converted.
+     * @return The equivalent number of seconds.
+     */
+    fun toSeconds(duration: Long): Long {
+        return javaTimeUnit?.toSeconds(duration) ?: (duration / TICKS_PER_SECOND)
+    }
+
+    /**
+     * Convert the given `duration` to Minecraft ticks.
+     *
+     * @param duration The duration to be converted.
+     * @return The equivalent number of Minecraft ticks.
+     */
+    fun toTicks(duration: Long): Long {
+        return (javaTimeUnit?.toMillis(duration)?.div(50)) ?: duration
+    }
+
+    /**
+     * Convert the given `duration` to milliseconds.
+     *
+     * @param duration The duration to be converted.
+     * @return The equivalent number of milliseconds.
+     */
+    fun toMillis(duration: Long): Long {
+        return javaTimeUnit?.toMillis(duration) ?: (duration * 50)
+    }
+
+}