Туман

Туман - это дымка, которая скрывает край мира и окрашивает всё в синий под водой. Файл тумана в пакете ресурсов задаёт его цвет и то, как близко он начинается. Потом его можно использовать в биоме или выдать игроку командой.

На этой странице вы сделаете тёплый розовый рубиновый туман для биома Рубиновая роща.

Файлы

RP/
  fogs/
    ruby_fog.json
  biomes/
    ruby_grove.client_biome.json

Файл тумана

{
  "format_version": "1.21.90",
  "minecraft:fog_settings": {
    "description": {
      "identifier": "wiki:ruby_fog"
    },
    "distance": {
      "air": {
        "fog_start": 0.6,
        "fog_end": 1.0,
        "fog_color": "#e8a0a8",
        "render_distance_type": "render"
      },
      "water": {
        "fog_start": 0,
        "fog_end": 40,
        "fog_color": "#8a2e4a",
        "render_distance_type": "fixed"
      },
      "weather": {
        "fog_start": 0.2,
        "fog_end": 0.6,
        "fog_color": "#7a5a60",
        "render_distance_type": "render"
      }
    }
  }
}

identifier должен содержать пространство имён. Один туман на файл.

Где действует туман

Внутри distance каждый ключ - это ситуация. Перечислять нужно только те, которые вы хотите изменить.

Поля

render_distance_type меняет смысл fog_start и fog_end:

• "render": числа - это доля дальности прорисовки игрока. 0.6 означает 60 процентов пути до края. Хорошо подходит для air, так он работает при любой настройке дальности прорисовки.
• "fixed": числа в блоках. 40 означает 40 блоков. Хорошо подходит для подводного тумана, где вид должен быть одинаковым у всех.

Плавный туман с transition_fog

Ванильная вода использует это, чтобы после погружения обзор прояснялся постепенно:

"transition_fog": {
  "init_fog": {
    "fog_start": 0,
    "fog_end": 0.01,
    "fog_color": "#8a2e4a",
    "render_distance_type": "fixed"
  },
  "min_percent": 0.25,
  "mid_seconds": 5,
  "mid_percent": 0.6,
  "max_seconds": 30
}

init_fog - туман в момент входа. Потом он движется к обычным настройкам: на min_percent пути в начале, на mid_percent через mid_seconds и полностью через max_seconds.

Объёмный туман

Когда включены Vibrant Visuals, туман может быть настоящей 3D-дымкой, сквозь которую проходит свет. Добавьте блок volumetric рядом с distance:

"volumetric": {
  "density": {
    "air": {
      "max_density": 0.08,
      "max_density_height": 64,
      "zero_density_height": 120
    }
  },
  "media_coefficients": {
    "air": {
      "scattering": [0.05, 0.03, 0.03],
      "absorption": [0.0, 0.0, 0.0]
    }
  },
  "henyey_greenstein_g": {
    "air": {
      "henyey_greenstein_g": 0.6
    }
  }
}

Игроки без Vibrant Visuals видят только туман из distance, поэтому всегда задавайте и его.

Как использовать свой туман

В биоме

Укажите его в клиентском биоме через minecraft:fog_appearance:

"minecraft:fog_appearance": {
  "fog_identifier": "wiki:ruby_fog"
}

Так же можно дать новый туман ванильному биому. Создайте файл клиентского биома с ванильным идентификатором, например minecraft:plains.

На границе двух биомов игра смешивает их туманы, поэтому переход получается плавным.

Командой

/fog накладывает туман поверх всего остального для выбранных игроков, и он остаётся даже после перезагрузки мира:

/fog @a push wiki:ruby_fog ruby_event
/fog @a pop ruby_event

Последнее слово - имя, которое вы придумываете сами. pop снимает самый новый туман с этим именем, remove снимает все туманы с этим именем.

Как игра выбирает настройку

Туман работает слоями. Для каждой настройки игра проверяет слои сверху вниз и берёт первый, где она задана:

1. Туманы, добавленные через /fog (сначала самые новые).
2. Туман биомов вокруг игрока.
3. Туман по умолчанию.
4. Встроенные значения, если больше нигде не задано.

Поэтому файл для /fog, в котором задан только water, оставляет туман биома для air.