Add wiki v2 documentation metadata

Author: Exanthiax

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

@@ -2,6 +2,7 @@ package com.willfp.ecojobs.libreforge
 
 import com.willfp.eco.core.config.interfaces.Config
 import com.willfp.ecojobs.api.activeJobs
+import com.willfp.libreforge.ArgType
 import com.willfp.libreforge.Dispatcher
 import com.willfp.libreforge.NoCompileData
 import com.willfp.libreforge.ProvidedHolder
@@ -11,8 +12,17 @@ import com.willfp.libreforge.get
 import org.bukkit.entity.Player
 
 object ConditionHasActiveJob : Condition<NoCompileData>("has_active_job") {
+    override val description = "Passes when the player has joined the specified job."
+
+    override val categories = setOf("player")
+
     override val arguments = arguments {
-        require("job", "You must specify the job!")
+        require(
+            "job",
+            "You must specify the job!",
+            description = "The id of the job the player must have joined.",
+            type = ArgType.STRING
+        )
     }
 
     override fun isMet(

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

@@ -4,6 +4,7 @@ import com.willfp.eco.core.config.interfaces.Config
 import com.willfp.ecojobs.api.event.PlayerJobLevelUpEvent
 import com.willfp.ecojobs.api.getJobLevel
 import com.willfp.ecojobs.jobs.Jobs
+import com.willfp.libreforge.ArgType
 import com.willfp.libreforge.Dispatcher
 import com.willfp.libreforge.NoCompileData
 import com.willfp.libreforge.ProvidedHolder
@@ -17,9 +18,23 @@ import org.bukkit.event.EventHandler
 import org.bukkit.event.EventPriority
 
 object ConditionHasJobLevel : Condition<NoCompileData>("has_job_level") {
+    override val description = "Passes when the player's level in the specified job is at or above the given level."
+
+    override val categories = setOf("player")
+
     override val arguments = arguments {
-        require("job", "You must specify the job!")
-        require("level", "You must specify the level!")
+        require(
+            "job",
+            "You must specify the job!",
+            description = "The id of the job to check the player's level in.",
+            type = ArgType.STRING
+        )
+        require(
+            "level",
+            "You must specify the level!",
+            description = "The minimum level required in the job. Supports expressions.",
+            type = ArgType.EXPRESSION
+        )
     }
 
     override fun isMet(

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

@@ -3,20 +3,35 @@ package com.willfp.ecojobs.libreforge
 import com.willfp.eco.core.config.interfaces.Config
 import com.willfp.ecojobs.api.giveJobExperience
 import com.willfp.ecojobs.jobs.Jobs
+import com.willfp.libreforge.ArgType
 import com.willfp.libreforge.NoCompileData
 import com.willfp.libreforge.arguments
 import com.willfp.libreforge.effects.Effect
 import com.willfp.libreforge.triggers.TriggerData
 import com.willfp.libreforge.triggers.TriggerParameter
 
 object EffectGiveJobXp : Effect<NoCompileData>("give_job_xp") {
+    override val description = "Gives the player experience in the specified job."
+
+    override val categories = setOf("economy", "player")
+
     override val parameters = setOf(
         TriggerParameter.PLAYER
     )
 
     override val arguments = arguments {
-        require("amount", "You must specify the amount of xp to give!")
-        require("job", "You must specify the job to give xp for!")
+        require(
+            "amount",
+            "You must specify the amount of xp to give!",
+            description = "The amount of job experience to give to the player. Supports expressions.",
+            type = ArgType.EXPRESSION
+        )
+        require(
+            "job",
+            "You must specify the job to give xp for!",
+            description = "The id of the job to give experience for.",
+            type = ArgType.STRING
+        )
     }
 
     override fun onTrigger(config: Config, data: TriggerData, compileData: NoCompileData): Boolean {

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

@@ -2,11 +2,22 @@ package com.willfp.ecojobs.libreforge
 
 import com.willfp.eco.core.config.interfaces.Config
 import com.willfp.ecojobs.api.event.JobEvent
+import com.willfp.libreforge.ArgType
 import com.willfp.libreforge.NoCompileData
 import com.willfp.libreforge.filters.Filter
 import com.willfp.libreforge.triggers.TriggerData
 
 object FilterJob : Filter<NoCompileData, Collection<String>>("job") {
+    override val description = "Matches when the job involved in the triggering event is one of the given job ids."
+
+    override val categories = setOf("player")
+
+    override val valueType = ArgType.STRING_LIST
+
+    override val additionalInfo = listOf(
+        "Passes automatically when the trigger event is not related to a job."
+    )
+
     override fun getValue(config: Config, data: TriggerData?, key: String): Collection<String> {
         return config.getStrings(key)
     }

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

@@ -8,6 +8,10 @@ import com.willfp.libreforge.triggers.TriggerParameter
 import org.bukkit.event.EventHandler
 
 object TriggerGainJobXp : Trigger("gain_job_xp") {
+    override val description = "Fires when the player gains experience in a job."
+
+    override val categories = setOf("economy", "player")
+
     override val parameters = setOf(
         TriggerParameter.PLAYER,
         TriggerParameter.LOCATION,

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

@@ -10,6 +10,10 @@ import org.bukkit.entity.Player
 import org.bukkit.event.EventHandler
 
 object TriggerJoinJob : Trigger("join_job") {
+    override val description = "Fires when the player joins a job."
+
+    override val categories = setOf("player")
+
     override val parameters = setOf(
         TriggerParameter.PLAYER,
         TriggerParameter.LOCATION,

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

@@ -10,6 +10,10 @@ import org.bukkit.entity.Player
 import org.bukkit.event.EventHandler
 
 object TriggerLeaveJob : Trigger("leave_job") {
+    override val description = "Fires when the player leaves a job."
+
+    override val categories = setOf("player")
+
     override val parameters = setOf(
         TriggerParameter.PLAYER,
         TriggerParameter.LOCATION,

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

@@ -8,6 +8,10 @@ import com.willfp.libreforge.triggers.TriggerParameter
 import org.bukkit.event.EventHandler
 
 object TriggerLevelUpJob : Trigger("level_up_job") {
+    override val description = "Fires when the player levels up in a job."
+
+    override val categories = setOf("player")
+
     override val parameters = setOf(
         TriggerParameter.PLAYER,
         TriggerParameter.LOCATION,