## [1.8.3] ### Fixed - **ModMenu settings screen now shows the full FPSFlow configuration again in modern builds** — The modern compatibility screen now exposes the same settings layout as the 1.21.11 build instead of opening an empty or placeholder page. ### Changed - **Version bumped to 1.8.4** — Gradle property `mod_version` updated from `1.8.3` to `1.8.4`. ## [1.8.3] ### Fixed - **Particle optimization is no longer enabled by default in the Balanced profile** — The default profile now keeps particle limits off unless you enable them manually, so visible effects like fishing particles are not filtered out on a fresh install. ### Changed - **Version bumped to 1.8.3** — Gradle property `mod_version` updated from `1.8.2` to `1.8.3`.

## [1.8.3] ### Fixed - **ModMenu settings screen now shows the full FPSFlow configuration again in modern builds** — The modern compatibility screen now exposes the same settings layout as the 1.21.11 build instead of opening an empty or placeholder page. ### Changed - **Version bumped to 1.8.4** — Gradle property `mod_version` updated from `1.8.3` to `1.8.4`. ## [1.8.3] ### Fixed - **Particle optimization is no longer enabled by default in the Balanced profile** — The default profile now keeps particle limits off unless you enable them manually, so visible effects like fishing particles are not filtered out on a fresh install. ### Changed - **Version bumped to 1.8.3** — Gradle property `mod_version` updated from `1.8.2` to `1.8.3`.

## [1.8.2] ### Changed - **Single modern build now supports both Minecraft 26.1.2 and 26.2** — The modern build target now uses a flexible dependency range (`>=26.1` for Minecraft, `>=0.155.1` for Fabric API) in `fabric.mod.json`. A single `gradle buildModern` produces one JAR that works on both Minecraft 26.1.2 and 26.2 without separate artifacts. - **Build system improvements** — Added `minecraft_dep` and `fabric_dep` properties to `build.gradle.kts`, keeping the compile-time dependency pinned to a specific version while declaring a wider runtime compatibility range in the mod metadata. ### Fixed - **Mod rejected on Minecraft 26.1.2** — The previous hard dependency on `Minecraft >=26.2` prevented the mod from loading on 26.1.2. The runtime dependency is now `>=26.1`, accepting all 26.x releases.

## [1.8.2] ### Changed - **Single modern build now supports both Minecraft 26.1.2 and 26.2** — The modern build target now uses a flexible dependency range (`>=26.1` for Minecraft, `>=0.155.1` for Fabric API) in `fabric.mod.json`. A single `gradle buildModern` produces one JAR that works on both Minecraft 26.1.2 and 26.2 without separate artifacts. - **Build system improvements** — Added `minecraft_dep` and `fabric_dep` properties to `build.gradle.kts`, keeping the compile-time dependency pinned to a specific version while declaring a wider runtime compatibility range in the mod metadata. ### Fixed - **Mod rejected on Minecraft 26.1.2** — The previous hard dependency on `Minecraft >=26.2` prevented the mod from loading on 26.1.2. The runtime dependency is now `>=26.1`, accepting all 26.x releases.

## [1.8.1] ### Added - **Lithium-inspired performance optimizations** — FPSFlow 1.8.1 integrates several key optimization techniques adapted from CaffeineMC's excellent [Lithium](https://github.com/CaffeineMC/lithium) mod, reimplemented from scratch to respect Lithium's license and ensure full compatibility with the FPSFlow codebase: - **Compact Sine Table** (`CompactSineTable.java`) — A memory-efficient sine LUT that reduces table size from 256 KB to 64 KB using trigonometric identities (sin(-x) = -sin(x), sin(x) = sin(π/2 - x)). Reduces CPU cache pressure during rotation-heavy rendering while maintaining bit-for-bit compatibility with Minecraft's MathHelper. - **Direction Constants Caching** (`DirectionValuesMixin.java`, `FastDirection.java`) — Prevents repeated defensive array copies from `Direction.values()` in hot code paths by providing cached references. Every call to `Enum.values()` in Java creates a new array allocation; this optimization eliminates that overhead in frequently-called redstone, block update, and entity collision code. - **Fast BlockPos Utilities** (`FastBlockPos.java`) — Thread-local mutable BlockPos for iteration contexts plus efficient long-packing for hash-based collections, reducing GC pressure in chunk scanning and neighbor-iteration hot loops. - **Collection Helper** (`FastCollectionHelper.java`) — Pre-sized HashMap/HashSet factories with optimal initial capacities, identity-based sets for entity classification, and utility methods that avoid the common allocation pitfalls found in vanilla's collection usage. - **Full Lithium attribution** — All adapted code paths include Javadoc `@see` references and `Inspired by` comments linking to the upstream Lithium repository. ### Changed - **Version bumped to 1.8.1** — Gradle property `mod_version` updated from `1.8` to `1.8.1`. - **OptimizationManager module list extended** — New lightweight utility modules are registered on startup (no tick overhead, no Minecraft class dependencies). ### Fixed - None.

## [1.8.1] ### Added - **Lithium-inspired performance optimizations** — FPSFlow 1.8.1 integrates several key optimization techniques adapted from CaffeineMC's excellent [Lithium](https://github.com/CaffeineMC/lithium) mod, reimplemented from scratch to respect Lithium's license and ensure full compatibility with the FPSFlow codebase: - **Compact Sine Table** (`CompactSineTable.java`) — A memory-efficient sine LUT that reduces table size from 256 KB to 64 KB using trigonometric identities (sin(-x) = -sin(x), sin(x) = sin(π/2 - x)). Reduces CPU cache pressure during rotation-heavy rendering while maintaining bit-for-bit compatibility with Minecraft's MathHelper. - **Direction Constants Caching** (`DirectionValuesMixin.java`, `FastDirection.java`) — Prevents repeated defensive array copies from `Direction.values()` in hot code paths by providing cached references. Every call to `Enum.values()` in Java creates a new array allocation; this optimization eliminates that overhead in frequently-called redstone, block update, and entity collision code. - **Fast BlockPos Utilities** (`FastBlockPos.java`) — Thread-local mutable BlockPos for iteration contexts plus efficient long-packing for hash-based collections, reducing GC pressure in chunk scanning and neighbor-iteration hot loops. - **Collection Helper** (`FastCollectionHelper.java`) — Pre-sized HashMap/HashSet factories with optimal initial capacities, identity-based sets for entity classification, and utility methods that avoid the common allocation pitfalls found in vanilla's collection usage. - **Full Lithium attribution** — All adapted code paths include Javadoc `@see` references and `Inspired by` comments linking to the upstream Lithium repository. ### Changed - **Version bumped to 1.8.1** — Gradle property `mod_version` updated from `1.8` to `1.8.1`. - **OptimizationManager module list extended** — New lightweight utility modules are registered on startup (no tick overhead, no Minecraft class dependencies). ### Fixed - None.

## [1.8.0] ### Changed - **Configurable Java target** — The Java version is no longer hardcoded in `build.gradle.kts`. It is now read from the `java_version` property in `gradle.properties` (default: `21`). Set `java_version=25` to build with Java 25. The Mixin compatibility level (`JAVA_21` / `JAVA_25`) and the `remapJar` classifier (`mc1.21.11-java21` / `mc1.21.11-java25`) are derived automatically from this value — nothing is hardcoded. - **Removed broken Java 21 / Java 25 multi-target build** — The previous `targetJavaVersion` switch that attempted to produce separate artifacts for different Minecraft generations never functioned correctly. The build now uses a single, configurable Java version. - **Removed Java 25 properties from `gradle.properties`** — The `minecraft_version_java25`, `yarn_mappings_java25`, `loader_version_java25`, `fabric_version_java25`, and `modmenu_version_java25` properties have been removed. All builds now use the single set of Fabric properties. - **Simplified `build.gradle.kts`** — Dead code removed, all comments translated to English, ModMenu removed from compile-time dependencies. The integration class now uses a matching method signature that ModMenu calls via reflection, eliminating the compile-time dependency that caused build failures when ModMenu artifacts were unavailable. - **Fixed TerraformersMC Maven repository URL** — Changed from `https://terraformersmc.com` to `https://maven.terraformersmc.com` for correct dependency resolution. - **Improved `fabric.mod.json`** — Description updated to match the Modrinth page; `fabricloader` and `fabric-api` dependency minimums tightened to `>=0.19.3` and `>=0.141.4` respectively. - **Updated `how_to_build.md`** — Rewritten for the single configurable Java build path; references to the removed `buildJava21` / `buildJava25` tasks eliminated. - **Updated `settings.gradle.kts`** — Removed version lock for fabric-loom and simplified plugin repository configuration. - **Fabric API version corrected** — Changed from `0.19.3+26.2` (invalid) to `0.141.4+1.21.11` (correct for MC 1.21.11). - **Build verified with Java 25** — Successfully compiled and remapped `fpsflow-1.8.0-mc1.21.11-java25.jar`. - **Version migration guide** — Added `VERSION_MIGRATION.md` documenting short-term (Yarn) and long-term (Mojang mappings) strategies. ### Fixed - **ModMenu integration was broken** — `FPSFlowModMenuIntegration.createConfigScreen()` returned `null`, causing a `NullPointerException` when a player clicked the Config button in ModMenu. The class now properly implements `ModMenuFactory` and returns a `FPSFlowConfigScreen` instance. - **Duplicate translation keys in `en_us.json` and `de_de.json`** — The `entity_lod` and `item_frame` key blocks were duplicated, with the first occurrence silently overwritten by the second. All duplicate blocks have been merged into single, complete entries. - **Missing translation keys** — Added `entity_culling.painting_backface_culling`, `entity_culling.painting_backface_culling.tooltip`, and `nameplate_culling.enabled.tooltip` to both language files. These keys were referenced by the config screen but had no translations, causing fallback to the raw key string. - **Dead variable in `settings.gradle.kts`** — The `mcVersion` variable was read from Gradle properties but never used in the `fabric-loom` resolution strategy. Removed. ### Removed - **`i18n_pending_keys.txt` and `README_UI_KEYS.txt`** — These development artifacts tracked missing translation keys. All keys are now present in both language files, so these files are no longer needed. - **`gradlew` and `gradle/wrapper/`** — The Gradle wrapper is unnecessary when Gradle is installed system-wide. Users can build directly with `gradle build`. - **Yarn OFFICIAL mapping mode** — Temporarily removed; Loom 1.17.3 requires explicit Yarn mappings.

## [1.8.0] ### Changed - **Configurable Java target** — The Java version is no longer hardcoded in `build.gradle.kts`. It is now read from the `java_version` property in `gradle.properties` (default: `21`). Set `java_version=25` to build with Java 25. The Mixin compatibility level (`JAVA_21` / `JAVA_25`) and the `remapJar` classifier (`mc1.21.11-java21` / `mc1.21.11-java25`) are derived automatically from this value — nothing is hardcoded. - **Removed broken Java 21 / Java 25 multi-target build** — The previous `targetJavaVersion` switch that attempted to produce separate artifacts for different Minecraft generations never functioned correctly. The build now uses a single, configurable Java version. - **Removed Java 25 properties from `gradle.properties`** — The `minecraft_version_java25`, `yarn_mappings_java25`, `loader_version_java25`, `fabric_version_java25`, and `modmenu_version_java25` properties have been removed. All builds now use the single set of Fabric properties. - **Simplified `build.gradle.kts`** — Dead code removed, all comments translated to English, ModMenu removed from compile-time dependencies. The integration class now uses a matching method signature that ModMenu calls via reflection, eliminating the compile-time dependency that caused build failures when ModMenu artifacts were unavailable. - **Fixed TerraformersMC Maven repository URL** — Changed from `https://terraformersmc.com` to `https://maven.terraformersmc.com` for correct dependency resolution. - **Improved `fabric.mod.json`** — Description updated to match the Modrinth page; `fabricloader` and `fabric-api` dependency minimums tightened to `>=0.19.3` and `>=0.141.4` respectively. - **Updated `how_to_build.md`** — Rewritten for the single configurable Java build path; references to the removed `buildJava21` / `buildJava25` tasks eliminated. - **Updated `settings.gradle.kts`** — Removed version lock for fabric-loom and simplified plugin repository configuration. - **Fabric API version corrected** — Changed from `0.19.3+26.2` (invalid) to `0.141.4+1.21.11` (correct for MC 1.21.11). - **Build verified with Java 25** — Successfully compiled and remapped `fpsflow-1.8.0-mc1.21.11-java25.jar`. - **Version migration guide** — Added `VERSION_MIGRATION.md` documenting short-term (Yarn) and long-term (Mojang mappings) strategies. ### Fixed - **ModMenu integration was broken** — `FPSFlowModMenuIntegration.createConfigScreen()` returned `null`, causing a `NullPointerException` when a player clicked the Config button in ModMenu. The class now properly implements `ModMenuFactory` and returns a `FPSFlowConfigScreen` instance. - **Duplicate translation keys in `en_us.json` and `de_de.json`** — The `entity_lod` and `item_frame` key blocks were duplicated, with the first occurrence silently overwritten by the second. All duplicate blocks have been merged into single, complete entries. - **Missing translation keys** — Added `entity_culling.painting_backface_culling`, `entity_culling.painting_backface_culling.tooltip`, and `nameplate_culling.enabled.tooltip` to both language files. These keys were referenced by the config screen but had no translations, causing fallback to the raw key string. - **Dead variable in `settings.gradle.kts`** — The `mcVersion` variable was read from Gradle properties but never used in the `fabric-loom` resolution strategy. Removed. ### Removed - **`i18n_pending_keys.txt` and `README_UI_KEYS.txt`** — These development artifacts tracked missing translation keys. All keys are now present in both language files, so these files are no longer needed. - **`gradlew` and `gradle/wrapper/`** — The Gradle wrapper is unnecessary when Gradle is installed system-wide. Users can build directly with `gradle build`. - **Yarn OFFICIAL mapping mode** — Temporarily removed; Loom 1.17.3 requires explicit Yarn mappings.

## [1.7.14] ### Fixed - Crash on launch on Minecraft 26.1.2 caused by lingering `net/minecraft/class_####` (intermediary) references in the release artifact mapping/remap pipeline. - Mixin loading is now fail-soft (`defaultRequire=0`) so missing/renamed targets from mapping drift no longer hard-crash the mod. - Updated mixin Java compatibility level to `JAVA_21` to match the project/toolchain.

## [1.7.13] ### Fixed - Crash on launch on Minecraft 26.1.2 caused by lingering `net/minecraft/class_####` (intermediary) references in the release artifact mapping/remap pipeline.