Add configuration and optimization transformers for Hytale plugin

- Introduced CatalystConfigFile to manage plugin configuration via JSON.
- Implemented ChunkRateTransformer to allow configurable chunk loading rates.
- Added EntityDistanceTransformer for adjustable entity view distance multipliers.
- Created PathfindingConfigTransformer to configure A* pathfinding parameters.
- Added utility class OptimizationMetrics to read runtime metrics from transformed classes.
- Updated service loader configuration to include new transformers.

Author: CriticalRange

CHANGELOG.md

@@ -2,6 +2,34 @@
 
 All notable changes to Catalyst will be documented in this file.
 
+## [0.2.0] - 2026-01-21
+
+### Added
+- **Entity Distance Control**: Configurable entity view distance multiplier (default: 1.0)
+  - Adjusts how far entities are visible/processed
+  - Lower values improve server performance
+- **Chunk Rate Control**: Configurable chunks processed per tick (default: 1)
+  - Limits chunk loading speed to prevent server lag spikes
+- **Pathfinding Optimization**: Configurable pathfinding timeout reduction (default: 50%)
+  - Reduces CPU usage from entity pathfinding calculations
+- **Reset to Defaults Button**: One-click reset in settings GUI to restore all defaults
+- **Optimization Metrics**: Track performance impact of enabled optimizations
+
+### Changed
+- **UI Redesign**: Complete settings UI overhaul following Hytale design patterns
+  - Organized into logical sections with color-coded headers
+  - Fixed position elements (reset button at bottom)
+  - Removed missing texture references that caused red backgrounds
+  - Improved layout with proper scrolling sections
+- **Slider Values Fixed**: Corrected property type from `.Text` to `.Value` for numeric sliders
+- **Improved transformer base class**: Better error handling and logging
+
+### Fixed
+- Fixed slider value setting error (now uses correct `.Value` property)
+- Fixed red background in UI sections (removed missing texture reference)
+- Fixed reset button position (now at fixed bottom position, not scrolling)
+- Fixed checkbox value binding in settings UI
+
 ## [0.1.1] - 2026-01-19
 
 ### Added

build.gradle

@@ -165,6 +165,39 @@ task deployEarlyPlugin(type: Copy) {
     }
 }
 
+// Task to deploy to both earlyplugins and mods directories
+task deploy {
+    group = 'Hytale'
+    description = 'Deploys the mod to both earlyplugins (transformers) and mods (commands/GUI) directories'
+    dependsOn shadowJar
+
+    doLast {
+        def earlyPluginsDir = file("${hytaleBaseDir}/earlyplugins")
+        def modsDir = file("${hytaleBaseDir}/mods")
+
+        if (!earlyPluginsDir.exists()) {
+            earlyPluginsDir.mkdirs()
+        }
+        if (!modsDir.exists()) {
+            modsDir.mkdirs()
+        }
+
+        copy {
+            from shadowJar.archiveFile
+            into earlyPluginsDir
+        }
+        copy {
+            from shadowJar.archiveFile
+            into modsDir
+        }
+
+        logger.lifecycle("Deployed Catalyst to:")
+        logger.lifecycle("  - ${earlyPluginsDir} (transformers)")
+        logger.lifecycle("  - ${modsDir} (commands/GUI)")
+        logger.lifecycle("Restart the Hytale server to apply changes.")
+    }
+}
+
 test {
     useJUnitPlatform()
 }
@@ -296,16 +329,24 @@ task runServer(type: JavaExec) {
         // Create run directory structure
         runDir.mkdirs()
         file("$runDir/earlyplugins").mkdirs()
+        file("$runDir/mods").mkdirs()
 
-        // Copy JAR to earlyplugins directory
+        // Copy JAR to earlyplugins directory (for transformers)
         copy {
             from shadowJar.archiveFile
             into file("$runDir/earlyplugins")
         }
 
+        // Copy JAR to mods directory (for commands/GUI)
+        copy {
+            from shadowJar.archiveFile
+            into file("$runDir/mods")
+        }
+
         logger.lifecycle("Starting Hytale server...")
         logger.lifecycle("Working directory: ${runDir}")
         logger.lifecycle("Early plugins: ${runDir}/earlyplugins/")
+        logger.lifecycle("Mods: ${runDir}/mods/")
         logger.lifecycle("Server data (universe/, logs/) will be created in ${runDir}")
     }
 
@@ -584,7 +625,7 @@ task vscode {
 }
 
 // Eclipse launch configuration generation
-task eclipse {
+task eclipseConfig {
     group = 'IDE'
     description = 'Generates Eclipse launch configuration for Hytale Server'
 
@@ -631,7 +672,7 @@ task eclipse {
 task ide {
     group = 'IDE'
     description = 'Generates run configurations for all supported IDEs (VSCode, Eclipse, IntelliJ)'
-    dependsOn vscode, eclipse
+    dependsOn vscode, eclipseConfig
 }
 
 // Publishing configuration

gradle.properties

@@ -1,6 +1,6 @@
 group=com.criticalrange
 name=Catalyst
-version=0.1.1
+version=0.2.0
 java_version=25
 mod_description=Hytale Performance Optimization Mod - High-performance Early Plugin using bytecode transformation for server optimization
 website=https://github.com/CriticalRange/catalyst

src/main/java/com/criticalrange/Catalyst.java

@@ -17,6 +17,9 @@
  *   <li>Lazy block entity initialization - defers creation until needed</li>
  *   <li>Lazy block tick discovery - defers ticking block detection</li>
  *   <li>Lazy fluid pre-processing - defers fluid simulation during chunk load</li>
+ *   <li>Entity view distance - configurable entity sync distance multiplier</li>
+ *   <li>Chunk rate - configurable chunks per tick</li>
+ *   <li>Pathfinding limits - configurable A* pathfinding parameters</li>
  * </ul>
  *
  * @author CriticalRange
@@ -25,6 +28,7 @@ public class Catalyst extends JavaPlugin {
 
     private static Catalyst instance;
     private CatalystTransformerManager transformerManager;
+    private CatalystConfigFile configFile;
 
     public Catalyst(@Nonnull JavaPluginInit init) {
         super(init);
@@ -50,6 +54,13 @@ public String getVersion() {
 
     @Override
     protected void setup() {
+        // Load configuration from file
+        configFile = new CatalystConfigFile(getDataDirectory());
+        configFile.load();
+
+        // Sync config values to injected fields in transformed classes
+        syncConfigToInjectedFields();
+
         transformerManager = new CatalystTransformerManager();
 
         try {
@@ -70,6 +81,12 @@ protected void start() {
     @Override
     protected void shutdown() {
         log("Catalyst shutting down...");
+
+        // Save configuration to file
+        if (configFile != null) {
+            configFile.save();
+        }
+
         log("\n" + CatalystMetrics.generateReport());
         if (transformerManager != null) {
             transformerManager.logMetrics();
@@ -83,6 +100,16 @@ private void logConfig() {
         log("    - Block Entities: " + s(CatalystConfig.LAZY_BLOCK_ENTITIES_ENABLED));
         log("    - Block Tick: " + s(CatalystConfig.LAZY_BLOCK_TICK_ENABLED));
         log("    - Fluid: " + s(CatalystConfig.LAZY_FLUID_ENABLED));
+        log("  Runtime Optimizations:");
+        log("    - Entity Distance: " + s(CatalystConfig.ENTITY_DISTANCE_ENABLED) + 
+            " (multiplier: " + CatalystConfig.ENTITY_VIEW_MULTIPLIER + ")");
+        log("    - Chunk Rate: " + s(CatalystConfig.CHUNK_RATE_ENABLED) + 
+            " (chunks/tick: " + CatalystConfig.CHUNKS_PER_TICK + ")");
+        log("  Pathfinding:");
+        log("    - Custom Limits: " + s(CatalystConfig.PATHFINDING_ENABLED));
+        log("    - Max Path Length: " + CatalystConfig.MAX_PATH_LENGTH);
+        log("    - Open Nodes: " + CatalystConfig.OPEN_NODES_LIMIT);
+        log("    - Total Nodes: " + CatalystConfig.TOTAL_NODES_LIMIT);
     }
 
     private String s(boolean enabled) {
@@ -93,7 +120,97 @@ private void log(String message) {
         System.out.println("[Catalyst] " + message);
     }
 
+    /**
+     * Syncs CatalystConfig values to the injected fields in transformed Hytale classes.
+     * This must be called after loading config but before the server starts using these values.
+     */
+    private void syncConfigToInjectedFields() {
+        // Lazy loading fields
+        setStaticField("com.hypixel.hytale.server.core.modules.block.BlockModule",
+            "$catalystLazyBlockEntities", CatalystConfig.LAZY_BLOCK_ENTITIES_ENABLED);
+        setStaticField("com.hypixel.hytale.builtin.blocktick.BlockTickPlugin",
+            "$catalystLazyBlockTick", CatalystConfig.LAZY_BLOCK_TICK_ENABLED);
+        setStaticField("com.hypixel.hytale.builtin.fluid.FluidPlugin",
+            "$catalystLazyFluid", CatalystConfig.LAZY_FLUID_ENABLED);
+
+        // Entity distance fields
+        setStaticField("com.hypixel.hytale.server.core.universe.Universe",
+            "$catalystEntityDistEnabled", CatalystConfig.ENTITY_DISTANCE_ENABLED);
+        setStaticField("com.hypixel.hytale.server.core.universe.Universe",
+            "$catalystEntityViewMultiplier", CatalystConfig.ENTITY_VIEW_MULTIPLIER);
+
+        // Chunk rate fields
+        setStaticField("com.hypixel.hytale.server.core.modules.entity.player.ChunkTracker",
+            "$catalystChunkRateEnabled", CatalystConfig.CHUNK_RATE_ENABLED);
+        setStaticField("com.hypixel.hytale.server.core.modules.entity.player.ChunkTracker",
+            "$catalystChunksPerTick", CatalystConfig.CHUNKS_PER_TICK);
+
+        // Pathfinding fields
+        setStaticField("com.hypixel.hytale.server.npc.navigation.AStarBase",
+            "$catalystPathfindingEnabled", CatalystConfig.PATHFINDING_ENABLED);
+        setStaticField("com.hypixel.hytale.server.npc.navigation.AStarBase",
+            "$catalystMaxPathLength", CatalystConfig.MAX_PATH_LENGTH);
+        setStaticField("com.hypixel.hytale.server.npc.navigation.AStarBase",
+            "$catalystOpenNodesLimit", CatalystConfig.OPEN_NODES_LIMIT);
+        setStaticField("com.hypixel.hytale.server.npc.navigation.AStarBase",
+            "$catalystTotalNodesLimit", CatalystConfig.TOTAL_NODES_LIMIT);
+    }
+
+    private void setStaticField(String className, String fieldName, boolean value) {
+        try {
+            Class<?> clazz = Class.forName(className);
+            java.lang.reflect.Field field = clazz.getField(fieldName);
+            field.setBoolean(null, value);
+        } catch (ClassNotFoundException e) {
+            // Class not loaded yet - this is fine, field will use default
+            log("  [Sync] " + className.substring(className.lastIndexOf('.') + 1) + " not loaded yet");
+        } catch (NoSuchFieldException e) {
+            // Field doesn't exist - transformer may not have run
+            log("  [Sync] Field " + fieldName + " not found in " + className);
+        } catch (Exception e) {
+            log("  [Sync] Failed to set " + fieldName + ": " + e.getMessage());
+        }
+    }
+
+    private void setStaticField(String className, String fieldName, int value) {
+        try {
+            Class<?> clazz = Class.forName(className);
+            java.lang.reflect.Field field = clazz.getField(fieldName);
+            field.setInt(null, value);
+        } catch (ClassNotFoundException e) {
+            // Class not loaded yet - this is fine, field will use default
+            log("  [Sync] " + className.substring(className.lastIndexOf('.') + 1) + " not loaded yet");
+        } catch (NoSuchFieldException e) {
+            // Field doesn't exist - transformer may not have run
+            log("  [Sync] Field " + fieldName + " not found in " + className);
+        } catch (Exception e) {
+            log("  [Sync] Failed to set " + fieldName + ": " + e.getMessage());
+        }
+    }
+
     public CatalystTransformerManager getTransformerManager() {
         return transformerManager;
     }
+
+    /**
+     * Saves the current configuration to the config file.
+     * Call this after making changes to {@link CatalystConfig} to persist them.
+     */
+    public void saveConfig() {
+        if (configFile != null) {
+            configFile.save();
+        }
+    }
+
+    /**
+     * Reloads configuration from the config file.
+     *
+     * @return true if config was reloaded successfully
+     */
+    public boolean reloadConfig() {
+        if (configFile != null) {
+            return configFile.load();
+        }
+        return false;
+    }
 }