lingHorizons-Server+Chunky

LING Horizons Server 是一个适用于 Minecraft 1.21.1 (NeoForge) 的专用服务器模组。它作为一个中心化的主控体素 DAG 引擎，持续索引、缓存并向连接了 LING Horizons Client 的玩家流式传输高分辨率细节层次（LOD）地形数据。

项目概述

LING Horizons Server 是一个工业级的 专用服务器 模组，适用于 Minecraft 1.21.1 (NeoForge)。它作为一个中心化的 主控体素 DAG 引擎，持续索引、压缩、缓存，并直接向运行 LING Horizons Client 的已连接玩家流式传输高分辨率的细节层次（LOD）远景地形：

• 智能 Chunky 自动桥接与自动化：
  • 自动扫描磁盘上已保存的、未完成的 Chunky 预生成任务（config/chunky/tasks/）。检测到任务后，立即执行 /chunky continue 以恢复生成，不会挂起或需要手动控制台确认。
  • 如果不存在现有任务，服务器将在安全启动延迟后，根据您配置的半径和形状自动启动预生成序列。
• 零延迟游戏体验（动态自动暂停与恢复）：
  • 有玩家在线 (>= 1)：自动执行 chunky pause，将 100% 的 CPU 和内存带宽让给玩家，以保证稳定的 20.00 TPS。
  • 服务器空闲 (0 人在线)：自动执行 chunky resume，利用服务器空闲时间在后台预生成区块并烘焙体素 LOD。
• 分层径向流式传输（即时视野，零空洞）：
  • 在加入或传送时，立即传输轻量级、粗略的地平线几何体（粗 LOD 4 和 3，约 15–30 KB），以消除视觉弹出和空洞。
  • 实时从每个玩家的位置开始，按径向向外排序，逐步流式传输高保真细节（精细 LOD 2, 1, 0）。
• 自适应令牌桶带宽限制器：
  • 限制每个玩家的 LOD 数据包传输速率（默认 50 KB/s），以防止网络饱和，即使在快速飞行或探索期间也能保持超低玩家延迟（<30ms）。
• 工业级 RocksDB 主数据库：
  • 将所有持久的体素 LOD 数据存储在内嵌的、高吞吐量的 RocksDB 键值存储中，位置在 world/ling_horizons/。
• 安全快速关闭（<1s）：
  • 拦截 /stop 命令，立即暂停 Chunky，停止异步后台工作线程，将数据库干净地刷新到磁盘，并在不挂起服务器或造成死锁的情况下退出。
• 原版与整合包友好：
  • 没有安装 LING Horizons Client 的玩家可以正常加入并游玩，无需强制安装客户端模组。

---

系统要求与前置条件

组件	最低配置	推荐配置
Java 运行时	Java 21 (Eclipse Temurin / OpenJDK 21)	启用 Vector API 的 64 位 Java 21
服务器平台	NeoForge 1.21.1 (v21.1.248+)	NeoForge 1.21.1
CPU	4 核 / 8 线程	6+ 核 / 12+ 线程
专用内存 (RAM)	6 GB - 8 GB	10 GB - 16 GB+（适用于大型整合包）
存储（磁盘）	SSD / NVMe（20–50 GB 可用空间）	高速 NVMe M.2 SSD
必需的服务端模组	lingHorizons-Server-V1-1.0.0.jar	lingHorizons-Server-V1-1.0.0.jar
推荐模组	Chunky (NeoForge 1.21.1)	Chunky (NeoForge 1.21.1)

使用手册与说明

📜 许可证

本项目根据 知识共享署名 4.0 国际 (CC BY 4.0) 许可证授权。

您可以自由地：

• 共享 — 以任何媒介或格式复制和重新分发本材料
• 改编 — 出于任何目的（甚至商业目的）重新混合、转换并基于本材料进行创作。

但须遵守以下条款：

• 署名 — 您必须给出适当的署名，提供指向许可证的链接，并指明是否进行了修改。

有关完整的许可证文本，请参阅 LICENSE 文件或访问 知识共享 CC BY 4.0。