feat: Implement TinyTorch command system and configuration integration

- Added TinyTorchCommands class to handle command registration and execution for configuration management. - Implemented commands for reloading, showing, and setting various configuration options such as torch light level, held light level, flicker speed, and dynamic lighting features. - Introduced TinyTorchModMenuIntegration class for integration with Mod Menu, allowing users to configure settings through a user-friendly interface. - Created language files for multiple languages (de_de, en_us, es_mx, fr_fr, ja_jp, pt_br, ru_ru, zh_cn) to support internationalization of mod descriptions and configuration options.
2025-11-04 20:06:29 +00:00
parent 6af3422ac3
commit 2f98d1a386
17 changed files with 632 additions and 49 deletions
--- a/README.md
+++ b/README.md
@@ -1,23 +1,23 @@
-# 🔥 TinyTorch
+# TinyTorch

 A Minecraft Fabric mod that makes lighting more realistic and atmospheric by reducing torch brightness and adding optional flickering effects.

 ## Features

-### ✨ Core Features
+### Core Features

 - **Reduced Light Radius**: Normal torch brightness reduced from light level 14 to configurable level (default: 8)
 - **Works for all torch types**: Both standing and wall torches affected
 - **Configurable**: All settings customizable via `tinytorch.json`

-### 🎭 Optional Effects
+### Optional Effects

 - **Flicker Effect**: Light level oscillates randomly ±1 every few ticks to simulate flickering flame
 - **Particle Effects**: Small smoke and spark particles appear occasionally around torches
 - **Held Light**: Torches emit weak light (level 4-5) when held in main/offhand
 - **Smart Updates**: Held light only updates when player moves for performance

-### ⚡ Advanced Features
+### Advanced Features

 - **Light Falloff Curve**: Sharper brightness drop-off after a few blocks (dark corners stay dark)
 - **Material-Based Lighting**: 
@@ -27,7 +27,49 @@ A Minecraft Fabric mod that makes lighting more realistic and atmospheric by red

 ## Configuration

-The mod creates a `tinytorch.json` config file in your config directory:
+### In-Game Configuration
+
+TinyTorch supports multiple ways to configure settings in-game:
+
+#### ModMenu Integration (Recommended)
+1. Install [ModMenu](https://modrinth.com/mod/modmenu)
+2. Go to Mods menu → TinyTorch → Config
+3. Adjust settings with sliders and toggles
+4. Changes save automatically
+
+#### In-Game Commands
+
+For server operators, use commands to configure settings:
+
+```bash
+# Show current configuration
+/tinytorch config show
+
+# Reload configuration from file  
+/tinytorch config reload
+
+# Set torch light level (0-15)
+/tinytorch config set torch_light_level 8
+
+# Set held torch light level (0-15)
+/tinytorch config set held_light_level 5
+
+# Enable/disable flicker effects
+/tinytorch config set enable_flicker true
+
+# Set flicker speed (1-20, higher = slower)
+/tinytorch config set flicker_speed 5
+
+# Enable/disable held torch lighting
+/tinytorch config set held_light true
+
+# Enable/disable sharp light falloff
+/tinytorch config set use_falloff_curve true
+```
+
+#### Manual Configuration File
+
+The mod creates a `tinytorch.json` file in your config folder:

 ```json
 {
@@ -46,7 +88,7 @@ The mod creates a `tinytorch.json` config file in your config directory:
 - `held_light_level` (0-15): Light level when holding a torch (default: 5)
 - `enable_flicker` (true/false): Enable flickering flame effect (default: true)
 - `flicker_speed` (1+): Ticks between flicker changes, higher = slower (default: 5)
- `use_falloff_curve` (true/false): Use custom sharp light falloff (default: true) 
+- `use_falloff_curve` (true/false): Use custom sharp light falloff (default: true)
 - `held_light` (true/false): Enable dynamic lighting when holding torches (default: true)

 ## Gameplay Impact
@@ -57,44 +99,30 @@ The mod creates a `tinytorch.json` config file in your config directory:
 - **Torches glow gently** in-hand when walking at night
 - **Strategic lighting** becomes more important for visibility

+## In-Game Configuration
+
+TinyTorch provides **three convenient ways** to adjust settings:
+
+### 1. **ModMenu GUI** (Recommended)
+- Install [ModMenu](https://modrinth.com/mod/modmenu) 
+- Access via Mods → TinyTorch → Config button
+- User-friendly sliders and toggles
+- Changes save automatically
+
+### 2. **In-Game Commands** (Server Admins)
+- `/tinytorch config show` - View current settings
+- `/tinytorch config set torch_light_level 6` - Change values
+- `/tinytorch config reload` - Reload from file
+- Requires OP permissions
+
+### 3. **Config File** (Advanced Users)
+- Edit `.minecraft/config/tinytorch.json`
+- Use `/tinytorch config reload` to apply changes
+
 ## Installation

-1. Install [Fabric Loader](https://fabricmc.net/use/)
-2. Install [Fabric API](https://modrinth.com/mod/fabric-api)
-3. Download TinyTorch jar
-4. Place in your `mods` folder
-
-## Compatibility
-
- ✅ **Fabric API**: Required
- ✅ **OptiFine**: Compatible
- ✅ **Sodium**: Compatible  
- ✅ **Shaders**: Works with vanilla lighting pipeline
- ✅ **Multiplayer**: Server-side mod, clients benefit from effects
-
-## Technical Details
-
- **Minecraft Version**: 1.21.1
- **Fabric Loader**: 0.17.3+
- **Java**: 21+
- **License**: CC0-1.0
-
-## Building
-
-```bash
-./gradlew build
-```
-
-Built jar will be in `build/libs/`
-
-## Contributing
-
-Contributions welcome! Please ensure:
- Code follows existing style
- Features are configurable
- Performance impact is minimal
- Works on both client and server
-
---
-
-*Made with ❤️ for atmospheric Minecraft lighting*
+1. Download and install [Fabric Loader](https://fabricmc.net/use/)
+2. Download [Fabric API](https://modrinth.com/mod/fabric-api)
+3. **(Optional but recommended)** Download [ModMenu](https://modrinth.com/mod/modmenu) for in-game config
+4. Download TinyTorch and place in your `mods` folder
+5. Launch the game and enjoy atmospheric lighting!
--- a/build.gradle
+++ b/build.gradle
@@ -16,6 +16,17 @@ repositories {
 	// Loom adds the essential maven repositories to download Minecraft and libraries from automatically.
 	// See https://docs.gradle.org/current/userguide/declaring_repositories.html
 	// for more information about repositories.
+	
+	// ModMenu repository
+	maven {
+		name = "TerraformersMC"
+		url = "https://maven.terraformersmc.com/"
+	}
+	// Cloth Config repository
+	maven {
+		name = "shedaniel"
+		url = "https://maven.shedaniel.me/"
+	}
 }

 fabricApi {
@@ -33,6 +44,12 @@ dependencies {
 	// Fabric API. This is technically optional, but you probably want it anyway.
 	modImplementation "net.fabricmc.fabric-api:fabric-api:${project.fabric_version}"
 	
+	// ModMenu for configuration screen - using stable version for 1.21.1
+	modImplementation "com.terraformersmc:modmenu:${project.modmenu_version}"
+	
+	// Cloth Config for settings GUI - using stable version for 1.21.1
+	modImplementation "me.shedaniel.cloth:cloth-config-fabric:${project.cloth_config_version}"
+	include "me.shedaniel.cloth:cloth-config-fabric:${project.cloth_config_version}"
 }

 processResources {
--- a/gradle.properties
+++ b/gradle.properties
@@ -13,9 +13,13 @@ loader_version=0.17.3
 loom_version=1.12-SNAPSHOT

 # Mod Properties
-mod_version=1.0.0
+mod_version=0.67
 maven_group=dev.sillyangel.tinytorch
 archives_base_name=tinytorch

 # Dependencies
-fabric_version=0.116.7+1.21.1
+fabric_version=0.116.7+1.21.1
+
+# Configuration Dependencies  
+modmenu_version=11.0.3
+cloth_config_version=15.0.140
--- a/icon.png
+++ b/icon.png
--- a/src/main/java/dev/sillyangel/tinytorch/TinyTorch.java
+++ b/src/main/java/dev/sillyangel/tinytorch/TinyTorch.java
@@ -1,5 +1,6 @@
 package dev.sillyangel.tinytorch;

+import dev.sillyangel.tinytorch.command.TinyTorchCommands;
 import dev.sillyangel.tinytorch.config.TinyTorchConfig;
 import net.fabricmc.api.ModInitializer;

@@ -26,5 +27,10 @@ public class TinyTorch implements ModInitializer {
 		TinyTorchConfig config = TinyTorchConfig.getInstance();
 		LOGGER.info("TinyTorch config loaded - torch light level: {}, flicker: {}", 
 			config.getValidTorchLightLevel(), config.enable_flicker);
+		
+		// Register commands
+		TinyTorchCommands.register();
+		
+		LOGGER.info("TinyTorch initialization complete!");
 	}
 }
--- a/src/main/java/dev/sillyangel/tinytorch/command/TinyTorchCommands.java
+++ b/src/main/java/dev/sillyangel/tinytorch/command/TinyTorchCommands.java
@@ -0,0 +1,116 @@
+package dev.sillyangel.tinytorch.command;
+
+import com.mojang.brigadier.CommandDispatcher;
+import com.mojang.brigadier.arguments.BoolArgumentType;
+import com.mojang.brigadier.arguments.IntegerArgumentType;
+import com.mojang.brigadier.context.CommandContext;
+import dev.sillyangel.tinytorch.config.TinyTorchConfig;
+import net.fabricmc.fabric.api.command.v2.CommandRegistrationCallback;
+import net.minecraft.server.command.CommandManager;
+import net.minecraft.server.command.ServerCommandSource;
+import net.minecraft.text.Text;
+
+public class TinyTorchCommands {
+    
+    public static void register() {
+        CommandRegistrationCallback.EVENT.register((dispatcher, registryAccess, environment) -> {
+            registerCommands(dispatcher);
+        });
+    }
+    
+    private static void registerCommands(CommandDispatcher<ServerCommandSource> dispatcher) {
+        dispatcher.register(CommandManager.literal("tinytorch")
+            .requires(source -> source.hasPermissionLevel(2)) // Requires OP level
+            .then(CommandManager.literal("config")
+                .then(CommandManager.literal("reload")
+                    .executes(TinyTorchCommands::reloadConfig))
+                .then(CommandManager.literal("show")
+                    .executes(TinyTorchCommands::showConfig))
+                .then(CommandManager.literal("set")
+                    .then(CommandManager.literal("torch_light_level")
+                        .then(CommandManager.argument("value", IntegerArgumentType.integer(0, 15))
+                            .executes(ctx -> setTorchLightLevel(ctx, IntegerArgumentType.getInteger(ctx, "value")))))
+                    .then(CommandManager.literal("held_light_level")
+                        .then(CommandManager.argument("value", IntegerArgumentType.integer(0, 15))
+                            .executes(ctx -> setHeldLightLevel(ctx, IntegerArgumentType.getInteger(ctx, "value")))))
+                    .then(CommandManager.literal("flicker_speed")
+                        .then(CommandManager.argument("value", IntegerArgumentType.integer(1, 20))
+                            .executes(ctx -> setFlickerSpeed(ctx, IntegerArgumentType.getInteger(ctx, "value")))))
+                    .then(CommandManager.literal("enable_flicker")
+                        .then(CommandManager.argument("value", BoolArgumentType.bool())
+                            .executes(ctx -> setEnableFlicker(ctx, BoolArgumentType.getBool(ctx, "value")))))
+                    .then(CommandManager.literal("held_light")
+                        .then(CommandManager.argument("value", BoolArgumentType.bool())
+                            .executes(ctx -> setHeldLight(ctx, BoolArgumentType.getBool(ctx, "value")))))
+                    .then(CommandManager.literal("use_falloff_curve")
+                        .then(CommandManager.argument("value", BoolArgumentType.bool())
+                            .executes(ctx -> setUseFalloffCurve(ctx, BoolArgumentType.getBool(ctx, "value"))))))));
+    }
+    
+    private static int reloadConfig(CommandContext<ServerCommandSource> ctx) {
+        TinyTorchConfig.getInstance().save();
+        TinyTorchConfig config = TinyTorchConfig.load();
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.reload"), true);
+        return 1;
+    }
+    
+    private static int showConfig(CommandContext<ServerCommandSource> ctx) {
+        TinyTorchConfig config = TinyTorchConfig.getInstance();
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.current"), false);
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.torch_light", config.torch_light_level), false);
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.held_light", config.held_light_level), false);
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.flicker", config.enable_flicker ? "enabled" : "disabled"), false);
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.flicker_speed", config.flicker_speed), false);
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.falloff", config.use_falloff_curve ? "enabled" : "disabled"), false);
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.held", config.held_light ? "enabled" : "disabled"), false);
+        return 1;
+    }
+    
+    private static int setTorchLightLevel(CommandContext<ServerCommandSource> ctx, int value) {
+        TinyTorchConfig config = TinyTorchConfig.getInstance();
+        config.torch_light_level = value;
+        config.save();
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.set.success", "torch_light_level", String.valueOf(value)), true);
+        return 1;
+    }
+    
+    private static int setHeldLightLevel(CommandContext<ServerCommandSource> ctx, int value) {
+        TinyTorchConfig config = TinyTorchConfig.getInstance();
+        config.held_light_level = value;
+        config.save();
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.set.success", "held_light_level", String.valueOf(value)), true);
+        return 1;
+    }
+    
+    private static int setFlickerSpeed(CommandContext<ServerCommandSource> ctx, int value) {
+        TinyTorchConfig config = TinyTorchConfig.getInstance();
+        config.flicker_speed = value;
+        config.save();
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.set.success", "flicker_speed", String.valueOf(value)), true);
+        return 1;
+    }
+    
+    private static int setEnableFlicker(CommandContext<ServerCommandSource> ctx, boolean value) {
+        TinyTorchConfig config = TinyTorchConfig.getInstance();
+        config.enable_flicker = value;
+        config.save();
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.set.success", "enable_flicker", String.valueOf(value)), true);
+        return 1;
+    }
+    
+    private static int setHeldLight(CommandContext<ServerCommandSource> ctx, boolean value) {
+        TinyTorchConfig config = TinyTorchConfig.getInstance();
+        config.held_light = value;
+        config.save();
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.set.success", "held_light", String.valueOf(value)), true);
+        return 1;
+    }
+    
+    private static int setUseFalloffCurve(CommandContext<ServerCommandSource> ctx, boolean value) {
+        TinyTorchConfig config = TinyTorchConfig.getInstance();
+        config.use_falloff_curve = value;
+        config.save();
+        ctx.getSource().sendFeedback(() -> Text.translatable("command.tinytorch.config.set.success", "use_falloff_curve", String.valueOf(value)), true);
+        return 1;
+    }
+}
--- a/src/main/java/dev/sillyangel/tinytorch/config/TinyTorchModMenuIntegration.java
+++ b/src/main/java/dev/sillyangel/tinytorch/config/TinyTorchModMenuIntegration.java
@@ -0,0 +1,81 @@
+package dev.sillyangel.tinytorch.config;
+
+import com.terraformersmc.modmenu.api.ConfigScreenFactory;
+import com.terraformersmc.modmenu.api.ModMenuApi;
+import me.shedaniel.clothconfig2.api.ConfigBuilder;
+import me.shedaniel.clothconfig2.api.ConfigCategory;
+import me.shedaniel.clothconfig2.api.ConfigEntryBuilder;
+import net.minecraft.client.gui.screen.Screen;
+import net.minecraft.text.Text;
+
+public class TinyTorchModMenuIntegration implements ModMenuApi {
+    
+    @Override
+    public ConfigScreenFactory<?> getModConfigScreenFactory() {
+        return TinyTorchModMenuIntegration::createConfigScreen;
+    }
+    
+    private static Screen createConfigScreen(Screen parent) {
+        TinyTorchConfig config = TinyTorchConfig.getInstance();
+        
+        ConfigBuilder builder = ConfigBuilder.create()
+            .setParentScreen(parent)
+            .setTitle(Text.translatable("config.tinytorch.title"))
+            .setSavingRunnable(config::save);
+        
+        ConfigEntryBuilder entryBuilder = builder.entryBuilder();
+        
+        // Light Settings Category
+        ConfigCategory lightCategory = builder.getOrCreateCategory(Text.translatable("config.tinytorch.category.light"));
+        
+        lightCategory.addEntry(entryBuilder
+            .startIntSlider(Text.translatable("config.tinytorch.torch_light_level"), config.torch_light_level, 0, 15)
+            .setDefaultValue(8)
+            .setTooltip(Text.translatable("config.tinytorch.torch_light_level.tooltip"))
+            .setSaveConsumer(value -> config.torch_light_level = value)
+            .build());
+        
+        lightCategory.addEntry(entryBuilder
+            .startIntSlider(Text.translatable("config.tinytorch.held_light_level"), config.held_light_level, 0, 15)
+            .setDefaultValue(5)
+            .setTooltip(Text.translatable("config.tinytorch.held_light_level.tooltip"))
+            .setSaveConsumer(value -> config.held_light_level = value)
+            .build());
+        
+        lightCategory.addEntry(entryBuilder
+            .startBooleanToggle(Text.translatable("config.tinytorch.use_falloff_curve"), config.use_falloff_curve)
+            .setDefaultValue(true)
+            .setTooltip(Text.translatable("config.tinytorch.use_falloff_curve.tooltip"))
+            .setSaveConsumer(value -> config.use_falloff_curve = value)
+            .build());
+        
+        // Flicker Effects Category
+        ConfigCategory flickerCategory = builder.getOrCreateCategory(Text.translatable("config.tinytorch.category.flicker"));
+        
+        flickerCategory.addEntry(entryBuilder
+            .startBooleanToggle(Text.translatable("config.tinytorch.enable_flicker"), config.enable_flicker)
+            .setDefaultValue(true)
+            .setTooltip(Text.translatable("config.tinytorch.enable_flicker.tooltip"))
+            .setSaveConsumer(value -> config.enable_flicker = value)
+            .build());
+        
+        flickerCategory.addEntry(entryBuilder
+            .startIntSlider(Text.translatable("config.tinytorch.flicker_speed"), config.flicker_speed, 1, 20)
+            .setDefaultValue(5)
+            .setTooltip(Text.translatable("config.tinytorch.flicker_speed.tooltip"))
+            .setSaveConsumer(value -> config.flicker_speed = value)
+            .build());
+        
+        // Dynamic Lighting Category
+        ConfigCategory dynamicCategory = builder.getOrCreateCategory(Text.translatable("config.tinytorch.category.dynamic"));
+        
+        dynamicCategory.addEntry(entryBuilder
+            .startBooleanToggle(Text.translatable("config.tinytorch.held_light"), config.held_light)
+            .setDefaultValue(true)
+            .setTooltip(Text.translatable("config.tinytorch.held_light.tooltip"))
+            .setSaveConsumer(value -> config.held_light = value)
+            .build());
+        
+        return builder.build();
+    }
+}
--- a/src/main/resources/assets/tinytorch/icon.png
+++ b/src/main/resources/assets/tinytorch/icon.png
--- a/src/main/resources/assets/tinytorch/lang/de_de.json
+++ b/src/main/resources/assets/tinytorch/lang/de_de.json
@@ -0,0 +1,40 @@
+{
+  "modmenu.nameTranslation.tinytorch": "TinyTorch",
+  "modmenu.summaryTranslation.tinytorch": "Atmosphärische Fackelbeleuchtung mit konfigurierbarer Helligkeit und Effekten",
+  "modmenu.descriptionTranslation.tinytorch": "TinyTorch macht die Minecraft-Beleuchtung realistischer und atmosphärischer, indem es den Helligkeitsradius von Fackeln reduziert und optional subtile Verblassungs- und Flackereffekte hinzufügt. Es verleiht Höhlen und Nachtszenen ein dunkleres, stimmungsvolleres Aussehen, während Fackeln für die Nahbeleuchtung nützlich bleiben.",
+  
+  "config.tinytorch.title": "TinyTorch Konfiguration",
+  
+  "config.tinytorch.category.light": "Licht-Einstellungen",
+  "config.tinytorch.category.flicker": "Flacker-Effekte",
+  "config.tinytorch.category.dynamic": "Dynamische Beleuchtung",
+  
+  "config.tinytorch.torch_light_level": "Fackel-Lichtstärke",
+  "config.tinytorch.torch_light_level.tooltip": "Lichtstärke von platzierten Fackeln (0-15). Standard: 8",
+  
+  "config.tinytorch.held_light_level": "Gehaltene Fackel-Lichtstärke", 
+  "config.tinytorch.held_light_level.tooltip": "Lichtstärke beim Halten einer Fackel (0-15). Standard: 5",
+  
+  "config.tinytorch.use_falloff_curve": "Scharfer Lichtabfall",
+  "config.tinytorch.use_falloff_curve.tooltip": "Benutzerdefinierte Lichtausbreitung für atmosphärische Beleuchtung verwenden. Standard: wahr",
+  
+  "config.tinytorch.enable_flicker": "Flacker-Effekte Aktivieren",
+  "config.tinytorch.enable_flicker.tooltip": "Aktiviert flackernde Flammeneffekte mit Partikeln. Standard: wahr",
+  
+  "config.tinytorch.flicker_speed": "Flacker-Geschwindigkeit",
+  "config.tinytorch.flicker_speed.tooltip": "Ticks zwischen Flacker-Änderungen. Höher = langsameres Flackern. Standard: 5",
+  
+  "config.tinytorch.held_light": "Gehaltene Fackel-Beleuchtung",
+  "config.tinytorch.held_light.tooltip": "Aktiviert dynamische Beleuchtung beim Halten von Fackeln. Standard: wahr",
+  
+  "command.tinytorch.config.reload": "TinyTorch Konfiguration neu geladen!",
+  "command.tinytorch.config.current": "Aktuelle TinyTorch Einstellungen:",
+  "command.tinytorch.config.torch_light": "Fackel-Lichtstärke: %d",
+  "command.tinytorch.config.held_light": "Gehaltene Fackel-Lichtstärke: %d", 
+  "command.tinytorch.config.flicker": "Flacker-Effekte: %s",
+  "command.tinytorch.config.flicker_speed": "Flacker-Geschwindigkeit: %d",
+  "command.tinytorch.config.falloff": "Scharfer Abfall: %s",
+  "command.tinytorch.config.held": "Gehaltene Beleuchtung: %s",
+  "command.tinytorch.config.set.success": "%s auf %s gesetzt",
+  "command.tinytorch.config.set.invalid": "Ungültiger Wert für %s. Erwartet: %s"
+}
--- a/src/main/resources/assets/tinytorch/lang/en_us.json
+++ b/src/main/resources/assets/tinytorch/lang/en_us.json
@@ -0,0 +1,40 @@
+{
+  "modmenu.nameTranslation.tinytorch": "TinyTorch",
+  "modmenu.summaryTranslation.tinytorch": "Atmospheric torch lighting with configurable brightness and effects",
+  "modmenu.descriptionTranslation.tinytorch": "TinyTorch makes Minecraft lighting more realistic and atmospheric by reducing the brightness radius of torches and optionally adding subtle fading and flickering effects. It gives caves and night scenes a darker, moodier look while keeping torches useful for close-up lighting.",
+  
+  "config.tinytorch.title": "TinyTorch Configuration",
+  
+  "config.tinytorch.category.light": "Light Settings",
+  "config.tinytorch.category.flicker": "Flicker Effects",
+  "config.tinytorch.category.dynamic": "Dynamic Lighting",
+  
+  "config.tinytorch.torch_light_level": "Torch Light Level",
+  "config.tinytorch.torch_light_level.tooltip": "Light level emitted by placed torches (0-15). Default: 8",
+  
+  "config.tinytorch.held_light_level": "Held Light Level", 
+  "config.tinytorch.held_light_level.tooltip": "Light level when holding a torch (0-15). Default: 5",
+  
+  "config.tinytorch.use_falloff_curve": "Sharp Light Falloff",
+  "config.tinytorch.use_falloff_curve.tooltip": "Use custom sharp light falloff for more atmospheric lighting. Default: true",
+  
+  "config.tinytorch.enable_flicker": "Enable Flicker Effects",
+  "config.tinytorch.enable_flicker.tooltip": "Enable flickering flame effect with particles. Default: true",
+  
+  "config.tinytorch.flicker_speed": "Flicker Speed",
+  "config.tinytorch.flicker_speed.tooltip": "Ticks between flicker changes. Higher = slower flickering. Default: 5",
+  
+  "config.tinytorch.held_light": "Held Torch Lighting",
+  "config.tinytorch.held_light.tooltip": "Enable dynamic lighting when holding torches. Default: true",
+  
+  "command.tinytorch.config.reload": "TinyTorch configuration reloaded!",
+  "command.tinytorch.config.current": "Current TinyTorch Settings:",
+  "command.tinytorch.config.torch_light": "Torch Light Level: %d",
+  "command.tinytorch.config.held_light": "Held Light Level: %d", 
+  "command.tinytorch.config.flicker": "Flicker Effects: %s",
+  "command.tinytorch.config.flicker_speed": "Flicker Speed: %d",
+  "command.tinytorch.config.falloff": "Sharp Falloff: %s",
+  "command.tinytorch.config.held": "Held Lighting: %s",
+  "command.tinytorch.config.set.success": "Set %s to %s",
+  "command.tinytorch.config.set.invalid": "Invalid value for %s. Expected: %s"
+}
--- a/src/main/resources/assets/tinytorch/lang/es_mx.json
+++ b/src/main/resources/assets/tinytorch/lang/es_mx.json
@@ -0,0 +1,40 @@
+{
+  "modmenu.nameTranslation.tinytorch": "TinyTorch",
+  "modmenu.summaryTranslation.tinytorch": "Iluminación atmosférica de antorchas con brillo y efectos configurables",
+  "modmenu.descriptionTranslation.tinytorch": "TinyTorch hace que la iluminación de Minecraft sea más realista y atmosférica al reducir el radio de brillo de las antorchas y, opcionalmente, agregar efectos sutiles de desvanecimiento y parpadeo. Brinda a las cuevas y escenas nocturnas una apariencia más oscura y melancólica mientras mantiene las antorchas útiles para la iluminación de cerca.",
+  
+  "config.tinytorch.title": "Configuración de TinyTorch",
+  
+  "config.tinytorch.category.light": "Configuración de Luz",
+  "config.tinytorch.category.flicker": "Efectos de Parpadeo",
+  "config.tinytorch.category.dynamic": "Iluminación Dinámica",
+  
+  "config.tinytorch.torch_light_level": "Nivel de Luz de Antorcha",
+  "config.tinytorch.torch_light_level.tooltip": "Nivel de luz emitido por antorchas colocadas (0-15). Predeterminado: 8",
+  
+  "config.tinytorch.held_light_level": "Nivel de Luz en Mano", 
+  "config.tinytorch.held_light_level.tooltip": "Nivel de luz al sostener una antorcha (0-15). Predeterminado: 5",
+  
+  "config.tinytorch.use_falloff_curve": "Caída de Luz Pronunciada",
+  "config.tinytorch.use_falloff_curve.tooltip": "Usar propagación de luz personalizada para iluminación más atmosférica. Predeterminado: verdadero",
+  
+  "config.tinytorch.enable_flicker": "Habilitar Efectos de Parpadeo",
+  "config.tinytorch.enable_flicker.tooltip": "Habilita el efecto de llama parpadeante con partículas. Predeterminado: verdadero",
+  
+  "config.tinytorch.flicker_speed": "Velocidad de Parpadeo",
+  "config.tinytorch.flicker_speed.tooltip": "Ticks entre cambios de parpadeo. Mayor = parpadeo más lento. Predeterminado: 5",
+  
+  "config.tinytorch.held_light": "Iluminación de Antorcha en Mano",
+  "config.tinytorch.held_light.tooltip": "Habilita iluminación dinámica al sostener antorchas. Predeterminado: verdadero",
+  
+  "command.tinytorch.config.reload": "¡Configuración de TinyTorch recargada!",
+  "command.tinytorch.config.current": "Configuración Actual de TinyTorch:",
+  "command.tinytorch.config.torch_light": "Nivel de Luz de Antorcha: %d",
+  "command.tinytorch.config.held_light": "Nivel de Luz en Mano: %d", 
+  "command.tinytorch.config.flicker": "Efectos de Parpadeo: %s",
+  "command.tinytorch.config.flicker_speed": "Velocidad de Parpadeo: %d",
+  "command.tinytorch.config.falloff": "Caída Pronunciada: %s",
+  "command.tinytorch.config.held": "Iluminación en Mano: %s",
+  "command.tinytorch.config.set.success": "Establecido %s a %s",
+  "command.tinytorch.config.set.invalid": "Valor inválido para %s. Esperado: %s"
+}
--- a/src/main/resources/assets/tinytorch/lang/fr_fr.json
+++ b/src/main/resources/assets/tinytorch/lang/fr_fr.json
@@ -0,0 +1,40 @@
+{
+  "modmenu.nameTranslation.tinytorch": "TinyTorch",
+  "modmenu.summaryTranslation.tinytorch": "Éclairage atmosphérique des torches avec luminosité et effets configurables",
+  "modmenu.descriptionTranslation.tinytorch": "TinyTorch rend l'éclairage de Minecraft plus réaliste et atmosphérique en réduisant le rayon de luminosité des torches et en ajoutant optionnellement des effets subtils de fondu et de scintillement. Il donne aux grottes et aux scènes nocturnes un aspect plus sombre et plus mélancolique tout en gardant les torches utiles pour l'éclairage de proximité.",
+  
+  "config.tinytorch.title": "Configuration TinyTorch",
+  
+  "config.tinytorch.category.light": "Paramètres d'Éclairage",
+  "config.tinytorch.category.flicker": "Effets de Scintillement",
+  "config.tinytorch.category.dynamic": "Éclairage Dynamique",
+  
+  "config.tinytorch.torch_light_level": "Niveau de Lumière des Torches",
+  "config.tinytorch.torch_light_level.tooltip": "Niveau de lumière émis par les torches placées (0-15). Par défaut : 8",
+  
+  "config.tinytorch.held_light_level": "Niveau de Lumière en Main", 
+  "config.tinytorch.held_light_level.tooltip": "Niveau de lumière lors de la tenue d'une torche (0-15). Par défaut : 5",
+  
+  "config.tinytorch.use_falloff_curve": "Chute de Lumière Prononcée",
+  "config.tinytorch.use_falloff_curve.tooltip": "Utiliser une propagation de lumière personnalisée pour un éclairage plus atmosphérique. Par défaut : vrai",
+  
+  "config.tinytorch.enable_flicker": "Activer les Effets de Scintillement",
+  "config.tinytorch.enable_flicker.tooltip": "Active l'effet de flamme scintillante avec des particules. Par défaut : vrai",
+  
+  "config.tinytorch.flicker_speed": "Vitesse de Scintillement",
+  "config.tinytorch.flicker_speed.tooltip": "Ticks entre les changements de scintillement. Plus élevé = scintillement plus lent. Par défaut : 5",
+  
+  "config.tinytorch.held_light": "Éclairage de Torche en Main",
+  "config.tinytorch.held_light.tooltip": "Active l'éclairage dynamique lors de la tenue de torches. Par défaut : vrai",
+  
+  "command.tinytorch.config.reload": "Configuration TinyTorch rechargée !",
+  "command.tinytorch.config.current": "Paramètres Actuels de TinyTorch :",
+  "command.tinytorch.config.torch_light": "Niveau de Lumière des Torches : %d",
+  "command.tinytorch.config.held_light": "Niveau de Lumière en Main : %d", 
+  "command.tinytorch.config.flicker": "Effets de Scintillement : %s",
+  "command.tinytorch.config.flicker_speed": "Vitesse de Scintillement : %d",
+  "command.tinytorch.config.falloff": "Chute Prononcée : %s",
+  "command.tinytorch.config.held": "Éclairage en Main : %s",
+  "command.tinytorch.config.set.success": "Défini %s à %s",
+  "command.tinytorch.config.set.invalid": "Valeur invalide pour %s. Attendu : %s"
+}
--- a/src/main/resources/assets/tinytorch/lang/ja_jp.json
+++ b/src/main/resources/assets/tinytorch/lang/ja_jp.json
@@ -0,0 +1,40 @@
+{
+  "modmenu.nameTranslation.tinytorch": "TinyTorch",
+  "modmenu.summaryTranslation.tinytorch": "設定可能な明度と効果を持つ大気的なたいまつ照明",
+  "modmenu.descriptionTranslation.tinytorch": "TinyTorchは、たいまつの明度半径を減らし、オプションで微妙なフェードとちらつき効果を追加することで、Minecraftの照明をより現実的で大気的にします。洞窟や夜のシーンをより暗く、よりムーディーな外観にしながら、近距離照明でたいまつを有用に保ちます。",
+  
+  "config.tinytorch.title": "TinyTorch設定",
+  
+  "config.tinytorch.category.light": "光の設定",
+  "config.tinytorch.category.flicker": "ちらつき効果",
+  "config.tinytorch.category.dynamic": "動的照明",
+  
+  "config.tinytorch.torch_light_level": "たいまつの光レベル",
+  "config.tinytorch.torch_light_level.tooltip": "設置されたたいまつが発する光レベル (0-15)。デフォルト: 8",
+  
+  "config.tinytorch.held_light_level": "手持ちたいまつの光レベル", 
+  "config.tinytorch.held_light_level.tooltip": "たいまつを持っているときの光レベル (0-15)。デフォルト: 5",
+  
+  "config.tinytorch.use_falloff_curve": "急激な光の減衰",
+  "config.tinytorch.use_falloff_curve.tooltip": "より雰囲気のある照明のためのカスタム光伝播を使用する。デフォルト: true",
+  
+  "config.tinytorch.enable_flicker": "ちらつき効果を有効にする",
+  "config.tinytorch.enable_flicker.tooltip": "パーティクル付きのちらつく炎の効果を有効にする。デフォルト: true",
+  
+  "config.tinytorch.flicker_speed": "ちらつきの速度",
+  "config.tinytorch.flicker_speed.tooltip": "ちらつき変化間のtick数。大きいほどゆっくりちらつく。デフォルト: 5",
+  
+  "config.tinytorch.held_light": "手持ちたいまつ照明",
+  "config.tinytorch.held_light.tooltip": "たいまつを持っているときの動的照明を有効にする。デフォルト: true",
+  
+  "command.tinytorch.config.reload": "TinyTorch設定がリロードされました！",
+  "command.tinytorch.config.current": "現在のTinyTorch設定:",
+  "command.tinytorch.config.torch_light": "たいまつの光レベル: %d",
+  "command.tinytorch.config.held_light": "手持ちたいまつの光レベル: %d", 
+  "command.tinytorch.config.flicker": "ちらつき効果: %s",
+  "command.tinytorch.config.flicker_speed": "ちらつきの速度: %d",
+  "command.tinytorch.config.falloff": "急激な減衰: %s",
+  "command.tinytorch.config.held": "手持ち照明: %s",
+  "command.tinytorch.config.set.success": "%s を %s に設定しました",
+  "command.tinytorch.config.set.invalid": "%s の値が無効です。期待値: %s"
+}
--- a/src/main/resources/assets/tinytorch/lang/pt_br.json
+++ b/src/main/resources/assets/tinytorch/lang/pt_br.json
@@ -0,0 +1,40 @@
+{
+  "modmenu.nameTranslation.tinytorch": "TinyTorch",
+  "modmenu.summaryTranslation.tinytorch": "Iluminação atmosférica de tochas com brilho e efeitos configuráveis",
+  "modmenu.descriptionTranslation.tinytorch": "TinyTorch torna a iluminação do Minecraft mais realista e atmosférica ao reduzir o raio de brilho das tochas e, opcionalmente, adicionar efeitos sutis de desvanecimento e tremulação. Dá às cavernas e cenas noturnas uma aparência mais escura e melancólica, mantendo as tochas úteis para iluminação de perto.",
+  
+  "config.tinytorch.title": "Configuração do TinyTorch",
+  
+  "config.tinytorch.category.light": "Configurações de Luz",
+  "config.tinytorch.category.flicker": "Efeitos de Tremulação",
+  "config.tinytorch.category.dynamic": "Iluminação Dinâmica",
+  
+  "config.tinytorch.torch_light_level": "Nível de Luz da Tocha",
+  "config.tinytorch.torch_light_level.tooltip": "Nível de luz emitido por tochas colocadas (0-15). Padrão: 8",
+  
+  "config.tinytorch.held_light_level": "Nível de Luz da Tocha na Mão", 
+  "config.tinytorch.held_light_level.tooltip": "Nível de luz ao segurar uma tocha (0-15). Padrão: 5",
+  
+  "config.tinytorch.use_falloff_curve": "Queda Acentuada de Luz",
+  "config.tinytorch.use_falloff_curve.tooltip": "Usar propagação de luz personalizada para iluminação mais atmosférica. Padrão: verdadeiro",
+  
+  "config.tinytorch.enable_flicker": "Ativar Efeitos de Tremulação",
+  "config.tinytorch.enable_flicker.tooltip": "Ativa o efeito de chama tremulante com partículas. Padrão: verdadeiro",
+  
+  "config.tinytorch.flicker_speed": "Velocidade de Tremulação",
+  "config.tinytorch.flicker_speed.tooltip": "Ticks entre mudanças de tremulação. Maior = tremulação mais lenta. Padrão: 5",
+  
+  "config.tinytorch.held_light": "Iluminação de Tocha na Mão",
+  "config.tinytorch.held_light.tooltip": "Ativa iluminação dinâmica ao segurar tochas. Padrão: verdadeiro",
+  
+  "command.tinytorch.config.reload": "Configuração do TinyTorch recarregada!",
+  "command.tinytorch.config.current": "Configurações Atuais do TinyTorch:",
+  "command.tinytorch.config.torch_light": "Nível de Luz da Tocha: %d",
+  "command.tinytorch.config.held_light": "Nível de Luz da Tocha na Mão: %d", 
+  "command.tinytorch.config.flicker": "Efeitos de Tremulação: %s",
+  "command.tinytorch.config.flicker_speed": "Velocidade de Tremulação: %d",
+  "command.tinytorch.config.falloff": "Queda Acentuada: %s",
+  "command.tinytorch.config.held": "Iluminação na Mão: %s",
+  "command.tinytorch.config.set.success": "Definido %s para %s",
+  "command.tinytorch.config.set.invalid": "Valor inválido para %s. Esperado: %s"
+}
--- a/src/main/resources/assets/tinytorch/lang/ru_ru.json
+++ b/src/main/resources/assets/tinytorch/lang/ru_ru.json
@@ -0,0 +1,40 @@
+{
+  "modmenu.nameTranslation.tinytorch": "TinyTorch",
+  "modmenu.summaryTranslation.tinytorch": "Атмосферное освещение факелов с настраиваемой яркостью и эффектами",
+  "modmenu.descriptionTranslation.tinytorch": "TinyTorch делает освещение Minecraft более реалистичным и атмосферным, уменьшая радиус яркости факелов и дополнительно добавляя тонкие эффекты затухания и мерцания. Это придает пещерам и ночным сценам более темный, угрюмый вид, сохраняя при этом полезность факелов для освещения вблизи.",
+  
+  "config.tinytorch.title": "Настройки TinyTorch",
+  
+  "config.tinytorch.category.light": "Настройки Освещения",
+  "config.tinytorch.category.flicker": "Эффекты Мерцания",
+  "config.tinytorch.category.dynamic": "Динамическое Освещение",
+  
+  "config.tinytorch.torch_light_level": "Уровень Света Факела",
+  "config.tinytorch.torch_light_level.tooltip": "Уровень света, излучаемого размещенными факелами (0-15). По умолчанию: 8",
+  
+  "config.tinytorch.held_light_level": "Уровень Света Факела в Руке", 
+  "config.tinytorch.held_light_level.tooltip": "Уровень света при держании факела (0-15). По умолчанию: 5",
+  
+  "config.tinytorch.use_falloff_curve": "Резкое Затухание Света",
+  "config.tinytorch.use_falloff_curve.tooltip": "Использовать пользовательское распространение света для более атмосферного освещения. По умолчанию: истина",
+  
+  "config.tinytorch.enable_flicker": "Включить Эффекты Мерцания",
+  "config.tinytorch.enable_flicker.tooltip": "Включает эффект мерцающего пламени с частицами. По умолчанию: истина",
+  
+  "config.tinytorch.flicker_speed": "Скорость Мерцания",
+  "config.tinytorch.flicker_speed.tooltip": "Тики между изменениями мерцания. Больше = медленнее мерцание. По умолчанию: 5",
+  
+  "config.tinytorch.held_light": "Освещение Факела в Руке",
+  "config.tinytorch.held_light.tooltip": "Включает динамическое освещение при держании факелов. По умолчанию: истина",
+  
+  "command.tinytorch.config.reload": "Настройки TinyTorch перезагружены!",
+  "command.tinytorch.config.current": "Текущие Настройки TinyTorch:",
+  "command.tinytorch.config.torch_light": "Уровень Света Факела: %d",
+  "command.tinytorch.config.held_light": "Уровень Света Факела в Руке: %d", 
+  "command.tinytorch.config.flicker": "Эффекты Мерцания: %s",
+  "command.tinytorch.config.flicker_speed": "Скорость Мерцания: %d",
+  "command.tinytorch.config.falloff": "Резкое Затухание: %s",
+  "command.tinytorch.config.held": "Освещение в Руке: %s",
+  "command.tinytorch.config.set.success": "Установлено %s в %s",
+  "command.tinytorch.config.set.invalid": "Недопустимое значение для %s. Ожидается: %s"
+}
--- a/src/main/resources/assets/tinytorch/lang/zh_cn.json
+++ b/src/main/resources/assets/tinytorch/lang/zh_cn.json
@@ -0,0 +1,40 @@
+{
+  "modmenu.nameTranslation.tinytorch": "TinyTorch",
+  "modmenu.summaryTranslation.tinytorch": "具有可配置亮度和效果的大气火把照明",
+  "modmenu.descriptionTranslation.tinytorch": "TinyTorch通过减少火把的亮度半径并可选择添加微妙的渐变和闪烁效果，使Minecraft的照明更加真实和大气。它为洞穴和夜景提供了更暗、更沉郁的外观，同时保持火把在近距离照明中的实用性。",
+  
+  "config.tinytorch.title": "TinyTorch 配置",
+  
+  "config.tinytorch.category.light": "光照设置",
+  "config.tinytorch.category.flicker": "闪烁效果",
+  "config.tinytorch.category.dynamic": "动态光照",
+  
+  "config.tinytorch.torch_light_level": "火把光照等级",
+  "config.tinytorch.torch_light_level.tooltip": "放置的火把发出的光照等级 (0-15)。默认值：8",
+  
+  "config.tinytorch.held_light_level": "手持火把光照等级", 
+  "config.tinytorch.held_light_level.tooltip": "手持火把时的光照等级 (0-15)。默认值：5",
+  
+  "config.tinytorch.use_falloff_curve": "急剧光照衰减",
+  "config.tinytorch.use_falloff_curve.tooltip": "使用自定义光照传播以获得更大气的照明。默认值：true",
+  
+  "config.tinytorch.enable_flicker": "启用闪烁效果",
+  "config.tinytorch.enable_flicker.tooltip": "启用带粒子效果的火焰闪烁。默认值：true",
+  
+  "config.tinytorch.flicker_speed": "闪烁速度",
+  "config.tinytorch.flicker_speed.tooltip": "闪烁变化之间的刻数。数值越高闪烁越慢。默认值：5",
+  
+  "config.tinytorch.held_light": "手持火把光照",
+  "config.tinytorch.held_light.tooltip": "启用手持火把时的动态光照。默认值：true",
+  
+  "command.tinytorch.config.reload": "TinyTorch 配置已重新加载！",
+  "command.tinytorch.config.current": "当前 TinyTorch 设置：",
+  "command.tinytorch.config.torch_light": "火把光照等级：%d",
+  "command.tinytorch.config.held_light": "手持火把光照等级：%d", 
+  "command.tinytorch.config.flicker": "闪烁效果：%s",
+  "command.tinytorch.config.flicker_speed": "闪烁速度：%d",
+  "command.tinytorch.config.falloff": "急剧衰减：%s",
+  "command.tinytorch.config.held": "手持光照：%s",
+  "command.tinytorch.config.set.success": "已将 %s 设置为 %s",
+  "command.tinytorch.config.set.invalid": "%s 的值无效。期望值：%s"
+}
--- a/src/main/resources/fabric.mod.json
+++ b/src/main/resources/fabric.mod.json
@@ -8,8 +8,8 @@
 		"SillyAngel"
 	],
 	"contact": {
-		"homepage": "https://github.com/sillyangel/tinytorch",
-		"sources": "https://github.com/sillyangel/tinytorch"
+		"homepage": "https://git.sillyangel.dev/angel/tinytorch",
+		"sources": "https://git.sillyangel.dev/angel/tinytorch"
 	},
 	"license": "MIT",
 	"icon": "assets/tinytorch/icon.png",
@@ -20,6 +20,9 @@
 		],
 		"fabric-datagen": [
 			"dev.sillyangel.tinytorch.TinyTorchDataGenerator"
+		],
+		"modmenu": [
+			"dev.sillyangel.tinytorch.config.TinyTorchModMenuIntegration"
 		]
 	},
 	"mixins": [
@@ -32,7 +35,15 @@
 		"fabric-api": "*"
 	},
 	"suggests": {
+		"modmenu": "*",
+		"cloth-config2": "*",
 		"sodium": "*",
 		"optifine": "*"
+	},
+	"custom": {
+		"modmenu": {
+			"badges": ["utility"],
+			"update_checker": true
+		}
 	}
 }