Компоненты частиц

Компоненты частиц описывают каждую отдельную частицу: как она появляется, как движется, как выглядит и когда исчезает. Они лежат в блоке components файла частиц, рядом с компонентами эмиттера, которые эти частицы создают.

Впервые работаешь с частицами? В гайде Твоя первая частица с нуля собирается рубиновая искра, и там используется большинство этих компонентов.

Числовые поля принимают обычное число или строку на Molang. Внутри можно использовать variable.particle_age, variable.particle_lifetime и от variable.particle_random_1 до _4, чтобы у каждой частицы был свой характер.

Начальное состояние

Эти компоненты задаются один раз, когда частица рождается.

Скорость

"minecraft:particle_initial_speed": "math.random(1, 2)"

С одним числом частица летит в направлении, которое задала форма эмиттера. С тремя числами ты сам задаёшь скорость, например [0, 2, 0] - прямо вверх. Если не добавлять компонент, частицы появляются неподвижными.

Вращение

"minecraft:particle_initial_spin": {
  "rotation": "math.random(0, 360)",
  "rotation_rate": "math.random(-90, 90)"
}

Вращение поворачивает плоскую картинку вокруг её центра, как колесо. Случайный начальный угол - самый простой способ сделать так, чтобы толпа частиц не выглядела как копии.

Свои переменные

"minecraft:particle_initialization": {
  "per_render_expression": "variable.twinkle = math.sin(variable.particle_age * 720) * 0.5 + 0.5;"
}

Теперь variable.twinkle качается между 0 и 1 дважды в секунду, и её можно использовать для размера или цвета. Для значения, которое меняется по форме в течение всей жизни, часто проще использовать кривую.

Движение

Эти компоненты двигают частицу каждый кадр после её рождения.

Динамическое

"minecraft:particle_motion_dynamic": {
  "linear_acceleration": [0, -9.8, 0],
  "linear_drag_coefficient": 0.5,
  "rotation_acceleration": 0,
  "rotation_drag_coefficient": 0
}

Динамическое движение работает со скоростью частицы, поэтому сочетается с particle_initial_speed: стартуй быстро, а дальше пусть работают гравитация и сопротивление.

Параметрическое

"minecraft:particle_motion_parametric": {
  "relative_position": [
    "math.cos(variable.particle_age * 360) * 0.8",
    "variable.particle_age",
    "math.sin(variable.particle_age * 360) * 0.8"
  ]
}

Здесь ты пропускаешь физику и просто говоришь, где находится частица относительно эмиттера. Этот пример делает круг раз в секунду и поднимается на один блок в секунду: получается рубиновая спираль. direction и rotation задаются так же.

Столкновения

"minecraft:particle_motion_collision": {
  "collision_radius": 0.1,
  "coefficient_of_restitution": 0.4,
  "collision_drag": 2,
  "events": { "event": "pop", "min_speed": 2 }
}

Без этого компонента частицы пролетают сквозь блоки.

Внешний вид

Эти компоненты решают, как частица выглядит на экране.

Билборд

"minecraft:particle_appearance_billboard": {
  "size": [0.1, 0.1],
  "facing_camera_mode": "lookat_xyz",
  "uv": {
    "texture_width": 32,
    "texture_height": 8,
    "uv": [0, 0],
    "uv_size": [8, 8]
  }
}

size - это [ширина, высота], и он проверяется каждый кадр, так что Molang здесь может увеличивать или уменьшать частицу. Каждое значение отсчитывается от центра, поэтому 0.5 даёт квадрат шириной в один блок.

facing_camera_mode решает, куда повёрнута плоская картинка:

Режимам направления нужно знать, куда направлена частица. Это задаётся через direction:

"direction": {
  "mode": "derive_from_velocity",
  "min_speed_threshold": 0.01
}

derive_from_velocity берёт направление движения частицы, но только пока она движется быстрее min_speed_threshold. Используй "mode": "custom_direction" с "custom_direction": [x, y, z], чтобы задать его самому.

uv выбирает, какую часть текстуры показывать. texture_width и texture_height - размер твоего PNG в пикселях, uv - левый верхний угол, а uv_size - ширина и высота нужной части. Пример выше показывает первый кадр 8x8 из полоски 32x8.

Покадровая анимация

Положи несколько кадров рядом, и билборд сможет проигрывать их как мультфильм. Замени uv и uv_size на flipbook:

"uv": {
  "texture_width": 32,
  "texture_height": 8,
  "flipbook": {
    "base_UV": [0, 0],
    "size_UV": [8, 8],
    "step_UV": [8, 0],
    "max_frame": 4,
    "stretch_to_lifetime": true,
    "loop": false
  }
}

Рубиновая искра из 4 кадров, которая раскрывается, сияет и снова закрывается, выглядит гораздо живее одной картинки.

Окрашивание

"minecraft:particle_appearance_tinting": {
  "color": [1, 0.15, 0.3, 1]
}

Цвет умножается на текстуру, поэтому рисуй текстуры частиц белыми или серыми, а цвет пусть добавляет окрашивание. Цвет можно записать любым из этих способов:

Чтобы цвет менялся со временем, используй градиент. Цвета распределяются равномерно, а interpolant выбирает, в какой точке градиента частица находится прямо сейчас:

"minecraft:particle_appearance_tinting": {
  "color": {
    "gradient": {
      "0.0": "#FFFFFFFF",
      "0.3": "#FFFF2650",
      "1.0": "#00600018"
    },
    "interpolant": "variable.particle_age / variable.particle_lifetime"
  }
}

Если записать градиент объектом, как здесь, каждый цвет стоит в той точке, которую ты указал. Обычный список, наоборот, распределяет их равномерно от 0 до 1. Эта искра вспыхивает белым, рано становится рубиново-красной, а потом медленно угасает.

Освещение

"minecraft:particle_appearance_lighting": {}

С ним частицы выглядят темнее в пещерах и ночью и лучше вписываются в мир. Не добавляй его для того, что должно светиться в темноте: магии, огня, нашей рубиновой искры.

Время жизни

Эти компоненты решают, когда частица исчезает.

Выражение времени жизни

"minecraft:particle_lifetime_expression": {
  "max_lifetime": "math.random(0.8, 1.5)"
}

• max_lifetime - время жизни в секундах, выбирается один раз при рождении частицы.
• expiration_expression проверяется каждый кадр. Когда оно не равно 0, частица исчезает. Например, "variable.particle_age > 1 && query.is_in_water" может завершить её раньше.

Можно использовать оба сразу: частица исчезнет по тому, что наступит раньше.

События жизни

"minecraft:particle_lifetime_events": {
  "creation_event": "flash",
  "expiration_event": "pop",
  "timeline": {
    "0.25": "twinkle"
  }
}

Названия указывают на блок events того же файла, и каждое поле принимает одно название или список. В отличие от версии для эмиттера, эти события срабатывают для каждой отдельной частицы, так что вспышка из 12 искр вызовет pop 12 раз. Что умеет событие, смотри в разделе про события.

Плоскость уничтожения

"minecraft:particle_kill_plane": [0, 1, 0, 0.5]

Четыре числа описывают плоскость по-математически: все точки, где A*x + B*y + C*z + D = 0, отсчитанные от эмиттера, но выровненные по миру. Частицы, которые её пересекают, исчезают. [0, 1, 0, 0.5] - это пол на полблока ниже эмиттера. Это дешёвый способ остановить падающие частицы без столкновений.

В блоках и не в блоках

"minecraft:particle_expire_if_not_in_blocks": [
  "minecraft:water",
  "minecraft:flowing_water",
  "minecraft:bubble_column"
]

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

Частица целиком

Все четыре группы вместе. Это сторона частицы для падающего рубинового осколка, который отскакивает и угасает:

"minecraft:particle_initial_speed": "math.random(2, 3)",
"minecraft:particle_initial_spin": {
  "rotation": "math.random(0, 360)",
  "rotation_rate": 180
},
"minecraft:particle_motion_dynamic": {
  "linear_acceleration": [0, -9.8, 0],
  "rotation_drag_coefficient": 1
},
"minecraft:particle_motion_collision": {
  "collision_radius": 0.05,
  "coefficient_of_restitution": 0.3,
  "collision_drag": 4
},
"minecraft:particle_appearance_billboard": {
  "size": [0.06, 0.06],
  "facing_camera_mode": "lookat_xyz",
  "uv": {
    "texture_width": 8,
    "texture_height": 8,
    "uv": [0, 0],
    "uv_size": [8, 8]
  }
},
"minecraft:particle_appearance_tinting": {
  "color": "#FFE0204A"
},
"minecraft:particle_appearance_lighting": {},
"minecraft:particle_lifetime_expression": {
  "max_lifetime": 2
}

Дай ему эмиттер из раздела Компоненты эмиттера, например вспышку из 8 частиц из маленькой сферы, и получится отличный эффект разрушения блока.