feat(i18n): add startup validation for missing translation keys

HypixelTranslator now eagerly loads all en_US keys at construction.
I18n.requireKey() throws IllegalStateException if a key is missing
from the default locale. All I18n.t(), string(), and dialogueLines()
methods validate keys on use, failing fast at startup if any
referenced key is absent from the English translation files.

Author: Swofty-Developments

loader/src/main/java/net/swofty/loader/Hypixel.java

@@ -34,6 +34,7 @@
 import net.swofty.type.generic.RavengardTypeLoader;
 import net.swofty.type.generic.SkyBlockTypeLoader;
 import net.swofty.type.generic.i18n.HypixelTranslator;
+import net.swofty.type.generic.i18n.I18n;
 import net.swofty.type.ravengardgeneric.RavengardGenericLoader;
 import net.swofty.type.skyblockgeneric.SkyBlockGenericLoader;
 import org.json.JSONArray;
@@ -190,7 +191,9 @@ static void main(String[] args) {
 
         MinestomAdventure.AUTOMATIC_COMPONENT_TRANSLATION = true;
         HypixelTranslator translator = new HypixelTranslator();
+        I18n.init(translator);
         GlobalTranslator.translator().addSource(translator);
+        Logger.info("Loaded " + translator.keyCount() + " translation keys for default locale");
 
         // Start the server
         MinecraftServer.setBrandName("Hypixel");

type.generic/src/main/java/net/swofty/type/generic/i18n/HypixelTranslator.java

@@ -18,24 +18,28 @@
 import java.nio.file.Path;
 import java.time.Duration;
 import java.util.HashMap;
+import java.util.HashSet;
 import java.util.Locale;
 import java.util.Map;
 import java.util.Objects;
 import java.util.Optional;
+import java.util.Set;
 
 public class HypixelTranslator extends MiniMessageTranslator {
 
     public static final Locale defaultLocale = Locale.US;
     private static final Path I18N_ROOT = Path.of("./configuration/i18n");
 
     private final Map<Locale, Map<String, Path>> fileIndexByLocale;
+    private final Set<String> defaultLocaleKeys;
     private final Cache<LocaleSubsystem, Map<String, String>> bundleCache;
     private final Cache<LocaleKey, Optional<String>> keyCache;
 
     public HypixelTranslator() {
         super(MiniMessage.miniMessage());
 
         this.fileIndexByLocale = buildFileIndex(I18N_ROOT);
+        this.defaultLocaleKeys = loadAllKeysForLocale(defaultLocale);
 
         this.bundleCache = Caffeine.newBuilder()
                 .maximumSize(64L)
@@ -48,6 +52,25 @@ public HypixelTranslator() {
                 .build();
     }
 
+    public boolean hasKey(String key) {
+        return defaultLocaleKeys.contains(key);
+    }
+
+    public int keyCount() {
+        return defaultLocaleKeys.size();
+    }
+
+    private Set<String> loadAllKeysForLocale(Locale locale) {
+        Map<String, Path> localeIndex = fileIndexByLocale.get(locale);
+        if (localeIndex == null) return Set.of();
+
+        Set<String> keys = new HashSet<>();
+        for (Path file : localeIndex.values()) {
+            keys.addAll(loadPropertiesFileFlat(file).keySet());
+        }
+        return Set.copyOf(keys);
+    }
+
     @Override
     public @Nullable String getMiniMessageString(@NotNull String key, @NotNull Locale locale) {
         LocaleKey lk = new LocaleKey(locale, key);

type.generic/src/main/java/net/swofty/type/generic/i18n/I18n.java

@@ -15,15 +15,30 @@ public class I18n {
 
     private static final String DIALOGUE_SEPARATOR = "\\|";
 
+    private static HypixelTranslator translator;
+
+    public static void init(HypixelTranslator instance) {
+        translator = instance;
+    }
+
+    public static void requireKey(String key) {
+        if (translator != null && !translator.hasKey(key)) {
+            throw new IllegalStateException("Missing translation key in en_US: " + key);
+        }
+    }
+
     public static TranslatableComponent t(String key) {
+        requireKey(key);
         return Component.translatable(key);
     }
 
     public static TranslatableComponent t(String key, Component... args) {
+        requireKey(key);
         return Component.translatable(key, args);
     }
 
     public static String string(String key, Locale locale) {
+        requireKey(key);
         Component rendered = GlobalTranslator.render(Component.translatable(key), locale);
         return LEGACY.serialize(rendered);
     }