lingHorizons-Server+Chunky

Quick rating

Community listing page, reviews here may not be monitored by the author.

lingHorizons-Server+Chunky

No reviews yet

Dedicated Server Voxel LOD Streaming & Intelligent Chunky Auto-Bridge for NeoForge

Mod Loaders
Minecraft

About

Description

LING Horizons Server is a Dedicated Server mod for Minecraft 1.21.1 (NeoForge). It operates as a centralized Master Voxel DAG Engine, persistently indexing, caching, and streaming high-resolution Level-of-Detail (LOD) terrain data to connected players running the LING Horizons Client

Project Overview

LING Horizons Server is an industrial-grade Dedicated Server mod for Minecraft 1.21.1 (NeoForge). It operates as a centralized Master Voxel DAG Engine, persistently indexing, compressing, caching, and streaming high-resolution Level-of-Detail (LOD) distant terrain directly to connected players running the LING Horizons Client:

  • Smart Chunky Auto-Bridge & Automation:
    • Automatically scans for saved, unfinished Chunky pre-generation tasks on disk (config/chunky/tasks/). When detected, it immediately issues /chunky continue to resume generation without hanging or requiring manual console confirmation.
    • If no existing task is present, the server automatically starts the pre-generation sequence with your configured radius and shape after a safe startup delay.
  • Zero-Lag Gameplay (Dynamic Auto-Pause & Resume):
    • Players Online (>= 1): Automatically executes chunky pause, yielding 100% of CPU and memory bandwidth to players to guarantee a stable 20.00 TPS.
    • Server Empty (0 Online): Automatically executes chunky resume, utilizing idle server time to pre-generate chunks and bake Voxel LODs in the background.
  • Hierarchical Radial Streaming (Instant Horizon, Zero Void):
    • Immediately transmits lightweight, coarse horizon geometry (Coarse LOD 4 & 3, ~15–30 KB) upon join or teleport to eliminate visual pop-in and void holes.
    • Progressively streams high-fidelity detail (Fine LOD 2, 1, 0) sorted radially outward from each player's position in real time.
  • Adaptive Token-Bucket Bandwidth Limiter:
    • Throttles LOD packet delivery per player (default 50 KB/s) to prevent network saturation, maintaining ultra-low player ping (<30ms) even during rapid flight or exploration.
  • Industrial RocksDB Master Database:
    • Stores all persistent Voxel LOD data in an embedded, high-throughput RocksDB key-value store located at world/ling_horizons/.
  • Safe Fast Shutdown (<1s):
    • Intercepts /stop commands to pause Chunky instantly, drop async background workers, flush databases cleanly to disk, and exit without server hangs or deadlock.
  • Vanilla & Modpack Friendly:
    • Players without the LING Horizons Client can join and play normally without being required to install client mods.

System Requirements & Prerequisites

Component Minimum Specification Recommended Specification
Java Runtime Java 21 (Eclipse Temurin / OpenJDK 21) Java 21 64-bit with Vector API enabled
Server Platform NeoForge 1.21.1 (v21.1.248+) NeoForge 1.21.1
CPU 4 Cores / 8 Threads 6+ Cores / 12+ Threads
Dedicated RAM 6 GB - 8 GB 10 GB - 16 GB+ (for large modpacks)
Storage (Disk) SSD / NVMe (20–50 GB free space) High-Speed NVMe M.2 SSD
Required Server Mod lingHorizons-Server-V1-1.0.0.jar lingHorizons-Server-V1-1.0.0.jar
Recommended Mod Chunky (NeoForge 1.21.1) Chunky (NeoForge 1.21.1)

Manual and Instructions for Use

📜 License

This project is licensed under the Creative Commons Attribution 4.0 International (CC BY 4.0) license.

CC BY 4.0

You are free to:

  • Share — copy and redistribute the material in any medium or format
  • Adapt — remix, transform, and build upon the material for any purpose, even commercially.

Under the following terms:

  • Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made.

For full license text, see the LICENSE file or visit Creative Commons CC BY 4.0.