ВЕРСИИ (29)

## [1.0.30+26.3] ### Fixed - **Knot ClassLoader Safety**: Purged legacy `ModVersionGuard` and string reflection runtime hazards (`Class.forName(...)`), preventing classloader crashes in production client and dedicated server environments. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/IG-item-clumps/issues) - [Source Code](https://github.com/Rifaditya/IG-item-clumps) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/ig-item-clumps/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.1+1.21.11] ### Fixed - **Knot ClassLoader Safety**: Purged legacy `ModVersionGuard` and string reflection runtime hazards (`Class.forName(...)`), preventing classloader crashes in production client and dedicated server environments. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/IG-item-clumps/issues) - [Source Code](https://github.com/Rifaditya/IG-item-clumps) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/ig-item-clumps/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.1+1.21.1] ### Fixed - **Knot ClassLoader Safety**: Purged legacy `ModVersionGuard` and string reflection runtime hazards (`Class.forName(...)`), preventing classloader crashes in production client and dedicated server environments. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/IG-item-clumps/issues) - [Source Code](https://github.com/Rifaditya/IG-item-clumps) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/ig-item-clumps/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.1+1.20.1] ### Fixed - **Knot ClassLoader Safety**: Purged legacy `ModVersionGuard` and string reflection runtime hazards (`Class.forName(...)`), preventing classloader crashes in production client and dedicated server environments. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/IG-item-clumps/issues) - [Source Code](https://github.com/Rifaditya/IG-item-clumps) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/ig-item-clumps/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.29+26.3] ### Added - **Minecraft 26.3 Release Support**: Fully upgraded and verified for the stable Minecraft 26.3 release with Fabric Loader 0.19.5 and Fabric API 0.161.0+26.3. - **DasikLibrary 1.9.2 Integration**: Aligned with the latest DasikLibrary 1.9.2 runtime for robust dynamic GameRule handling and centralized configuration management. ### Changed - **Toolchain Modernization**: Migrated to Fabric Loom 1.15.2 and streamlined build pipeline for optimal compatibility. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/IG-item-clumps/issues) - [Source Code](https://github.com/Rifaditya/IG-item-clumps) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/ig-item-clumps/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.0+1.21.11] ### Added - **Minecraft 1.21.11 Older Anchor Port**: Established dedicated anchor subproject for Minecraft 1.21.11 with multi-era parity and zero cross-version reflection. - **DasikLibrary 1.1.0 Integration**: Standardized on DasikLibrary 1.1.0 dynamic GameRule and config subsystems. - **Full Feature Parity**: Full parity with modern features including non-invasive MixinExtras, holographic clump labels, and in-game YACL configuration. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/IG-item-clumps/issues) - [Source Code](https://github.com/Rifaditya/IG-item-clumps) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/ig-item-clumps/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.0+1.21.1] ### Added - **Minecraft 1.21.1 Older Anchor Port**: Established dedicated anchor subproject for Minecraft 1.21.1 with multi-era parity and zero cross-version reflection. - **DasikLibrary 1.1.0 Integration**: Standardized on DasikLibrary 1.1.0 dynamic GameRule and config subsystems. - **Full Feature Parity**: Full parity with modern features including non-invasive MixinExtras, holographic clump labels, and in-game YACL configuration. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/IG-item-clumps/issues) - [Source Code](https://github.com/Rifaditya/IG-item-clumps) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/ig-item-clumps/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.0+1.20.1] ### Added - **Minecraft 1.20.1 Legacy Anchor Port**: Established dedicated anchor subproject for Minecraft 1.20.1 with multi-era parity and zero cross-version reflection. - **DasikLibrary 1.0.0 Integration**: Standardized on DasikLibrary 1.0.0 dynamic GameRule and config subsystems. - **Full Feature Parity**: Full parity with modern features including non-invasive MixinExtras, holographic clump labels, and in-game configuration. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/IG-item-clumps/issues) - [Source Code](https://github.com/Rifaditya/IG-item-clumps) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/ig-item-clumps/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.26+26.2] ### Changed - **Mixin Modernization**: Replaced invasive method `@Redirect` on `AABB.inflate(...)` in `ItemEntityMixin` with non-invasive `@ModifyExpressionValue` from MixinExtras, ensuring high compatibility with other entity/performance mods. - **Player Agency & True Sandbox Freedom**: Unlocked `MERGE_RADIUS` from `.range(1, 10)` to `.range(1, Integer.MAX_VALUE)` in accordance with the Player Agency & Anti-Nanny Invariant (lower bound 1 preserved to prevent fatal bounding box crashes). - **License Header Standardization**: Normalized headers to single-line GPLv3 format.

## [1.0.25+26.2] ### Changed - Clean up config warning wording and remove repetitive notice boilerplate from option descriptions.

## [1.0.7+26.1.2] ### Changed - Clean up config warning wording and remove repetitive notice boilerplate from option descriptions.

## [1.0.24+26.2] ### Changed - **In-Game Creator Support Button:** Injected top-pinned Ko-fi creator support button at index 0 of options group in YACL configuration screen via `DasikSupportHelper.createYaclButton()`.

## [1.0.6+26.1.2] ### Changed - - **YACL Migration & Ko-fi Support**: Migrated in-game configuration GUI from Cloth Config to YetAnotherConfigLib v3 (YACL) with top-pinned Ko-fi creator support button. Upgraded to DasikLibrary 1.8.38.

## [1.0.5+26.1.2] ### Changed - - **Label Min Count GameRule**: Registered `item_clumps:label_min_count` GameRule and config option for MC 26.1.2, fixing `Unknown registry key` on world load. - **Performance & Mod Interop Parity**: Removed entity tick overhead by updating labels on `setItem`, converted merge radius to fast `@Redirect`, added `magnet` mod reflection interop, and integrated `ModVersionGuard`.

## [1.0.4+26.1.2] ### Changed - - Standardized Config Warning. - Appended gold warning notice to option descriptions to clarify that changing config values only defines default settings for newly created worlds.

## [1.0.21+26.2] - 2026-07-15 ### Fixed - Fixed compatibility mismatch with Magnet mod version 26.2. The reflection helper now queries for the new `ig_magnet$isMagnetized` method signature first, falling back to the 26.1 `ig$isMagnetized` signature, preventing items from clumping while in magnet flight. - Fixed properties synchronization during partial merges. The target item entity now inherits `pickupDelay` and `age` from the merged entity, preventing items from bypassing pickup delays or despawning prematurely.

## [1.0.20+26.2] - 2026-07-14 ### Fixed - Fixed ModMenu configuration screen factory initialization. Replaced the obsolete `ClothConfigScreenHelper` reference (which was deleted in 1.0.18 during YACL migration) with `YaclScreenHelper` and updated the initialization helper to `GuiHelper.getOptionalYaclFactory`, restoring functionality to the client-side config screen when ModMenu is installed. ## [1.0.19+26.2] - 2026-07-11 ### Removed - Removed live GameRule sync on config save. Changing config values now only defines default settings for new worlds, allowing each world to maintain independent GameRule settings. - Switched config screen Option descriptions to use dedicated config-specific translation keys with the `§6Notice:§r` warning notice.

## [1.0.18+26.2] - 2026-07-07 ### Added - Migrated client configuration GUI screen from **Cloth Config** to **YetAnotherConfigLib (YACL)**. - Aligned ground clumping limits dynamically to match Stack Size Adjuster's custom limits when both mods are installed. - Hidden/disabled the redundant "Max Clump Size" GameRule and config options when Stack Size Adjuster is loaded.

## [1.0.17+26.2] - 2026-07-07 ### Fixed - Fixed a math integer overflow bug in `tryToMerge` where merging ground item entities under massive stack sizes (millions/billions) could overflow to negative stack counts, causing infinite loops and game crashes.

## [1.0.16+26.2] - 2026-07-06 ### Added - Added `label_min_count` Config and dynamic GameRule setting. Default value is `-1` which uses vanilla default stackable limits. If set to a positive integer, clump labels will only render when the stack size is larger than that number.

## 1.0.15+26.2 *Released: July 6, 2026* ### Fixed * **What**: Fixed missing ground item count labels when used alongside Stack Size Adjuster. * **Why**: The Stack Size Adjuster mod overrides `getMaxStackSize()` to return custom larger limits (e.g. 640). Item Clumps was checking `stack.getMaxStackSize()` to determine if count was above limit, which failed because the count (e.g., 100) was less than 640. * **How**: Modified `ItemEntityMixin.java` to fetch default max stack size from components (`stack.getOrDefault(DataComponents.MAX_STACK_SIZE, 1)`) bypassing the overridden `getMaxStackSize()`.

## 1.0.14+R-26.2 ### Changed - **ModMenu GUI Refactor**: Migrated configuration screen loading in `ModMenuIntegration` to use the reflection-based `GuiHelper.getOptionalFactory` from `DasikLibrary` for safe server/client classloader isolation. - **New World Warning**: Added a warning text description at the top of the general Cloth Config category to alert users that options only adjust new world defaults. - **Dependencies**: Bumped `dasik-library` minimum dependency to version `1.8.2`. ---

## [1.0.12+R-26.2] ### Summary The production **Release** version enabling multi-version compatibility. - **Multi-Version Compatibility**: Widened dependencies and verified codebase APIs to support both Minecraft **26.1.2** and **26.2** (compiled against **26.2-pre-3**). - **Core Optimizations Stabilized**: Production-grade verification of `copyWithCount` API optimization, `tryToMerge` fast-path optimizations, and optional `cloth-config` / `modmenu` GUI configurations. ## [1.0.11+A-26.2] ### Summary The **"tryToMerge Fast-Path Checks"** update. - **tryToMerge Optimization**: Reordered checks in `tryToMerge` inside `ItemEntityMixin.java` to perform cheap item/target compatibility comparisons first. Mismatching items now exit instantly before doing expensive Map-based GameRule lookups or reflection calls. ## [1.0.10+A-26.2] ### Summary The **"copyWithCount API Optimization"** update. - **copyWithCount Optimization**: Replaced two-step `.copy()` and `.setCount()` calls inside `ItemEntityMixin` (merging/pickups) and `HopperBlockEntityMixin` (hopper extraction) with a single call to the native `copyWithCount(int)` API. This reduces total object allocation overhead in JVM heap memory. ## [1.0.9+A-26.2] ### Summary The **"Magnet Mod Compatibility"** update. - **Magnet Compatibility**: Added dynamic reflection-based check for the `magnet` mod during item merges (`tryToMerge`). Prevents items from clumping while in-flight under magnet attraction, ensuring smooth physics paths and preventing visual warping or loss of velocity. ## [1.0.8+A-26.2] ### Summary The **"Search Radius Optimization"** update. - **ModifyArgs Redirect Optimization**: Replaced the `@ModifyArgs` injection targeting `AABB.inflate()` in `ItemEntityMixin` with a `@Redirect` call. This prevents array/object allocations at runtime, improving garbage collection behavior during item clumping checks. ## [1.0.7+A-26.2] ### Summary The **"Pickup Loop Optimization"** update. - **smartPickup Optimization**: Refactored `smartPickup` in `ItemEntityMixin` to use Minecraft's native single-batch inventory addition. This eliminates chunk-by-chunk iteration, list splitting, and multiple object allocations when picking up mega-clumps.

## [1.0.6+A-26.2] - 2026-05-30 ### Summary The **"Minecraft 26.2 Upgrade & Tick Optimization"** update. - **Tick Optimization**: Removed the per-tick mixin hook on `ItemEntity.tick()` that updated the vanilla name tag. Moving this update exclusively to `setItem()` eliminates constant queries to the GameRules API and string allocations for non-moving ground items. - **Minecraft 26.2 Upgrade**: Upgraded the project dependency configurations to target Minecraft `26.2-pre-2` and Fabric API `0.149.2+local`. - when it released i will publish the released version both in 26.1.2 and 26.2 rn im testing the pre releases

# Changelog ## [1.0.5+A-26.1.2] - 2026-05-26 ### Summary The **"ConfigHelper Migration"** update. Refactors configuration loading and saving to use the standard centralized API in `DasikLibrary`. - **Config Migration**: Refactored `ItemClumpsConfig` to delegate all deserialization, serialization, backup, size limit checking, and atomic swap writes to the library's centralized `ConfigHelper` class. - **Runtime Dependency Guard**: Added a runtime version verification at startup. If `DasikLibrary` version is less than `1.7.4` (or `ConfigHelper` is missing), the game aborts and throws a Minecraft `ReportedException` wrapping a descriptive `CrashReport`: `"Item Clumps: DasikLibrary version mismatch! Requires version 1.7.4 or higher. Please update your mods."` - **⚠️ WARNING**: This version requires the newest **`DasikLibrary 1.7.4`** or higher. Older library versions will trigger the crash report. ## [1.0.4+A-26.1.2] - 2026-05-26 ### Summary The **"Library Update & Sync Fix"** release. Bumps DasikLibrary dependency to 1.7.2 and fixes client-server desync. - **Client-Server Count Desync**: Added stack copying before count modifications in entity merging (`tryToMerge`), player pickups (`playerTouch`), and hopper collections. This ensures that the mutated `ItemStack` has a different object reference, forcing Minecraft's `SyncedEntityData` to register the change and broadcast metadata packets to all tracking clients. - **Library Version Bump**: Updated project dependencies to require `dasik-library` version `1.7.2` or later. - **Dual-Side Game Rule Lookup Parity**: Updated integration to support the new dual-side query helpers in `DynamicGameRuleManager` from DasikLibrary. ## [1.0.3+R-26.1.2] - 2026-05-23 ### Summary The production **Release** version of the **"Optional GUI Configuration"** updates. - **Optional GUI Configuration**: Added optional integration with **Cloth Config** and **ModMenu** for clients that have these mods installed. Allows players to customize baseline defaults for new worlds via a graphical config menu. - **Metadata Suggestions**: Updated `fabric.mod.json` to suggest `cloth-config` and `modmenu` instead of strictly requiring them.

1.0.0+build.10 Released: May 20, 2026 Added Root README & License: Created missing GPLv3 license and comprehensive project README at root featuring badges, installation, configuration reference, and guide indexes. Changed Documentation Parity: Updated concept_item_clumps.md config type definitions and architecture.md sequence diagrams to match actual codebase implementations (optimized larger-absorbs-smaller clumping, age inheritance, and integer merge radius). Fixed Source Verification & Imports: Cleaned up unused imports in all Mixin classes and added required Source Verification Protocol citations referencing decompiled Mojang-mapped classes (ItemEntity.java, HopperBlockEntity.java, and ItemEntityRenderer.java).

## 1.0.0+build.9 *Released: May 20, 2026* ### Fixed - **Client-Side Item Disappearance**: Implemented client packet interception for partial pickups in `ClientPacketListener`. Temporarily scales the client-side item stack count to match the logical clump's size during packet processing, preventing the client from incorrectly shrinking the base stack below 1 and discarding the item entity from the screen. --- ## 1.0.0+build.8 *Released: May 20, 2026* ### Fixed - **Player Pickup Item Deletion**: Corrected player inventory pickup logic to correctly calculate the quantity of items successfully added during partial inventory slots intake, preventing unabsorbed items from being silently deleted when the player's inventory becomes full mid-pickup. --- ## 1.0.0+build.7 *Released: May 20, 2026* ### Changed - **Merge Radius Description**: Updated `item_clumps:merge_radius` GameRule description (in both registration code and `en_us.json` language files) to explicitly clarify that it operates as a horizontal block search radius, and that items will not clump if one is 1 block above or below the other, preserving vanilla vertical merging constraints. --- ## 1.0.0+build.6 *Released: May 20, 2026* ### Fixed - **Name Tag Visibility Toggle**: Synced the `item_clumps:render_labels` GameRule from the server to client entities via `EntityDataAccessor`, ensuring floating count labels disappear immediately when the GameRule is toggled off and reappear when toggled on. --- ## 1.0.0+build.5 *Released: May 20, 2026* ### Added - **Optimized Mod Icon**: Re-designed and scaled up the 3D grass block icon and the accompanying "x129" text label to ensure pixel-perfect legibility and prevent smudging when rendered at small icon scales (e.g. 64x64 or 32x32 pixels). --- ## 1.0.0+build.4 *Released: May 20, 2026* ### Added - **Mod Icon**: Configured the custom generated 3D isometric grass block mod icon for project visibility in the Fabric mod list and launch environments. --- ## 1.0.0+build.3 *Released: May 20, 2026* ### Fixed - **Localization**: Added missing language translation file (`en_us.json`) to localize the custom GameRuleCategory display name as "Item Clumps" in the Game Rules settings screen. --- ## 1.0.0+build.2 *Released: May 20, 2026* ### Fixed - **Client Crash**: Removed non-existent client entrypoint registration from `fabric.mod.json` which was causing crashes upon client initialization. - **Mixin Refmap**: Added the `refmap` property to the mixin configuration (`item-clumps.mixins.json`) to prevent production/remapped environment initialization failures. --- ## 1.0.0+build.1 *Released: May 19, 2026* ### Added - **Infinite Merging**: Merges identical item entities in the world into a single entity tracking a virtual count. - **Hopper Integration**: Drip-feeds items from virtual clumps into hoppers one item at a time. - **Name Tags**: Client-side name tag display above virtual clumps showing item count. - **Configuration**: Added three customizable GameRules (`enable_clumping`, `merge_radius`, and `max_clump_size`).