InSight Chests — Changelog

Version 1.0.5 — Official Release

Major Milestone: Deep Sophisticated Storage Integration

• Non-Destructive Screen Interception Pipeline
  • InSight Chests now officially features native, deep integration with Sophisticated Storage chests (Wood, Copper, Iron, Gold, Diamond, Netherite, and double chest variants)!
  • Unlike traditional screen replacement approaches that break third-party GUI functionality, InSight Chests introduces a Non-Destructive Interception Pipeline (SophisticatedStorageInterceptionHandler). The native StorageScreen is preserved intact underneath, ensuring 100% interactive access to all native upgrade tabs (Magnet, Hopper, Filter, Void, Compact, Auto-Smelt, Crafting, etc.), memory slots, sorting buttons, and settings panels.
  • Implemented TransparentGuiGraphics to strip away the opaque vanilla-style gray backgrounds in real time, projecting Sophisticated Storage's complex widgets onto the signature sleek frosted glass aesthetic.
• Dynamic Material Cavity Mapping
  • Automatically interrogates BlockEntity NBT via dynamic reflection to detect wood types (oak, spruce, birch, jungle, acacia, dark_oak, mangrove, cherry, bamboo, crimson, warped) and metal finishes, rendering accurate interior wall textures that match the exterior chest casing.

New Configuration Suite & Settings Overhaul

• Dedicated Sophisticated Storage Configuration Suite ([compatibility]):
  • enableSophisticatedStorage (Default: true): Master toggle for client-side 3D physical item simulations, dynamic wood cavities, and custom frosted glass integration for Sophisticated Storage containers.
  • sophisticatedStorageReplaceScreen (Default: true): Controls the frosted glass styling pass over native storage screens while preserving all clickable upgrade tabs, filter slots, and search bars.
  • sophisticatedStorageLargeGuiScale (Default: 0.80, Range: 0.5 – 1.0): Adaptive GUI scale factor for large containers (Gold, Diamond, Netherite, and double chests) so massive inventories scale down neatly without covering the entire screen.
  • sophisticatedStorageSmallGuiScale (Default: 0.90, Range: 0.5 – 1.0): GUI scale factor for smaller containers (Wood, Copper, Iron chests).
  • sophisticatedStorageLargeSideOffset (Tuned to Default: 18, Range: 0 – 200): Horizontal screen padding (in pixels) for large containers when side-docked (guiPosition = RIGHT or LEFT), preventing side-attached upgrade tabs from clipping off-screen.
  • sophisticatedStorageSmallSideOffset (Tuned to Default: 22, Range: 0 – 200): Horizontal screen padding for smaller containers when side-docked.
• Independent Dynamic Model Balancer (Global Item Caps):
  • enableSophisticatedStorageGlobalItemCap (Default: false): Enables a smart item density balancer designed specifically for Sophisticated Storage containers without altering Vanilla chest caps.
  • Per-Tier Density Ceilings: Configurable total model limits per tier:
    • sophisticatedStorageWoodCap (Default: 32, Range: 27 – 108)
    • sophisticatedStorageCopperCap (Default: 54, Range: 45 – 180)
    • sophisticatedStorageIronCap (Default: 64, Range: 54 – 216)
    • sophisticatedStorageGoldCap (Default: 96, Range: 81 – 324)
    • sophisticatedStorageDiamondCap (Default: 128, Range: 108 – 432)
    • sophisticatedStorageNetheriteCap (Default: 160, Range: 132 – 528)
    • Note: Every non-empty slot is always guaranteed at least 1 visual item model.
• New Diagnostic Configuration ([debug]):
  • debugMode (Default: false): Enables dense diagnostic telemetry and pipeline watchdog tracing. When active, outputs comprehensive real-time lifecycle tracking to logs/insightchests/debug-session.log for easy troubleshooting.
• Critical Fix: Config Comment Mismatch & Auto-Reset Elimination:
  • Resolved a longstanding issue where hardcoded "Default: ..." comments inside the config specification caused the config comment validator to detect a mismatch with generated TOML values, inadvertently resetting player configurations back to default on startup.
  • All config builders have been sanitized to follow strict platform comment guidelines, guaranteeing that custom user settings are permanently preserved across game launches.

Architectural Overhaul: Hollow Cavity Depth Carving & GPU Pipeline

• Blaze3D Native Pipeline Transition
  • Completely overhauled HollowChestDepthRenderer to eliminate legacy immediate-mode BufferBuilder tessellation and unstable NativeImage lightmap reflections.
  • Migrated entirely to Mojang's modern MultiBufferSource.BufferSource pipeline and introduced OuterWrappedRenderType, injecting custom depth-test states (GL_ALWAYS) via standard RenderStateShard composite passes without destabilizing the GPU render state.
• Shaderpack PBR & Normal Vector Compliance
  • Added full mathematical surface normal generation (nx, ny, nz) and OverlayTexture.NO_OVERLAY coordinates to all 5 interior cavity quads. This provides complete deferred shading and PBR lightmap compatibility under Iris, Oculus, and OptiFine shader engines.
• 3-Stage Synchronized Buffer Flushing
  • Strictly sequenced draw call flushes (bufferSource.endBatch()) across three discrete stages:
    1. Pre-Cavity Flush: Flushes all vanilla block entity geometry before depth carving begins.
    2. Cavity Mask Flush: Locks depth values before physical 3D items render.
    3. Item & Glint Isolation Flush: Prevents render type state bleed and eliminates shader glint corruption on enchanted items.

Next-Gen Diagnostic Architecture: Comprehensive 3-Tier Engine (InsightDebug)

• Tier 1: Lifecycle Pipeline Watchdog
  • Integrated an active heartbeat watchdog (tickWatchdog) monitoring the entire chest interaction lifecycle (SCREEN_OPENING ➔ CHEST_RECOGNITION ➔ CONTAINER_INTERCEPTION ➔ SIMULATION_INIT ➔ CAMERA_TRANSITION_START ➔ LEVEL_STAGE_RENDER).
  • Automatically detects pipeline drops and raises alarms with contextual diagnostics ([MISSED_PIPELINE_STAGE]) if any render or screen event fails to trigger within 2500ms.
• Tier 2: Silent Anomaly & Bailout Logger
  • Eliminated all silent catch (Exception ignored) blocks across container detection, level rendering, and reflection queries. Any soft failure or abnormal fallback is now logged as a categorized [SILENT_ANOMALY].
• Tier 3: Critical Failure & Contextual Environment Snapshot
  • Equipped rendering and mouse interception passes with defense-in-depth try-catch guards.
  • Upon detecting an unhandled exception, the engine logs [CRITICAL_FAILURE] and automatically generates a comprehensive debug snapshot including player coordinates, look vectors, active GUI classes, slot counts, and active Shaderpack/OptiFine/Iris states.
• Dedicated Diagnostic Logging Session
  • Added clean independent log routing to logs/insightchests/debug-session.log with dedicated headers and severity filtering (debugMode, default: false).

Iron Chests Polish & Crystal Preview Suppression System

• Zero-Noise Crystal Floating Item Suppression
  • Hardened the dual-layer interception system (CrystalChestBlockEntityMixin & IronChestRendererMixin) to suppress the 8 spinning preview items while Crystal Chests are open or opening.
  • Implemented per-frame de-duplication cache sets (LOGGED_CHESTS), ensuring diagnostic logs are recorded exactly once per chest interaction without FPS drops or console spam.
  • Maintained user toggle enableIronChestsCrystalPreview (default: true) to allow players to customize spinning item behavior when chests are closed.

Quality of Life, Input Safety & Visual Polish

• Block Selection Highlight Suppression
  • Suppressed vanilla's black wireframe block selection highlight when the player is viewing the inside of an open chest (ClientEvents.onRenderBlockHighlight). Items inside the cavity are now presented completely unobstructed by black wireframes.
  • Integrated position caching (lastHighlightedChestPos) to eliminate redundant event processing and prevent log noise.
• Enchanted Item Glint Protection
  • Upgraded DummyVertexConsumer to swallow corrupted glint render passes when shaders are active, preventing enchanted items from turning into solid purple silhouettes.
• Robust Mouse & Keyboard Interception
  • Wrapped all transformed mouse clicks, releases, dragging, and wheel scrolling operations inside fault-tolerant safety barriers to prevent game freezing during rapid inventory interactions.

Community Feedback & Bug Reports

• I am dedicated to delivering the ultimate chest immersion experience! If you encounter any visual anomalies, mod incompatibilities, or unexpected behavior, please submit an issue on the GitHub issue tracker.
• Diagnostic Log Notice: When filing an issue report, attaching your logs/insightchests/debug-session.log helps me diagnose and fix problems immediately.
  (Please note: This dedicated diagnostic log is only generated when you open your configuration file .minecraft/config/insightchests-client.toml or in-game config menu and set debugMode = true under the [debug] section. By default, it remains inactive to ensure maximum performance and zero disk clutter).

Changelog Summary

• Added comprehensive, non-destructive integration for Sophisticated Storage (all wood variants and metal tiers).
• Introduced TransparentGuiGraphics for seamless frosted-glass rendering of complex container GUIs.
• Added complete suite of Sophisticated Storage configs: GUI scaling (0.80 / 0.90), side-docking offsets (18px / 22px), and per-tier global item caps.
• Added [debug] debugMode configuration and dedicated logs/insightchests/debug-session.log output (active only when enabled in config).
• Fixed config comment mismatch validator bug that previously caused client configs to reset on startup.
• Overhauled 3D hollow cavity depth carving engine using OuterWrappedRenderType and Blaze3D batching.
• Added full normal vectors and OverlayTexture support for flawless shaderpack PBR lighting.
• Implemented comprehensive 3-Tier Diagnostic Engine (InsightDebug: Watchdog, Silent Anomaly, Snapshot).
• Suppressed vanilla block selection outline over open chests for a clean interior view.
• Eliminated per-frame log spam on Iron Chests Crystal preview suppression.
• Hardened mouse input transformation and container cleanup lifecycles.