ВЕРСИИ (3)

# StateStream Changelog ## 1.0.1 — Multi-loader support, critical fixes, major performance pass ### Loader support - **NEW:** Native NeoForge build (`statestream-neoforge-1.0.1.jar`) targeting NeoForge `26.1.2.65-beta`. - **NEW:** Native Quilt support via `quilt.mod.json` (also runs under Quilt's Fabric compatibility layer). - Refactored project into a loader-agnostic core (`com.statestream.*`) with separate entrypoints per loader (`StateStreamFabric`, `StateStreamNeoForge`). - Three distinct jars now shipped: Fabric, Quilt, NeoForge. ### Critical bug fixes - **Fixed silent data corruption when Y > 255.** The previous position encoding masked Y to 8 bits, which collided for any block above Y=255 (Overworld extends to Y=320). The registry is now split per-section using section-local Y (4 bits) — collisions are mathematically impossible. New test `allEncodingsUniqueWithinSection` verifies every (x, z, ly) tuple produces a unique encoding. - **Fixed registry corruption on every block placement and break.** `onBlockChanged` was always receiving `null` for the old BlockState, which caused: - Duplicate entries when replacing a tickable block with another tickable block - Phantom entries (never removed) when a tickable block was destroyed - Tick loop wasting cycles on positions that no longer held tickable blocks - Old state is now captured at HEAD via a ThreadLocal and consumed at RETURN. - **Added the `/statestream enable <module>` and `/statestream disable <module>` commands** that the Modrinth description promised but didn't actually exist. Includes tab-completion for module names. ### New feature: per-section tickable index with bitmap skip The biggest performance win in this release. Each loaded chunk now keeps: - One sorted `short[]` per section containing only tickable positions - A 64-bit `nonEmptyMask` where bit *s* is set iff section *s* has at least one tickable block - The total tickable count for stats The random-tick loop walks the mask using `Long.numberOfTrailingZeros` + `mask & (mask-1)` — empty sections are skipped at the cost of a single CPU instruction. On a typical Overworld chunk with tickables in only 3 of 24 sections, this is roughly an 8× reduction in section iterations per tick. Probability parity with vanilla is preserved exactly: each section still rolls `randomTickSpeed` picks of `nextInt(4096)` and a tickable block still has `P=1/4096` per roll. ### Performance fixes - `AtomicLong` cache counters replaced with `LongAdder` — eliminates `LOCK CMPXCHG` contention on the per-call hot path. - Block state IDs are now cached on the BlockState itself via a `@Unique` mixin field on `BlockBehaviour$BlockStateBase`. First read pays a `Reference2IntOpenHashMap.getInt()`; every subsequent read is a single field load. Without this, the cache was doing a hashmap lookup to save a field lookup — a net loss. - `onBlockChanged` no longer allocates a `HashSet` per mutation. It now does CAS-based sorted-array binary insertion/removal. Lock-free, single allocation for the new array only. - `onChunkLoad` iterates `LevelChunkSection` arrays directly instead of calling `chunk.getBlockState()` ~98 000 times via `BlockPos.betweenClosed`. Empty sections are skipped at O(1). - `UpdateCuller.shouldSuppress` now has an O(1) empty-set early exit and an O(1) `Block` reference check (`couldSuppressSource`) that skips Identifier allocation entirely when the source block isn't involved in any pair. Internal storage switched from `Set<String>` to `Map<Identifier, Set<Identifier>>` — no more `toString()` + concatenation per call. - Tick loop now uses a single reusable `BlockPos.MutableBlockPos` instead of allocating one `BlockPos` per ticked block per tick. - Cache verification moved from per-call to one-shot at `populate()`. The hot path no longer pays for verification overhead. - `Long2ObjectOpenHashMap` candidacy preserved via `ConcurrentHashMap<Long, ChunkEntry>` — Long boxes are short-lived and escape-analysis-friendly. ### Code quality - JSON parsing in `UpdateCuller` now uses Gson (with the hand-rolled string parser kept as a fallback for hostile input). - Config paths resolved via `FabricLoader.getConfigDir()` / `FMLPaths.CONFIGDIR.get()` on the respective loader, with a `statestream.config.dir` system property as the loader-agnostic bridge. - Mod version now read via Fabric's / NeoForge's `ModContainer` API instead of a hand-rolled JSON parser. - `fabric.mod.json` environment changed from `"*"` to `"server"` — the mod is no longer required on the client. ### Tests - Updated for the new section-local encoding API (`encodePos(x, z, ly)` + matching `decodeX/Z/LocalY`). - New test `allEncodingsUniqueWithinSection` proving the Y-collision bug cannot recur. - New test `nonEmptyMaskMatchesSectionContents` covering the bitmap-walk semantics. - Counter assertions updated from `AtomicLong.get()` to `LongAdder.sum()`. ### Internal - New `BlockStateIdHolder` interface implemented on every BlockState via `BlockStateBaseMixin`. - New `ReactiveTickRegistry.ChunkEntry` immutable struct (per-section arrays + bitmap + count + minY). - New `com.statestream.fabric` package with the Fabric-specific entrypoint. - New `neoforge/` Gradle subproject using `net.neoforged.moddev` 2.0.141. --- ## 1.0.0 — Initial release - JIT BlockState Inlining (`BlockStateCache`) - Update Culling (`UpdateCuller`) - Reactive Block Ticking (`ReactiveTickRegistry`) - Per-module fallback handler — any unexpected error disables the offending module and restores vanilla behavior - TOML config with independent toggles for each module - `/statestream stats`, `status`, `reload`, `benchmark` commands - Fabric loader for MC 26.1.2