Перейти к содержимому
Mineforgian

Laminar

A low-overhead Fabric mod that unleashes your idle Integrated GPU to assist the CPU with heavy AI pathfinding, acoustics, and Line-of-Sight.

Загрузки
2K
Подписчики
19
Обновлён
6 июля 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 29 мая 2026 г.

Сообщить об ошибке

Laminar

Laminar Engine

Minecraft Fabric Java License

Asynchronous iGPU Co-Processing for Minecraft AI, Acoustics, and Line-of-Sight.

Laminar is an optimization suite designed to interface the CPU with the built-in integrated graphics processor (Intel HD/UHD Graphics, AMD Radeon Graphics) using explicit OpenCL 1.2/1.1 pipelines.

By offloading computationally intensive CPU tasks, Laminar assists in maintaining server tick rates (TPS) while reducing CPU utilization on the rendering and main logic threads.

⚠️ Note: Laminar doesn't increase the maximum FPS you can achieve. It simply improves stability and the ability to handle multiple mobs and sounds simultaneously without lag or significant FPS drops using parallel processing on the iGPU.

Important: The issue with the dedicated server has been fixed without having to separate it into 2 editions(Standart and Server Edition) in version 1.3.1+

Core Engine Architecture

1. Project "Hive" (Asynchronous Flow-Field AI Pathfinding)

High-density mob farms or massive siege events normally bring servers to their knees due to heavy, single-threaded CPU pathfinding loops. Project Hive completely bypasses this limitation by offloading global routing to the GPU co-processor.

  • Integrated Flow-Field Co-Processing: Instead of generating hundreds of individual, CPU-heavy paths, the iGPU calculates a single, unified 3D vector field spanning over 110,000 voxels around the player. Hundreds of hostile entities can then simultaneously read their movement directions from this single grid in constant O(1) time, saving massive amounts of CPU cycles.
  • Intelligent Hybrid Navigation: Global macro-pathing is calculated dynamically on the GPU, while micro-level physics (such as jumping, swimming, and block collision avoidance) are handed back to the native Minecraft engine, maintaining authentic movement and animation behaviors.
  • Fluid-Agnostic Routing: Voxel-level filtering automatically ignores non-obstructive ocean blocks (like water, kelp, and seagrass), preventing server lag and pathfinding errors when mobs navigate underwater biomes.
  • Dynamic Swarm Intelligence: Mobs behave like a coordinated pack. When one hostile entity spots you, it dynamically alerts nearby pack members within a physical auditory radius, allowing them to instantly coordinate a swarm attack via the GPU flow-field.

2. Project "Echo" (Environmental Acoustics & 3D Sound Occlusion)

Experience Minecraft's audio like never before. Project Echo completely transforms how sound propagates through the world, delivering rich, physical, and highly immersive acoustics powered by your integrated GPU.

  • True Physical Occlusion: Sound waves now dynamically react to the block materials separating you from the source. Whether it is a zombie groaning behind a thick stone wall, a piston firing in a deep cavern, or water flowing overhead, the audio is realistically muffled and dampened using hardware-accelerated low-pass filtering.
  • Dynamic Cave Reverb: Deep caves, narrow tunnels, and massive hollow caverns now feel physically alive. Using a 16-ray Fibonacci sphere, the iGPU continuously measures the size of your surroundings, automatically applying cinematic echoes and reverberation that adapt seamlessly as you transition from tight stone passages to wide underground chambers.
  • Intelligent Open-Sky Guard: The acoustic engine is smart enough to differentiate enclosed spaces from the open sky. Sound waves escaping into the open atmosphere dissipate naturally, ensuring zero artificial echoes under the sky while preserving rich, atmospheric acoustics inside caves and buildings.
  • Seamless Mod & Media Compatibility: Built to support custom music discs, instruments, and complex audio additions from other mods out of the box. By dynamically scaling range calculations with in-game sound properties, every custom audio event in your modpack propagates and dampens with authentic physical properties.
  • Decoupled Performance Engine: All heavy raymarching calculations are quarantined to a dedicated background co-processor thread. By utilizing a local RAM caching system, the client's rendering thread is completely isolated from audio compute overhead, maintaining fluid, stutter-free frame rates even during chaotic, noisy encounters.

3. Project "Aura" (Parallel Raymarching Line-of-Sight)

Hostile mobs constantly run expensive line-of-sight checks on the CPU to see if they can target you. Project Aura moves this heavy workload entirely to the integrated GPU.

  • Parallel GPU Raymarching: Executes parallel raymarching checks from the eye level of up to 1,024 active entities to the player simultaneously on the iGPU, entirely freeing the server thread from expensive visibility checks during dense encounters.
  • Symmetric Trust Validation: The engine fully trusts the GPU's highly precise visibility calculations. If the GPU determines a mob can see you, or is completely blocked by a wall, it immediately bypasses the CPU's expensive raycast, reducing the CPU's line-of-sight workload by up to 90% during massive chases.
  • Instant Shadow Cache: Stores visibility states in a lightning-fast, local CPU-side memory registry. The main server thread can query whether a mob can see the player in constant O(1) time, eliminating all tick spikes.

4. Adaptive Entity AI Throttling (Level of Detail AI)(has been removed since version 1.2.9)

  • Dynamic 4-Zone LOD Engine:
    • Zone 1a (Active Pursuit): Mobs with an active target run at 20 TPS.
    • Zone 1b (Proximity Combat): Mobs within a 10-block radius of a player run at 20 TPS, preventing delayed aggro or inactive AI behaviors when players are close.
    • Zone 2 (Close Idle): Mobs within a 24-block radius run at 5 TPS (delay = 4).
    • Zone 3 (Far Idle): Mobs outside 24 blocks run at 1.6 TPS (delay = 12).
  • Event-Driven Target Registry: Mobs register to an event-driven via hooks. This reduces the requirement for world scans on every tick, minimizing server CPU overhead.
  • UUID-Staggered Ticking: Tick execution is staggered across frames using a positive bitwise modulo of the mob's UUID to flatten CPU usage spikes.
  • Momentum & Animation Resets: On target loss (e.g., Creative mode transition), a 48-block sweep resets physical velocity, terminates active navigation paths, and resets aggressive state animations.

Performance Benchmarks

Tested on: Intel Core i7-4770K (Haswell @ 4.3 GHz OC, AVX2), Intel HD 4600 iGPU (OpenCL 1.2), NVIDIA GTX 1050. Scenario: 500 active Zombies, 32 Chunks loaded. Client optimization pack contains Sodium, FerriteCore, and Lithium.

Performance Metric Vanilla Minecraft Laminar v1.2.7 + Pack Net Improvement
Server Tick Rate 19.35 TPS 20.00 TPS +0.65 TPS (Locked 20)
Median MSPT 31.1 ms 7.68 ms -75.3% (4x faster)
95th% MSPT 50.5 ms 27.8 ms -44.9% (Smoother)
CPU Process Usage 36.12% 21.78% -39.7% (Lower CPU overhead)
Memory Footprint 1.4 GB 1.0 GB -28.5% (Less RAM allocation)
GC Young Frequency 2.2s 4.0s +81.8% (Infrequent GCs)
GC Young Avg Pause 19.3 ms 17.1 ms -11.4% (Shorter GC pauses)
GC Young Total Runs 200 runs (in 113s) 71 runs (in 120s) -64.5% fewer GC events
About increasing the maximum sound and mobs that can be handled

By increasing the maximum simultaneous audio occlusion capacity to 256 channels (previously 64) and the simultaneous Line-of-Sight Raymarching capacity to 1,024 active entities (previously 256), the rendering frame rate during dense crowd chases has increased.

Client Rendering Framerates during Dense Crowd Chases:

  • Laminar v1.2.5: 64 - 71 FPS
  • Laminar v1.2.6b (Current): 76 - 84 FPS

Result: A highly responsive +10 to +20 FPS gain under heavy entity stress, ensuring smoother camera movement and consistent frametimes when actively pursued by large hordes.

Note

Testing Note regarding ImmediatelyFast:

ImmediatelyFast has been excluded from our standardized benchmark environment. While it is an exceptional mod that successfully boosts client-side FPS and lowers overall CPU utilization, our testing indicates that its aggressive rendering buffer optimizations can introduce slight memory bandwidth contention when paired with Laminar's asynchronous OpenCL host-mapping on older architectures (causing a marginal increase in median MSPT and GC frequency).

It remains 100% compatible and safe to use alongside Laminar if you prioritize maximum visual frame rates over strict server-tick consistency.

Compatibility & Requirements

  • Fabric Loader: v0.19.2+ (Minecraft 26.1.2+)
  • Hardware: A dual-GPU configuration (CPU + Integrated GPU) or an APU.
  • OpenCL: The iGPU must support OpenCL 1.1 or higher.
  • Java: Java 25 (GraalVM recommended for vectorization optimizations).

Compatible Modifications

Laminar is designed to operate alongside other render and system optimization modifications.

  • Compatible with Sodium, Lithium, FerriteCore, and ImmediatelyFast.
  • VulkanMod Compatible: Operates alongside Vulkan rendering by bypassing GPU memory conflicts through host memory-mapped buffers.

Incompatible

  • CPU-Bound Sound Physics Modifications (Sound Physics Remastered, Acoustic Overhaul). Project Echo serves as a hardware-accelerated alternative to these modifications.

FAQ (Frequently Asked Questions)

Q: Will this work on a Dedicated Server?

A: Most enterprise server CPUs (Xeon/EPYC) do not contain an integrated GPU. Laminar will detect this condition and disable itself without crashing. Laminar is designed for Single-Player, LAN, or Self-Hosted servers running on consumer desktop/laptop processors (Intel Core / AMD Ryzen).

Q: Does it change any vanilla behaviour?

A: For the most part, no. Mobs still walk, jump, and behave exactly like vanilla.

The only gameplay changes are:

  • Sounds get muffled realistically when you are behind walls.
  • Mobs nearby will alert each other to join the chase (like piglins when they are angry).

If you want 100% vanilla gameplay, you can easily disable both of these features in the config file (laminar.json).

Q: Do I need to configure anything?

A: Laminar operates with default configurations out of the box.

Q: What if I only have an Integrated GPU (iGPU) with no dedicated graphics card?

A: The effectiveness depends on current iGPU utilization and your rendering backend:

  • iGPU with headroom (Usage < 85%): Laminar will utilize the remaining GPU cores to offload CPU calculations, resulting in lower tick latency.
  • iGPU fully utilized (Usage ~ 100%, e.g., due to shaders): Introducing OpenCL compute tasks may cause resource contention on the GPU silicon, which could lead to a reduction in visual FPS.
  • Vulkan Backend on iGPU-only setups (Minecraft 26.2+): Due to the highly optimized nature of the Vulkan rendering engine, it will naturally saturate the integrated GPU's execution units to their absolute peak limits. On an iGPU-only configuration, this maximum utilization leaves virtually zero headroom for Laminar's OpenCL compute queues, which can result in frame-time drops and context stalls.

Note: If operating on an iGPU-only configuration, it is recommended to pair Laminar with performance modifications like Sodium and use optimized graphics settings. Furthermore, if you are using the experimental Vulkan backend on an iGPU-only setup, it is highly recommended to cap your in-game framerate (e.g., to 60 or 90 FPS) to artificially create the necessary GPU headroom for Laminar's asynchronous co-processing loops.

Ченджлог

1.3.1+26.2Релиз26.2 · 6 июля 2026 г.

Laminar Engine - Version 1.3.1 Changelog

Architectural Unification & Compatibility

  • The Universal Edition (Dynamic Runtime Downloader): Discontinued the split between "Standard" and "Server" editions. Laminar is now distributed as a single, ultra-lightweight universal JAR. To achieve this without causing classpath pollution on clients, a pre-launch bootstrapper has been engineered. When deployed on a headless dedicated server, the engine automatically detects missing hardware bindings and dynamically fetches/injects the precise native compute libraries (LWJGL OpenCL) directly into the server's memory at runtime. This guarantees zero conflict with client rendering mods (e.g., Sodium) while maintaining full asynchronous co-processing on dedicated servers.
  • Diagnostic Overlay (F3) Pipeline Fix: Resolved an issue on Minecraft 26.2 where monolithic UI render passes caused the diagnostic text entries to endlessly duplicate and accumulate on the screen. The overlay now utilizes a localized purge-and-reinject routine, ensuring real-time telemetry updates (active sound slots, AI grids) remain clean and static.
  • Third-Party HUD Compatibility: Implemented a hardware-level compatibility guard for UI-altering modifications. The native Laminar diagnostic overlay will now gracefully disable itself upon detecting BetterF3 or similar structural HUD mods, preventing visual overlapping and maintaining a clean user interface.
1.3.1Релиз26.1, 26.1.1, 26.1.2 · 6 июля 2026 г.

Laminar Engine - Version 1.3.1 Changelog

Architectural Unification & Compatibility

  • The Universal Edition (Dynamic Runtime Downloader): Discontinued the split between "Standard" and "Server" editions. Laminar is now distributed as a single, ultra-lightweight universal JAR. To achieve this without causing classpath pollution on clients, a pre-launch bootstrapper has been engineered. When deployed on a headless dedicated server, the engine automatically detects missing hardware bindings and dynamically fetches/injects the precise native compute libraries (LWJGL OpenCL) directly into the server's memory at runtime. This guarantees zero conflict with client rendering mods (e.g., Sodium) while maintaining full asynchronous co-processing on dedicated servers.
  • Diagnostic Overlay (F3) Pipeline Fix: Resolved an issue on Minecraft 26.2 where monolithic UI render passes caused the diagnostic text entries to endlessly duplicate and accumulate on the screen. The overlay now utilizes a localized purge-and-reinject routine, ensuring real-time telemetry updates (active sound slots, AI grids) remain clean and static.
  • Third-Party HUD Compatibility: Implemented a hardware-level compatibility guard for UI-altering modifications. The native Laminar diagnostic overlay will now gracefully disable itself upon detecting BetterF3 or similar structural HUD mods, preventing visual overlapping and maintaining a clean user interface.
1.3.0+ServerБета26.1, 26.1.1, 26.1.2 · 5 июля 2026 г.

Laminar Engine - Version 1.3.0 Server Edition Changelog

Dedicated Server Support & Stability Hotfixes

This update introduces native dedicated server compatibility and robust platform-level fallbacks, allowing the co-processing engine to safely execute on dedicated server architectures. Server edition does not support sodium and other Rendering Mods!.

  • Resolved Dedicated Server Startup Crash: Fixed a fatal NoClassDefFoundError that occurred when launching Laminar on headless dedicated server environments. Minecraft dedicated servers natively strip all system-level hardware interaction libraries (LWJGL) from their classpaths. Laminar now safely bundles the minimum required lightweight Java bindings for core hardware compute operations natively using Fabric's Jar-in-Jar mechanism.
  • Implemented Robust Headless OS Fallbacks: Enhanced the hardware initialization pipeline to gracefully handle operating systems lacking native OpenCL drivers or system runtimes (common in headless Linux VPS or enterprise hosting). By upgrading the error-trapping routines to catch all native linkage and JVM errors, the server will now cleanly print a diagnostic warning and fallback to standard CPU execution instead of triggering a fatal JVM crash.
1.3.0+26.2+ServerБета26.2 · 5 июля 2026 г.

Laminar Engine - Version 1.3.0 Server Edition Changelog

Dedicated Server Support & Stability Hotfixes

This update introduces native dedicated server compatibility and robust platform-level fallbacks, allowing the co-processing engine to safely execute on dedicated server architectures. Server edition does not support sodium and other Rendering Mods!.

  • Resolved Dedicated Server Startup Crash: Fixed a fatal NoClassDefFoundError that occurred when launching Laminar on headless dedicated server environments. Minecraft dedicated servers natively strip all system-level hardware interaction libraries (LWJGL) from their classpaths. Laminar now safely bundles the minimum required lightweight Java bindings for core hardware compute operations natively using Fabric's Jar-in-Jar mechanism.
  • Implemented Robust Headless OS Fallbacks: Enhanced the hardware initialization pipeline to gracefully handle operating systems lacking native OpenCL drivers or system runtimes (common in headless Linux VPS or enterprise hosting). By upgrading the error-trapping routines to catch all native linkage and JVM errors, the server will now cleanly print a diagnostic warning and fallback to standard CPU execution instead of triggering a fatal JVM crash.
1.3.0Релиз26.1, 26.1.1, 26.1.2 · 4 июля 2026 г.

Laminar Engine - Version 1.3.0 "Echo Extended" Changelog

This major release introduces a complete overhaul of the audio occlusion pipeline (Project Echo), implements high-fidelity hardware-accelerated environmental acoustics, resolves critical transition states in AI tracking, and introduces a modern hardware diagnostic overlay.

1. Project Echo: "Extended" (High-Fidelity Audio Occlusion & Reverb)

  • Dual-Engine Hybrid Acoustics: Implemented native hardware-accelerated OpenAL EFX support. On compatible devices, the engine now delegates acoustic calculations directly to the audio hardware, applying physical direct filters (low-pass high-frequency damping based on block obstruction) and dynamic environmental reverb (decay times mapped to physical room volumes).
  • Laminar Ghost Echo Fallback: Engineered a robust, software-side fallback system for systems lacking EFX support. It utilizes a dynamic, asynchronous "Ghost Sound" spawner that schedules identical duplicate sound instances with physical delays, muffled volumes, and adjusted pitches to simulate cave echoes without any native OpenAL crash risks.
  • Open Sky Reflection Guard: Optimized the Fibonacci sphere raymarching kernel to detect open space. Rays that escape the voxel grid boundaries without hitting solid walls contribute 0% to the reverb calculations, completely eliminating artificial reverb in open plains or under the sky while keeping cave acoustics rich and deep.
  • Decoupled Render Thread (Zero Memory Stalls): Introduced a CPU-side RAM cache for all active sound calculations. The client rendering thread now queries standard, L1/L2 cached memory arrays instead of reading from un-cached mapped GPU memory, completely resolving physical memory bus stalls and stabilizing frame-time 1% lows.
  • Dynamic Range & Mod Compatibility: Replaced static range tables with dynamic queries utilizing the game's native attenuation properties and volume scales. Any custom music discs, instruments, or sound events introduced by other mods are now automatically and correctly occluded and propagated.
  • Queue Congestion Prevention: Implemented distance-based sound prioritization, capping active OpenCL audio calculations to the 32 closest sound sources per cycle to minimize driver-level submission overhead.

2. Project Hive (Asynchronous AI Pathfinding)

  • Resolved Creative Transition Loop: Patched a critical logical loop where switching game modes to Creative or Spectator caused the GPU-driven grids to endlessly flicker (toggling between 0 and 1).
  • Resolved Lingering Mobs Bug: Fixed an issue where out-of-radius mobs were missed by the cleanup sweep, keeping the active AI tracker occupied. All tracking registries are now fully and permanently flushed upon player invulnerability or game-mode change.

3. Hardware Diagnostic OSD (F3 Debug Screen)

  • Modern Rendering Hook: Successfully bypassed deprecated debug screen methods. Injected a lightweight, zero-refmap target hook directly into Minecraft's modern, monolithic line-extraction pipeline.
  • Real-time Performance Telemetry: Displays the locked hardware co-processor GPU name, active EFX status, active sound channels, and active pathfinding grids/mobs directly in the F3 screen under the system information panel.
1.3.0+26.2Релиз26.2 · 4 июля 2026 г.

Laminar Engine - Version 1.3.0 "Echo Extended" Changelog

This major release introduces a complete overhaul of the audio occlusion pipeline (Project Echo), implements high-fidelity hardware-accelerated environmental acoustics, resolves critical transition states in AI tracking, and introduces a modern hardware diagnostic overlay.

1. Project Echo: "Extended" (High-Fidelity Audio Occlusion & Reverb)

  • Dual-Engine Hybrid Acoustics: Implemented native hardware-accelerated OpenAL EFX support. On compatible devices, the engine now delegates acoustic calculations directly to the audio hardware, applying physical direct filters (low-pass high-frequency damping based on block obstruction) and dynamic environmental reverb (decay times mapped to physical room volumes).
  • Laminar Ghost Echo Fallback: Engineered a robust, software-side fallback system for systems lacking EFX support. It utilizes a dynamic, asynchronous "Ghost Sound" spawner that schedules identical duplicate sound instances with physical delays, muffled volumes, and adjusted pitches to simulate cave echoes without any native OpenAL crash risks.
  • Open Sky Reflection Guard: Optimized the Fibonacci sphere raymarching kernel to detect open space. Rays that escape the voxel grid boundaries without hitting solid walls contribute 0% to the reverb calculations, completely eliminating artificial reverb in open plains or under the sky while keeping cave acoustics rich and deep.
  • Decoupled Render Thread (Zero Memory Stalls): Introduced a CPU-side RAM cache for all active sound calculations. The client rendering thread now queries standard, L1/L2 cached memory arrays instead of reading from un-cached mapped GPU memory, completely resolving physical memory bus stalls and stabilizing frame-time 1% lows.
  • Dynamic Range & Mod Compatibility: Replaced static range tables with dynamic queries utilizing the game's native attenuation properties and volume scales. Any custom music discs, instruments, or sound events introduced by other mods are now automatically and correctly occluded and propagated.
  • Queue Congestion Prevention: Implemented distance-based sound prioritization, capping active OpenCL audio calculations to the 32 closest sound sources per cycle to minimize driver-level submission overhead.

2. Project Hive (Asynchronous AI Pathfinding)

  • Resolved Creative Transition Loop: Patched a critical logical loop where switching game modes to Creative or Spectator caused the GPU-driven grids to endlessly flicker (toggling between 0 and 1).
  • Resolved Lingering Mobs Bug: Fixed an issue where out-of-radius mobs were missed by the cleanup sweep, keeping the active AI tracker occupied. All tracking registries are now fully and permanently flushed upon player invulnerability or game-mode change.

3. Hardware Diagnostic OSD (F3 Debug Screen)

  • Modern Rendering Hook: Successfully bypassed deprecated debug screen methods. Injected a lightweight, zero-refmap target hook directly into Minecraft's modern, monolithic line-extraction pipeline.
  • Real-time Performance Telemetry: Displays the locked hardware co-processor GPU name, active EFX status, active sound channels, and active pathfinding grids/mobs directly in the F3 screen under the system information panel.
1.2.10Релиз26.1, 26.1.1, 26.1.2 · 2 июля 2026 г.

Minor Bug fix.

1.2.10+26.2Релиз26.2 · 2 июля 2026 г.

Minor bug fix.

Комментарии

Загружаем…