Add max limit functionality to prepare world command

- Support '/prepare [count] max' syntax to limit total prepared worlds
- Smart calculation to only generate needed worlds to reach limit
- Early exit when max limit already reached
- Enhanced messaging for max limit operations

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: finreinhard

src/main/kotlin/li/angu/challengeplugin/commands/PrepareWorldCommand.kt

@@ -29,32 +29,67 @@ class PrepareWorldCommand(private val plugin: ChallengePluginPlugin) : CommandEx
             return true
         }
 
-        // Parse the count argument
+        // Parse arguments: /prepare [count] [max]
         var count = 1
+        var maxLimit: Int? = null
+        
         try {
             count = args[0].toInt()
             if (count <= 0) {
                 sender.sendMessage("${ChatColor.RED}Count must be a positive number.")
                 return true
             }
+            
+            // Check for 'max' parameter
+            if (args.size > 1 && args[1].lowercase() == "max") {
+                maxLimit = count
+                count = count - currentCount // Only generate what's needed to reach the limit
+                
+                if (count <= 0) {
+                    sender.sendMessage("${ChatColor.GREEN}Already have $currentCount worlds, which meets or exceeds the max limit of $maxLimit.")
+                    return true
+                }
+                
+                sender.sendMessage("${ChatColor.YELLOW}Will generate $count world(s) to reach max limit of $maxLimit (currently have $currentCount).")
+            }
         } catch (e: NumberFormatException) {
-            sender.sendMessage("${ChatColor.RED}Invalid number format. Usage: /prepare [count]")
+            sender.sendMessage("${ChatColor.RED}Invalid number format. Usage: /prepare [count] [max]")
             return true
         }
 
         // Start generation
-        sender.sendMessage("${ChatColor.YELLOW}Starting generation of $count world(s)...")
+        val message = if (maxLimit != null) {
+            "Starting generation of $count world(s) to reach max limit of $maxLimit..."
+        } else {
+            "Starting generation of $count world(s)..."
+        }
+        sender.sendMessage("${ChatColor.YELLOW}$message")
 
-        generateNextWorld(sender, worldManager, 0, count)
+        generateNextWorld(sender, worldManager, 0, count, maxLimit)
 
         return true
     }
 
-    private fun generateNextWorld(sender: CommandSender, worldManager: WorldPreparationManager, generated: Int, total: Int) {
+    private fun generateNextWorld(sender: CommandSender, worldManager: WorldPreparationManager, generated: Int, total: Int, maxLimit: Int? = null) {
+        // Check if we've reached the max limit before generating more
+        if (maxLimit != null) {
+            val currentCount = worldManager.countAvailableWorlds()
+            if (currentCount >= maxLimit) {
+                sender.sendMessage("${ChatColor.GREEN}Reached max limit of $maxLimit prepared worlds. Stopping generation.")
+                sender.sendMessage("${ChatColor.GREEN}Currently have $currentCount pregenerated worlds available.")
+                return
+            }
+        }
+        
         if (generated >= total) {
             // After finishing, show updated count
             val currentCount = worldManager.countAvailableWorlds()
-            sender.sendMessage("${ChatColor.GREEN}All $total worlds have been prepared successfully!")
+            val completionMessage = if (maxLimit != null) {
+                "Generated $total worlds and reached max limit of $maxLimit!"
+            } else {
+                "All $total worlds have been prepared successfully!"
+            }
+            sender.sendMessage("${ChatColor.GREEN}$completionMessage")
             sender.sendMessage("${ChatColor.GREEN}Now have $currentCount pregenerated worlds available.")
             return
         }
@@ -67,7 +102,7 @@ class PrepareWorldCommand(private val plugin: ChallengePluginPlugin) : CommandEx
                 if (success) {
                     sender.sendMessage("${ChatColor.GREEN}World $currentNum/$total generated successfully.")
                     // Generate the next world
-                    generateNextWorld(sender, worldManager, currentNum, total)
+                    generateNextWorld(sender, worldManager, currentNum, total, maxLimit)
                 } else {
                     sender.sendMessage("${ChatColor.RED}Failed to generate world $currentNum/$total. Stopping generation.")
                     // Show current count after failure

src/main/resources/plugin.yml

@@ -55,7 +55,7 @@ commands:
     permission: challengeplugin.debug
   prepare:
     description: Pre-generate worlds for challenges or show available pre-generated worlds
-    usage: /prepare [count]
+    usage: /prepare [count] [max]
     permission: challengeplugin.prepare
   pause:
     description: Pause or resume the current challenge