Lumen Terrain

ARCHIVED FOR NOW (DESCRIPTION IS FOR UPDATE 2.0 WHEN I GET TIME TO MAKE IT)

Lumen Terrain

Lumen Terrain (LTE) is a Fabric server-side performance mod designed to accelerate Minecraft terrain generation by making better use of available hardware resources. Instead of relying solely on standard generation paths, LTE intelligently distributes terrain processing across available multi-core CPUs and OpenCL-capable GPUs.

⚡ Features

• Intelligent Hardware Scheduling: Dynamically selects the best processing backend (CPU or GPU) based on live benchmarking and workload size.
• Heterogeneous Compute: Processes workloads simultaneously across multiple CPUs and GPUs when beneficial.
• Failover Safety: Hardware or native library failures safely fall back to CPU or vanilla generation to prevent server crashes.
• Plug-and-Play Native Libraries: Bundled native code automatically extracts and loads based on your operating system and architecture.

🧠 Intelligent Hardware Scheduling

LTE does not blindly send every task to the GPU. It benchmarks available hardware and assesses workload size, queue pressure, and processing overhead to schedule tasks intelligently. If the CPU is faster for a specific terrain workload, LTE will select it as the optimal path.

🧮 Multi-Core CPU Processing

LTE processes independent terrain workloads concurrently across multiple CPU workers, utilizing hardware-aware scheduling to maximize multi-core efficiency without overloading the system.

🎮 Multi-GPU Processing

The engine is designed to enumerate multiple OpenCL-capable GPUs and process independent terrain workloads concurrently. The scheduler considers device health, measured performance, and current queue pressure to balance the load across heterogeneous devices.

⚡ CPU + GPU Processing

LTE is capable of combining CPU and GPU processing to improve overall throughput. By benchmarking available processing paths, LTE seamlessly delegates tasks to whichever hardware is most efficient for the current workload.

📊 Hardware Benchmarking

LTE detects CPU topology and GPU capabilities, caching hardware profiles and benchmark results. By measuring actual performance rather than relying on assumed metrics, LTE ensures the most efficient processing path is always chosen.

🛡️ Reliability & Fallbacks

Acceleration failures will not crash your server. If a GPU fails or native processing is unavailable, LTE marks the device as unhealthy and falls back to a safer processing path—first attempting CPU workers, and ultimately falling back to standard vanilla Minecraft terrain generation if necessary.

🌍 Cross-Platform Support

LTE features a platform-aware architecture built for modern server environments. Native libraries are built and supported for:

• Windows x86-64
• Windows ARM64
• Linux x86-64
• Linux ARM64
• macOS ARM64

📦 Self-Contained Native Libraries

Compatible .dll, .so, and .dylib files are bundled directly within the mod JAR. LTE detects your platform and architecture at runtime, automatically extracting and loading the correct native libraries without requiring any manual installation by the user.

🪶 Lightweight Design

LTE minimizes its footprint with low idle CPU usage, bounded queues and caches, efficient native resource management, and reduced unnecessary memory allocations. Hardware profiles are cached, and unnecessary logging is kept to a minimum to maintain low overhead.

🖥️ Fabric Server Integration

LTE integrates directly into the Fabric server terrain-generation pipeline. It intercepts standard Minecraft terrain data and processes it through a dedicated pipeline: 16×16 heightmap → slope map → terrain mask → height modification → processed terrain. Both CPU and GPU implementations produce equivalent, predictable terrain results.

📥 Installation

Drop the LTE .jar file into your Fabric server's mods folder. No external dependencies or manual native library installations are required.

🔧 Configuration

Customize LTE to fit your server hardware through configuration options including:

• Automatic or explicit backend selection
• Chunks-per-cycle and processing rate limits
• Worker configuration
• Verbose logging for diagnostics

🔗 Links

GitHub: https://github.com/Astryon-official/Lumen-Terrain

Contact: astryon@proton.me

📜 License

MIT License