Repository navigation
Trading Stall and Cycle Recap


Every people of the mod trades at a painted market stall instead of the grey villager screen: the people of each world, the Doll Peddler of the Surface, the travelling merchants of the world events and the black market of a dark karma. Vanilla villagers and wandering traders keep their own screen.
| Part | What it shows |
|---|---|
| The awning and the plate | The trader's name on a cartouche in its world's enamel, under an awning striped in the world's colour |
| The ledger (left) | One line per offer: what it costs, what it gives, how many are left (9/12), and the karma's change to the price as a small tag (green -1 for a discount, red +1 for a markup); the count on the price is green or red too |
| The plaque (top right) | The world's medallion and name, the kind of trader (people of the world, doll trader of the Surface, travelling merchant with the time before it moves on, black market with its number of forbidden goods) and the karma the prices answer to |
| The counter | The selected trade's slots, with its price and goods waiting faintly in the empty slots, and its stock under the plank |
| The tray | Your inventory |
- Click a line to select a trade: the price moves from your inventory onto the counter, as in the villager screen. Take the result, or shift-click it to trade as long as you can pay and the stock lasts.
- The mouse wheel (or the gold thumb on the right of the page) scrolls a long ledger.
- A line you cannot pay yet has a red mark under its price; a sold-out line is stamped Sold out and its arrow is crossed on the counter. The mod's traders do not restock.
- With a karma of -25 or lower, the black market's goods come last, under the counter: a plum section with wax seals, kept apart from the regular wares.
- Hover an icon for its item tooltip, the rest of a line for its price, the karma's change, the stock and what you still lack.
The stall is only a screen: the trades, their slots and their packets are the vanilla merchant's, so the delivery quests, the karma prices and other mods that watch trades behave as before. A client without the mod gets the vanilla screen.


When an ending's crawl is over (or skipped with Escape), the great doll opens in two halves on the recap of the cycle: the head rises, the base sinks and the parchment they held unrolls between them.
| Line | What it counts |
|---|---|
| Title | The ending, the cycle number, played alone or in a group, and a line for the ending |
| The cores | The eleven bosses, from the Guardian to the Unfinished, lit when beaten during the cycle by you or your group (hover for the name) |
| Worlds opened | Worlds you entered, or whose World Block or boss your group had in this cycle |
| Bosses beaten | The lit cores |
| Deaths | Real deaths (a layer of the Doll of Life that saves you is not one) |
| Layers lost / rebuilt | Doll of Life layers broken, and layers put back (Soul Altar, bosses) |
| Souls gathered | Every soul gained from play during the cycle |
| Time played | Time online during the cycle |
| Hidden dolls | The most hidden dolls carried at once |
| Journal pages, quests done | Found and done in this cycle, then your total |
| Karma | The karma reached at the ending (before the Absorbed ending's fall), and its name |
| Class | The class most of your worn and held gear belongs to, and its highest level |
| Best trial | The hardest Trial run in the cycle, with its time |
Hide (F1) hides the buttons and writes the mod's name and yours under the board, for a picture to share; F1 or a click brings them back. Continue closes it.
The recap of the last ending stays in the Journal: the Objective page has a Last cycle button. The counters start again at each New Cycle; the recap stays until the next ending.
The numbers are kept server side in the player's state, saved with it and sent to the client with the rest of the Journal.
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
- Quests
- Achievements
- Difficulty formulas
- Balance
- Sounds and music
- Visuals
- Lore
Setting up
Server and development