feat: Added useful functions

Author: CoasterFreakDE

src/main/kotlin/cc/modlabs/kpaper/extensions/BlockExtension.kt

@@ -3,6 +3,7 @@ package cc.modlabs.kpaper.extensions
 import org.bukkit.Material
 import org.bukkit.block.Barrel
 import org.bukkit.block.Block
+import org.bukkit.block.BlockFace
 import org.bukkit.block.Chest
 import org.bukkit.block.Container
 import org.bukkit.inventory.ItemStack
@@ -21,4 +22,12 @@ fun Block.getConnectedStorageContainers() = sequenceOf(
 
 fun Material.asQuantity(amount: Int): ItemStack {
     return ItemStack(this, amount)
-}
+}
+
+val BlockFace.yaw: Float
+    get() = when (this) {
+        BlockFace.EAST -> -90f
+        BlockFace.WEST -> 90f
+        BlockFace.NORTH -> 180f
+        else -> 0f
+    }

src/main/kotlin/cc/modlabs/kpaper/extensions/InventoryExtensions.kt

@@ -5,6 +5,7 @@ import cc.modlabs.kpaper.consts.NAMESPACE_ITEM_IDENTIFIER
 import cc.modlabs.kpaper.coroutines.taskRunLater
 import cc.modlabs.kpaper.inventory.ItemBuilder
 import cc.modlabs.kpaper.inventory.toItemBuilder
+import cc.modlabs.kpaper.main.PluginInstance
 import dev.fruxz.ascend.extension.isNull
 import dev.fruxz.stacked.text
 import org.bukkit.Bukkit
@@ -152,13 +153,27 @@ fun ItemStack.hasKey(namespacedKey: NamespacedKey): Boolean {
     ) == true
 }
 
+fun <T : Any> ItemStack.hasKey(namespacedKey: NamespacedKey, type: PersistentDataType<T, T>): Boolean {
+    return this.itemMeta?.persistentDataContainer?.has(
+        namespacedKey,
+        type
+    ) == true
+}
+
 fun ItemStack.getKey(namespacedKey: NamespacedKey): String? {
     return this.itemMeta?.persistentDataContainer?.get(
         namespacedKey,
         PersistentDataType.STRING
     )
 }
 
+fun <T : Any> ItemStack.getKey(namespacedKey: NamespacedKey, type: PersistentDataType<T, T>): T? {
+    return this.itemMeta?.persistentDataContainer?.get(
+        namespacedKey,
+        type
+    )
+}
+
 fun ItemStack.addCustomString(value: String): ItemStack {
     return this.toItemBuilder {
         addCustomString(value)

src/main/kotlin/cc/modlabs/kpaper/extensions/JDKExtensions.kt

@@ -1,12 +1,10 @@
 package cc.modlabs.kpaper.extensions
 
-import cc.modlabs.kpaper.main.PluginInstance
-import org.slf4j.LoggerFactory
+import cc.modlabs.kpaper.functions.getInternalKPaperLogger
+import cc.modlabs.kpaper.functions.getLogger
 
-fun getLogger(): org.slf4j.Logger {
-    return LoggerFactory.getLogger(PluginInstance::class.java)
-}
+@Deprecated("Moved into functions folder", replaceWith = ReplaceWith("getLogger()", "cc.modlabs.kpaper.functions"))
+fun getLogger(): org.slf4j.Logger = getLogger()
 
-fun getInternalKPaperLogger(): org.slf4j.Logger {
-    return LoggerFactory.getLogger("cc.modlabs.kpaper")
-}
+@Deprecated("Moved into functions folder", replaceWith = ReplaceWith("getInternalKPaperLogger()", "cc.modlabs.kpaper.functions"))
+fun getInternalKPaperLogger(): org.slf4j.Logger = getInternalKPaperLogger()

src/main/kotlin/cc/modlabs/kpaper/functions/ConsoleFunctions.kt

@@ -0,0 +1,61 @@
+package cc.modlabs.kpaper.functions
+
+const val ANSI_RESET = "\u001B[0m"
+const val ANSI_BLACK = "\u001B[30m"
+const val ANSI_RED = "\u001B[31m"
+const val ANSI_GREEN = "\u001B[32m"
+const val ANSI_YELLOW = "\u001B[33m"
+const val ANSI_BLUE = "\u001B[34m"
+const val ANSI_PURPLE = "\u001B[35m"
+const val ANSI_CYAN = "\u001B[36m"
+const val ANSI_WHITE = "\u001B[37m"
+
+
+fun printColor(text: String, color: String) {
+    print("$color$text$ANSI_RESET")
+}
+
+fun printlnColor(text: String, color: String) {
+    println("$color$text$ANSI_RESET")
+}
+
+// Quick shortcuts
+fun printlnRed(text: String) = printlnColor(text, ANSI_RED)
+fun printlnGreen(text: String) = printlnColor(text, ANSI_GREEN)
+fun printlnYellow(text: String) = printlnColor(text, ANSI_YELLOW)
+fun printlnBlue(text: String) = printlnColor(text, ANSI_BLUE)
+fun printlnCyan(text: String) = printlnColor(text, ANSI_CYAN)
+fun printlnPurple(text: String) = printlnColor(text, ANSI_PURPLE)
+
+
+// --- SECTION TITLES AND DIVIDERS ---
+
+fun sectionTitle(title: String, color: String = ANSI_CYAN) {
+    val line = "═".repeat(title.length + 4)
+    printlnColor("╔$line╗", color)
+    printlnColor("║  $title  ║", color)
+    printlnColor("╚$line╝", color)
+}
+
+fun divider(length: Int = 50, color: String = ANSI_WHITE) {
+    printlnColor("─".repeat(length), color)
+}
+
+
+// --- PROGRESS BAR ---
+
+fun progressBar(progress: Double, length: Int = 30, color: String = ANSI_GREEN) {
+    require(progress in 0.0..1.0) { "Progress must be between 0.0 and 1.0" }
+    val filled = (progress * length).toInt()
+    val bar = "█".repeat(filled) + "░".repeat(length - filled)
+    printColor("\r[$bar] ${(progress * 100).toInt()}%", color)
+    if (progress >= 1.0) println()
+}
+
+
+// --- USER INPUT (with prompt color) ---
+
+fun readLinePrompt(prompt: String, color: String = ANSI_YELLOW): String? {
+    printColor(prompt, color)
+    return readLine()
+}

src/main/kotlin/cc/modlabs/kpaper/functions/LoggerFunctions.kt

@@ -0,0 +1,13 @@
+package cc.modlabs.kpaper.functions
+
+import cc.modlabs.kpaper.main.PluginInstance
+import org.slf4j.Logger
+import org.slf4j.LoggerFactory
+
+fun getLogger(): Logger {
+    return LoggerFactory.getLogger(PluginInstance::class.java)
+}
+
+fun getInternalKPaperLogger(): Logger {
+    return LoggerFactory.getLogger("cc.modlabs.kpaper")
+}

src/main/kotlin/cc/modlabs/kpaper/functions/RandomFunctions.kt

@@ -0,0 +1,27 @@
+package cc.modlabs.kpaper.functions
+
+import kotlin.math.abs
+import kotlin.random.Random
+
+/**
+ * Returns a Random object with a seed derived from the given seed and a series of integers.
+ *
+ * @param seed the base seed used to generate the initial Random object
+ * @param ints the additional integers used to further seed the Random object
+ * @return a Random object with the seeded value
+ */
+fun getMultiSeededRandom(seed: Long, vararg ints: Int): Random {
+    var seeder = seed
+    for (num in ints) {
+        seeder = Random(seeder + num).nextLong()
+    }
+    return Random(seeder)
+}
+
+fun getRandomIntAt(x: Int, y: Int, seed: Long, max: Int): Int {
+    return abs(getMultiSeededRandom(seed, x, y).nextInt(max))
+}
+
+fun getRandomFloatAt(x: Int, y: Int, seed: Long): Float {
+    return getMultiSeededRandom(seed, x, y).nextFloat()
+}

src/main/kotlin/cc/modlabs/kpaper/inventory/ItemStackConverter.kt

@@ -1,6 +1,7 @@
 package cc.modlabs.kpaper.inventory
 
 import org.bukkit.Bukkit
+import org.bukkit.Material
 import org.bukkit.inventory.Inventory
 import org.bukkit.inventory.ItemStack
 import org.bukkit.inventory.PlayerInventory