MagicParticles

Magic Particles

Серверный косметический мод для Fabric, позволяющий администратору создавать собственные частицы с помощью простых json-файлов

Команды

• /mp — Список всех доступных магических частиц — magic-particles.root
• `/mp set — Установить текущую магическую частицу —magic-particles.particle`
• /mp disable — Отключить текущую магическую частицу — magic-particles.disable
• /mp reload — Перезагрузить магические частицы и сообщения — magic-particles.reload

Собственные частицы

Мод включает более 40 стандартных частиц, которые могут послужить полезными примерами для понимания формата.

Формат JSON

Каждому типу магической частицы нужно понятное человеку имя и список частиц, из которых она состоит

Корень

{
  "name": "Some name", // Понятное человеку имя
  "particles": [
    // Определения частиц
  ]
}

Определение частицы

На данный момент существует 3 типа определения частиц (simple, image и bezier). Все они имеют несколько общих значений в дополнение к своим специфичным.

Simple

{
  "type": "simple",
  "count": 1, // Количество частиц (необязательно)
  "pos": [1.0, 2.0, 0.0], // Смещение от начала координат (подвержено вращению)
  "delta": [0.1, 0.1, 0.1], // Размер области частицы (необязательно)
  "speed": 0, // Параметр скорости частицы, используется некоторыми типами частиц (необязательно)
  "particle_type": {
    "type": "minecraft:angry_villager" // Тип частицы: https://minecraft.wiki/w/Particles_(Java_Edition)#Types_of_particles
    // У некоторых типов частиц есть дополнительные атрибуты, которые нужно указать здесь
  },
  "anchor": "feet", // Начало координат частицы ["feet"|"eyes"] (необязательно)
  "origin": [0.0, 0.5, 0.0], // Смещение от начала координат (необязательно)
  "billboard": "fixed" // Какая ось вращения должна влиять на "pos" ["fixed", "vertical", "horizontal", "center"] (необязательно)
}

Image

{
  "type": "image",
  "image": "drex.png", // Путь к изображению, изображение должно находиться в config/magic-particles/images/<image>
  "size_x": 0.8, // Ширина изображения частицы
  "size_y": 0.8, // Высота изображения частицы
  "pixel_size": 0.6, // Размер каждой отдельной частицы
  "pos": [1.0, 2.0, 0.0], // Смещение от начала координат (подвержено вращению)
  "anchor": "feet", // Начало координат частицы ["feet"|"eyes"] (необязательно)
  "origin": [0.0, 0.5, 0.0], // Смещение от начала координат (необязательно)
  "billboard": "fixed" // Какая ось вращения должна влиять на "pos" ["fixed", "vertical", "horizontal", "center"] (необязательно)
}

Bezier

(Не могу особо рекомендовать использовать это, создать изображение нужной формы и использовать тип image проще)