Force IntelliJ to "download" our sources variant, fixes #1008

Also bumps minimum required Gradle to 9.3.0-rc-1, for usage of
`AttributeContainer#named`.

Author: Jonathing

gradle/wrapper/gradle-wrapper.jar

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.0-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.3.0-rc-1-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

gradle/wrapper/gradle-wrapper.properties

@@ -35,7 +35,7 @@ dependencyResolutionManagement.versionCatalogs.register('libs') {
     // Gradle API
     // Original: https://github.com/remal-gradle-api/packages/packages/760197?version=9.0.0
     // Mirror:   https://repos.moddinglegacy.com/#/modding-legacy/name/remal/gradle-api/gradle-api/9.0.0
-    version 'gradle', '9.2.0'
+    version 'gradle', '9.3.0-rc-1'
     library 'gradle', 'name.remal.gradle-api', 'gradle-api'  versionRef 'gradle'
 
     // GradleUtils Shared Base
@@ -45,7 +45,7 @@ dependencyResolutionManagement.versionCatalogs.register('libs') {
     // https://plugins.gradle.org/plugin/net.minecraftforge.accesstransformers
     library 'accesstransformers-gradle', 'net.minecraftforge.accesstransformers', 'net.minecraftforge.accesstransformers.gradle.plugin' version '5.0.1'
 
-    library 'utils-data',     'net.minecraftforge', 'json-data-utils' version '0.4.0'  // https://files.minecraftforge.net/net/minecraftforge/json-data-utils/index.html
+    library 'utils-data',     'net.minecraftforge', 'json-data-utils' version '0.4.1'  // https://files.minecraftforge.net/net/minecraftforge/json-data-utils/index.html
     library 'utils-os',       'net.minecraftforge', 'os-utils'        version '0.1.0'  // https://files.minecraftforge.net/net/minecraftforge/os-utils/index.html
     library 'utils-hash',     'net.minecraftforge', 'hash-utils'      version '0.1.12' // https://files.minecraftforge.net/net/minecraftforge/hash-utils/index.html
     library 'utils-download', 'net.minecraftforge', 'download-utils'  version '0.4.0'  // https://files.minecraftforge.net/net/minecraftforge/download-utils/index.html

settings.gradle

@@ -25,6 +25,8 @@
 import org.gradle.api.artifacts.ExternalModuleDependency;
 import org.gradle.api.artifacts.ExternalModuleDependencyBundle;
 import org.gradle.api.artifacts.repositories.MavenArtifactRepository;
+import org.gradle.api.attributes.Category;
+import org.gradle.api.attributes.DocsType;
 import org.gradle.api.file.DirectoryProperty;
 import org.gradle.api.file.ProjectLayout;
 import org.gradle.api.flow.FlowProviders;
@@ -247,6 +249,33 @@ private void finish(Project project) {
                     if (mavenizer == null) continue;
 
                     syncMavenizer.configure(task -> task.dependsOn(mavenizer));
+
+                    var dependency = minecraftDependency.asDependency();
+                    if (dependency == null) continue;
+
+                    // See https://github.com/MinecraftForge/ForgeGradle/issues/1008#issuecomment-3623727384
+                    // Basically, if IntelliJ can't immediately find a sources JAR next to the main jar, it tries to use this scuffed task
+                    // Intercept the configuration that the task uses and replace any dependencies we have with our own
+                    project.getConfigurations().named(name -> name.startsWith("downloadArtifact_")).configureEach(configuration -> {
+                        var itor = configuration.getDependencies().iterator();
+                        while (itor.hasNext()) {
+                            var existing = itor.next();
+                            if (!Objects.equals(dependency.getGroup(), existing.getGroup())
+                                || !dependency.getName().equals(existing.getName())
+                                || !Objects.equals(dependency.getVersion(), existing.getVersion()))
+                                continue;
+
+                            itor.remove();
+                            var replacement = dependency.copy();
+                            replacement.attributes(a -> {
+                                a.attribute(Category.CATEGORY_ATTRIBUTE, a.named(Category.class, Category.DOCUMENTATION));
+                                a.attribute(DocsType.DOCS_TYPE_ATTRIBUTE, a.named(DocsType.class, DocsType.SOURCES));
+                            });
+                            configuration.withDependencies(dependencies ->
+                                dependencies.add(replacement)
+                            );
+                        }
+                    });
                 }
 
                 project.getPluginManager().withPlugin("eclipse", eclipsePlugin -> {