chore: bump version

- As voted on in a recent MidnightDust Discord Poll

common/src/main/java/eu/midnightdust/lib/config/MidnightConfig.java

@@ -5,7 +5,8 @@ import com.google.gson.*; import com.google.gson.stream.*;
 import eu.midnightdust.lib.util.PlatformFunctions;
 import net.fabricmc.api.EnvType; import net.fabricmc.api.Environment;
 import net.minecraft.client.MinecraftClient; import net.minecraft.client.font.TextRenderer; import net.minecraft.client.gui.DrawContext;
-import net.minecraft.client.gui.Element; import net.minecraft.client.gui.Selectable; import net.minecraft.client.gui.screen.Screen;
+import net.minecraft.client.gui.Element; import net.minecraft.client.gui.Selectable;
+import net.minecraft.client.gui.screen.ConfirmLinkScreen; import net.minecraft.client.gui.screen.Screen;
 import net.minecraft.client.gui.tab.GridScreenTab; import net.minecraft.client.gui.tab.Tab; import net.minecraft.client.gui.tab.TabManager;
 import net.minecraft.client.gui.tooltip.Tooltip; import net.minecraft.client.gui.widget.*;
 import net.minecraft.client.render.RenderLayer;
@@ -13,7 +14,9 @@ import net.minecraft.client.resource.language.I18n;
 import net.minecraft.registry.Registries;
 import net.minecraft.screen.ScreenTexts;
 import net.minecraft.text.Style; import net.minecraft.text.Text;
+import net.minecraft.text.TranslatableTextContent;
 import net.minecraft.util.Formatting; import net.minecraft.util.Identifier;
+import net.minecraft.util.TranslatableOption;
 import org.jetbrains.annotations.Nullable;
 
 import javax.swing.*; import javax.swing.filechooser.FileNameExtensionFilter;
@@ -66,20 +69,18 @@ public abstract class MidnightConfig {
                 this.entry = field.getAnnotation(Entry.class);
                 this.comment = field.getAnnotation(Comment.class);
                 this.conditions = field.getAnnotationsByType(Condition.class);
-            } else {
-                this.fieldName = ""; this.dataType = null;
-            }
+            } else { this.fieldName = ""; this.dataType = null; }
             if (entry != null && !entry.name().isEmpty()) this.name = Text.translatable(entry.name());
             else if (comment != null && !comment.name().isEmpty()) this.name = Text.translatable(comment.name());
         }
         public void setValue(Object value) {
             if (this.field.getType() != List.class) { this.value = value;
-                this.tempValue = value == null ? "" : value.toString();   // fix bug+: illegal Identifier cannot input character
+                this.tempValue = value.toString();
             } else { writeList(this.listIndex, value);
                 this.tempValue = toTemporaryValue(); }
         }
         public String toTemporaryValue() {
-            if (this.field.getType() != List.class) return this.value == null ? "" : this.value.toString();  // fix bug+: illegal Identifier cannot input character
+            if (this.field.getType() != List.class) return this.value.toString();
             else try { return ((List<?>) this.value).get(this.listIndex).toString(); } catch (Exception ignored) {return "";}
         }
         public void updateFieldValue() {
@@ -107,6 +108,10 @@ public abstract class MidnightConfig {
             if (index >= list.size()) list.add(value);
             else list.set(index, value);
         }
+        public Tooltip getTooltip(boolean isButton) {
+            String key = this.modid + ".midnightconfig."+this.fieldName+(!isButton ? ".label" : "" )+".tooltip";
+            return Tooltip.of(isButton && this.error != null ? this.error : I18n.hasTranslation(key) ? Text.translatable(key) : Text.empty());
+        }
     }
 
     public static final Map<String, Class<? extends MidnightConfig>> configClass = new HashMap<>();
@@ -120,11 +125,6 @@ public abstract class MidnightConfig {
                 public Identifier read(JsonReader in) throws IOException { return Identifier.of(in.nextString()); }
             }).setPrettyPrinting().create();
 
-    @SuppressWarnings("unused") // Utility for mod authors
-    public static @Nullable Object getDefaultValue(String modid, String entry) {
-        String key = modid + ":" + entry;
-        return entries.containsKey(key) ? entries.get(key).defaultValue : null;
-    }
     public static void loadValuesFromJson(String modid) {
         try { gson.fromJson(Files.newBufferedReader(path), configClass.get(modid)); }
         catch (Exception e) { write(modid); }
@@ -168,10 +168,7 @@ public abstract class MidnightConfig {
                 }, func);
             } else if (info.dataType.isEnum()) {
                 List<?> values = Arrays.asList(field.getType().getEnumConstants());
-                Function<Object, Text> func = value -> {
-                    String translationKey = modid + ".midnightconfig.enum." + info.dataType.getSimpleName() + "." + info.toTemporaryValue();
-                    return I18n.hasTranslation(translationKey) ? Text.translatable(translationKey) : Text.literal(info.toTemporaryValue());
-                };
+                Function<Object, Text> func = value -> getEnumTranslatableText(value, modid, info);
                 info.function = new AbstractMap.SimpleEntry<ButtonWidget.PressAction, Function<Object, Text>>(button -> {
                     int index = values.indexOf(info.value) + 1;
                     info.setValue(values.get(index >= values.size() ? 0 : index));
@@ -188,16 +185,20 @@ public abstract class MidnightConfig {
         try { return (Class<?>) rawType.getField("TYPE").get(null); // Tries to get primitive types from non-primitives (e.g. Boolean -> boolean)
         } catch (NoSuchFieldException | IllegalAccessException ignored) { return rawType; }
     }
-    public static Tooltip getTooltip(EntryInfo info, boolean isButton) {
-        String key = info.modid + ".midnightconfig."+info.fieldName+(!isButton ? ".label" : "" )+".tooltip";
-        return Tooltip.of(isButton && info.error != null ? info.error : I18n.hasTranslation(key) ? Text.translatable(key) : Text.empty());
+
+    private static Text getEnumTranslatableText(Object value, String modid, EntryInfo info) {
+        if (value instanceof TranslatableOption translatableOption) return translatableOption.getText();
+
+        String translationKey = "%s.midnightconfig.enum.%s.%s".formatted(modid, info.dataType.getSimpleName(), info.toTemporaryValue());
+        return I18n.hasTranslation(translationKey) ? Text.translatable(translationKey) : Text.literal(info.toTemporaryValue());
     }
 
     private static void textField(EntryInfo info, Function<String,Number> f, Pattern pattern, double min, double max, boolean cast) {
         boolean isNumber = pattern != null;
         info.function = (BiFunction<TextFieldWidget, ButtonWidget, Predicate<String>>) (t, b) -> s -> {
             s = s.trim();
-            if (!(s.isEmpty() || !isNumber || pattern.matcher(s).matches())) return false;
+            if (!(s.isEmpty() || !isNumber || pattern.matcher(s).matches()) ||
+                    (info.dataType == Identifier.class && Identifier.validate(s).isError())) return false;
 
             Number value = 0; boolean inLimits = false; info.error = null;
             if (!(isNumber && s.isEmpty()) && !s.equals("-") && !s.equals(".")) {
@@ -206,7 +207,7 @@ public abstract class MidnightConfig {
                 info.error = inLimits? null : Text.literal(value.doubleValue() < min ?
                         "§cMinimum " + (isNumber? "value" : "length") + (cast? " is " + (int)min : " is " + min) :
                         "§cMaximum " + (isNumber? "value" : "length") + (cast? " is " + (int)max : " is " + max)).formatted(Formatting.RED);
-                t.setTooltip(getTooltip(info, true));
+                t.setTooltip(info.getTooltip(true));
             }
 
             info.tempValue = s;
@@ -215,11 +216,7 @@ public abstract class MidnightConfig {
             b.active = entries.values().stream().allMatch(e -> e.inLimits);
 
             if (inLimits) {
-                if (info.dataType == Identifier.class) {     // avoid the crash due to Identifier syntax not legitimate
-                    Identifier id = Identifier.tryParse(s);
-                    if (id == null) return false;
-                    info.setValue(id);
-                }
+                if (info.dataType == Identifier.class) info.setValue(Identifier.tryParse(s));
                 else info.setValue(isNumber ? value : s);
             }
 
@@ -242,6 +239,15 @@ public abstract class MidnightConfig {
               Files.write(path, gson.toJson(getClass(modid)).getBytes());
         } catch (Exception e) { e.fillInStackTrace(); }
     }
+
+    @SuppressWarnings("unused") // Utility for mod authors
+    public static @Nullable Object getDefaultValue(String modid, String entry) {
+        String key = modid + ":" + entry;
+        return entries.containsKey(key) ? entries.get(key).defaultValue : null;
+    }
+
+    public void onTabInit(String tabName, MidnightConfigListWidget list, MidnightConfigScreen screen) {}
+
     @Environment(EnvType.CLIENT)
     public static Screen getScreen(Screen parent, String modid) {
         return new MidnightConfigScreen(parent, modid);
@@ -249,7 +255,7 @@ public abstract class MidnightConfig {
     @Environment(EnvType.CLIENT)
     public static class MidnightConfigScreen extends Screen {
         protected MidnightConfigScreen(Screen parent, String modid) {
-            super(Text.translatable(modid + ".midnightconfig." + "title"));
+            super(Text.translatable(modid + ".midnightconfig.title"));
             this.parent = parent; this.modid = modid;
             this.translationPrefix = modid + ".midnightconfig.";
             loadValuesFromJson(modid);
@@ -296,11 +302,11 @@ public abstract class MidnightConfig {
         public void updateButtons() {
             if (this.list != null) {
                 for (ButtonEntry entry : this.list.children()) {
-                    if (entry.buttons != null && entry.buttons.size() > 1) {
+                    if (entry.buttons != null && entry.buttons.size() > 1 && entry.info.field != null) {
                         if (entry.buttons.get(0) instanceof ClickableWidget widget)
-                            if (widget.isFocused() || widget.isHovered()) widget.setTooltip(getTooltip(entry.info, true));
+                            if (widget.isFocused() || widget.isHovered()) widget.setTooltip(entry.info.getTooltip(true));
                         if (entry.buttons.get(1) instanceof ButtonWidget button)
-                            button.active = !Objects.equals(String.valueOf(entry.info.value), String.valueOf(entry.info.defaultValue));
+                            button.active = !Objects.equals(String.valueOf(entry.info.value), String.valueOf(entry.info.defaultValue)) && entry.info.conditionsMet;
         }}}}
         @Override
         public boolean keyPressed(int keyCode, int scanCode, int modifiers) {
@@ -338,7 +344,9 @@ public abstract class MidnightConfig {
             this.list.clear(); fillList();
         }
         public void fillList() {
+            MidnightConfig.getClass(modid).onTabInit(prevTab.getTitle().getContent() instanceof TranslatableTextContent translatable ? translatable.getKey().replace("%s.midnightconfig.category.".formatted(modid), "") : prevTab.getTitle().toString(), list, this);
             for (EntryInfo info : entries.values()) {
+                info.updateConditions();
                 if (!info.conditionsMet) {
                     boolean visibleButLocked = false;
                     for (Condition condition : info.conditions) {
@@ -360,19 +368,19 @@ public abstract class MidnightConfig {
                         Entry e = info.entry;
                         if (info.function instanceof Map.Entry) { // Enums & booleans
                             var values = (Map.Entry<ButtonWidget.PressAction, Function<Object, Text>>) info.function;
-                            if (info.dataType.isEnum())
-                                values.setValue(value -> Text.translatable(translationPrefix + "enum." + info.dataType.getSimpleName() + "." + info.value.toString()));
-                            widget = ButtonWidget.builder(values.getValue().apply(info.value), values.getKey()).dimensions(width - 185, 0, 150, 20).tooltip(getTooltip(info, true)).build();
+                            if (info.dataType.isEnum()) {
+                                values.setValue(value -> getEnumTranslatableText(value, modid, info));
+                            }
+                            widget = ButtonWidget.builder(values.getValue().apply(info.value), values.getKey()).dimensions(width - 185, 0, 150, 20).tooltip(info.getTooltip(true)).build();
                         } else if (e.isSlider())
                             widget = new MidnightSliderWidget(width - 185, 0, 150, 20, Text.of(info.tempValue), (Double.parseDouble(info.tempValue) - e.min()) / (e.max() - e.min()), info);
-                        else
-                            widget = new TextFieldWidget(textRenderer, width - 185, 0, 150, 20, Text.empty());
+                        else widget = new TextFieldWidget(textRenderer, width - 185, 0, 150, 20, Text.empty());
                         if (widget instanceof TextFieldWidget textField) {
                             textField.setMaxLength(e.width()); textField.setText(info.tempValue);
                             Predicate<String> processor = ((BiFunction<TextFieldWidget, ButtonWidget, Predicate<String>>) info.function).apply(textField, done);
                             textField.setTextPredicate(processor);
                         }
-                        widget.setTooltip(getTooltip(info, true));
+                        widget.setTooltip(info.getTooltip(true));
 
                         ButtonWidget cycleButton = null;
                         if (info.field.getType() == List.class) {
@@ -417,7 +425,6 @@ public abstract class MidnightConfig {
                             explorerButton.setPosition(width - 185, 0);
                             info.actionButton = explorerButton;
                         }
-                        if (!info.conditionsMet) widget.active = false;
                         List<ClickableWidget> widgets = Lists.newArrayList(widget, resetButton);
                         if (info.actionButton != null) {
                             if (IS_SYSTEM_MAC) info.actionButton.active = false;
@@ -428,6 +435,7 @@ public abstract class MidnightConfig {
                             widget.setWidth(widget.getWidth() - 22); widget.setX(widget.getX() + 22);
                             widgets.add(cycleButton);
                         }
+                        if (!info.conditionsMet) widgets.forEach(w -> w.active = false);
                         this.list.addButton(widgets, name, info);
                     } else this.list.addButton(List.of(), name, info);
                 } list.setScrollY(scrollProgress);
@@ -471,14 +479,14 @@ public abstract class MidnightConfig {
 
             if (text != null && (!text.getString().contains("spacer") || !buttons.isEmpty())) {
                 title = new MultilineTextWidget((centered) ? (scaledWidth / 2 - (textRenderer.getWidth(text) / 2)) : 12, 0, Text.of(text), textRenderer);
-                if (info != null) title.setTooltip(getTooltip(info, false));
+                if (info != null) title.setTooltip(info.getTooltip(false));
                 title.setMaxWidth(buttons.size() > 1 ? buttons.get(1).getX() - 24 : scaledWidth - 24);
             }
         }
         public void render(DrawContext context, int index, int y, int x, int entryWidth, int entryHeight, int mouseX, int mouseY, boolean hovered, float tickDelta) {
             buttons.forEach(b -> { b.setY(y); b.render(context, mouseX, mouseY, tickDelta);});
             if (title != null) {
-                title.setY(y + 9);
+                title.setY(y+5);
                 title.renderWidget(context, mouseX, mouseY, tickDelta);
 
                 boolean tooltipVisible = mouseX >= title.getX() && mouseX < title.getWidth() + title.getX() && mouseY >= title.getY() && mouseY < title.getHeight() + title.getY();
@@ -490,6 +498,14 @@ public abstract class MidnightConfig {
                 }
             }
         }
+
+        @Override
+        public boolean mouseClicked(double mouseX, double mouseY, int button) {
+            if (this.info != null && this.info.comment != null && !this.info.comment.url().isBlank())
+                ConfirmLinkScreen.open(MinecraftClient.getInstance().currentScreen, this.info.comment.url(), true);
+            return super.mouseClicked(mouseX, mouseY, button);
+        }
+
         public List<? extends Element> children() {return Lists.newArrayList(buttons);}
         public List<? extends Selectable> selectableChildren() {return Lists.newArrayList(buttons);}
     }
@@ -521,7 +537,7 @@ public abstract class MidnightConfig {
      * - <b>width</b>: The maximum character length of the {@link String}, {@link Identifier} or String/Identifier {@link List<>} field<br>
      * - <b>min</b>: The minimum value of the <code>int</code>, <code>float</code> or <code>double</code> field<br>
      * - <b>max</b>: The maximum value of the <code>int</code>, <code>float</code> or <code>double</code> field<br>
-     * - <b>name</b>: The name of the field in the config screen<br>
+     * - <b>name</b>: Will be used instead of the default translation key, if not empty<br>
      * - <b>selectionMode</b>: The selection mode of the file picker button for {@link String} fields,
      *   -1 for none, {@link JFileChooser#FILES_ONLY} for files, {@link JFileChooser#DIRECTORIES_ONLY} for directories,
      *   {@link JFileChooser#FILES_AND_DIRECTORIES} for both (default: -1). Remember to set the translation key
@@ -569,10 +585,18 @@ public abstract class MidnightConfig {
      */
     @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.FIELD) public @interface Hidden {}
 
+    /**
+     * Comment Annotation<br>
+     * - <b>{@link Comment#centered()}</b>: If the comment should be centered<br>
+     * - <b>{@link Comment#category()}</b>: The category of the comment in the config screen<br>
+     * - <b>{@link Comment#name()}</b>: Will be used instead of the default translation key, if not empty<br>
+     * - <b>{@link Comment#url()}</b>: The url of the comment should link to in the config screen (none if left empty)<br>
+     * */
     @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.FIELD) public @interface Comment {
         boolean centered() default false;
         String category() default "default";
         String name() default "";
+        String url() default "";
         @Deprecated String requiredMod() default "";
     }
     /**

common/src/main/resources/assets/midnightlib/lang/es_ar.json

@@ -0,0 +1,8 @@
+{
+	"midnightlib.overview.title": "Visión general de MidnightConfig",
+	"midnightlib.midnightconfig.title": "Configuración de MidnightLib",
+	"midnightlib.midnightconfig.config_screen_list": "Habilitar lista de pantallas de configuración",
+	"midnightlib.midnightconfig.enum.ConfigButton.TRUE": "§aSí",
+	"modmenu.summaryTranslation.midnightlib": "Librería común para facilitar la configuración.",
+	"midnightconfig.colorChooser.title": "Elegí un color"
+}

gradle.properties

@@ -6,7 +6,7 @@ yarn_mappings=1.21.4+build.1
 enabled_platforms=fabric,neoforge
 
 archives_base_name=midnightlib
-mod_version=1.7.2-rc.1
+mod_version=1.7.3
 maven_group=eu.midnightdust
 release_type=release
 curseforge_id=488090

test-fabric/src/main/java/eu/midnightdust/fabric/example/MidnightLibExtras.java

@@ -0,0 +1,96 @@
+package eu.midnightdust.fabric.example;
+
+import com.google.common.collect.Lists;
+import eu.midnightdust.lib.config.MidnightConfig;
+import net.minecraft.client.MinecraftClient;
+import net.minecraft.client.gui.tooltip.Tooltip;
+import net.minecraft.client.gui.widget.ButtonWidget;
+import net.minecraft.client.gui.widget.ClickableWidget;
+import net.minecraft.client.gui.widget.TextIconButtonWidget;
+import net.minecraft.client.option.KeyBinding;
+import net.minecraft.client.util.InputUtil;
+import net.minecraft.text.MutableText;
+import net.minecraft.text.Text;
+import net.minecraft.util.Formatting;
+import net.minecraft.util.Identifier;
+import org.jetbrains.annotations.Nullable;
+import org.lwjgl.glfw.GLFW;
+
+/*
+ Pre-made additional (niche) functionality that is not included in MidnightLib to keep the file size small.
+ Feel free to copy the parts you need :)
+*/
+public class MidnightLibExtras {
+    public static class KeybindButton extends ButtonWidget {
+        public static ButtonWidget focusedButton;
+
+        public static void add(KeyBinding binding, MidnightConfig.MidnightConfigListWidget list, MidnightConfig.MidnightConfigScreen screen) {
+            KeybindButton editButton = new KeybindButton(screen.width - 185, 0, 150, 20, binding);
+            TextIconButtonWidget resetButton = TextIconButtonWidget.builder(Text.translatable("controls.reset"), (button -> {
+                binding.setBoundKey(binding.getDefaultKey());
+                screen.updateList();
+            }), true).texture(Identifier.of("midnightlib","icon/reset"), 12, 12).dimension(20, 20).build();
+            resetButton.setPosition(screen.width - 205 + 150 + 25, 0);
+            editButton.resetButton = resetButton;
+            editButton.updateMessage(false);
+            MidnightConfig.EntryInfo info = new MidnightConfig.EntryInfo(null, screen.modid);
+
+            list.addButton(Lists.newArrayList(editButton, resetButton), Text.translatable(binding.getTranslationKey()), info);
+        }
+
+        private final KeyBinding binding;
+        private @Nullable ClickableWidget resetButton;
+        public KeybindButton(int x, int y, int width, int height, KeyBinding binding) {
+            super(x, y, width, height, binding.getBoundKeyLocalizedText(), (button) -> {
+                ((KeybindButton) button).updateMessage(true);
+                focusedButton = button;
+            }, (textSupplier) -> binding.isUnbound() ? Text.translatable("narrator.controls.unbound", binding.getTranslationKey()) : Text.translatable("narrator.controls.bound", binding.getTranslationKey(), textSupplier.get()));
+            this.binding = binding;
+            updateMessage(false);
+        }
+        @Override
+        public boolean keyPressed(int keyCode, int scanCode, int modifiers) {
+            if (focusedButton == this) {
+                if (keyCode == GLFW.GLFW_KEY_ESCAPE) {
+                    this.binding.setBoundKey(InputUtil.UNKNOWN_KEY);
+                } else {
+                    this.binding.setBoundKey(InputUtil.fromKeyCode(keyCode, scanCode));
+                }
+                updateMessage(false);
+
+                focusedButton = null;
+                return true;
+            }
+            return super.keyPressed(keyCode, scanCode, modifiers);
+        }
+
+        public void updateMessage(boolean focused) {
+            boolean hasConflicts = false;
+            MutableText conflictingBindings = Text.empty();
+            if (focused) this.setMessage(Text.literal("> ").append(this.binding.getBoundKeyLocalizedText().copy().formatted(Formatting.WHITE, Formatting.UNDERLINE)).append(" <").formatted(Formatting.YELLOW));
+            else {
+                this.setMessage(this.binding.getBoundKeyLocalizedText());
+
+                if (!this.binding.isUnbound()) {
+                    for(KeyBinding keyBinding : MinecraftClient.getInstance().options.allKeys) {
+                        if (keyBinding != this.binding && this.binding.equals(keyBinding)) {
+                            if (hasConflicts) conflictingBindings.append(", ");
+
+                            hasConflicts = true;
+                            conflictingBindings.append(Text.translatable(keyBinding.getTranslationKey()));
+                        }
+                    }
+                }
+            }
+
+            if (this.resetButton != null) this.resetButton.active = !this.binding.isDefault();
+
+            if (hasConflicts) {
+                this.setMessage(Text.literal("[ ").append(this.getMessage().copy().formatted(Formatting.WHITE)).append(" ]").formatted(Formatting.RED));
+                this.setTooltip(Tooltip.of(Text.translatable("controls.keybinds.duplicateKeybinds", conflictingBindings)));
+            } else {
+                this.setTooltip(null);
+            }
+        }
+    }
+}

test-fabric/src/main/java/eu/midnightdust/fabric/example/config/MidnightConfigExample.java

@@ -1,16 +1,23 @@
 package eu.midnightdust.fabric.example.config;
 
 import com.google.common.collect.Lists;
+import eu.midnightdust.fabric.example.MidnightLibExtras;
 import eu.midnightdust.lib.config.MidnightConfig;
+import net.minecraft.text.MutableText;
+import net.minecraft.text.Text;
+import net.minecraft.util.Formatting;
+import net.minecraft.client.MinecraftClient;
 import net.minecraft.util.Identifier;
+import net.minecraft.util.TranslatableOption;
 
 import javax.swing.*;
 import java.util.ArrayList;
 import java.util.List;
+import java.util.Objects;
 
 /** Every option in a MidnightConfig class has to be public and static, so we can access it from other classes.
  * The config class also has to extend MidnightConfig*/
-@SuppressWarnings("unused")
+@SuppressWarnings({"unused", "DefaultAnnotationParam"})
 public class MidnightConfigExample extends MidnightConfig {
     public static final String TEXT = "text";
     public static final String NUMBERS = "numbers";
@@ -18,6 +25,7 @@ public class MidnightConfigExample extends MidnightConfig {
     public static final String LISTS = "lists";
     public static final String FILES = "files";
     public static final String CONDITIONS = "conditions";
+    public static final String EXTRAS = "extras";
 
     @Comment(category = TEXT) public static Comment text1;                       // Comments are rendered like an option without a button and are excluded from the config file
     @Comment(category = TEXT, centered = true) public static Comment text2;      // Centered comments are the same as normal ones - just centered!
@@ -31,6 +39,10 @@ public class MidnightConfigExample extends MidnightConfig {
     public enum ModPlatform {                               // Enums allow the user to cycle through predefined options
         QUILT, FABRIC, FORGE, NEOFORGE, VANILLA
     }
+    @Entry(category = TEXT) public static GraphicsSteps graphicsSteps = GraphicsSteps.FABULOUS;   // Example for an enum option with TranslatableOption
+
+    @Comment(category = TEXT, name = "§nMidnightLib Wiki", centered = true, url = "https://www.midnightdust.eu/wiki/midnightlib/") public static Comment wiki; // Example for a comment with a url
+
     @Entry(category = NUMBERS) public static int fabric = 16777215;                 // Example for an int option
     @Entry(category = NUMBERS) public static double world = 1.4D;                   // Example for a double option
     @Entry(category = NUMBERS, min=69,max=420) public static int hello = 420;   // - The entered number has to be larger than 69 and smaller than 420
@@ -113,4 +125,46 @@ public class MidnightConfigExample extends MidnightConfig {
     @Comment(category = CONDITIONS, name="You disabled MidnightLib's config screen list. Why? :(", centered = true)  public static Comment why;
 
     public static int imposter = 16777215; // - Entries without an @Entry or @Comment annotation are ignored
+
+    public enum GraphicsSteps implements TranslatableOption {
+        FAST(0, "options.graphics.fast"),
+        FANCY(1, "options.graphics.fancy"),
+        FABULOUS(2, "options.graphics.fabulous");
+
+        private final int id;
+        private final String translationKey;
+
+        GraphicsSteps(int id, String translationKey) {
+            this.id = id;
+            this.translationKey = translationKey;
+        }
+
+        @Override
+        public Text getText() {
+            MutableText mutableText = Text.translatable(this.getTranslationKey());
+            return this == GraphicsSteps.FABULOUS ? mutableText.formatted(Formatting.ITALIC).formatted(Formatting.AQUA) : mutableText;
+        }
+
+        @Override
+        public int getId() {
+            return this.id;
+        }
+
+        @Override
+        public String getTranslationKey() {
+            return this.translationKey;
+        }
+    }
+
+    @Condition(requiredModId = "thismoddoesnotexist")
+    @Comment(category = EXTRAS) public static Comment iAmJustADummy; // We only have this to initialize an empty tab for the keybinds below
+
+    @Override
+    public void onTabInit(String tabName, MidnightConfigListWidget list, MidnightConfigScreen screen) {
+        if (Objects.equals(tabName, EXTRAS)) {
+            MidnightLibExtras.KeybindButton.add(MinecraftClient.getInstance().options.advancementsKey, list, screen);
+            MidnightLibExtras.KeybindButton.add(MinecraftClient.getInstance().options.dropKey, list, screen);
+        }
+    }
+
 }

test-fabric/src/main/resources/assets/modid/lang/en_us.json

@@ -16,6 +16,7 @@
   "modid.midnightconfig.enum.ModPlatform.QUILT":"Quilt",
   "modid.midnightconfig.enum.ModPlatform.NEOFORGE":"NeoForge",
   "modid.midnightconfig.enum.ModPlatform.VANILLA":"Vanilla",
+  "modid.midnightconfig.graphicsSteps":"I am an enum with TranslatableOption!",
   "modid.midnightconfig.myFileOrDirectory.fileChooser": "Select an image or directory",
   "modid.midnightconfig.myFileOrDirectory.fileFilter": "Supported Images (.png, .jpg, .jpeg)",
   "modid.midnightconfig.category.numbers": "Numbers",
@@ -24,5 +25,6 @@
   "modid.midnightconfig.category.lists": "Lists",
   "modid.midnightconfig.category.files": "Files",
   "modid.midnightconfig.category.conditions": "Quiz",
+  "modid.midnightconfig.category.extras": "Extras",
   "modid.midnightconfig.category.multiConditions": "Multi-Conditions"
 }

test-fabric/src/main/resources/assets/modid/lang/es_ar.json

@@ -0,0 +1,28 @@
+{
+  "modid.midnightconfig.title": "Soy un título",
+  "modid.midnightconfig.text1": "Soy un comentario *u*",
+  "modid.midnightconfig.text2": "Soy un comentario centrado (╯°□°）╯︵ ┻━┻",
+  "modid.midnightconfig.name": "¡Soy una cadena de texto!",
+  "modid.midnightconfig.name.label.tooltip": "Soy el tooltip de una etiqueta \n¡Wujuu!",
+  "modid.midnightconfig.name.tooltip": "Soy un tooltip uwu \nY una nueva línea",
+  "modid.midnightconfig.fabric": "Soy un entero",
+  "modid.midnightconfig.world": "Soy un número decimal",
+  "modid.midnightconfig.showInfo": "Soy un booleano",
+  "modid.midnightconfig.hello": "¡Soy un entero limitado!",
+  "modid.midnightconfig.id": "¡Soy un identificador de ítem!",
+  "modid.midnightconfig.modPlatform": "¡Soy un enumerador!",
+  "modid.midnightconfig.enum.ModPlatform.FORGE": "Forge",
+  "modid.midnightconfig.enum.ModPlatform.FABRIC": "Fabric",
+  "modid.midnightconfig.enum.ModPlatform.QUILT": "Quilt",
+  "modid.midnightconfig.enum.ModPlatform.NEOFORGE": "NeoForge",
+  "modid.midnightconfig.enum.ModPlatform.VANILLA": "Vanilla",
+  "modid.midnightconfig.myFileOrDirectory.fileChooser": "Seleccioná una imagen o carpeta",
+  "modid.midnightconfig.myFileOrDirectory.fileFilter": "Imágenes compatibles (.png, .jpg, .jpeg)",
+  "modid.midnightconfig.category.numbers": "Números",
+  "modid.midnightconfig.category.text": "Texto",
+  "modid.midnightconfig.category.sliders": "Deslizadores",
+  "modid.midnightconfig.category.lists": "Listas",
+  "modid.midnightconfig.category.files": "Archivos",
+  "modid.midnightconfig.category.conditions": "Cuestionario",
+  "modid.midnightconfig.category.multiConditions": "Condiciones múltiples"
+}