feat: Add built-in localization (i18n) support

.github/workflows/check-translations.yml

@@ -0,0 +1,171 @@
+name: Check Translations
+
+on:
+  pull_request:
+    paths:
+      - 'src/main/resources/Server/Languages/**'
+
+jobs:
+  check-lang-keys:
+    name: Verify .lang keys
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check for missing translation keys
+        run: |
+          LANG_DIR="src/main/resources/Server/Languages"
+          EN_DIR="$LANG_DIR/en-US"
+          EXIT_CODE=0
+          TOTAL_MISSING=0
+
+          if [ ! -d "$EN_DIR" ]; then
+            echo "::error::No en-US directory found at $EN_DIR"
+            exit 1
+          fi
+
+          # Collect en-US keys per file
+          for en_file in "$EN_DIR"/*.lang; do
+            [ -f "$en_file" ] || continue
+            filename=$(basename "$en_file")
+
+            # Extract keys (non-blank, non-comment lines before '=')
+            en_keys=$(grep -v '^\s*#' "$en_file" | grep -v '^\s*$' | sed 's/=.*//' | sed 's/\s*$//' | sort)
+            en_count=$(echo "$en_keys" | wc -l)
+
+            # Check each locale
+            for locale_dir in "$LANG_DIR"/*/; do
+              locale=$(basename "$locale_dir")
+              [ "$locale" = "en-US" ] && continue
+
+              locale_file="$locale_dir/$filename"
+
+              if [ ! -f "$locale_file" ]; then
+                echo "::error file=$locale_file::[$locale] MISSING FILE: $filename ($en_count keys)"
+                TOTAL_MISSING=$((TOTAL_MISSING + en_count))
+                EXIT_CODE=1
+                continue
+              fi
+
+              # Extract locale keys
+              locale_keys=$(grep -v '^\s*#' "$locale_file" | grep -v '^\s*$' | sed 's/=.*//' | sed 's/\s*$//' | sort)
+
+              # Find missing keys
+              missing=$(comm -23 <(echo "$en_keys") <(echo "$locale_keys"))
+
+              if [ -n "$missing" ]; then
+                count=$(echo "$missing" | wc -l)
+                echo "::warning file=$locale_file::[$locale] $filename: $count missing key(s)"
+                echo "$missing" | while read -r key; do
+                  echo "  - $key"
+                done
+                TOTAL_MISSING=$((TOTAL_MISSING + count))
+                EXIT_CODE=1
+              fi
+
+              # Find extra keys (in locale but not in en-US)
+              extra=$(comm -13 <(echo "$en_keys") <(echo "$locale_keys"))
+              if [ -n "$extra" ]; then
+                extra_count=$(echo "$extra" | wc -l)
+                echo "::notice file=$locale_file::[$locale] $filename: $extra_count extra key(s) not in en-US"
+              fi
+            done
+          done
+
+          echo ""
+          if [ $TOTAL_MISSING -gt 0 ]; then
+            echo "::error::Total missing keys across all locales: $TOTAL_MISSING"
+          else
+            echo "All locales have complete .lang key coverage."
+          fi
+
+          exit $EXIT_CODE
+
+  check-help-files:
+    name: Verify help files
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check for missing help files
+        run: |
+          LANG_DIR="src/main/resources/Server/Languages"
+          EN_HELP="$LANG_DIR/en-US/help"
+          EXIT_CODE=0
+          TOTAL_MISSING=0
+
+          if [ ! -d "$EN_HELP" ]; then
+            echo "::error::No en-US/help directory found at $EN_HELP"
+            exit 1
+          fi
+
+          # Collect all en-US help file relative paths
+          en_files=$(cd "$EN_HELP" && find . -name "*.md" -type f | sort)
+          en_count=$(echo "$en_files" | wc -l)
+          echo "Found $en_count help files in en-US"
+
+          # Check each locale
+          for locale_dir in "$LANG_DIR"/*/; do
+            locale=$(basename "$locale_dir")
+            [ "$locale" = "en-US" ] && continue
+
+            locale_help="$locale_dir/help"
+
+            if [ ! -d "$locale_help" ]; then
+              echo "::error file=$locale_help::[$locale] MISSING help/ directory ($en_count files)"
+              TOTAL_MISSING=$((TOTAL_MISSING + en_count))
+              EXIT_CODE=1
+              continue
+            fi
+
+            # Check each en-US help file exists in locale
+            missing_files=""
+            missing_count=0
+            while IFS= read -r relpath; do
+              locale_file="$locale_help/$relpath"
+              if [ ! -f "$locale_file" ]; then
+                missing_files="$missing_files  - $relpath"$'\n'
+                missing_count=$((missing_count + 1))
+              fi
+            done <<< "$en_files"
+
+            if [ $missing_count -gt 0 ]; then
+              echo "::error file=$locale_help::[$locale] $missing_count missing help file(s)"
+              echo "$missing_files"
+              TOTAL_MISSING=$((TOTAL_MISSING + missing_count))
+              EXIT_CODE=1
+            fi
+
+            # Check for untranslated files (identical to en-US)
+            untranslated=0
+            while IFS= read -r relpath; do
+              locale_file="$locale_help/$relpath"
+              en_file="$EN_HELP/$relpath"
+              if [ -f "$locale_file" ] && cmp -s "$en_file" "$locale_file"; then
+                untranslated=$((untranslated + 1))
+              fi
+            done <<< "$en_files"
+
+            if [ $untranslated -gt 0 ]; then
+              echo "::warning file=$locale_help::[$locale] $untranslated help file(s) identical to en-US (possibly untranslated)"
+            fi
+
+            # Check for extra files not in en-US
+            if [ -d "$locale_help" ]; then
+              locale_files=$(cd "$locale_help" && find . -name "*.md" -type f | sort)
+              extra=$(comm -13 <(echo "$en_files") <(echo "$locale_files"))
+              if [ -n "$extra" ]; then
+                extra_count=$(echo "$extra" | wc -l)
+                echo "::notice file=$locale_help::[$locale] $extra_count extra help file(s) not in en-US"
+              fi
+            fi
+          done
+
+          echo ""
+          if [ $TOTAL_MISSING -gt 0 ]; then
+            echo "::error::Total missing help files across all locales: $TOTAL_MISSING"
+          else
+            echo "All locales have complete help file coverage."
+          fi
+
+          exit $EXIT_CODE

.gitignore

@@ -2,6 +2,7 @@
 .gradle/
 build/
 !gradle/wrapper/gradle-wrapper.jar
+!src/main/java/com/hyperfactions/build/
 
 # IDE
 .idea/

build.gradle

@@ -128,6 +128,85 @@ public final class BuildInfo {
     }
 }
 
+// Generate help .lang files from markdown sources
+tasks.register('generateHelpLang', JavaExec) {
+    group = 'build'
+    description = 'Generate help .lang files from markdown sources'
+    dependsOn 'compileJava'
+    classpath = sourceSets.main.compileClasspath + files(sourceSets.main.java.classesDirectory)
+    mainClass = 'com.hyperfactions.build.HelpLangGenerator'
+    args = [
+        file('src/main/resources/Server/Languages').absolutePath,
+        layout.buildDirectory.dir('generated/resources').get().asFile.absolutePath
+    ]
+    inputs.dir(file('src/main/resources/Server/Languages'))
+    outputs.dir(layout.buildDirectory.dir('generated/resources'))
+}
+
+sourceSets.main.resources.srcDir(layout.buildDirectory.dir('generated/resources'))
+
+// Check translations: compare keys in en-US against other locales
+tasks.register('checkTranslations') {
+    group = 'verification'
+    description = 'Report missing translation keys compared to en-US'
+    doLast {
+        def langDir = file('src/main/resources/Server/Languages')
+        def enDir = new File(langDir, 'en-US')
+        if (!enDir.exists()) {
+            println "No en-US directory found at ${enDir.absolutePath}"
+            return
+        }
+        // Collect en-US keys per file
+        def enKeys = [:]
+        enDir.listFiles({ f -> f.name.endsWith('.lang') } as FileFilter).each { f ->
+            def keys = []
+            f.eachLine { line ->
+                line = line.trim()
+                if (line && !line.startsWith('#') && line.contains('=')) {
+                    keys << line.substring(0, line.indexOf('=')).trim()
+                }
+            }
+            enKeys[f.name] = keys
+        }
+        // Check each locale
+        def locales = langDir.listFiles({ f -> f.isDirectory() && f.name != 'en-US' } as FileFilter)
+        if (!locales) {
+            println "No non-English locales found."
+            return
+        }
+        def totalMissing = 0
+        locales.sort { it.name }.each { localeDir ->
+            def localeMissing = 0
+            enKeys.each { fileName, keys ->
+                def localeFile = new File(localeDir, fileName)
+                if (!localeFile.exists()) {
+                    println "[${localeDir.name}] MISSING FILE: ${fileName} (${keys.size()} keys)"
+                    localeMissing += keys.size()
+                    return
+                }
+                def localeKeys = []
+                localeFile.eachLine { line ->
+                    line = line.trim()
+                    if (line && !line.startsWith('#') && line.contains('=')) {
+                        localeKeys << line.substring(0, line.indexOf('=')).trim()
+                    }
+                }
+                def missing = keys.findAll { !localeKeys.contains(it) }
+                if (missing) {
+                    println "[${localeDir.name}] ${fileName}: ${missing.size()} missing keys"
+                    missing.each { println "  - ${it}" }
+                    localeMissing += missing.size()
+                }
+            }
+            if (localeMissing == 0) {
+                println "[${localeDir.name}] All keys present"
+            }
+            totalMissing += localeMissing
+        }
+        println "\nTotal missing keys across all locales: ${totalMissing}"
+    }
+}
+
 // Expand version placeholder in manifest.json
 processResources {
     def ver = buildVersion
@@ -192,6 +271,11 @@ javadoc {
     failOnError = false
 }
 
+// Ensure help lang files are generated before processResources copies them
+tasks.named('processResources') {
+    dependsOn 'generateHelpLang'
+}
+
 // Ensure build info is generated and HyperPerms shadowJar is built before compiling
 tasks.named('compileJava') {
     dependsOn 'generateBuildInfo'