Chiikawa Mod

Привнесите мир Chiikawa в Minecraft - приручаемых друзей, систему работы, в которой они трудятся сами, и музыкальную шкатулку, играющую ваши собственные песни.

Chiikawa, Hachiware, Usagi... эти милые, слегка бестолковые малыши теперь живут в вашем мире. Приручите их, дайте им инструмент - и они будут фермерствовать, сражаться и даже подбирать музыкальную шкатулку, чтобы сыграть вашу любимую мелодию. Они будут милыми, будут получать урон, издавать свои фирменные писки, а когда упадут - достаточно кусочка торта, чтобы вернуть их.

Зачем он нужен

• Семь персонажей из оригинала, все приручаемые: Chiikawa, Hachiware, Usagi, Shisa, Momonga, Kurimanju и Rakko. У каждого своя модель, текстуры и характер.
• Система работы, работающая сама по себе - положите инструмент в рюкзак питомца, переключите его в режим Работа, и он займется делом: Фермер сажает и собирает урожай, Фехтовальщик атакует в ближнем бою, Лучник стреляет издалека, а Музыкант играет для вас.
• Музыкальная шкатулка, играющая ваши песни - кидайте .mp3/.wav файлы в папку и слушайте их в игре. Воспроизведение через чистую Java, без внешнего ffmpeg; на мультиплеерном сервере все игроки рядом слышат один трек.
• Собственный анимационный движок - пайплайн моделей и анимаций из Bedrock (вдохновлён GeckoLib, но без его runtime-зависимости), управляемый семантическим автоматом для плавных idle, walk, run, work и реакций.
• Персональные звуки - характерные писки Usagi, звуки приручения и получения урона для каждого персонажа, чтобы они казались живыми.
• Рюкзак питомца - щелкните правой кнопкой по питомцу пустой рукой, чтобы открыть инвентарь и управлять его инструментами.
• Куклы и яйца призыва - кукла для каждого персонажа (попробуйте поставить её на торт) и яйца призыва в творческом режиме.
• Оружие персонажей - крафтовые "палки дисциплины" для Chiikawa, Hachiware и Usagi.

Для Fabric также потребуется Fabric API.

Как играть

Этот раздел - всё, что нужно. Большинство жалоб "не работает" возникают, когда пропускают один из этих шагов.

Приручение

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

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

Три режима: Следовать / Сидеть / Работа

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

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

Работы

Работа питомца определяется инструментом, который он держит. Откройте его рюкзак (правая кнопка пустой рукой), положите туда инструмент и переключите в режим Работа:

Работа	Дайте ему...	Что делает
Фермер	Мотыгу	сажает и собирает урожай рядом (поддерживаются модифицированные семена)
Фехтовальщик	Меч (или "палку дисциплины" персонажа)	атакует враждебных мобов в ближнем бою
Лучник	Лук (стрелы должны быть в рюкзаке)	атакует враждебных мобов на расстоянии
Музыкант	Музыкальную шкатулку	играет вашу импортированную музыку

Питомцы сражаются и работают только в режиме Работа - в режиме Следовать они мирные и не вступают в бой.

Важно: только Hachiware сейчас может быть Музыкантом - другие персонажи не будут играть, даже если держат шкатулку.

Другие взаимодействия

• Лечение - покормите раненого питомца едой (правая кнопка).
• Открыть рюкзак - правая кнопка пустой рукой (без shift).

Где они появляются

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

Как получить предметы

• Оружие ("палки дисциплины") крафтится - проверьте книгу рецептов (шерсть + палка + кремень).
• Музыкальная шкатулка, куклы и яйца призыва находятся в творческом инвентаре. Питомец также выпадает куклой при смерти, сохраняя свой рюкзак и данные.

Музыкальная шкатулка: играйте свои песни

1. Откройте экран Музыкальной шкатулки и нажмите Открыть папку, чтобы перейти в config/chiikawa/music.
2. Положите туда .mp3/.wav файлы, нажмите Перезагрузить и выберите трек.
3. Дайте шкатулку Hachiware и переключите его на работу Музыкант - он будет держать шкатулку и играть для вас.

Аудио декодируется на чистой Java (mp3spi / JLayer для MP3, JDK для WAV), кодируется в Opus и стримится с сервера к клиентам рядом - никаких внешних инструментов не нужно.

Админы могут выполнить команду /chiikawa music rescan, чтобы принудительно пересканировать папку с музыкой.

Поддерживаемые версии

Майнкрафт	Загрузчики
26.1.2	Fabric · NeoForge
1.21.11 / 1.21.10 / 1.21.8 / 1.21.7 / 1.21.6 / 1.21.5 / 1.21.4 / 1.21.1	Fabric · NeoForge
1.20.6	Fabric · NeoForge
1.20.4 / 1.20.2 / 1.20.1	Fabric · Forge

Поддерживаются только Minecraft 1.20.1 и новее. Новые снапшоты (вроде последних 26.x) будут поддерживаться, когда экосистема загрузчиков стабилизируется.