LIDAR

LIDAR

The LIDAR mod fundamentally transforms Minecraft's visual perception, turning the familiar world into a space composed of particles and dots. These elements are projected from the player onto surrounding surfaces, creating a unique and challenging gaming experience.

Visualization Features

Gameplay becomes significantly more challenging due to the unusual way the environment is displayed. This visualization creates an atmosphere of tension and mystery, making the game genuinely spooky.

Musical Accompaniment

The mod also includes modified musical content. Most compositions are available on popular music platforms.

Configuration Settings

Currently, the mod's configuration is edited manually through the config/lidar-lidarconfig.json file. It's important to remember that incorrect values in this file may cause game crashes. Future updates plan to add an in-game settings menu.

{
    // activation of mod rendering
    "isActive": true,
    // mapping of block identifiers to particle colors
    "blockColorMap": {
        "default": "#FFFFFF",
        "minecraft:water": "#0000FF",
        "minecraft:seagrass": "#0000FF"
    },
    // mapping of entity identifiers to particle colors
    "entityColorMap": {
        "default": "#ff7e7e",
        "peaceful": "#61cf66",
        "hostile": "#ff7e7e",
        "minecraft:enderman": "#7e009e",
        "minecraft:creeper": "#008f07"
    },
    // entities excluded from the particle system and rendered normally
    "entityRender": [
        "minecraft:item",
        "minecraft:item_frame",
        "minecraft:glow_item_frame",
        // removing the Ender Dragon from this list will cause game crashes during rendering
        "minecraft:ender_dragon"
    ],
    // particles following moving entities (looks unnatural, disabled by default)
    "entityParticleFollow": false,
    // accurate particle projection onto entity models with performance cost
    "entityParticleModel": true,
    // particles from other entities rendering on the current player (blocks view, disabled by default)
    "entityParticlesOnSelf": false,
    // number of lidar projections from non-player entities per tick
    "entityLidarCount": 20,
    // lidar particle projection distance in blocks
    "lidarDistance": 10.0,
    // particle radius/spread in degrees
    "lidarSpread": 30.0,
    // number of lidar projections for player entities per tick
    "lidarCount": 100,
    // particle display duration on blocks in ticks
    "lidarDurationBlock": 100,
    // particle display duration on entities in ticks
    "lidarDurationEntity": 20,
    // application of bloom effect for lidar particles
    "lidarBloom": true
}

Controls

The mod provides one key to toggle between particle display and normal graphics modes. By default, this function is assigned to the K key. Control settings can be changed in the "options > controls > key binds" section.

Compatibility

Due to the way it modifies rendering logic, this mod is likely incompatible with most other Fabric mods. Known incompatibility exists with Sodium, Iris, and similar mods. Use at your own risk.

License

Copyright (c) 2023 James Fenn

This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at https://mozilla.org/MPL/2.0/.