Repository navigation
Equipment Classes
Every weapon, tool and armor piece receives a random class when it is crafted, whether at a Matriochka station or a vanilla crafting table. The Class Table raises the class level, and a Chance Doll rerolls the class. Bonuses are written into the item's attribute modifiers on the server and shown in its tooltip.
| Class | Can appear on | Design intent | What the code gives (at level L, multiplier m = 1 + bonus) |
|---|---|---|---|
| Guardian | Armor | Armor, knockback resistance | Armor + max(1, 15% of the piece's armor) x m; knockback resistance + 0.04 x m; one extra armor layer, half as sturdy again (see Nesting systems) |
| Berserker | Weapons, armor | Damage, attack speed | Weapon: attack damage + 8% of its damage plus the whole bonus of its level (+8% at level 1, +18% at 2, +28% at 3, +43% at 4, +58% at 5; at least 1 damage), attack speed + 0.08 x m. Armor: +3% x m attack damage |
| Prowler | Weapons, armor | Movement speed, dodge | +3% x m movement speed, and a chance to dodge a blow: 2.5% per piece, more with the level, at most 30%. A dodge shows a puff of air and "Dodged" |
| Reaper | Weapons, armor | Life steal, soul gain | Luck + 0.5 x m, and life steal: each Reaper item heals you for 3% x m of the damage you deal. Killing a creature also heals a share of its health. Extra souls: 5% per piece (more with the level) of every kill's souls, and even creatures worth no soul may yield one |
| Survivor | Weapons, armor | World effect resistance, recovery | Max health + 1 x m, and each Survivor item reduces gauge changes (toxin, heat, noise) by 6% x m, capped at 60% in total |
| Prospector | Tools | Mining speed, ore luck | Mining efficiency + 3 x m, luck + 0.5 x m |
Pools: armor rolls among Guardian, Berserker, Prowler, Reaper and Survivor; weapons among Berserker, Prowler, Reaper and Survivor; tools are always Prospector. An item counts as a weapon if it has the weapon component or is a sword or axe, and as a tool if it has the tool component (pickaxes, shovels, hoes, the Drill).
| Level | Bonus | Upgrade cost (souls) | Shell Shards | Allowed once |
|---|---|---|---|---|
| 1 | +0% | - | - | Start |
| 2 | +10% | 10 | 1 | World 2 boss defeated |
| 3 | +20% | 30 | 1 | World 4 boss defeated |
| 4 | +35% | 90 | 2 | World 6 boss defeated |
| 5 | +50% | 270 | 2 | World 8 boss defeated |
Going from level 1 to level 5 costs 400 souls in total (10 + 30 + 90 + 270). The level cap follows your group's highest defeated boss: level 2 after World 2, 3 after World 4, 4 after World 6, 5 after World 8. Creative players ignore the cap. Every upgrade also costs Shell Shards, the boss material: 6 from level 1 to level 5. Every boss leaves 3 Shell Shards to each player who fought it, and a mutated boss 2 more: enough to bring each world's weapon to the class cap (see Balance).
A Berserker weapon used to add 8% x m of its damage, so 8% to 12%, far from the design's +50% at level 5; the reference creature took 6.7 hits in World 10 instead of 5. It now adds 8% plus the whole level bonus, and the reference creature again takes about 5 hits in World 10. The bosses' Shell Shards went from 2 to 3 in the same pass. The figures are in the Balance report.
On top of its class, each class has a tree of twelve talents, learnt at the Class Table with souls and Shell Shards. A class's talents act only while you wear or hold at least one item of that class. See Talents.
The Reroll button of the Class Table consumes one Chance Doll and souls, and draws a new class that is always different from the current one. The level is kept. The soul cost doubles with each change on the same item:
| Change | Souls |
|---|---|
| 1st | 20 |
| 2nd | 40 |
| 3rd | 80 |
| 4th | 160 |
| nth | 20 x 2^(n-1) |
The Chance Doll is crafted at the Matrix Workbench (2 Oak Planks, 1 Red Dye, 2 Gold Ingots) or bought from the Doll Peddler for 6 Emeralds.
Tools only have one class, so they cannot be rerolled: the table refuses and takes nothing.
The Inverter of World 6 swaps the class, class level and enchantments of two pieces of the same kind (two armor pieces, two weapons or two tools). Each loses a quarter of its durability and counts one more class change, and an enchantment the other piece cannot carry is lost.
Armor pieces can carry Lacquer Layers laid at the Class Table. A piece holds 1 layer, plus one at class level 3, one at level 5 and one for Guardian gear. See Nesting systems.
The gear of your group's newest world can only be crafted by players who took part in its last boss fight. See Multiplayer and groups.
Each item stores its class, level and number of changes in a matriochka:gear component, which survives repairs and trades. Levels read from the component are bounded, so an edited item cannot go past level 5. Gear from other mods or vanilla shows its class and layers in its tooltip too.
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