Totoro: Spirits of the Forest

Totoro: Spirits of the Forest

Bring a little forest magic into your Minecraft world. Befriend four Totoro companions, care for your own woodland clearing and turn everyday journeys into small adventures. Travel with useful companions, take to the sky and share a Catbus ride with friends.

Meet Gray, Blue, White and Elder Totoro in forests and taigas. Each spirit has its own role, with expressive models, animations and a place in your journey.

Craft acorns from two wheat seeds and one stick, then offer them to a wild spirit. Feed, pet and walk with your companions to build friendship. Acorns and apples also restore their health.

Blue Totoro carries a real nine-slot backpack. Sneak and interact with your own companion to open it. Choose follow or wait with an empty hand; its supplies and orders remain when you return to your world.

Ask White Totoro to search for seeds and acorns through its order menu. Searches have a cooldown and each area can be searched once per in-game day. Explore fresh ground together, or ask your companion to wait.

Use an umbrella beside your Gray or Elder Totoro to take flight. Steer, climb, descend, boost and dash above the trees on a spinning top. The Elder brings stronger flight abilities.

When real rain falls beneath an open sky, sneak and use your umbrella beside your guardian to begin its rain animation.

Use a Forest Charm with Gray or Elder Totoro to start a crop dance. Three pulses help nearby crops grow. The Elder reaches farther, and nearby small companions can join the dance.

Mark a clearing with a Clearing Seed and plant different flowers and saplings within ten blocks. Grow your friendship and planting variety to reach new stages and earn milestone gifts.

Summon Catbus on clear ground and place up to four stops per player in the Overworld. Rename a stop item in an anvil before placing it. Call an available Catbus from your stop, board and choose a destination. One ticket pays for the trip; up to four passengers can travel together.

Getting started

Install one JAR matching your Minecraft version and loader. Add GeckoLib on every build, Fabric API on Fabric, and MixinBooter on Forge 1.12.2. Use the same mod and dependencies on the client and server. Do not combine builds for different loaders or Minecraft versions.

Available builds

• Forge: 1.12.2, 1.16.5, 1.20.1, 1.21.1 and 26.3.
• NeoForge: 1.20.1, 1.21.1 and 26.3.
• Fabric: 1.20.1, 1.21.1 and 26.3.

Java 8 for 1.12.2/1.16.5; Java 17 for 1.20.1; Java 21 for 1.21.1; Java 25 for 26.3.

Required mods: geckolib, fabric-api, mixin-booter. See the matching file changelog for the tested dependency versions.

Controls

• Tame a spirit: Offer acorns.
• Gray / Elder follow or wait: Interact with an empty hand.
• Blue backpack: Sneak + interact with your own Blue Totoro.
• White orders: Interact with an empty hand or Forest Charm.
• Flight: Use an umbrella with your Gray or Elder Totoro; WASD steers and Space climbs. Look down while moving forward to descend.
• Boost / dash / dismount: Right-click boosts, left-click dashes, and sneak dismounts.
• Rain animation: Sneak + umbrella near your guardian during rain under open sky.
• Crop dance / friendship: Use a Forest Charm on Gray or Elder; sneak + charm shows friendship.
• Catbus: Call from your stop, board with an empty hand or ticket, then select one of your destinations.

Compatibility notes

Forge 1.21.1: open singleplayer worlds from the main menu. Direct QuickPlay world startup has a reproduced loader issue with the tested Forge 52.1.20 build.

NeoForge 1.20.1: install geckolib-forge-1.20.1-4.8.4.jar with the tested legacy NeoForge 47.1.106 build. A dependency relation identifies the GeckoLib project, but does not pin this particular file; check the installed file manually.

On Minecraft 1.12.2 and 1.16.5, newer decorative plant rewards use flowers and saplings available in those versions. Java and Bedrock worlds are separate; this release does not convert worlds between editions.

The cover uses shaders for presentation. Shaders and Flashback are not gameplay dependencies.