be_lod-compat

be_lod-compat

这个模组使一些模组方块在DistantHorizon中渲染得更好。

工具

当前状态:DH-2.3.5DH-2.4.5 请使用 0.6a,DH-3.0.2DH-3.0.3 请使用 0.7.2a,DH-3.1.0 及以上请使用 0.7.3a

BeLodCompat

此模组改进了 Distant Horizons 对来自某些模组的方块的渲染方式。没有它,这些方块在远处可能会显示异常或完全消失。

特性

没有此模组时,LittleTiles 方块会被 Distant Horizons 当作应避免的方块处理(类似于花),使它们大多不可见,或在可见时显示为灰色。Immersive Railroading 的铁轨会显示为纯白色。

  • LittleTiles – 从 LittleTiles 方块中提取单个 tile 的方块状态和颜色。颜色混合需要启用数据库缓存,并将 Distant Horizons 配置选项 common.lodBuilding.worldCompression 设置为 "MERGE_SAME_BLOCKS" 才能稳定渲染。
  • Immersive Railroading – 从父方块的 NBT 中读取道床填充材料 ID。如果未启用固定方块覆盖,则必须启用数据库缓存才能确保可靠的远距离显示。
  • 数据库支持 – 每个维度维护自己的 SQLite 数据库,存储于不同位置:
    • 单人游戏:<save_folder>/belodcompat/<dimension>.db
    • 多人游戏客户端:.minecraft/belodcompat_servers/<server_ip>/<dimension>.db
    • 专用服务器:<world_root>/belodcompat/<dimension>.db 这种按维度隔离的方式可防止数据混淆,并确保所有维度中的 LOD 渲染正确。

依赖要求

  • Minecraft:1.20.1 (Forge) 或 1.21.1 (NeoForge)
  • Distant Horizons 2.3.5/3.0.2 或更高版本
  • LittleTiles(可选)
  • Immersive Railroading(可选)

配置

配置文件生成于 config/belodcompat.cfg。文件更改后会自动重新加载(enableDatabase 除外,它需要重启)。可用选项如下:

选项 描述 默认值
debugLogging 启用调试日志记录(某些情况下部分调试信息可能不会写入日志) false
overrideIrRailBlock 强制所有 IR 铁轨使用自定义方块,而不是其道床填充材料 false
overrideIrRailBlockId 启用覆盖时使用的方块 ID(若无效则回退到 minecraft:soul_sand) minecraft:soul_sand
getIrDataFromParentDirectly 直接从父铁轨获取道床填充颜色(更快,但可能略微降低速度) false
replaceIrIfAir 若原始道床填充颜色为空气,则用回退颜色替换 false
enableDatabase 启用 SQLite 数据库缓存(需要重启) true
useAsyncDbWrite 使用异步数据库写入(性能更好,但崩溃时可能丢失数据) true

命令

此模组添加了 /belodcompat 命令,包含以下子命令:

命令 描述
/belodcompat dumpIR [dimension] 导出指定维度(若省略则为当前维度)的所有缓存 IR 方块状态
/belodcompat dumpLT [dimension] 导出所有缓存的 LT 方块状态及其颜色
/belodcompat showConfig 显示当前配置值
/belodcompat getLtColor <x> <y> <z> [dimension] 显示给定位置处缓存的 LT 颜色
/belodcompat getBlockStateOfLT <x> <y> <z> [dimension] 显示缓存的 LT 方块状态
/belodcompat getBlockStateOfIR <x> <y> <z> [dimension] 显示缓存的 IR 方块状态

许可证

LGPL 3.0

项目链接

GitHub:https://github.com/Deepseasaltyfish/BE_DH-compat