Removed ConfigUpdater import

Update Job.kt

.github/workflows/publish-release.yml

@@ -15,11 +15,11 @@ jobs:
       - name: Checkout latest code
         uses: actions/checkout@v2
 
-      - name: Set up JDK 17
+      - name: Set up JDK 21
         uses: actions/setup-java@v2
         with:
           distribution: 'temurin'
-          java-version: 17
+          java-version: 21
 
       - name: Change wrapper permissions
         run: chmod +x ./gradlew

build.gradle.kts

@@ -1,9 +1,11 @@
+import org.jetbrains.kotlin.gradle.dsl.JvmTarget
+
 plugins {
     java
     `java-library`
     `maven-publish`
-    kotlin("jvm") version "1.9.20"
-    id("com.github.johnrengelman.shadow") version "8.0.0"
+    kotlin("jvm") version "2.1.0"
+    id("com.gradleup.shadow") version "8.3.0"
     id("com.willfp.libreforge-gradle-plugin") version "1.0.0"
 }
 
@@ -25,7 +27,7 @@ allprojects {
     apply(plugin = "java")
     apply(plugin = "kotlin")
     apply(plugin = "maven-publish")
-    apply(plugin = "com.github.johnrengelman.shadow")
+    apply(plugin = "com.gradleup.shadow")
 
     repositories {
         mavenLocal()
@@ -37,14 +39,14 @@ allprojects {
     }
 
     dependencies {
-        compileOnly("com.willfp:eco:6.55.0")
+        compileOnly("com.willfp:eco:6.77.0")
         compileOnly("org.jetbrains:annotations:23.0.0")
-        compileOnly("org.jetbrains.kotlin:kotlin-stdlib:1.9.20")
+        compileOnly("org.jetbrains.kotlin:kotlin-stdlib:2.1.0")
     }
 
     java {
         withSourcesJar()
-        toolchain.languageVersion.set(JavaLanguageVersion.of(17))
+        toolchain.languageVersion.set(JavaLanguageVersion.of(21))
     }
 
     tasks {
@@ -54,8 +56,8 @@ allprojects {
         }
 
         compileKotlin {
-            kotlinOptions {
-                jvmTarget = "17"
+            compilerOptions {
+                jvmTarget.set(JvmTarget.JVM_21)
             }
         }
 

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/EcoJobsPlugin.kt

@@ -10,8 +10,10 @@ import com.willfp.ecojobs.api.getJobLevel
 import com.willfp.ecojobs.api.jobLimit
 import com.willfp.ecojobs.commands.CommandEcoJobs
 import com.willfp.ecojobs.commands.CommandJobs
+import com.willfp.ecojobs.jobs.EcoJobsJobTopPlaceholder
 import com.willfp.ecojobs.jobs.JobLevelListener
 import com.willfp.ecojobs.jobs.Jobs
+import com.willfp.ecojobs.jobs.JobsGUI
 import com.willfp.ecojobs.jobs.PriceHandler
 import com.willfp.ecojobs.jobs.ResetOnQuitListener
 import com.willfp.ecojobs.libreforge.ConditionHasActiveJob
@@ -64,6 +66,8 @@ class EcoJobsPlugin : LibreforgePlugin() {
             }
         }
 
+        EcoJobsJobTopPlaceholder(this).register()
+
         PlayerPlaceholder(
             this,
             "limit"
@@ -84,28 +88,10 @@ class EcoJobsPlugin : LibreforgePlugin() {
             }
             level.toString()
         }.register()
-
-        DynamicPlaceholder(
-            this,
-            Pattern.compile("top_[a-z]+_[0-9]+_[a-z]+")
-        ) {
-            val split = it.split("_")
-            val jobId = split.getOrNull(1) ?: return@DynamicPlaceholder "You must specify the job id!"
-            val job = Jobs.getByID(jobId) ?: return@DynamicPlaceholder "Invalid job id!"
-            val placeString = split.getOrNull(2) ?: return@DynamicPlaceholder "You must specify the place!"
-            val place = placeString.toIntOrNull() ?: return@DynamicPlaceholder "Invalid place!"
-            val type = split.getOrNull(3) ?: return@DynamicPlaceholder "You must specify the top type!"
-            val topEntry = job.getTop(place)
-            return@DynamicPlaceholder when (type) {
-                "name" -> topEntry?.player?.savedDisplayName
-                    ?: this.langYml.getFormattedString("top.name-empty")
-
-                "amount" -> topEntry?.amount?.toNiceString()
-                    ?: this.langYml.getFormattedString("top.amount-empty")
-
-                else -> "Invalid type: $type! Available types: name/amount"
     }
-        }.register()
+
+    override fun handleReload() {
+        JobsGUI.update(this)
     }
 
     override fun loadPluginCommands(): List<PluginCommand> {

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/api/EcoJobsAPI.kt

@@ -140,7 +140,7 @@ fun OfflinePlayer.resetJob(job: Job) {
 /**
  * Get the experience required to advance to the next level.
  */
-fun OfflinePlayer.getJobXPRequired(job: Job) = job.getExpForLevel(this.getJobLevel(job) + 1)
+fun OfflinePlayer.getJobXPRequired(job: Job) = job.getFormattedExpForLevel(this.getJobLevel(job) + 1)
 
 /**
  * Get progress to next level between 0 and 1, where 0 is none and 1 is complete.

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/commands/CommandJobs.kt

@@ -12,6 +12,7 @@ class CommandJobs(plugin: EcoPlugin) : PluginCommand(plugin, "jobs", "ecojobs.co
     init {
         this.addSubcommand(CommandJoin(plugin))
             .addSubcommand(CommandLeave(plugin))
+            .addSubcommand(CommandTop(plugin))
     }
 
     override fun onExecute(player: Player, args: List<String>) {

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/commands/CommandReset.kt

@@ -10,6 +10,7 @@ import com.willfp.ecojobs.api.resetJob
 import com.willfp.ecojobs.jobs.Jobs
 import org.bukkit.Bukkit
 import org.bukkit.command.CommandSender
+import org.bukkit.util.StringUtil
 
 class CommandReset(plugin: EcoPlugin) : Subcommand(plugin, "reset", "ecojobs.command.reset", false) {
     override fun onExecute(sender: CommandSender, args: List<String>) {
@@ -24,16 +25,68 @@ class CommandReset(plugin: EcoPlugin) : Subcommand(plugin, "reset", "ecojobs.com
         }
 
         val playerName = args[0]
+        val jobName = args[1]
 
+        // Reset all jobs for all players
+        if (playerName.equals("all", ignoreCase = true) && jobName.equals("all", ignoreCase = true)) {
+            Bukkit.getOnlinePlayers().forEach { player ->
+                Jobs.values().forEach { job ->
+                    if (player.hasJob(job)) {
+                        player.forceLeaveJob(job)
+                        player.resetJob(job)
+                    }
+                }
+            }
+            sender.sendMessage(plugin.langYml.getMessage("reset-all-players-all-jobs"))
+            return
+        }
+
+        // Reset a specific job for all players
+        if (playerName.equals("all", ignoreCase = true)) {
+            val job = Jobs.getByID(jobName)
+            if (job == null) {
+                sender.sendMessage(plugin.langYml.getMessage("invalid-job"))
+                return
+            }
+
+            Bukkit.getOnlinePlayers().forEach { player ->
+                if (player.hasJob(job)) {
+                    player.forceLeaveJob(job)
+                    player.resetJob(job)
+                }
+            }
+
+            sender.sendMessage(
+                plugin.langYml.getMessage("reset-all-players")
+                    .replace("%job%", job.name)
+            )
+            return
+        }
+
+        // Reset all jobs for a specific player
         val player = Bukkit.getPlayer(playerName)
-
         if (player == null) {
             sender.sendMessage(plugin.langYml.getMessage("invalid-player"))
             return
         }
 
-        val job = Jobs.getByID(args[1])
+        if (jobName.equals("all", ignoreCase = true)) {
+            Jobs.values().forEach { job ->
+                if (player.hasJob(job)) {
+                    player.forceLeaveJob(job)
+                    player.resetJob(job)
+                }
+            }
 
+            sender.sendMessage(
+                plugin.langYml.getMessage("reset-all-jobs")
+                    .replace("%player%", player.savedDisplayName)
+            )
+            return
+        }
+
+        // Reset a specific job for a specific player
+        val job = Jobs.getByID(jobName)
         if (job == null) {
             sender.sendMessage(plugin.langYml.getMessage("invalid-job"))
             return
@@ -55,12 +108,23 @@ class CommandReset(plugin: EcoPlugin) : Subcommand(plugin, "reset", "ecojobs.com
     }
 
     override fun tabComplete(sender: CommandSender, args: List<String>): List<String> {
+        val completions = mutableListOf<String>()
         if (args.size == 1) {
-            return Bukkit.getOnlinePlayers().map { it.name }
+            StringUtil.copyPartialMatches(
+                args[0],
+                listOf("all") union Bukkit.getOnlinePlayers().map { player -> player.name },
+                completions
+            )
+            return completions
         }
 
         if (args.size == 2) {
-            return Jobs.values().map { it.id }
+            StringUtil.copyPartialMatches(
+                args[1],
+                listOf("all") union Jobs.values().map { it.id },
+                completions
+            )
+            return completions
         }
 
         return emptyList()

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/commands/CommandTop.kt

@@ -0,0 +1,87 @@
+package com.willfp.ecojobs.commands
+
+import com.willfp.eco.core.EcoPlugin
+import com.willfp.eco.core.command.impl.Subcommand
+import com.willfp.eco.core.placeholder.context.placeholderContext
+import com.willfp.eco.util.formatEco
+import com.willfp.eco.util.savedDisplayName
+import com.willfp.ecojobs.jobs.Jobs
+import org.bukkit.command.CommandSender
+import org.bukkit.entity.Player
+import org.bukkit.util.StringUtil
+
+class CommandTop(plugin: EcoPlugin) : Subcommand(plugin, "top", "ecojobs.command.top", false) {
+    override fun onExecute(sender: CommandSender, args: List<String>) {
+        plugin.scheduler.runAsync {
+            val job = Jobs.getByID(args.getOrNull(0))
+
+            if (job == null) {
+                sender.sendMessage(plugin.langYml.getMessage("invalid-job"))
+                return@runAsync
+            }
+
+            val page = args.getOrNull(1)?.toIntOrNull() ?: 1
+
+            if (args.getOrNull(1)?.let { it.isNotBlank() && !it.matches("\\d+".toRegex()) } == true) {
+                sender.sendMessage(plugin.langYml.getMessage("invalid-page"))
+                return@runAsync
+            }
+
+            val offset = (page - 1) * 10
+            val positions = (offset + 1..offset + 10).toList()
+
+            val top = positions.mapNotNull { job.getTop(it) }
+
+            val messages = plugin.langYml.getStrings("top.format").toMutableList()
+            val lines = mutableListOf<String>()
+
+            top.forEachIndexed { index, entry ->
+                val line = plugin.langYml.getString("top-line-format")
+                    .replace("%rank%", (offset + index + 1).toString())
+                    .replace("%level%", entry.level.toString())
+                    .replace("%player%", entry.player.savedDisplayName)
+                lines.add(line)
+            }
+
+            val linesIndex = messages.indexOf("%lines%")
+            if (linesIndex != -1) {
+                messages.removeAt(linesIndex)
+                messages.addAll(linesIndex, lines)
+            }
+
+            messages.forEach { message ->
+                sender.sendMessage(
+                    message.formatEco(
+                        placeholderContext(
+                            player = sender as? Player
+                        )
+                    )
+                )
+            }
+        }
+    }
+
+    override fun tabComplete(sender: CommandSender, args: List<String>): List<String> {
+        val completions = mutableListOf<String>()
+
+        if (args.size == 1) {
+            StringUtil.copyPartialMatches(
+                args[0],
+                Jobs.values().map { it.id },
+                completions
+            )
+            return completions
+        }
+
+        if (args.size == 2 && Jobs.getByID(args[0]) != null) {
+            StringUtil.copyPartialMatches(
+                args[1],
+                listOf("1", "2", "3", "4", "5"),
+                completions
+            )
+            return completions
+        }
+
+        return emptyList()
+    }
+}

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/jobs/EcoJobsTopPlaceholder.kt

@@ -0,0 +1,37 @@
+package com.willfp.ecojobs.jobs
+
+import com.willfp.eco.core.EcoPlugin
+import com.willfp.eco.core.placeholder.RegistrablePlaceholder
+import com.willfp.eco.core.placeholder.context.PlaceholderContext
+import com.willfp.eco.util.savedDisplayName
+import java.util.regex.Pattern
+
+class EcoJobsJobTopPlaceholder(
+    private val plugin: EcoPlugin
+) : RegistrablePlaceholder {
+    private val pattern = Pattern.compile("top_([a-z0-9_]+)_(\\d+)_(name|level|amount)")
+
+    override fun getPattern(): Pattern = pattern
+    override fun getPlugin(): EcoPlugin = plugin
+
+    override fun getValue(params: String, ctx: PlaceholderContext): String? {
+        val emptyPosition: String = plugin.langYml.getString("top.empty-position")
+
+        val matcher = pattern.matcher(params)
+        if (!matcher.matches()) {
+            return null
+        }
+
+        val jobId = matcher.group(1)
+        val place = matcher.group(2).toIntOrNull() ?: return null
+        val type = matcher.group(3)
+
+        val job = Jobs.getByID(jobId) ?: return null
+
+        return when (type) {
+            "name" -> job.getTop(place)?.player?.savedDisplayName ?: emptyPosition
+            "level", "amount" -> job.getTop(place)?.level?.toString() ?: emptyPosition
+            else -> null
+        }
+    }
+}

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/jobs/Job.kt

@@ -9,12 +9,15 @@ import com.willfp.eco.core.items.builder.ItemStackBuilder
 import com.willfp.eco.core.placeholder.PlayerPlaceholder
 import com.willfp.eco.core.placeholder.PlayerStaticPlaceholder
 import com.willfp.eco.core.placeholder.PlayerlessPlaceholder
+import com.willfp.eco.core.placeholder.context.placeholderContext
 import com.willfp.eco.core.price.ConfiguredPrice
 import com.willfp.eco.core.price.impl.PriceEconomy
 import com.willfp.eco.core.registry.Registrable
 import com.willfp.eco.util.NumberUtils
+import com.willfp.eco.util.NumberUtils.evaluateExpression
 import com.willfp.eco.util.formatEco
 import com.willfp.eco.util.toNiceString
+import com.willfp.eco.util.toNumeral
 import com.willfp.ecojobs.EcoJobsPlugin
 import com.willfp.ecojobs.api.activeJobs
 import com.willfp.ecojobs.api.canJoinJob
@@ -24,20 +27,23 @@ import com.willfp.ecojobs.api.getJobXP
 import com.willfp.ecojobs.api.getJobXPRequired
 import com.willfp.ecojobs.api.hasJobActive
 import com.willfp.ecojobs.api.jobLimit
+import com.willfp.ecojobs.util.LeaderboardCacheEntry
+import com.willfp.ecojobs.util.LevelInjectable
 import com.willfp.libreforge.ViolationContext
 import com.willfp.libreforge.conditions.ConditionList
 import com.willfp.libreforge.conditions.Conditions
 import com.willfp.libreforge.counters.Counters
 import com.willfp.libreforge.effects.EffectList
 import com.willfp.libreforge.effects.Effects
+import com.willfp.libreforge.effects.executors.impl.NormalExecutorFactory
 import org.bukkit.Bukkit
 import org.bukkit.OfflinePlayer
+import org.bukkit.configuration.InvalidConfigurationException
 import org.bukkit.entity.Player
 import org.bukkit.inventory.ItemStack
 import java.time.Duration
 import java.util.Objects
-import java.util.concurrent.TimeUnit
-import kotlin.math.max
+import java.util.UUID
 
 class Job(
     val id: String,
@@ -49,8 +55,11 @@ class Job(
         .build<Int, LeaderboardCacheEntry?>()
 
     val name = config.getFormattedString("name")
+
     val description = config.getFormattedString("description")
+
     val isUnlockedByDefault = config.getBool("unlocked-by-default")
+
     val resetsOnQuit = config.getBool("reset-on-quit")
 
     val joinPrice = ConfiguredPrice.create(config.getSubsection("join-price")) ?: ConfiguredPrice(
@@ -71,9 +80,11 @@ class Job(
         EcoJobsPlugin.instance.namespacedKeyFactory.create("${id}_xp"), PersistentDataKeyType.DOUBLE, 0.0
     )
 
+    private val xpFormula = config.getStringOrNull("xp-formula")
+
     private val levelXpRequirements = listOf(0) + config.getInts("level-xp-requirements")
 
-    val maxLevel = levelXpRequirements.size
+    val maxLevel = config.getIntOrNull("max-level") ?: levelXpRequirements?.size ?: Int.MAX_VALUE
 
     val levelGUI = JobLevelGUI(plugin, this)
 
@@ -106,6 +117,10 @@ class Job(
     }
 
     init {
+        if (xpFormula == null && levelXpRequirements == null) {
+            throw InvalidConfigurationException("Skill $id has no requirements or xp formula")
+        }
+
         config.injectPlaceholders(PlayerStaticPlaceholder(
             "level"
         ) { p ->
@@ -122,24 +137,7 @@ class Job(
             ViolationContext(plugin, "Job $id")
         )
 
-        for (string in config.getStrings("level-commands")) {
-            val split = string.split(":")
-
-            if (split.size == 1) {
-                for (level in 1..maxLevel) {
-                    val commands = levelCommands[level] ?: mutableListOf()
-                    commands.add(string)
-                    levelCommands[level] = commands
-                }
-            } else {
-                val level = split[0].toInt()
-
-                val command = string.removePrefix("$level:")
-                val commands = levelCommands[level] ?: mutableListOf()
-                commands.add(command)
-                levelCommands[level] = commands
-            }
-        }
+        manageLevelCommands(config)
 
         PlayerPlaceholder(
             plugin, "${id}_percentage_progress"
@@ -188,8 +186,59 @@ class Job(
         ) {
             Bukkit.getOfflinePlayers().count { this in it.activeJobs }.toString()
         }.register()
+
+        PlayerPlaceholder(
+            plugin, "${id}_leaderboard_rank"
+        ) { player ->
+            val emptyPosition = plugin.langYml.getString("top.empty-position")
+            val position = getPosition(player.uniqueId)
+            position?.toString() ?: emptyPosition
+        }.register()
     }
 
+    @Deprecated("Use level-up-effects instead")
+    private fun manageLevelCommands(config: Config) {
+        if (config.getStrings("level-commands").isNotEmpty()) {
+            plugin.logger.warning("$id job: The `level-commands` key is deprecated and will be removed in future versions. Switch to `level-up-effects` instead. Refer to the wiki for more info.")
+        }
+        for (string in config.getStrings("level-commands")) {
+            val split = string.split(":")
+
+            if (split.size == 1) {
+                for (level in 1..maxLevel) {
+                    val commands = levelCommands[level] ?: mutableListOf()
+                    commands.add(string)
+                    levelCommands[level] = commands
+                }
+            } else {
+                val level = split[0].toInt()
+
+                val command = string.removePrefix("$level:")
+                val commands = levelCommands[level] ?: mutableListOf()
+                commands.add(command)
+                levelCommands[level] = commands
+            }
+        }
+    }
+
+    val levelUpEffects = Effects.compileChain(
+        config.getSubsections("level-up-effects"),
+        NormalExecutorFactory.create(),
+        ViolationContext(plugin, "Job $id level-up-effects")
+    )
+
+    val joinEffects = Effects.compileChain(
+        config.getSubsections("join-effects"),
+        NormalExecutorFactory.create(),
+        ViolationContext(plugin, "Job $id join-effects")
+    )
+
+    val leaveEffects = Effects.compileChain(
+        config.getSubsections("leave-effects"),
+        NormalExecutorFactory.create(),
+        ViolationContext(plugin, "Job $id leave-effects")
+    )
+
     override fun onRegister() {
         jobXpGains.forEach { it.bind(JobXPAccumulator(this)) }
     }
@@ -272,20 +321,31 @@ class Job(
     }
 
     fun injectPlaceholdersInto(lore: List<String>, player: Player, forceLevel: Int? = null): List<String> {
-        val withPlaceholders = lore.map {
-            it.replace("%percentage_progress%", (player.getJobProgress(this) * 100).toNiceString())
+        val withPlaceholders = lore.map { line ->
+            var result = line
+                .replace("%percentage_progress%", (player.getJobProgress(this) * 100).toNiceString())
                 .replace("%current_xp%", player.getJobXP(this).toNiceString())
-                .replace("%required_xp%", this.getExpForLevel(player.getJobLevel(this) + 1).let { req ->
-                    if (req == Int.MAX_VALUE) {
-                        plugin.langYml.getFormattedString("infinity")
-                    } else {
-                        req.toNiceString()
-                    }
-                }).replace("%description%", this.description).replace("%job%", this.name)
+                .replace("%required_xp%", this.getFormattedExpForLevel(player.getJobLevel(this) + 1))
+                .replace("%description%", this.description).replace("%job%", this.name)
                 .replace("%level%", (forceLevel ?: player.getJobLevel(this)).toString())
                 .replace("%level_numeral%", NumberUtils.toNumeral(forceLevel ?: player.getJobLevel(this)))
                 .replace("%join_price%", this.joinPrice.getDisplay(player))
                 .replace("%leave_price%", this.leavePrice.getDisplay(player))
+                .replace("%rank%", this.getPosition(player.uniqueId)?.toString() ?: plugin.langYml.getString("top.empty-position"))
+
+            val level = forceLevel ?: player.getJobLevel(this)
+            val regex = Regex("%level_(-?\\d+)(_numeral)?%")
+
+            // Handle dynamic %level_X% and %level_X_numeral%
+            result = regex.replace(result) { match ->
+                val offset = match.groupValues[1].toIntOrNull() ?: return@replace match.value
+                val isNumeral = match.groupValues[2].isNotEmpty()
+                val newLevel = level + offset
+
+                if (isNumeral) newLevel.toNumeral() else newLevel.toString()
+            }
+
+            result
         }.toMutableList()
 
         val processed = mutableListOf<List<String>>()
@@ -347,14 +407,36 @@ class Job(
         }.build()
     }
 
-    fun getExpForLevel(level: Int): Int {
+    /**
+     * Get the XP required to reach the next level, if currently at [level].
+     */
+    fun getExpForLevel(level: Int): Double {
         if (level < 1 || level > maxLevel) {
-            return Int.MAX_VALUE
+            return Double.MAX_VALUE
         }
 
-        return levelXpRequirements[level - 1]
+        if (xpFormula != null) {
+            return evaluateExpression(
+                xpFormula,
+                placeholderContext(
+                    injectable = LevelInjectable(level - 1)
+                )
+            )
         }
 
+        return levelXpRequirements[level - 1].toDouble()
+    }
+
+    fun getFormattedExpForLevel(level: Int): String {
+        val required = getExpForLevel(level)
+        return if (required.isInfinite()) {
+            plugin.langYml.getFormattedString("infinity")
+        } else {
+            required.toNiceString()
+        }
+    }
+
+    @Deprecated("Use level-up-effects instead")
     fun executeLevelCommands(player: Player, level: Int) {
         val commands = levelCommands[level] ?: emptyList()
 
@@ -371,6 +453,14 @@ class Job(
         }
     }
 
+    fun getPosition(uuid: UUID): Int? {
+        val leaderboard = Bukkit.getOfflinePlayers().sortedByDescending { it.getJobLevel(this) }
+            .map { it.uniqueId }
+
+        val index = leaderboard.indexOf(uuid)
+        return if (index == -1) null else index + 1
+    }
+
     override fun getID(): String {
         return this.id
     }
@@ -394,11 +484,6 @@ private class LevelPlaceholder(
     operator fun invoke(level: Int) = function(level)
 }
 
-data class LeaderboardCacheEntry(
-    val player: OfflinePlayer,
-    val amount: Int
-)
-
 private fun Collection<LevelPlaceholder>.format(string: String, level: Int): String {
     var process = string
     for (placeholder in this) {
@@ -408,44 +493,3 @@ private fun Collection<LevelPlaceholder>.format(string: String, level: Int): Str
 }
 
 fun OfflinePlayer.getJobLevelObject(job: Job): JobLevel = job.getLevel(this.getJobLevel(job))
-
-private val expMultiplierCache = Caffeine.newBuilder().expireAfterWrite(10, TimeUnit.SECONDS).build<Player, Double> {
-    it.cacheJobExperienceMultiplier()
-}
-
-val Player.jobExperienceMultiplier: Double
-    get() = expMultiplierCache.get(this)
-
-private fun Player.cacheJobExperienceMultiplier(): Double {
-    if (this.hasPermission("ecojobs.xpmultiplier.quadruple")) {
-        return 4.0
-    }
-
-    if (this.hasPermission("ecojobs.xpmultiplier.triple")) {
-        return 3.0
-    }
-
-    if (this.hasPermission("ecojobs.xpmultiplier.double")) {
-        return 2.0
-    }
-
-    if (this.hasPermission("ecojobs.xpmultiplier.50percent")) {
-        return 1.5
-    }
-
-    return 1 + getNumericalPermission("ecojobs.xpmultiplier", 0.0) / 100
-}
-
-fun Player.getNumericalPermission(permission: String, default: Double): Double {
-    var highest: Double? = null
-
-    for (permissionAttachmentInfo in this.effectivePermissions) {
-        val perm = permissionAttachmentInfo.permission
-        if (perm.startsWith(permission)) {
-            val found = perm.substring(perm.lastIndexOf(".") + 1).toDoubleOrNull() ?: continue
-            highest = max(highest ?: Double.MIN_VALUE, found)
-        }
-    }
-
-    return highest ?: default
-}

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/jobs/JobLevelListener.kt

@@ -1,7 +1,9 @@
 package com.willfp.ecojobs.jobs
 
+import com.willfp.eco.util.SoundUtils
 import com.willfp.ecojobs.EcoJobsPlugin
 import com.willfp.ecojobs.api.event.PlayerJobLevelUpEvent
+import com.willfp.libreforge.toDispatcher
 import org.bukkit.Sound
 import org.bukkit.event.EventHandler
 import org.bukkit.event.EventPriority
@@ -16,12 +18,14 @@ class JobLevelListener(
         val player = event.player
         val level = event.level
 
+        job.levelUpEffects?.trigger(player.toDispatcher())
         job.executeLevelCommands(player, level)
 
         if (this.plugin.configYml.getBool("level-up.sound.enabled")) {
-            val sound = Sound.valueOf(this.plugin.configYml.getString("level-up.sound.id").uppercase())
+            val sound = SoundUtils.getSound(this.plugin.configYml.getString("level-up.sound.id"))
             val pitch = this.plugin.configYml.getDouble("level-up.sound.pitch")
 
+            if (sound != null) {
                 player.playSound(
                     player.location,
                     sound,
@@ -29,6 +33,7 @@ class JobLevelListener(
                     pitch.toFloat()
                 )
             }
+        }
 
         if (this.plugin.configYml.getBool("level-up.message.enabled")) {
             for (message in job.injectPlaceholdersInto(

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/jobs/JobXPAccumulator.kt

@@ -1,9 +1,12 @@
 package com.willfp.ecojobs.jobs
 
+import com.github.benmanes.caffeine.cache.Caffeine
 import com.willfp.ecojobs.api.giveJobExperience
 import com.willfp.ecojobs.api.hasJobActive
 import com.willfp.libreforge.counters.Accumulator
 import org.bukkit.entity.Player
+import java.util.concurrent.TimeUnit
+import kotlin.math.max
 
 class JobXPAccumulator(
     private val job: Job
@@ -16,3 +19,44 @@ class JobXPAccumulator(
         player.giveJobExperience(job, count)
     }
 }
+
+private val expMultiplierCache = Caffeine.newBuilder().expireAfterWrite(10, TimeUnit.SECONDS).build<Player, Double> {
+    it.cacheJobExperienceMultiplier()
+}
+
+val Player.jobExperienceMultiplier: Double
+    get() = expMultiplierCache.get(this)
+
+private fun Player.cacheJobExperienceMultiplier(): Double {
+    if (this.hasPermission("ecojobs.xpmultiplier.quadruple")) {
+        return 4.0
+    }
+
+    if (this.hasPermission("ecojobs.xpmultiplier.triple")) {
+        return 3.0
+    }
+
+    if (this.hasPermission("ecojobs.xpmultiplier.double")) {
+        return 2.0
+    }
+
+    if (this.hasPermission("ecojobs.xpmultiplier.50percent")) {
+        return 1.5
+    }
+
+    return 1 + getNumericalPermission("ecojobs.xpmultiplier", 0.0) / 100
+}
+
+fun Player.getNumericalPermission(permission: String, default: Double): Double {
+    var highest: Double? = null
+
+    for (permissionAttachmentInfo in this.effectivePermissions) {
+        val perm = permissionAttachmentInfo.permission
+        if (perm.startsWith(permission)) {
+            val found = perm.substring(perm.lastIndexOf(".") + 1).toDoubleOrNull() ?: continue
+            highest = max(highest ?: Double.MIN_VALUE, found)
+        }
+    }
+
+    return highest ?: default
+}

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/jobs/Jobs.kt

@@ -2,7 +2,6 @@ package com.willfp.ecojobs.jobs
 
 import com.google.common.collect.ImmutableList
 import com.willfp.eco.core.config.interfaces.Config
-import com.willfp.eco.core.config.updating.ConfigUpdater
 import com.willfp.eco.core.registry.Registry
 import com.willfp.ecojobs.EcoJobsPlugin
 import com.willfp.ecojobs.api.getJobLevel
@@ -30,8 +29,8 @@ object Jobs : ConfigCategory("job", "jobs") {
      * @return The matching [Job], or null if not found.
      */
     @JvmStatic
-    fun getByID(name: String): Job? {
-        return registry[name]
+    fun getByID(name: String?): Job? {
+        return name?.let { registry[it] }
     }
 
     override fun clear(plugin: LibreforgePlugin) {

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/jobs/JobsGUI.kt

@@ -1,6 +1,5 @@
 package com.willfp.ecojobs.jobs
 
-import com.willfp.eco.core.config.updating.ConfigUpdater
 import com.willfp.eco.core.gui.menu
 import com.willfp.eco.core.gui.menu.Menu
 import com.willfp.eco.core.gui.onLeftClick
@@ -13,6 +12,7 @@ import com.willfp.eco.core.gui.slot.MaskItems
 import com.willfp.eco.core.items.Items
 import com.willfp.eco.core.items.builder.ItemStackBuilder
 import com.willfp.eco.core.items.builder.SkullBuilder
+import com.willfp.eco.util.SoundUtils
 import com.willfp.eco.util.formatEco
 import com.willfp.ecojobs.EcoJobsPlugin
 import com.willfp.ecojobs.api.activeJobs
@@ -27,16 +27,12 @@ import org.bukkit.entity.Player
 import org.bukkit.inventory.ItemStack
 import org.bukkit.inventory.meta.SkullMeta
 import kotlin.math.ceil
-import kotlin.math.max
-import kotlin.math.min
 
 object JobsGUI {
     private lateinit var menu: Menu
     private val jobAreaSlots = mutableListOf<Pair<Int, Int>>()
 
-    @JvmStatic
-    @ConfigUpdater
-    fun update(plugin: EcoJobsPlugin) {
+    internal fun update(plugin: EcoJobsPlugin) {
         val topLeftRow = plugin.configYml.getInt("gui.job-area.top-left.row")
         val topLeftColumn = plugin.configYml.getInt("gui.job-area.top-left.column")
         val bottomRightRow = plugin.configYml.getInt("gui.job-area.bottom-right.row")
@@ -150,13 +146,17 @@ object JobsGUI {
                             }
                         }
 
+                        val sound = SoundUtils.getSound(plugin.configYml.getString("gui.job-icon.click.sound"))
+
+                        if (sound != null) {
                             player.playSound(
                                 player.location,
-                            Sound.valueOf(plugin.configYml.getString("gui.job-icon.click.sound").uppercase()),
+                                sound,
                                 1f,
                                 plugin.configYml.getDouble("gui.job-icon.click.pitch").toFloat()
                             )
                         }
+                    }
 
                     onRightClick { player, _, _, menu ->
                         val page = menu.getPage(player)
@@ -170,14 +170,18 @@ object JobsGUI {
                         if (player.hasJobActive(job)) {
                             job.leaveGUI.open(player)
 
+                            val sound = SoundUtils.getSound(plugin.configYml.getString("gui.job-icon.click.sound"))
+
+                            if (sound != null) {
                                 player.playSound(
                                     player.location,
-                                Sound.valueOf(plugin.configYml.getString("gui.job-icon.click.sound").uppercase()),
+                                    sound,
                                     1f,
                                     plugin.configYml.getDouble("gui.job-icon.click.pitch").toFloat()
                                 )
                             }
                         }
+                    }
                 })
             }
 
@@ -204,12 +208,14 @@ object JobsGUI {
             )
 
             maxPages { player ->
-                ceil(Jobs.values()
+                ceil(
+                    Jobs.values()
                         .filter { player.getJobLevel(it) > 0 }
                         .size.toDouble() / jobAreaSlots.size).toInt()
             }
 
-            setSlot(plugin.configYml.getInt("gui.close.location.row"),
+            setSlot(
+                plugin.configYml.getInt("gui.close.location.row"),
                 plugin.configYml.getInt("gui.close.location.column"),
                 slot(
                     ItemStackBuilder(Items.lookup(plugin.configYml.getString("gui.close.item")))

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/jobs/PriceHandler.kt

@@ -2,6 +2,7 @@ package com.willfp.ecojobs.jobs
 
 import com.willfp.ecojobs.api.event.PlayerJobJoinEvent
 import com.willfp.ecojobs.api.event.PlayerJobLeaveEvent
+import com.willfp.libreforge.toDispatcher
 import org.bukkit.entity.Player
 import org.bukkit.event.EventHandler
 import org.bukkit.event.EventPriority
@@ -23,6 +24,7 @@ object PriceHandler : Listener {
         }
 
         price.pay(player)
+        job.joinEffects?.trigger(player.toDispatcher())
     }
 
     @EventHandler(
@@ -40,5 +42,6 @@ object PriceHandler : Listener {
         }
 
         price.pay(player)
+        job.leaveEffects?.trigger(player.toDispatcher())
     }
 }

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/util/LeaderboardCacheEntry.kt

@@ -0,0 +1,8 @@
+package com.willfp.ecojobs.util
+
+import org.bukkit.OfflinePlayer
+
+data class LeaderboardCacheEntry(
+    val player: OfflinePlayer,
+    val level: Int
+)

eco-core/core-plugin/src/main/kotlin/com/willfp/ecojobs/util/LevelInjectable.kt

@@ -0,0 +1,27 @@
+package com.willfp.ecojobs.util
+
+import com.willfp.eco.core.placeholder.InjectablePlaceholder
+import com.willfp.eco.core.placeholder.PlaceholderInjectable
+import com.willfp.eco.core.placeholder.StaticPlaceholder
+
+class LevelInjectable(
+    level: Int
+) : PlaceholderInjectable {
+    private val placeholders = listOf(
+        StaticPlaceholder(
+            "level"
+        ) { level.toString() }
+    )
+
+    override fun getPlaceholderInjections(): List<InjectablePlaceholder> {
+        return placeholders
+    }
+
+    override fun addInjectablePlaceholder(p0: Iterable<InjectablePlaceholder>) {
+        return
+    }
+
+    override fun clearInjectedPlaceholders() {
+        return
+    }
+}

eco-core/core-plugin/src/main/resources/jobs/_example.yml

@@ -27,6 +27,13 @@ join-price:
 # Reference with %join_lore%
 join-lore: []
 
+# A list of effects to run when the player joins the job.
+# Read https://plugins.auxilor.io/effects/configuring-an-effect
+join-effects:
+  - id: broadcast
+    args:
+      message: "&8» &a%player% &8joined the &6Miner &8job!"
+
 # The price to leave this job (set to 0 to disable)
 # Read here for more: https://plugins.auxilor.io/all-plugins/prices
 leave-price:
@@ -39,7 +46,22 @@ leave-price:
 leave-lore:
   - " &8» This will cost %leave_price%"
 
-# The xp requirements for each job level - add new levels by adding more to this list
+# A list of effects to run when the player leaves the job.
+# Read https://plugins.auxilor.io/effects/configuring-an-effect
+leave-effects:
+  - id: send_message
+    args:
+      message: "&8» &8You left the &6Miner &8job!"
+
+# There are two ways to specify level XP requirements:
+#  1. A formula to calculate for infinite levels
+#  2. A list of XP requirements for each level
+
+# Formula
+# xp-formula: (2 ^ %level%) * 25
+# max-level: 100 # The max level of the job
+
+# List
 level-xp-requirements:
   - 100
   - 120
@@ -133,10 +155,13 @@ level-up-messages:
   1:
     - "&8» &8Earn &a$%money%&8 for each &a%blocks%&8 blocks mined"
 
-# Commands to be sent on levelup, can be formatted two ways:
-# level:command (e.g. 10:eco give %player% 1000), which would execute that command for level 10
-# command (e.g. eco give %player% 5000), which would execute that command for all levels
-level-commands: [ ]
+# Effects to run when the skill levels up
+# %level% is the level the skill leveled up to.
+# If you want to restrict this to certain levels, you can use
+# require: %level% = 20, or require: %level% < 50, etc.
+# If you want a reward to run every x levels, you can use
+# every: 1, or every: 12, etc
+level-up-effects: [ ]
 
 # The effects for the job, has %level% as a placeholder
 effects:

eco-core/core-plugin/src/main/resources/jobs/beekeeper.yml

@@ -10,6 +10,8 @@ join-price:
   type: coins
   display: "&a$%value%"
 
+join-effects: []
+
 join-lore: []
 
 leave-price:
@@ -17,6 +19,8 @@ leave-price:
   type: coins
   display: "&a$%value%"
 
+leave-effects: []
+
 leave-lore:
   - ""
 
@@ -95,7 +99,7 @@ level-up-messages:
   1:
     - "&8» &8Earn &a$%money%&8 for each bee you breed"
 
-level-commands: [ ]
+level-up-effects: [ ]
 
 effects:
   - id: give_money

eco-core/core-plugin/src/main/resources/jobs/builder.yml

@@ -10,6 +10,8 @@ join-price:
   type: coins
   display: "&a$%value%"
 
+join-effects: []
+
 join-lore: []
 
 leave-price:
@@ -17,6 +19,8 @@ leave-price:
   type: coins
   display: "&a$%value%"
 
+leave-effects: []
+
 leave-lore:
   - ""
 
@@ -94,7 +98,7 @@ level-up-messages:
   1:
     - "&8» &8Earn &a$%money%&8 for each &a%blocks%&8 blocks placed"
 
-level-commands: [ ]
+level-up-effects: [ ]
 
 effects:
   - id: give_money

eco-core/core-plugin/src/main/resources/jobs/enchanter.yml

@@ -10,6 +10,8 @@ join-price:
   type: coins
   display: "&a$%value%"
 
+join-effects: []
+
 join-lore: []
 
 leave-price:
@@ -17,6 +19,8 @@ leave-price:
   type: coins
   display: "&a$%value%"
 
+leave-effects: []
+
 leave-lore:
   - ""
 
@@ -92,7 +96,7 @@ level-up-messages:
   1:
     - "&8» &8Earn &a$%money%&8 for each enchanted item"
 
-level-commands: [ ]
+level-up-effects: [ ]
 
 effects:
   - id: give_money

eco-core/core-plugin/src/main/resources/jobs/farmer.yml

@@ -10,6 +10,8 @@ join-price:
   type: coins
   display: "&a$%value%"
 
+join-effects: []
+
 join-lore: []
 
 leave-price:
@@ -17,6 +19,8 @@ leave-price:
   type: coins
   display: "&a$%value%"
 
+leave-effects: []
+
 leave-lore:
   - ""
 
@@ -107,7 +111,7 @@ level-up-messages:
   1:
     - "&8» &8Earn &a$%money%&8 for each crop farmed"
 
-level-commands: [ ]
+level-up-effects: [ ]
 
 effects:
   - id: give_money

eco-core/core-plugin/src/main/resources/jobs/fisherman.yml

@@ -10,6 +10,8 @@ join-price:
   type: coins
   display: "&a$%value%"
 
+join-effects: []
+
 join-lore: []
 
 leave-price:
@@ -17,6 +19,8 @@ leave-price:
   type: coins
   display: "&a$%value%"
 
+leave-effects: []
+
 leave-lore:
   - ""
 
@@ -92,7 +96,7 @@ level-up-messages:
   1:
     - "&8» &8Earn &a$%money%&8 for each fish caught"
 
-level-commands: [ ]
+level-up-effects: [ ]
 
 effects:
   - id: give_money

eco-core/core-plugin/src/main/resources/jobs/lumberjack.yml

@@ -10,6 +10,8 @@ join-price:
   type: coins
   display: "&a$%value%"
 
+join-effects: []
+
 join-lore: []
 
 leave-price:
@@ -17,6 +19,8 @@ leave-price:
   type: coins
   display: "&a$%value%"
 
+leave-effects: []
+
 leave-lore:
   - ""
 
@@ -104,7 +108,7 @@ level-up-messages:
   1:
     - "&8» &7Earn &a$%money%&7 for each log chopped."
 
-level-commands: [ ]
+level-up-effects: [ ]
 
 effects:
   - id: give_money

eco-core/core-plugin/src/main/resources/jobs/miner.yml

@@ -10,6 +10,8 @@ join-price:
   type: coins
   display: "&a$%value%"
 
+join-effects: []
+
 join-lore: []
 
 leave-price:
@@ -17,6 +19,8 @@ leave-price:
   type: coins
   display: "&a$%value%"
 
+leave-effects: []
+
 leave-lore:
   - ""
 
@@ -74,8 +78,10 @@ level-xp-requirements:
 xp-gain-methods:
   - trigger: mine_block
     multiplier: 0.5
-    conditions: [ ]
-    filters:
+    filters: [ ]
+    conditions:
+      - id: in_mainhand
+        args:
           items:
             - "*wooden_pickaxe"
             - "*stone_pickaxe"
@@ -102,14 +108,16 @@ level-up-messages:
   1:
     - "&8» &8Earn &a$%money%&8 for each &a%blocks%&8 blocks mined"
 
-level-commands: [ ]
+level-up-effects: [ ]
 
 effects:
   - id: give_money
     args:
       every: "ceil(10 - %level% / 10)"
       amount: "0.4 * %level%"
-    filters:
+    conditions:
+      - id: in_mainhand
+        args:
           items:
             - "*wooden_pickaxe"
             - "*stone_pickaxe"

eco-core/core-plugin/src/main/resources/jobs/slayer.yml

@@ -10,6 +10,8 @@ join-price:
   type: coins
   display: "&a$%value%"
 
+join-effects: []
+
 join-lore: []
 
 leave-price:
@@ -17,6 +19,8 @@ leave-price:
   type: coins
   display: "&a$%value%"
 
+leave-effects: []
+
 leave-lore:
   - ""
 
@@ -95,7 +99,7 @@ level-up-messages:
     - "&8» &8Earn &a$%money%&8 per heart of health that"
     - "  &8mobs you kill have"
 
-level-commands: [ ]
+level-up-effects: [ ]
 
 effects:
   - id: give_money

eco-core/core-plugin/src/main/resources/jobs/smelter.yml

@@ -10,6 +10,8 @@ join-price:
   type: coins
   display: "&a$%value%"
 
+join-effects: []
+
 join-lore: []
 
 leave-price:
@@ -17,6 +19,8 @@ leave-price:
   type: coins
   display: "&a$%value%"
 
+leave-effects: []
+
 leave-lore:
   - ""
 
@@ -92,7 +96,7 @@ level-up-messages:
   1:
     - "&8» &8Earn &a$%money%&8 for each smelted item"
 
-level-commands: [ ]
+level-up-effects: [ ]
 
 effects:
   - id: give_money

eco-core/core-plugin/src/main/resources/jobs/toolsmith.yml

@@ -18,6 +18,8 @@ join-price:
   type: coins
   display: "&a$%value%"
 
+join-effects: []
+
 join-lore: []
 
 leave-price:
@@ -25,6 +27,8 @@ leave-price:
   type: coins
   display: "&a$%value%"
 
+leave-effects: []
+
 leave-lore:
   - ""
 
@@ -133,7 +137,7 @@ level-up-messages:
   1:
     - "&8» &8Earn &a$%money%&8 for each tool crafted"
 
-level-commands: [ ]
+level-up-effects: [ ]
 
 effects:
   - id: give_money

eco-core/core-plugin/src/main/resources/lang.yml

@@ -8,6 +8,9 @@ messages:
   needs-player: "&cYou must specify a player!"
   gave-xp: "&fYou have given &a%xp% &fXP to %player%&f's %job%&f!"
   reset-xp: "&fYou have reset %player%&f's %job%&f XP!"
+  reset-all-players: "&fYou have reset all players' %job%&f XP!"
+  reset-all-jobs: "&fYou have reset %player%&f's XP for all jobs!"
+  reset-all-players-all-jobs: "&fYou have reset all players' XP for all jobs!"
   needs-job: "&cYou must specify a job!"
   need-amount: "&cYou must specify a amount!"
   invalid-player: "&cInvalid player!"
@@ -31,6 +34,9 @@ menu:
 
 infinity: "∞"
 
+top-line-format: "%rank%. %player% - %level%"
 top:
-  name-empty: "&cEmpty"
-  amount-empty: "0"
+  empty-position: "&cN/A"
+  format:
+    - "---- Jobs Leaderboard ----"
+    - "%lines%"

gradle.properties

@@ -1,5 +1,5 @@
 #libreforge-updater
-#Mon Jan 01 20:02:16 GMT 2024
+#Mon Oct 06 08:56:29 BST 2025
 kotlin.code.style=official
-libreforge-version=4.52.0
-version=3.50.2
+libreforge-version=4.79.0
+version=3.77.2

gradle/wrapper/gradle-wrapper.properties

@@ -1,5 +1,7 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.0.2-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

jitpack.yml

@@ -1,6 +0,0 @@
-jdk: openjdk17
-before_install:
-  - source "$HOME/.sdkman/bin/sdkman-init.sh"
-  - sdk update
-  - sdk install java 17.0.1-tem
-  - sdk use java 17.0.1-tem

settings.gradle.kts

@@ -2,11 +2,15 @@ pluginManagement {
     repositories {
         gradlePluginPortal()
         mavenLocal()
-        maven("https://repo.jpenilla.xyz/snapshots/")
         maven("https://repo.auxilor.io/repository/maven-public/")
+        maven("https://repo.papermc.io/repository/maven-public/")
     }
 }
 
+plugins {
+    id("org.gradle.toolchains.foojay-resolver-convention") version "0.8.0"
+}
+
 rootProject.name = "EcoJobs"
 
 // Core