From fe706856f5293f7d29e9ec882e21537b910ed6e1 Mon Sep 17 00:00:00 2001 From: Strokkur24 Date: Fri, 9 Jan 2026 17:37:48 +0100 Subject: [PATCH 1/5] feat: add template translations --- .../messages/MinecraftDevelopment.properties | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/src/main/resources/messages/MinecraftDevelopment.properties b/src/main/resources/messages/MinecraftDevelopment.properties index 5ea08a1ee..fa35a432b 100644 --- a/src/main/resources/messages/MinecraftDevelopment.properties +++ b/src/main/resources/messages/MinecraftDevelopment.properties @@ -109,6 +109,17 @@ creator.ui.use_fabricapi.label=Use Fabric API creator.ui.spongeapi_version.label=Sponge Version\: creator.ui.velocity_version.label=Velocity Version\: creator.ui.versions_download.label=Downloading versions... +creator.ui.use_version_catalog.label=Use Gradle version catalog\: +creator.ui.include_plugin_bootstrap.label=Include plugin bootstrap file\: +creator.ui.use_gremlin.label=Use Gremlin for dependency resolution\: +creator.ui.include_plugin_loader.label=Include plugin loader file\: +creator.ui.java_plugin_loader.label=Generate the plugin loader in Java\: +creator.ui.use_resource_factory_plugin.label=Use the resource-factory Gradle plugin\: +creator.ui.use_paperweight_userdev.label=Use the paperweight-userdev Gradle plugin\: +creator.ui.include_shadow_plugin.label=Include the shadow Gradle plugin\: +creator.ui.include_run_paper_plugin.label=Include the run-paper Gradle plugin\: +creator.ui.accept_eula.label=Add eula-agree runServer JVM flag\: +creator.ui.accept_eula.warning=By using this feature, you agree to the Minecraft EULA. creator.ui.warn.no_yarn_to_mc_match=Unable to match Yarn versions to Minecraft version creator.ui.warn.no_fabricapi_to_mc_match=Unable to match API versions to Minecraft version From f344512766ad6bead332fabdc4fddf7f126a5ca8 Mon Sep 17 00:00:00 2001 From: Strokkur24 Date: Fri, 9 Jan 2026 18:32:45 +0100 Subject: [PATCH 2/5] feat: prepare other misc changes --- ...xtractPaperApiVersionPropertyDerivation.kt | 79 +++++++++++++++++++ ...ractVersionMajorMinorPropertyDerivation.kt | 2 +- .../kotlin/creator/custom/model/StringList.kt | 3 + .../types/SemanticVersionCreatorProperty.kt | 6 ++ 4 files changed, 89 insertions(+), 1 deletion(-) create mode 100644 src/main/kotlin/creator/custom/derivation/ExtractPaperApiVersionPropertyDerivation.kt diff --git a/src/main/kotlin/creator/custom/derivation/ExtractPaperApiVersionPropertyDerivation.kt b/src/main/kotlin/creator/custom/derivation/ExtractPaperApiVersionPropertyDerivation.kt new file mode 100644 index 000000000..258b3ec07 --- /dev/null +++ b/src/main/kotlin/creator/custom/derivation/ExtractPaperApiVersionPropertyDerivation.kt @@ -0,0 +1,79 @@ +/* + * Minecraft Development for IntelliJ + * + * https://mcdev.io/ + * + * Copyright (C) 2025 minecraft-dev + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License as published + * by the Free Software Foundation, version 3.0 only. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program. If not, see . + */ + +package com.demonwav.mcdev.creator.custom.derivation + +import com.demonwav.mcdev.creator.custom.PropertyDerivation +import com.demonwav.mcdev.creator.custom.TemplateValidationReporter +import com.demonwav.mcdev.creator.custom.types.CreatorProperty +import com.demonwav.mcdev.util.SemanticVersion + +class ExtractPaperApiVersionPropertyDerivation : ExtractVersionMajorMinorPropertyDerivation() { + + override fun derive(parentValues: List): Any { + val from = parentValues[0] as SemanticVersion + if (from.parts.size < 2) { + return SemanticVersion(emptyList()) + } + + if (from.parts.size == 3) { + val (part1, part2, part3) = from.parts + if (part1 is SemanticVersion.Companion.VersionPart.ReleasePart && + part2 is SemanticVersion.Companion.VersionPart.ReleasePart && + part3 is SemanticVersion.Companion.VersionPart.ReleasePart + ) { + // From Minecraft version 1.20.5 onwards, the Paper API version also contains the 'minor' number. + if (part1.version >= 26 || (part2.version >= 21) || (part2.version == 20 && part3.version >= 5)) { + return SemanticVersion(listOf(part1, part2, part3)) + } + } + } + + val (part1, part2) = from.parts + if (part1 is SemanticVersion.Companion.VersionPart.ReleasePart && + part2 is SemanticVersion.Companion.VersionPart.ReleasePart + ) { + return SemanticVersion(listOf(part1, part2)) + } + + return SemanticVersion(emptyList()) + } + + companion object : PropertyDerivationFactory { + + override fun create( + reporter: TemplateValidationReporter, + parents: List?>?, + derivation: PropertyDerivation + ): PreparedDerivation? { + if (parents.isNullOrEmpty()) { + reporter.error("Expected a parent") + return null + } + + if (!parents[0]!!.acceptsType(SemanticVersion::class.java)) { + reporter.error("First parent must produce a semantic version") + return null + } + + return ExtractPaperApiVersionPropertyDerivation() + } + } +} diff --git a/src/main/kotlin/creator/custom/derivation/ExtractVersionMajorMinorPropertyDerivation.kt b/src/main/kotlin/creator/custom/derivation/ExtractVersionMajorMinorPropertyDerivation.kt index 6d5c3ac04..c8ef54b87 100644 --- a/src/main/kotlin/creator/custom/derivation/ExtractVersionMajorMinorPropertyDerivation.kt +++ b/src/main/kotlin/creator/custom/derivation/ExtractVersionMajorMinorPropertyDerivation.kt @@ -25,7 +25,7 @@ import com.demonwav.mcdev.creator.custom.TemplateValidationReporter import com.demonwav.mcdev.creator.custom.types.CreatorProperty import com.demonwav.mcdev.util.SemanticVersion -class ExtractVersionMajorMinorPropertyDerivation : PreparedDerivation { +open class ExtractVersionMajorMinorPropertyDerivation : PreparedDerivation { override fun derive(parentValues: List): Any? { val from = parentValues[0] as SemanticVersion diff --git a/src/main/kotlin/creator/custom/model/StringList.kt b/src/main/kotlin/creator/custom/model/StringList.kt index 95ec00df2..9256b5b84 100644 --- a/src/main/kotlin/creator/custom/model/StringList.kt +++ b/src/main/kotlin/creator/custom/model/StringList.kt @@ -28,4 +28,7 @@ data class StringList(val values: List) : List by values { @JvmOverloads fun toString(separator: String, prefix: String = "", postfix: String = ""): String = values.joinToString(separator, prefix, postfix) + + fun toStringQuoted(): String = + values.joinToString(", ", transform = { '"' + it + '"' }) } diff --git a/src/main/kotlin/creator/custom/types/SemanticVersionCreatorProperty.kt b/src/main/kotlin/creator/custom/types/SemanticVersionCreatorProperty.kt index 46dae66ef..2bf327a38 100644 --- a/src/main/kotlin/creator/custom/types/SemanticVersionCreatorProperty.kt +++ b/src/main/kotlin/creator/custom/types/SemanticVersionCreatorProperty.kt @@ -24,6 +24,7 @@ import com.demonwav.mcdev.creator.custom.CreatorContext import com.demonwav.mcdev.creator.custom.PropertyDerivation import com.demonwav.mcdev.creator.custom.TemplatePropertyDescriptor import com.demonwav.mcdev.creator.custom.TemplateValidationReporter +import com.demonwav.mcdev.creator.custom.derivation.ExtractPaperApiVersionPropertyDerivation import com.demonwav.mcdev.creator.custom.derivation.ExtractVersionMajorMinorPropertyDerivation import com.demonwav.mcdev.creator.custom.derivation.PreparedDerivation import com.demonwav.mcdev.creator.custom.derivation.SelectPropertyDerivation @@ -64,6 +65,11 @@ open class SemanticVersionCreatorProperty( ExtractVersionMajorMinorPropertyDerivation.create(reporter, parents, derives) } + "extractPaperApiVersion" -> { + val parents = collectDerivationParents(reporter) + ExtractPaperApiVersionPropertyDerivation.create(reporter, parents, derives) + } + null -> { SelectPropertyDerivation.create(reporter, emptyList(), derives) } From cdb986df23af764e96459a59e1bc4ba2c57dfa93 Mon Sep 17 00:00:00 2001 From: Strokkur24 Date: Fri, 9 Jan 2026 22:23:16 +0100 Subject: [PATCH 3/5] refactor: use MinecraftVersions field for version comparison --- ...xtractPaperApiVersionPropertyDerivation.kt | 29 ++++--------------- 1 file changed, 5 insertions(+), 24 deletions(-) diff --git a/src/main/kotlin/creator/custom/derivation/ExtractPaperApiVersionPropertyDerivation.kt b/src/main/kotlin/creator/custom/derivation/ExtractPaperApiVersionPropertyDerivation.kt index 258b3ec07..de2c57940 100644 --- a/src/main/kotlin/creator/custom/derivation/ExtractPaperApiVersionPropertyDerivation.kt +++ b/src/main/kotlin/creator/custom/derivation/ExtractPaperApiVersionPropertyDerivation.kt @@ -23,37 +23,18 @@ package com.demonwav.mcdev.creator.custom.derivation import com.demonwav.mcdev.creator.custom.PropertyDerivation import com.demonwav.mcdev.creator.custom.TemplateValidationReporter import com.demonwav.mcdev.creator.custom.types.CreatorProperty +import com.demonwav.mcdev.util.MinecraftVersions import com.demonwav.mcdev.util.SemanticVersion class ExtractPaperApiVersionPropertyDerivation : ExtractVersionMajorMinorPropertyDerivation() { - override fun derive(parentValues: List): Any { + override fun derive(parentValues: List): Any? { val from = parentValues[0] as SemanticVersion - if (from.parts.size < 2) { - return SemanticVersion(emptyList()) + if (from >= MinecraftVersions.MC1_20_5) { + return from } - if (from.parts.size == 3) { - val (part1, part2, part3) = from.parts - if (part1 is SemanticVersion.Companion.VersionPart.ReleasePart && - part2 is SemanticVersion.Companion.VersionPart.ReleasePart && - part3 is SemanticVersion.Companion.VersionPart.ReleasePart - ) { - // From Minecraft version 1.20.5 onwards, the Paper API version also contains the 'minor' number. - if (part1.version >= 26 || (part2.version >= 21) || (part2.version == 20 && part3.version >= 5)) { - return SemanticVersion(listOf(part1, part2, part3)) - } - } - } - - val (part1, part2) = from.parts - if (part1 is SemanticVersion.Companion.VersionPart.ReleasePart && - part2 is SemanticVersion.Companion.VersionPart.ReleasePart - ) { - return SemanticVersion(listOf(part1, part2)) - } - - return SemanticVersion(emptyList()) + return super.derive(parentValues); } companion object : PropertyDerivationFactory { From 60162c1058fff3103c1a82c619983fbe616a299b Mon Sep 17 00:00:00 2001 From: Strokkur24 Date: Sun, 11 Jan 2026 16:07:15 +0100 Subject: [PATCH 4/5] chore: bump to template version 2 --- src/main/kotlin/creator/custom/TemplateDescriptor.kt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/main/kotlin/creator/custom/TemplateDescriptor.kt b/src/main/kotlin/creator/custom/TemplateDescriptor.kt index 54890a8e3..5b6352cce 100644 --- a/src/main/kotlin/creator/custom/TemplateDescriptor.kt +++ b/src/main/kotlin/creator/custom/TemplateDescriptor.kt @@ -40,7 +40,7 @@ data class TemplateDescriptor( companion object { - const val FORMAT_VERSION = 1 + const val FORMAT_VERSION = 2 } } From ce5196f057c30a6a25cd4db9eba065831884f077 Mon Sep 17 00:00:00 2001 From: Strokkur24 Date: Sun, 11 Jan 2026 22:39:57 +0100 Subject: [PATCH 5/5] feat: add automatic Paper version fetching --- .editorconfig | 8 +- .../types/PaperVersionCreatorProperty.kt | 82 +++++++++++++++++++ .../custom/types/SimpleCreatorProperty.kt | 66 ++++++++------- src/main/resources/META-INF/plugin.xml | 3 + 4 files changed, 126 insertions(+), 33 deletions(-) create mode 100644 src/main/kotlin/creator/custom/types/PaperVersionCreatorProperty.kt diff --git a/.editorconfig b/.editorconfig index e8a57bf1e..66b889a6a 100644 --- a/.editorconfig +++ b/.editorconfig @@ -1,6 +1,10 @@ +root = true + [*.{kt,kts}] -max_line_length=120 -ij_kotlin_imports_layout=* +indent_size = 4 +indent_style = space +max_line_length = 120 +ij_kotlin_imports_layout = * ij_kotlin_name_count_to_use_star_import = 2147483647 ij_kotlin_name_count_to_use_star_import_for_members = 2147483647 insert_final_newline = true diff --git a/src/main/kotlin/creator/custom/types/PaperVersionCreatorProperty.kt b/src/main/kotlin/creator/custom/types/PaperVersionCreatorProperty.kt new file mode 100644 index 000000000..191a3d208 --- /dev/null +++ b/src/main/kotlin/creator/custom/types/PaperVersionCreatorProperty.kt @@ -0,0 +1,82 @@ +/* + * Minecraft Development for IntelliJ + * + * https://mcdev.io/ + * + * Copyright (C) 2025 minecraft-dev + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License as published + * by the Free Software Foundation, version 3.0 only. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program. If not, see . + */ + +package com.demonwav.mcdev.creator.custom.types + +import com.demonwav.mcdev.creator.custom.CreatorContext +import com.demonwav.mcdev.creator.custom.TemplatePropertyDescriptor +import com.demonwav.mcdev.util.MinecraftVersions +import com.demonwav.mcdev.util.SemanticVersion +import com.intellij.ui.dsl.builder.Panel +import io.ktor.client.* +import io.ktor.client.request.* +import io.ktor.client.statement.* +import io.ktor.http.* +import kotlinx.coroutines.DelicateCoroutinesApi +import kotlinx.coroutines.runBlocking +import kotlinx.serialization.json.Json +import kotlinx.serialization.json.jsonArray +import kotlinx.serialization.json.jsonObject +import kotlinx.serialization.json.jsonPrimitive + +open class PaperVersionCreatorProperty( + descriptor: TemplatePropertyDescriptor, + context: CreatorContext +) : SemanticVersionCreatorProperty(descriptor, context) { + + @OptIn(DelicateCoroutinesApi::class) + companion object { + val paperVersions: Map? = loadPaperVersions()?.associate { it to it.toString() } + + fun loadPaperVersions(): List? { + val client = HttpClient() + return runBlocking { + val response = client.get("https://fill.papermc.io/v3/projects/paper") + if (response.status.isSuccess()) { + val element = Json.parseToJsonElement(response.bodyAsText()) + return@runBlocking element.jsonObject["versions"]?.jsonObject?.values + ?.asSequence() + ?.flatMap { it.jsonArray } + ?.map { it.jsonPrimitive.content } + ?.mapNotNull { SemanticVersion.tryParse(it) } + // only release versions + ?.filter { ver -> ver.parts.all { it is SemanticVersion.Companion.VersionPart.ReleasePart } } + // nothing lower than 1.18.2 should be selectable + ?.filter { it >= MinecraftVersions.MC1_18_2 } + ?.toList() + ?.sortedDescending() + } else { + return@runBlocking null + } + } + } + } + + override fun buildUi(panel: Panel) { + super.buildDropdownMenu(panel, paperVersions) + } + + class Factory : CreatorPropertyFactory { + override fun create( + descriptor: TemplatePropertyDescriptor, + context: CreatorContext + ): CreatorProperty<*> = PaperVersionCreatorProperty(descriptor, context) + } +} diff --git a/src/main/kotlin/creator/custom/types/SimpleCreatorProperty.kt b/src/main/kotlin/creator/custom/types/SimpleCreatorProperty.kt index 5f5d2a5a7..df99c215e 100644 --- a/src/main/kotlin/creator/custom/types/SimpleCreatorProperty.kt +++ b/src/main/kotlin/creator/custom/types/SimpleCreatorProperty.kt @@ -38,7 +38,7 @@ abstract class SimpleCreatorProperty( valueType: Class ) : CreatorProperty(descriptor, context, valueType) { - private val options: Map? = makeOptionsList() + val options: Map? = makeOptionsList() private fun makeOptionsList(): Map? { val map = when (val options = descriptor.options) { @@ -78,37 +78,41 @@ abstract class SimpleCreatorProperty( override val graphProperty: GraphProperty by lazy { graph.property(defaultValue) } - override fun buildUi(panel: Panel) { - if (isDropdown) { - if (graphProperty.get() !in options!!.keys) { - graphProperty.set(defaultValue) + protected fun buildDropdownMenu(panel: Panel, options: Map?) { + if (graphProperty.get() !in options!!.keys) { + graphProperty.set(defaultValue) + } + + panel.row(descriptor.translatedLabel) { + if (descriptor.forceDropdown == true) { + comboBox(options.keys, DropdownAutoRenderer()) + .bindItem(graphProperty) + .enabled(descriptor.editable != false) + .also { + val component = it.component + ComboboxSpeedSearch.installOn(component) + val validation = + BuiltinValidations.isAnyOf(component::getSelectedItem, options.keys, component) + it.validationOnInput(validation) + it.validationOnApply(validation) + } + } else { + segmentedButton(options.keys) { text = options[it] ?: it.toString() } + .bind(graphProperty) + .enabled(descriptor.editable != false) + .maxButtonsCount(4) + .validation { + val message = MCDevBundle("creator.validation.invalid_option") + addInputRule(message) { it.selectedItem !in options.keys } + addApplyRule(message) { it.selectedItem !in options.keys } + } } + }.propertyVisibility() + } - panel.row(descriptor.translatedLabel) { - if (descriptor.forceDropdown == true) { - comboBox(options.keys, DropdownAutoRenderer()) - .bindItem(graphProperty) - .enabled(descriptor.editable != false) - .also { - val component = it.component - ComboboxSpeedSearch.installOn(component) - val validation = - BuiltinValidations.isAnyOf(component::getSelectedItem, options.keys, component) - it.validationOnInput(validation) - it.validationOnApply(validation) - } - } else { - segmentedButton(options.keys) { text = options[it] ?: it.toString() } - .bind(graphProperty) - .enabled(descriptor.editable != false) - .maxButtonsCount(4) - .validation { - val message = MCDevBundle("creator.validation.invalid_option") - addInputRule(message) { it.selectedItem !in options.keys } - addApplyRule(message) { it.selectedItem !in options.keys } - } - } - }.propertyVisibility() + override fun buildUi(panel: Panel) { + if (isDropdown) { + buildDropdownMenu(panel, options) } else { buildSimpleUi(panel) } @@ -125,7 +129,7 @@ abstract class SimpleCreatorProperty( isSelected: Boolean, cellHasFocus: Boolean ): Component { - val label = options!![value] ?: value.toString() + val label = options?.get(value) ?: value.toString() return super.getListCellRendererComponent(list, label, index, isSelected, cellHasFocus) } } diff --git a/src/main/resources/META-INF/plugin.xml b/src/main/resources/META-INF/plugin.xml index 22f3b95d5..3f20251bd 100644 --- a/src/main/resources/META-INF/plugin.xml +++ b/src/main/resources/META-INF/plugin.xml @@ -214,6 +214,9 @@ +