be_lod-compat

_Current status: Please use 0.6a for DH-2.3.5~DH-2.4.5, 0.7.2a for DH-3.0.2~DH-3.0.3, 0.7.3a for DH-3.1.0 and above_

BeLodCompat

This mod improves how Distant Horizons renders blocks from certain mods. Without it, those blocks may look wrong or disappear entirely in the distance.

Features

Without this mod, LittleTiles blocks are treated as avoided blocks by Distant Horizons (similar to flowers), making them mostly invisible or appearing as gray when visible. Immersive Railroading rails appear as pure white.

• LittleTiles – Extracts one tile’s block state and color from LittleTiles blocks. Color blending requires database caching to be enabled and the Distant Horizons config option common.lodBuilding.worldCompression set to "MERGE_SAME_BLOCKS" for stable rendering.
• Immersive Railroading – Reads the rail bed fill material ID from the parent block’s NBT. If the fixed block override is not enabled, database caching must be active to ensure reliable long‑distance display.
• Database support – Each dimension maintains its own SQLite database, stored in separate locations:
• Singleplayer: <save_folder>/belodcompat/<dimension>.db
• Multiplayer client: .minecraft/belodcompat_servers/<server_ip>/<dimension>.db
• Dedicated server: <world_root>/belodcompat/<dimension>.db This per‑dimension isolation prevents data mixing and ensures correct LOD rendering across all dimensions.

Requirements

• Minecraft: 1.20.1 (Forge) or 1.21.1 (NeoForge)
• Distant Horizons 2.3.5/3.0.2 or later
• LittleTiles (optional)
• Immersive Railroading (optional)

Configuration

A config file is generated at config/belodcompat.cfg. The file is automatically reloaded when changed (except for enableDatabase, which requires a restart). The following options are available:

| Option | Description | Default |
|——–|————-|———|
| debugLogging | Enable debug logging (some debug messages may not be written to the log in certain situations) | false |
| overrideIrRailBlock | Force all IR rails to use a custom block instead of their bed fill material | false |
| overrideIrRailBlockId | Block ID used when override is enabled (falls back to minecraft:soul_sand if invalid) | minecraft:soul_sand |
| getIrDataFromParentDirectly | Retrieve bed fill color directly from parent rail (faster but may slow down slightly) | false |
| replaceIrIfAir | Replace the bed fill color with a fallback if the original is air | false |
| enableDatabase | Enable SQLite database caching (requires restart) | true |
| useAsyncDbWrite | Use asynchronous database writes (better performance but may lose data on crash) | true |

Commands

The mod adds the /belodcompat command with the following subcommands:

| Command | Description |
|———|————-|
| /belodcompat dumpIR [dimension] | Dump all cached IR block states for the specified dimension (or current dimension if omitted) |
| /belodcompat dumpLT [dimension] | Dump all cached LT block states with colors |
| /belodcompat showConfig | Display current configuration values |
| /belodcompat getLtColor <x> <y> <z> [dimension] | Show the cached LT color at the given position |
| /belodcompat getBlockStateOfLT <x> <y> <z> [dimension] | Show the cached LT block state |
| /belodcompat getBlockStateOfIR <x> <y> <z> [dimension] | Show the cached IR block state |

License

LGPL 3.0

Project Links

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