Repository navigation
FAQ
Short answers to the questions that come up most. Each links to the page with the details.
Where is the Block Guardian? In the Guardian's Sanctuary on the Surface: a polished deepslate disc with eight stone pillars around an altar. One generates about every 24 x 24 chunks. Use the altar to wake it. See Getting started.
My world does not open. Smoke puffs mean the Seed or rite site is waiting. The World 1 Seed needs tilled World Soil 0 and water within 4 blocks. Every other world opens with its own object and rite, and a rite site tells you, when you are close, what it still lacks: for example lava and 4 Ashrock for the Ember Heart, an iron door and a redstone signal for the Jailer's Key, a storm or a Storm Essence for the Storm Rod, dawn or dusk for the Sapling. On a server that caps groups or parcels, it also waits while the server is full and tells you so (see Configuration). See The way into each world.
"Your group has not defeated the boss of world n yet." Seeds and rite objects check your group's progression. Beat the previous boss, or join the group that did.
I cannot see a recipe at the station. Locked recipes are hidden until your group beats the boss that unlocks them. Station recipes are listed on each world page.
The station says "Not ready". Each world station has a condition: heat sources for the Ash Foundry, lightning charge for the Lightning Forge, complete darkness for the Dark Altar, deep water for the Abyssal Press, dawn or dusk for the Time Workshop, the lock pattern for the Jailer's Table. See Blocks and stations.
I died inside a world and lost my things. They are in a death chest where you died (or at the arena entrance). Chat gave you its coordinates. See Doll of Life and death.
How do I get back inside after dying? Place a Soul Cradle in the world before you die. Otherwise walk back to your World Block.
I broke my World Block. Is my world gone? No. You got a Cracked Doll: right-click a block face with it to put the World Block back. Opening that world again with its Seed or rite also leads back to the same place.
Can I use elytra in the floating islands? Not before your group beats the World 8 boss. Elytra flight stops in worlds 4, 6 and 9 until then. Use the Glider and the Grappling Hook.
Why are there no diamonds? Diamond ore is removed from the Surface and diamonds from vanilla loot chests, and villagers keep their diamond trades aside until your group beats World 5. Diamonds come from World 5: 4 Diamond Fragments make 1 Diamond at the Dark Altar. See Progression gates.
Can I fight a boss again? Yes, the altar can wake a boss again after it is beaten. It drops its core, soil and souls again.
Do I have to do the quests? No. All 70 quests are optional.
Does it work on Lunar Client? Yes, through Lunar Client's Fabric profile for 26.3 (or 26.2 / 26.1.2 with the matching jar), with Fabric API and GeckoLib. See Getting started.
Why is everything painted by code? Models, animations and textures are generated by the mod's tools, so they stay consistent and can be rebuilt at any size. Since 0.4.0 the items and blocks you see most are painted in the vanilla style, every boss attack has its own animation, and an optional HD pack doubles the textures. See Visuals and Boss attacks.
I cannot breathe in World 7. Without a helmet your breath lasts about half a minute under water. Craft a snorkel helmet at the Abyssal Press (Divers also sell one, and World 7 chests sometimes hold a worn one), and refill it in air pockets, over Air Vents or with Oxygen Capsules. See World 7.
The halls of World 3 moved and I am lost. They move every five minutes, but never next to a block you placed: build or light your route and it stays. See World 3.
What are the hidden dolls for? Nested in the right order, the ten make the Whole Matryoshka, which opens World 0 once the Unfinished has fallen. See Hidden Dolls.
I beat the Unfinished. What now? Your karma chose your ending. World 0 holds the third one, and the Journal can begin a New Cycle with stronger worlds. See Endings and the New Cycle. Once you have seen an ending, the Trials open: boss rushes against the clock, with a server leaderboard.
The screen shakes too much, or Nausea makes me sick. Open Options > Matriochka...: shakes, flashes, Nausea and Darkness, cinematics, particles and music can all be softened or turned off. See Accessibility.
Is it translated? Yes: English, French, Spanish, German and Brazilian Portuguese. See Translations.
Does it work with Sodium, Iris or a minimap? Yes. Sodium and Iris show no conflict; Xaero's maps lose their cave view and radar in World 5 only. There is also a ready-made modpack. See Compatibility and Modpack.
Is there a recipe viewer? Yes, Just Enough Items or Roughly Enough Items (optional): every station has a recipe page. EMI has no build for 26.x yet.
Does the mod need to be on the server and the client? Yes, on both.
Matriochka is made by achedon12. Code under the MIT License; models, textures and other art assets all rights reserved. This wiki describes version 0.2.0 (alpha) and the changes since, for Minecraft 26.3.
Playing
- Getting started
- Core loop
- The way into each world
- Progression gates
- Doll of Life and death
- Souls and karma
- Equipment classes
- Talents
- Nesting systems
- Refuge Doll
- The Artisan's Journal
- World variants and mutations
- Effects between the scales
- Multiplayer and groups
- World events
Worlds
- 1. Toxic Jungle
- 2. Giant Veins
- 3. Endless Dungeon
- 4. Storm Archipelago
- 5. Lightless Deep
- 6. Upside Realm
- 7. Pressure Ocean
- 8. Hastened Seasons
- 9. Restless Ground
- 10. The Giant Workshop
- 0. The Smallest Doll
After the last boss
Reference
- Bosses
- Boss attacks
- Bestiary
- Creature attacks
- Items
- New gear
- Blocks and stations
- Structures
- New structures
- Wonders
- World ores and the Matriarch Armour
- Quests
- Achievements
- Difficulty formulas
- Balance
- Sounds and music
- Visuals
- Lore
Setting up
Server and development