О проекте

Форк ArieX

Неофициальный русский форк Matcha: авторство ArieX, ручная локализация, проверенные исправления и установка одного ZIP.

Коротко

ArieX является автором и сопровождающим этого неофициального форка Matcha Flavoured, его ручной русской локализации и русскоязычной вики.

Оригинальный Matcha Flavoured создан Klei. Форк не выдаёт себя за официальное обновление Klei и не меняет происхождение ассетов. Задача форка состоит в том, чтобы сохранить авторскую игру, сделать её понятной русскоязычному игроку и исправить воспроизводимые технические дефекты.

Роль	Автор
Оригинальный Matcha Flavoured	Klei
Пластинка Golden	Ciren
Форк, ручная русская локализация и вики	ArieX

Что входит в редакцию

единый пакет механик и клиентских ресурсов Matcha Flavoured;
ручной контекстный перевод собственных строк, предметов, достижений и механик;
официальные русские названия целевой версии Minecraft там, где текст остаётся ванильным;
проверенные группы исправлений с открытым реестром;
сохранённая совместимость внутренних идентификаторов с исходной редакцией;
статическая вики, извлекающая предметы, рецепты и ассеты непосредственно из распакованного pack/;
воспроизводимый релизный ZIP и файл контрольной суммы SHA-256.

Машинный перевод в итоговый архив не входил. Детали переводческого подхода опубликованы в TRANSLATION.md.

Как устроена локализация

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

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

Инструкция по добавлению следующего языка и точные причины для каждой отложенной строки находятся в wiki-data/localization/.

Как устроен реестр исправлений

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

Читаемый список с объяснениями находится на странице «Исправления и известные проблемы».

Какие проблемы исправлены

Редакция исправляет, в частности:

отвергавшиеся при загрузке JSON и недопустимые файлы в реестрах данных;
битые ссылки на добычу, рецепты, модели и текстуры;
недостижимое достижение полного рыболовного улова и неверный биомный тег;
потерю или смешивание состояния разных игроков в постоянно работающих функциях;
голод, здоровье, сон, Эстус, наковальню и зачарования в многопользовательской игре;
фактические характеристики снаряжения, расходившиеся с подсказками;
Оберег, Божественность, Зефир и очистку поверхности после дракона;
эффекты еды, старые блюда и несовместимые размеры стопок;
дублирующий рецепт огнива и конфликты переплавки сырой руды;
устаревшие связи между рецептами и достижениями и неполное достижение благословений.

Исправление попадает в форк только при наличии точного источника, наблюдаемого неверного поведения, причинной правки и регрессионной проверки. Пожелание по балансу не маскируется под исправление ошибки.

Что форк намеренно не меняет

авторскую прогрессию и экономику без отдельного обоснованного решения;
силу серебряного меча, щита-оберега или электрума только потому, что они кажутся мощными;
внутренние идентификаторы ради более красивых имён;
ещё не реализованные планы Klei;
ограничения целевой версии Minecraft, для которых нет безопасного решения средствами пака.

Открытые ограничения остаются видимыми в реестре известных проблем, а не скрываются рискованными обходными решениями.

Один ZIP для механик и клиентских ресурсов

Готовый релизный .zip: это не два разных скачивания. Один архив содержит обе части, а pack.mcmeta, data/ и assets/ лежат в его корне.

Скачать актуальный архив можно на странице последнего GitHub Release. Выбирайте приложенный .zip с названием Matcha; автоматические архивы Source code не являются готовым игровым паком.

Одиночная игра

Закройте мир штатным способом.
Положите ZIP в .minecraft/resourcepacks и включите его в настройках.
Положите тот же ZIP в .minecraft/saves/<мир>/datapacks.
Откройте мир и выполните /reload, если пакет добавлен в уже созданный мир.
Проверьте сообщение о загрузке Matcha и вкладки её достижений.

Сервер

Положите ZIP в <каталог мира>/datapacks на сервере.
Перезапустите сервер или выполните /reload.
Включите тот же ZIP в наборах ресурсов на каждом клиенте.

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

Совместимость

Точные версии Matcha и Minecraft указаны в шапке сайта. Редакция предназначена для Minecraft Java Edition, не работает в Bedrock Edition и не обещает совместимость с другой линией Minecraft.

Внутренние идентификаторы исходной редакции сохранены, поэтому форк предназначен для прямой замены соответствующей версии. Однако Matcha заменяет часть обычных предметов своими вариантами:

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

Как проверяется релиз

Каноническое распакованное дерево находится в pack/. Архив не редактируется отдельно, а каждый раз собирается из этого каталога.

Полная локальная проверка bun run validate:

проверяет фильтр рецептов;
заново извлекает данные и публичные ассеты;
запускает проверку стиля и типов;
запускает автоматические тесты;
пререндерит всю статическую вики;
собирает ZIP;
вычисляет SHA-256.

Сборщик дополнительно распаковывает созданный архив и проверяет наличие pack.mcmeta и русского языкового файла в корне. ZIP собирается с фиксированным временем файлов, поэтому одинаковое дерево даёт побайтово одинаковый релиз в разных часовых поясах.

Версии форка

CHANGELOG.md хранит историю выпусков и разделяет игровую версию оригинала и ревизию форка. Текущие значения объявлены один раз в wiki-data/project.json; шапка сайта и имя релизного архива получают их автоматически.

Оригинал, исходники и лицензия

Оригинал и этот производный форк распространяются по CC BY-NC-SA 4.0. Атрибуция Klei, Ciren и перечисленных в CREDITS.txt источников сохраняется. Форк остаётся некоммерческим и публикуется на тех же условиях ShareAlike.