Keep release jars clean and use UTF-8

Remove Windows folder metadata and use UTF-8/LF for sources and Javadocs on every platform.

Author: SkyBlade1978

.gitignore

@@ -31,6 +31,8 @@ libs/*
 !/libs/README.txt
 
 .DS_Store
+[Dd]esktop.ini
+[Tt]humbs.db
 
 # Local working notes and generated validation reports
 AGENTS.md

CHANGELOG.txt

@@ -34,5 +34,7 @@
 - Connect this target to the shared release action, using one verified bundle
   for Maven, CurseForge and GitHub. Keep publication behind explicit confirmation.
 - Normalize changed text files to LF and fix the stray import whitespace.
+- Leave Windows folder metadata out of downloads and use UTF-8 for sources
+  and Javadocs on every platform.
 
 2.5.0 for 1.10.2

build.gradle

@@ -34,20 +34,23 @@ tasks.withType(Javadoc).configureEach {
     failOnError = false
     options.encoding = 'UTF-8'
     options.addStringOption('Xdoclint:none', '-quiet')
+    options.addStringOption('docencoding', 'UTF-8')
+    options.addStringOption('charset', 'UTF-8')
     options.addBooleanOption('notimestamp', true)
 }
 tasks.withType(AbstractArchiveTask).configureEach {
     preserveFileTimestamps = false
     reproducibleFileOrder = true
     includeEmptyDirs = false
+    exclude '**/desktop.ini', '**/Thumbs.db', '**/.DS_Store'
 }
 // Mapped dependency bytes no longer match their original signatures. Keep the
 // verified downloads intact and strip signatures only from renamed copies.
 tasks.withType(net.minecraftforge.renamer.gradle.RenameJar).configureEach {
     additionalArgs.addAll('--strip-sigs', 'ALL', '--disable-abstract-param')
 }
 
-def textPatterns = ['cfg', 'info', 'java', 'json', 'lang', 'mcmeta', 'md', 'properties', 'txt', 'xml']
+def textPatterns = ['cfg', 'css', 'html', 'info', 'java', 'js', 'json', 'lang', 'mcmeta', 'md', 'properties', 'txt', 'xml']
         .collect { "**/*.${it}".toString() }
 def normalizeText = { details ->
     details.filter(FixCrLfFilter, eol: FixCrLfFilter.CrLf.newInstance('lf'),
@@ -141,6 +144,7 @@ renamer.mappings.from minecraft.dependency.toSrgFile
 
 tasks.named('processResources', ProcessResources) {
     filteringCharset = 'UTF-8'
+    exclude '**/desktop.ini', '**/Thumbs.db', '**/.DS_Store'
     inputs.property 'version', project.version
     inputs.property 'mcversion', project.minecraft_version
     filesMatching('mcmod.info') { expand version: project.version, mcversion: project.minecraft_version }
@@ -158,7 +162,10 @@ tasks.named('jar', Jar) {
             'FMLCorePluginContainsFMLMod': 'true', 'FMLCorePlugin': project.coreplugin)
 }
 ['sourcesJar', 'javadocJar'].each { name ->
-    tasks.named(name, Jar) { filesMatching(textPatterns, normalizeText) }
+    tasks.named(name, Jar) {
+        filteringCharset = 'UTF-8'
+        filesMatching(textPatterns, normalizeText)
+    }
 }
 
 ext.baseMetalsBuild = [developmentOutput: developmentOutput].asImmutable()

gradle/release/artifacts.gradle

@@ -68,6 +68,7 @@ def auditJars = { File directory ->
                     if (path.startsWith('review/') || path.contains('probe') || path.contains('fixture')
                             || path.contains('agent-notes') || path.contains('agents.md') || path.contains('.codex')
                             || path.contains('.agents') || path.contains('claude') || path.contains('gemini')
+                            || path.tokenize('/').any { it in ['desktop.ini', 'thumbs.db', '.ds_store'] }
                             || path.startsWith('tools/') || path.startsWith('reference/')
                             || path.startsWith('com/mcmoddev/lib/oregen/')
                             || path.startsWith('com/mcmoddev/orespawn/')
@@ -79,6 +80,13 @@ def auditJars = { File directory ->
                     if (!entry.directory && !(date.toString() in ['1980-01-01T00:00', '1980-02-01T00:00'])) {
                         throw new GradleException("Volatile archive timestamp: ${entry.name}")
                     }
+                    if (!entry.directory && path ==~ /.*\.(java|html|css|js|json|lang|mcmeta|md|txt|xml|cfg|info|properties)/) {
+                        def decoder = java.nio.charset.StandardCharsets.UTF_8.newDecoder()
+                                .onMalformedInput(java.nio.charset.CodingErrorAction.REPORT)
+                                .onUnmappableCharacter(java.nio.charset.CodingErrorAction.REPORT)
+                        String content = decoder.decode(java.nio.ByteBuffer.wrap(zip.getInputStream(entry).bytes)).toString()
+                        if (content.contains('\r')) throw new GradleException("Non-LF text in ${entry.name}")
+                    }
                     if (!entry.directory && path ==~ /.*\.(class|java|html|json|info|xml|properties|txt|md|lang|cfg)/) {
                         String content = new String(zip.getInputStream(entry).bytes,
                                 java.nio.charset.StandardCharsets.ISO_8859_1)