feat(Meta): Add api-version implementation

Author: osipxd

CHANGELOG.md

@@ -37,6 +37,18 @@ bukkit {
 ```
 If `bukkit.server.version` is not specified, will be used `bukkit.apiVersion` for server.
 
+Now, BukkitGradle adds `api-version` field to `plugin.yml`.
+It will be parsed from `bukkit.apiVersion` but you can override it with `bukkit.meta.apiVersion` if need:
+```kotlin
+bukkit {
+    apiVersion = "1.16.4" // Inferred api-version is 1.16
+    
+    meta {
+        apiVersion.set("1.13") // But here you can override it
+    }
+}
+```
+
 ### Re-written in Kotlin
 The plugin has been converted to Kotlin to make support easier.
 The plugin still can be configured with Groovy DSL but
@@ -51,6 +63,7 @@ now it is friendly to Kotlin DSL.
 - Add `nogui` argument by default to `bukkitArgs`
 - Type of properties `server.jvmArgs` and `server.bukkitArgs` changed from `String` to `List<String>`.
   It makes it easier to add arguments without overriding defaults
+- Default main class pattern changed from `<groupId>.<lowercased name>.<name>` to `<groupId>.<name>` 
 
 ### Housekeeping
 - Default bukkit version now is 1.16.4

src/main/kotlin/BukkitGradlePlugin.kt

@@ -48,6 +48,7 @@ public class BukkitGradlePlugin : Plugin<Project> {
             description.convention(provider { project.description })
             main.convention(name.map { "${project.group}.${StringUtils.toPascalCase(it)}" })
             version.convention(provider { project.version.toString() })
+            apiVersion.convention(provider { StringUtils.parseApiVersion(bukkit.apiVersion) })
             url.convention(provider { findProperty("url")?.toString() })
         }
     }

src/main/kotlin/meta/extension/PluginMeta.kt

@@ -19,6 +19,10 @@ public interface PluginMeta {
     @get:Input
     public val version: Provider<String>
 
+    @get:Optional
+    @get:Input
+    public val apiVersion: Provider<String>
+
     @get:Optional
     @get:Input
     public val url: Provider<String>

src/main/kotlin/meta/extension/PluginMetaImpl.kt

@@ -15,6 +15,7 @@ public class PluginMetaImpl(objects: ObjectFactory) : PluginMeta {
     override val description: Property<String> = objects.property()
     override val main: Property<String> = objects.property()
     override val version: Property<String> = objects.property()
+    override val apiVersion: Property<String> = objects.property()
     override val url: Property<String> = objects.property()
     override val authors: ListProperty<String> = objects.listProperty()
 

src/main/kotlin/meta/task/MergePluginMeta.kt

@@ -52,6 +52,7 @@ public open class MergePluginMeta @Inject internal constructor(
             name = meta.name.get(),
             description = meta.description.orNull,
             version = meta.version.get(),
+            apiVersion = meta.apiVersion.orNull,
             website = meta.url.orNull,
             authors = meta.authors.get().takeIf { it.isNotEmpty() }
         )

src/main/kotlin/meta/task/ParsePluginMetaFile.kt

@@ -56,6 +56,7 @@ internal open class ParsePluginMetaFile @Inject constructor(
             name?.let(meta.name::convention)
             description?.let(meta.description::convention)
             version?.let(meta.version::convention)
+            apiVersion?.let(meta.apiVersion::convention)
             website?.let(meta.url::convention)
             authors?.let(meta.authors::convention)
         }

src/main/kotlin/meta/util/StringUtils.kt

@@ -8,4 +8,12 @@ internal object StringUtils {
         val camelCaseText = text.replace(Regex("[ _-]([A-Za-z0-9])")) { match -> match.groupValues[1].toUpperCase() }
         return camelCaseText.capitalize()
     }
+
+    @JvmStatic
+    fun parseApiVersion(version: String): String? {
+        val versionParts = version.split('.').mapNotNull { it.toIntOrNull() }
+        require(versionParts.size in 2..3) { "Unable to parse API version '$version'." }
+        val (major, minor) = versionParts
+        return if (major >= 1 && minor >= 13) "$major.$minor" else null
+    }
 }