Chiikawa

Chiikawa Mod

⭐ Enjoying the mod? Star it on GitHub ⭐

It really means a lot to me~

🐛 Bugs or ideas? Open a GitHub issue

Replies here in the comments may be slow, but every issue gets an answer.

---

Bring the world of Chiikawa into Minecraft — tameable little friends, a job system that lets them work on their own, and a music box that plays your very own songs.

Chiikawa, Hachiware, Usagi… these healing, slightly goofy little ones now move into your world. Tame them, hand them a tool, and they'll farm, fight, and even pick up a music box and play your favorite song for you. They'll be adorable, they'll get hurt, they'll let out their signature squeaks — and when they fall, all it takes is a slice of cake to bring them back. 🎂

✨ Why you'll want it

• 🐾 Seven characters from the original, all tameable — Chiikawa, Hachiware, Usagi, Shisa, Momonga, Kurimanju, and Rakko, each with its own model, textures, and personality.
• 🧰 A job system that works on its own — drop a tool into a pet's backpack, flip it to Work mode, and it gets busy for you: the Farmer plants and harvests, the Fencer fights up close, the Archer picks off enemies at range, and the Musician plays for you.
• 🎵 A music box that plays your own songs — drop .mp3 / .wav files into a folder and hear them in-game. Pure-Java decoding, no external ffmpeg required; on a multiplayer server, everyone nearby hears the same track.
• 🎬 In-house animation engine — a Bedrock model/animation pipeline built for this mod (inspired by GeckoLib, but with no GeckoLib runtime dependency), driven by a semantic state machine for smooth idle, walk, run, work, and reaction poses.
• 🔊 Per-character sounds — Usagi's signature squeaks, plus tame/hurt voices for the cast, to make them feel alive.
• 🎒 Pet backpack — right-click a pet with an empty hand to open its inventory and manage its tools and gear.
• 🪆 Dolls & spawn eggs — a doll for every character (try placing one on a cake 🎂), and spawn eggs in Creative.
• ⚔️ Character weapons — craftable signature "discipline sticks" for Chiikawa, Hachiware, and Usagi.

📥 Download

Platform	Link
Modrinth	https://modrinth.com/mod/pT971QUb
CurseForge	https://www.curseforge.com/minecraft/mc-mods/chiikawa

Fabric players also need the Fabric API.

🎮 How to Play

New here? This section is all you need — most "it's not working" reports come from skipping one of these steps.

🍖 Taming

Hold almost any food (apple, bread, cookie, carrot, potato, cooked meat, melon slice, sweet berries, golden apple…) and right-click the pet.

⚠️ Taming is chance-based. Each feed has a chance to succeed, so keep feeding! Hearts = tamed. A puff of smoke / confused reaction = not yet, try again. Flowers no longer work — use food.

🧭 Three modes — Follow / Sit / Work

Once it's yours, Sneak (Shift) + right-click with an empty hand to cycle through:

• Follow — the pet follows you.
• Sit — the pet stays put.
• Work — the pet performs its job around the spot where you set it.

💼 Jobs

A pet's job is decided by the tool it holds. Open its backpack (right-click with an empty hand), place a tool inside, then set it to Work:

Job	Give it…	What it does
Farmer	a Hoe	plants and harvests nearby crops (modded seeds supported)
Fencer	a Sword (or a character's discipline stick)	attacks hostile mobs in melee
Archer	a Bow (keep arrows in the backpack)	attacks hostile mobs at range
Musician	a Music Box	plays your imported music

Pets only fight/work while in Work mode — in Follow mode they stay peaceful and won't pick fights.

🎵 Note: only Hachiware can currently take the Musician job — other characters won't play even while holding a music box.

❤️ Other interactions

• Heal a hurt pet by right-clicking it with food.
• Open its backpack by right-clicking with an empty hand (no sneak).

🌍 Where they spawn

Pets appear naturally in Plains, Sunflower Plains, Savanna, Savanna Plateau, Desert, Swamp, and Snowy Plains. In Creative, use the spawn eggs.

🎁 Getting items

• Weapons (discipline sticks) are craftable — check the recipe book (wool + stick + flint).
• The Music Box, dolls, and spawn eggs are in the Creative inventory. A pet also drops its doll when it dies, preserving its backpack and data.

🎵 Music Box: play your own songs

1. Open the Music Box screen and click Open Folder to jump to config/chiikawa/music.
2. Drop your .mp3 / .wav files in, hit Reload, and pick a track.
3. Give the Music Box to Hachiware and set it to the Musician job — it'll hold the box and play for you.

Audio is decoded in pure Java (mp3spi / JLayer for MP3, the JDK for WAV), encoded with Opus, and streamed from the server to nearby clients — no external tools needed.

Admins can run /chiikawa music rescan to force a rescan of the music folder.

🗂️ Supported Versions

Minecraft	Loaders
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

Only Minecraft 1.20.1 and newer are maintained.

Newer snapshot releases (such as the latest 26.x) will be supported once the loader ecosystem stabilizes — please hang tight.

📜 License & Credits

• Licensed under CC-BY-NC-SA-4.0.
• Art support by zoe_1000.
• Chiikawa and its characters are the property of Nagano. This is a non-commercial fan project, not affiliated with or endorsed by the rights holders.