Immersive Chests — Update Changelog

New Features

Persistent Config Saving

All Mod Menu settings are now automatically saved to a local config file and persist between game launches.

Config file location:

/config/immersive-chests.json

This includes:

• camera positioning
• offsets
• animation settings
• orientation behaviour
• yaw behaviour
• Delay GUI settings
• debug options

No more resetting settings every restart.

---

Delay GUI Opening

Added a new optional immersive opening mode:

Delay GUI

When enabled, container GUIs are held briefly while the immersive camera animation plays, then open once the camera reaches the target.

This creates a smoother “walk into the inventory” effect for:

• chests
• barrels
• furnaces
• crafting tables
• boats with chests
• minecart chests
• supported modded containers

---

GUI Release Tick Control

Added a configurable timing system for delayed GUI opening:

GUI Release Ticks Before Finish

Controls how many ticks before the camera animation completes the GUI should appear.

Examples:

0 = GUI opens exactly at animation completion
2 = GUI opens slightly before completion
5 = GUI opens much earlier during the animation

This allows fine tuning between:

cinematic immersion
vs
instant responsiveness

---

Animation System Improvements

Improved Moving Entity Tracking

Chest boats and chest minecarts now track significantly more smoothly during opening animations.

Entity-based containers now use:

live target tracking

instead of static interpolation, reducing drift while moving.

---

Refactored Camera Architecture

Large internal refactor of the camera animation system:

• render-rate camera progression
• centralized delayed GUI lifecycle
• improved opening/closing phase handling
• cleaner separation between:
  • camera state
  • GUI timing
  • target resolution
  • rendering

This also improves stability for future updates and compatibility work.

---

Bug Fixes

Fixed Config Resetting

Settings no longer revert to defaults between launches.

---

Fixed Chest Remaining Open After Cancel

Cancelling delayed GUI openings now properly closes the container state.

---

Fixed Animation Timing Desync

Resolved issues where GUI timing and animation completion could drift apart at slower animation speeds.

---

Fixed Double Camera Tick Behaviour

Removed duplicate animation progression paths that caused inconsistent animation speed and snapping behaviour.

---

Notes

• Delay GUI is optional and can be disabled at any time.
• Existing configs from older versions may generate new default entries automatically on first launch.