Guide

[CHANGELOG] Version: 1.0.0-NeoForge

Complete low-level architectural migration and deep core integration with the NeoForge 1.21.1 ecosystem, achieving absolute feature parity with the Forge branch while utilizing native modern engine pipelines.

Core Kernel & API Integration:

• Native NeoForge Event Bus Re-wiring — Completely refactored the mod's event architecture to hook directly into NeoForge's decoupled Mod and Forge buses. Extracted all registration sequences into modern deferred registries, eliminating legacy system overhead and ensuring clean initialization profiles.

• Modern Pipeline Synchronization — Rebuilt the 3D projection subsystem to align with NeoForge's rewritten RenderLevelStageEvent. Remapped world-space rendering passes to hook cleanly into the modern Stage.AFTER_PARTICLES pipeline, maintaining visual integrity across variable render distances without shader conflicts.

• Delta-Tracker Adaptation — Adapted the world assistant animation and raytracing threads to utilize NeoForge's modern DeltaTracker parameters for partial-tick calculations, ensuring butter-smooth camera-relative billboard transformations and animations at any framerate.

• Isolated GUI Graphics Hook — Migrated the entire screen-space interface, bossbars, and HUD modules to RenderGuiEvent.Post. Reconfigured all 2D text layout algorithms to natively utilize the modern GuiGraphics context, dropping deprecated blit systems.

Platform Feature Parity & Porting:

• Asynchronous GUI Icon Rasterization — Integrated a lightweight item-rendering proxy into the HUD thread, leveraging modern NeoForge item rendering. It extracts ItemStack data directly from cached BlockState structures to stream high-definition 2D or 3D block icons straight to the screen.

• Ray-Traced Hologram Interaction — Ported the precise vector-based intersection algorithm (AABB.clip) using native NeoForge player interaction range properties. It evaluates line-of-sight rays from player coordinates inside air blocks, enabling instant, error-free target block tracking.

• Direct OpenAL Audio Engine — Transferred the independent file-system streaming engine (GuideSoundManager) to handle disk-based asset loading seamlessly alongside NeoForge's resource packs, eliminating null-pointer exceptions and overlap bugs during page ticks.

• World-Anchor Placement Assistant — Successfully ported the client-side hologram projection framework (PlacementProjector) with full multi-axis rotation remapping, real-time progress calculations, error highlighting, and depth-stencil optimizations.

• EntityBlock Structural Wireframes — Maintained full contextual outline support for non-solid containers (chests, shulker boxes, banners, skulls) with precise tint configurations, now fully synchronized with NeoForge's render types.