Версия мода: 0.6.0
Автор: slepa01
Лицензия: GPLv3

CATR real3d v10 — экспериментальный патч отображения на депо Create
Основа: предоставленный catr-1.21.1-0.6.0-neo-real3d-v7 (1).jar
Minecraft 1.21.1 / NeoForge; зависимости оставлены без изменений.

ИСПРАВЛЕНИЕ V10 — ТОЛЬКО ГОТОВОЕ ОРУЖИЕ TACZ
Проверено по точному tacz-neoforge-1.21.1-1.1.8-r2.jar с Modrinth:
https://modrinth.com/mod/tacz-1.21.1/version/1.1.8-r2
SHA512 скачанного файла сверена с метаданными Modrinth (в tests/native).

Причина: прежний обход считал настоящими опорными поверхностями служебные
кубы lefthand_pos/righthand_pos. В рендере TACZ эти кубы заменены специальными
обработчиками; вне первого лица они не отображаются. Также нулевые грани
в PerFace-кубах содержат повторяющиеся координаты фиктивной вершины.

V10:
- исключает lefthand_pos, righthand_pos, muzzle_flash и shell/shell_N;
- исключает невидимые вырожденные грани из расчёта границ;
- не хранит навсегда границы, полученные до первой отрисовки и установки
  динамической видимости деталей нативным рендером TACZ;
- сохраняет масштаб, поворот, высоту площадки и всё поведение CATR из v9.

ПРОВЕРКА
Офлайн-тест с настоящими BedrockPart, BedrockCubeBox/PerFace, BedrockPolygon
и BedrockVertex из r2, настоящим fastutil/JOML и тестовыми реализациями API
Minecraft проверил 110 вариантов моделей стандартного пака (включая LOD).
В тесте воспроизводится базовая видимость незаряженного оружия без обвесов.
Эталон — native BedrockPart.render после скрытия служебных узлов контекста
NONE. Это НЕ полный GunItemRendererWrapper и НЕ работающий клиент игры.
В v9 56/110 случаев давали несовпадение; v10: 0/110 несовпадений опорной
координаты. Для AKM ложный зазор v9: 0,216796875 блока, в этом тесте v10: 0.
В tests/native — программа теста, поддерживающие API-заглушки, результаты
v9/v10 и сведения о версии TACZ. Бинарники TACZ и сторонние библиотеки
НЕ включены. Для повторения см. run.sh (нужны ECJ, Gson, JOML и fastutil).

ОГРАНИЧЕНИЯ
- В Minecraft не запускалось. Фотографии пользователя использовались для
  диагностики, но новых игровых скриншотов нет.
- Рабочий расчёт использует основную модель из getGunModel(). Переключение
  фактического рендера TACZ на LOD на большом расстоянии не синхронизировано
  с этим выбором. Тест LOD проверяет геометрию, не механизм её выбора в игре.
- Динамическая видимость читается из текущего состояния базовой модели;
  первая отрисовка и разные обвесы на предметах с одной общей моделью могут
  потребовать дополнительной работы. Тесты относятся к базовым вариантам.
- Дополнительные прицелы и сторонние оружейные паки не проверены.

ИСПРАВЛЕНИЕ V9
В v8 точка рендера Create (15/16 блока) ошибочно принималась за поверхность
депо. Модель стандартного депо Create 6.0.9 имеет верхнюю грань на 13/16.
V9 смещает все обрабатываемые модели вниз на 2/16 блока, дополнительно
сокращая технический зазор с 0,001 до 0,0001 блока. Масштаб и укладка из v8
сохранены. Проверки теперь включают исходное смещение Create и высоту
реальной модели блока, а не только локальную точку рендера.

ИЗМЕНЕНИЯ
- Корпусы и незавершённое оружие CATR: лежат на боку, центрированы по геометрии.
- Крупное оружие: масштаб на депо относительно прежнего ×2,75.
- RPG-7 и Minigun: ×4.
- Пистолеты/револьверы: исходный масштаб сохранён.
- Ступени сборки определяются прежней системой assembly_step. Геометрия и
  точка опоры вычисляются уже после выбора модели текущей стадии.
- Минимальная расчётная высота геометрии над поверхностью: 0,0001 блока.
- Свечение/выделение корпусов при наведении на депо удалено.
  Вызов связанной с ним всплывающей подсказки на депо тоже удалён.
  Обычное выделение самого блока депо Minecraft не изменено.
- Готовое оружие TACZ использует native 3D-рендер с контекстом NONE и поворотом
  на бок. Его опора вычисляется по базовой Bedrock-геометрии.
- Предметы, не являющиеся корпусами/незавершёнными оружиями/оружием TACZ,
  обрабатываются обычным рендером Create.
- Модели инвентаря и рук, рецепты, предметы, текстуры и механика сборки
  не редактировались. Отрисовывается одна модель, а не копии стопки.

УСТАНОВКА
1. Закройте игру и сохраните резервную копию исходного JAR.
2. Уберите старый catr JAR из mods (не оставляйте две версии одновременно).
3. Поместите catr-1.21.1-0.6.0- neo.jar в mods.
4. Остальные моды/зависимости не меняйте. На выделенном сервере синхронизируйте
   CATR у клиентов и сервера, если сборка проверяет совпадение файлов.
5. Проверьте корпус, каждую стадию сборки и готовое оружие на депо.

ПРОВЕРКИ И ОГРАНИЧЕНИЯ
- Проверена целостность ZIP/JAR и отсутствие посторонних замен.
- Проверены структура байткода ASM и Java 21 class format.
- Математически проверены 366 моделей: 52 корпуса, 54 базовых незавершённых,
  260 моделей стадий. Учитываются повороты/масштабирование элементов JSON.
- Выполнены синтетические тесты на API-заглушках: 45 случаев CATR,
  4 случая TACZ, исключения прочих предметов и восстановление PoseStack.
- Minecraft/NeoForge не запускались. Загрузка mixin в настоящей сборке,
  визуальный результат, шейдеры и производительность в игре НЕ проверены.
- Интеграция TACZ ориентирована на API NeoForge-порта MUKSC/TACZ-1.21.1
  ветки neoforge/1.21.1. Точный релиз TACZ r2 скачан по указанному пользователем имени.
  При несовместимости API выводится предупреждение в журнал; готовое оружие
  возвращается к штатному отображению Create вместо падения из-за этого API.
- Измеряется базовая геометрия TACZ без выполнения функциональных рендереров:
  дополнительные прицелы, обвесы и нестандартные оружейные паки могут
  потребовать отдельной подгонки. Предполагается, что тонкая ось модели — X.
- Белый контур не добавлялся: выбран предложенный вариант удаления выделения.
- Рендерер перехватывает общий статический метод DepotRenderer.renderItem;
  сторонние механизмы, использующие этот же метод, тоже могут получить
  такое отображение. Рендеры руки/инвентаря этот метод не используют.

ИСТОЧНИКИ ДЛЯ ПРОВЕРКИ API
https://github.com/Creators-of-Create/Create/blob/mc1.21.1-6.0.9/src/main/java/com/simibubi/create/content/logistics/depot/DepotRenderer.java
https://github.com/Creators-of-Create/Create/blob/mc1.21.1-6.0.9/src/main/resources/assets/create/models/block/depot/block.json
https://github.com/MUKSC/TACZ-1.21.1/tree/neoforge/1.21.1
Официальные клиентские mappings Minecraft 1.21.1 (Mojang).

ИСХОДНИКИ ПАТЧА
CATR-depotfix-v10-source.zip содержит новые исходники, генератор mixin,
API-заглушки, скрипты/исходники тестов и отчёт по моделям.
Для математической проверки приложены block.json и DepotRenderer.java из
Create mc1.21.1-6.0.9 по ссылкам выше; это эталон, не замена файлов Create.
Заглушки НЕ входят в рабочий JAR. Библиотеки Minecraft/TACZ не вложены.
Изменения распространяются по GPL-3.0-or-later, как патч к GPL-моду CATR.
Это исходники изменения, а не полный исходный проект исходного мода.
