Angelica/docs/model-spec_uk.md

Специфікація моделей

🌐 Мови: English | Українська

Запозичено з неофіційної Minecraft wiki на умовах ліцензії CC BY-NC-SA 3.0.

Папка assets/<namespace>/models/block містить файли моделей для усіх вказаних варіантів. Назви файлів можна змінювати, але вони завжди повинні відповідати назвам, що використовуються у файлах варіантів.

• [TAG_compound] Кореневий тег
  • [TAG_string] parent: Завантажує іншу модель із вказаного шляху у формі локації ресурсу. Якщо задано і "parent", і "elements", тег "elements" перевизначає тег "elements" із попередньої моделі.
    • Може мати значення "builtin/generated", щоб використовувати модель, створену із вказаної піктограми. Зверніть увагу: підтримується лише перший шар, а обертання можна досягти лише за допомогою файлів станів блоку.
  • [TAG_byte] ambientocclusion: Визначає, чи використовувати розсіяне затінення (true — за замовчуванням), чи ні (false). Примітка: працює лише у батьківському файлі.
  • [TAG_object] display: Містить різні місця відображення моделей предметів.
    • [TAG_compound] Position: Має назву thirdperson_righthand, thirdperson_lefthand, firstperson_righthand, firstperson_lefthand, gui, head, ground або fixed. Місце, де відображається модель предмета. Містить її обертання, зміщення та масштаб для вказаної ситуації. '''fixed''' стосується рамок для предметів, а решта відповідають своїм назвам. Зверніть увагу: зміщення застосовується до моделі перед обертанням.
      • [TAG_list] rotation: Задає обертання моделі за схемою [x, y, z].
      • [TAG_list] translation: Задає зміщення моделі за схемою [x, y, z]. Значення обмежені в діапазоні від -80 до 80.
      • [TAG_list] scale: Задає масштаб моделі за схемою [x, y, z]. Якщо значення більше за 4, воно відображається як 4.
  • [TAG_compound] textures: Містить текстури моделі у формі локації ресурсу або у вигляді іншої текстурної змінної.
    • [TAG_string] particle: Текстура, з якої завантажуються частинки. Ця текстура також використовується як оверлей, якщо ви перебуваєте в порталі Незеру, а також для нерухомих текстур води та лави.^[1] Ця текстура також вважається текстурною змінною, на яку можна посилатися як "#particle". Примітка: Усі частинки руйнування для блоків без моделей вшиті в код, наприклад, для бар’єрів.
    • [TAG_string] Texture variable: Визначає текстурну змінну з ім’ям name та призначає її текстурі або іншій змінній.
  • [TAG_list] elements: Містить усі елементи моделі. Вони можуть мати лише кубічну форму. Якщо задано і "parent", і "elements", тег "elements" перевизначає тег "elements" із попередньої моделі.
    • [TAG_compound] Елемент.
      • [TAG_list] from: Початкова точка кубоїда за схемою [x, y, z]. Значення мають бути від -16 до 32.
      • [TAG_list] to: Кінцева точка кубоїда за схемою [x, y, z]. Значення мають бути від -16 до 32.
      • [TAG_compound] rotation: Визначає обертання елемента.
        • [TAG_list] origin: Встановлює центр обертання за схемою [x, y, z].
        • [TAG_string] axis: Задає вісь обертання: може бути "x", "y" або "z".
        • [TAG_float] angle: Задає кут обертання. Може бути від 45 до -45 градусів із кроком у 22,5 градуса.
        • [TAG_byte] rescale: Визначає, чи масштабувати грані по всьому блоку. Може бути true або false. За замовчуванням — false.
      • [TAG_byte] shade: Визначає, чи рендерити тіні (true — за замовчуванням), чи ні (false).
      • [TAG_compound] faces: Містить усі грані кубоїда. Якщо грань пропущено, вона не рендериться.
        • [TAG_compound] Face: Має назву down, up, north, south, west або east. Містить властивості вказаної грані.
          • [TAG_list] uv: Визначає ділянку текстури для використання за схемою [x1, y1, x2, y2]. Поведінка текстури стає непередбачуваною, якщо значення UV виходять за межі 0 або 16. Якщо значення x1 та x2 поміняти місцями (наприклад, з 0, 0, 16, 16 на 16, 0, 0, 16), текстура віддзеркалюється. Параметр UV є необов’язковим; якщо його не вказано, він автоматично генерується на основі позиції елемента.
          • [TAG_string] texture: Вказує текстуру у формі текстурної змінної зі знаком # на початку.
          • [TAG_string] cullface: Визначає, чи не потрібно рендерити грань, якщо до неї в указаній позиції торкається інший блок. Позиція може бути: down, up, north, south, west або east. Цей параметр також визначає сторону блоку, з якої береться рівень освітлення для цієї грані; якщо параметр не задано, за замовчуванням використовується відповідна сторона.
          • [TAG_int] rotation: Обертає текстуру за годинниковою стрілкою на вказаний кут у градусах. Може бути 0, 90, 180 або 270. За замовчуванням — 0. Обертання не впливає на те, яка частина текстури використовується. Натомість воно зводиться до перестановки вершин вибраної текстури (вибраних неявно або явно через uv).
          • [TAG_int] tintindex: Визначає, чи потрібно тонувати текстуру за допомогою вшитого індексу відтінку. Значення за замовчуванням, -1, вказує на те, що відтінок не використовується. Будь-яке інше число передається в BlockColors для отримання значення відтінку, відповідного цьому індексу. Однак більшість блоків не мають визначеного значення відтінку (у такому разі використовується білий колір). Крім того, жоден ванільний блок наразі не використовує кілька значень відтінку, тому значення індексу відтінку ігнорується (якщо воно відмінне від -1); втім, його можна використовувати для модифікованих блоків, яким потрібні кілька різних значень відтінку в одному блоці.