Description
Gallery
Changelog
Versions
Tetra is a minecraft mod that allows players to modify and improve tools, weapons and other types of equipment. Modified items can be improved over time through use. Powerful tool parts and schematics can be found in the world by scavenging ancient ruins or through trade and barter.
Tetra has two advancement tabs which covers most of the available content, and the holosphere provides an overview of the stats of modules, improvements and materials.
More information about tetra can be found on the tetra website
Tetra uses a utility library (mutil), you have to install that manually if you are not using the curseforge installer.
📝 Getting Started
- Craft a mallet using two sticks and two planks
- Craft and place a vanilla crafting table
- Right click the table with the mallet to upgrade it into a workbench
- Craft a vanilla weapon, tool, shield or a bow and place it in the workbench
Check the advancements window to learn how to progress further
🔌 Mod compatibility
Tetra has curios compat by default (for the toolbelt), for more mod compat you can look into:
🔗 Links
📜 Licensing & use
Feel free to use this in modpacks or compilations as long as it's distributed through modrinth or curseforge. Feel free to modify or add content with datapacks (or kubejs or similar), for more information about use regarding addons and mod integration take a look at the github repo.
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
|
R
6.17.0
|
10h ago | 1 | |||
|
R
6.16.0
|
10h ago | 1 | |||
|
R
6.15.0
|
10h ago | 1 | |||
|
R
6.14.2
|
10h ago | 1 | |||
|
R
6.14.1
|
10h ago | 1 | |||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
|
B
6.0.0
|
10h ago | 1 | |||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 | ||||
| 10h ago | 1 |
[6.17.0] 6.17.0
by mickelus on Oct 13, 2026
Download
__**Changes:**__
__**Fixes:**__
- removed forged mesh chainmail recipes
- changed quality improvement description
__**Fixes:**__
- fixed bucklers not applying stats from offhand
[6.16.0] 6.16.0
by mickelus on Oct 13, 2026
Download
__**Technical changes:**__
- added material improvement crafting effect outcome
- added loot table crafting effect outcome
- added magic capacity crafting requirement and crafting effect condition
- added empty field to slot crafting requirement and crafting effect condition
[6.15.0] 6.15.0
by mickelus on Oct 13, 2026
Download
__**Fixes:**__
__**Technical changes:**__
- made toolbelt inventory stingier
- fixed rounding issue in honing tooltips
- fixed bow quality and ravenous improvements not affecting bow damage
- fixed bow attributes not syncing properly
__**Technical changes:**__
- added dye materials
- added group field to "tetra:improvement" condition
- added group, aspect and all fields to "tetra:remove_improvements" outcome
- made it possible for improvements to change item name
[6.14.2] 6.14.2
by mickelus on Oct 13, 2026
Download
__**Fixes:**__
__**Technical changes:**__
- fixed incorrect attribute calculations for abilities
- fixed cooldown being incorrectly triggered for secondary abilities
- increased width of schematic title in detail view to fill full width
__**Technical changes:**__
- replaced vanilla tooltip attributes
- fixed inverted tooltip stats showing double signs
[6.14.1] 6.14.1
by mickelus on Oct 13, 2026
Download
__**Fixes:**__
__**Technical changes:**__
- fixed trim names not showing up properly in item tooltips
- fixed machetes being overly weak when breaking blocks tagged as swordVeryEfficient or swordInstamine
- fixed rounding issue for attributes, caused stat diffs to show up when there were none
- fixed stray pixel in crude shortblade
__**Technical changes:**__
- made it possible to add/override item tooltip stats
- added ignoreBase and ignoreBonuses fields to attribute_addition stat getter
- added ignoreBonuses to attibute_multiply stat getter
- changed to only load shield model geometry from the tetra namespace
[6.14.0] tetra 6.14.0
by mickelus on Oct 13, 2026
Download
__**Fixes:**__
- fixed attributes being present when they should not
- fixed log spam from command effects
[6.13.0] tetra 6.13.0
by mickelus on Oct 13, 2026
Download
__**Changes:**__
__**Fixes:**__
__**Technical changes:**__
- tweaked turtle shell stats
- tweaked shulker shell stats
- added mangrove root material
- added mangrove wood material
- added azalea root material
- added flexmesh to materials view
- changed stats for hide, leather, shulker shell and turtle scute materials
- changed leather color
__**Fixes:**__
- fixed module material crafting requirements not working properly
- added arrested modifier for creative inventory obsidian hammer
- fixed material names not working properly for some modules (containing slashes in keys)
__**Technical changes:**__
- overriding schematics with requirements no longer removes the requirement
- added stat getters for only getting flat or multiplier modifiers for an attribute
- multiply stat getter now shows if all of its children should show
- add stat getter now shows if any of its children should show
- added "tetra:is_item" stat getter
- added "showNegative" field to effect stat getters, causing bars using them to show despite negative values
- added signed versions for all stat formatters (always shows +/- before the numerical value)
- changed how and + or stat getters return values
- changed available textures for skins
- added translation entries for overriding improvement texts in holosphere the material UI
- added roman numeral stat formatter
[6.12.0] tetra 6.12.0
by mickelus on Oct 13, 2026
Download
__**Changes:**__
__**Fixes:**__
__**Technical changes:**__
- unstable power now grows more unstable as its duration and/or amplifier increases
- changed efficiency treatises to have a chance to reduce materials used by more than 1 (and to 0)
__**Fixes:**__
- fixed crossbow projectiles not going in the correct direction for high velocity projectiles
- fixed hammer treatise not working
- fixed cleanse can no longer trigger destabilization effects (again)
- fixed missing tool tier requirement for forged blocks (cred: yiran1457)
- multiblock schematic outline not working properly in multiplayer
- fixed tool action ingredient not deserializing properly
__**Technical changes:**__
- ModularLooseProjectilesEvent now fires for crossbows (will replace with a new event later)
- ModularProjectileSpawnEvent now fires for arrows shot with crossbows (will replace with a new event later)
- added missing fields to stat bar json schema
- added tag 'sword_instamine', tagged blocks can be instamined with tools providing the 'cut' tool action (works like bamboo)
- added tag 'sword_very_efficient', tagged blocks break very easily with tools providing the 'cut' tool action (works like cobweb)
- fixed crash when applying the suspend effect to a non-player entity
- fixed datagen causing NPE
[6.11.0] tetra 6.11.0
by mickelus on Oct 13, 2026
Download
__**Changes:**__
__**Fixes:**__
__**Technical changes:**__
- Updated russian translation (thanks Quarkrus!)
__**Fixes:**__
- removed non-functioning chaotic destabilization effect
- fixed imprint effects not affecting damage
- fixed exiled and heroic imprint mining crash
- fixed being able to swap the toolbelt item out of place in the toolbelt screen
- fixed storage and quickslot toolbelt inventories ignoring nbt when quick storing
__**Technical changes:**__
- improved logging for modifier effects
- added hit damage modifier effect type
[6.10.1] tetra 6.10.1
by mickelus on Oct 13, 2026
Download
__**Fixes:**__
- fixed compat issue introduced in 6.10.0
[6.10.0] tetra 6.10.0
by mickelus on Oct 13, 2026
Download
__**Changes:**__
- reworked and re-added destabilization effects
- added advancements for enchanting and destabilization
- buffed efficiency gain from quality improvement
- changed visuals for the bleeding effect
- made thrown modular items glow after not being picked up (and chunk loaded) for an hour
- increased magic capacity use for enchantments (from minCost + maxCost / 2 to minCost + maxCost)
- tweaked tool icons to make prying more apparent
__**Fixes:**__
- fixed holosphere animation issues
- fixed some incorrect localization entries
- prevented players from placing holospheres with faulty nbt (and fixed crash caused by looking at holospheres with faulty nbt)
- fixed text color issues in some tooltips
__**Technical changes:**__
- holosphere entries are now datadriven (or resource-driven rather)
- added "tetra:on_use" item effect trigger
- added random and count fields to find blocks item effect outcome
- fixed position vector provider origin field not being optional
- Added spawn entity item effect outcome
- added crafting effect outcome for spawning blocks
- added spawn entity crafting effect outcome
- added lightning strike crafting effect outcome
- added lingering potion cloud crafting effect outcome
- added explosion crafting effect outcome
- added spawn_sculk crafting effect outcome
- added active field to crafting effects, can be set to false to stop the effect from triggering directly
- added 'references' field to apply_list crafting effect outcomes
- added isRiding field to item effect entity condition
- added "bookEnchantmentSchematic" feature flag, can be disabled in the config to prevent tetra table book enchanting
- added clamp stat getter
[6.9.0] tetra 6.9.0
by mickelus on Oct 13, 2026
Download
__**Changes:**__
__**Technical changes:**__
- added ability to preview locked schematics in the holosphere
__**Technical changes:**__
- made it possible to omit the stats and formatters fields for stat bar tooltips when no data is to be displayed in the tooltip
- fixed apply hit effects for bows inverting attacker and target
- improved error logging for stat bars, stat indicators & stat sorters
[6.8.0] tetra 6.8.0
by mickelus on Oct 13, 2026
Download
__**Changes:**__
__**Fixes:**__
__**Technical changes:**__
- moved honing above temporary schematics in sorting order
- reduced the number of ruined pieces in a ruins schematic to 1/4th (was 60%)
__**Fixes:**__
- fixed faulty thermal cell tooltip
- fixed aspect button tooltip crash
- fixed efficiency, piercing and tier hones not working properly for unbounch earthpiercer
- fixed warforging improvement being applicable when already present
- fixed crash related to resource loading
__**Technical changes:**__
- fixed missing slot crafting requirement
- fixed throwing knife referencing incorrect improvement directory
- multiblock schematics now also provide a crafting effect with the same id as their schematic
- the forged workbench now provide a "tetra:"forged_workbench" schematic and effect when used
[6.7.0] tetra 6.7.0
by mickelus on Oct 13, 2026
Download
__**Fixes:**__
__**Technical changes:**__
- fixed mob effect item effects not working
__**Technical changes:**__
- added ambient, visible and showIcon flags to mob effect item effect outcome
[6.6.0] tetra 6.6.0
by mickelus on Oct 13, 2026
Download
__**Fixes:**__
__**Technical changes:**__
- removed transparent pixel from crude short blade texture
- fixed damage stat bars not showing
__**Technical changes:**__
- changed the 'tetra:apply_hit_effects' to also trigger for bows and crossbows
- added item effect outcomes and providers for dealing with entity properties
- added item effect outcomes and providers for dealing with persisted entity data
- added number provider for different types of time values
- added canFreeze, isFreezing and isFrozen fields to the entity item effect condition
- updated json schemas (incorrect type for default tooltip getter, missing replace field for crafting effects)
[6.5.0] tetra 6.5.0
by mickelus on Oct 13, 2026
Download
__**Changes:**__
__**Fixes:**__
__**Technical changes:**__
- nerfed amethyst sockets
__**Fixes:**__
- hopefully fixed null issues with the forged container
- fixed scrolls not dropping when broken by water
- fixed save/world screen crash when some other mods are present
- fixed gild scroll advancement not triggering
- fixed holosphere concussion scanning triggering incorrect advancements
- fixed issue where tetra items could be merged in a grindstone
__**Technical changes:**__
- added datadriven item effects
- added datadriven stat sorters
- added datadriven statbars
[6.4.0] tetra 6.4.0
by mickelus on Oct 13, 2026
Download
__**Changes:**__
__**Fixes:**__
__**Technical changes:**__
- added chinese translation (cred: Haiyanbaka)
__**Fixes:**__
- fixed reaching effect tooltips displaying lower values than what was actually used
- ruins can now spawn in modded mountaineous biomes
- fixed thrown bucklers covering the screen
- fixed "open toolbelt" ignoring modifiers?
- fixed quality improvement not applying the appropriate stats
__**Technical changes:**__
- added tool action ingredient
- stopped handheld tetra items from being consumed when used in regular crafting (also gains honing progression and takes durability damage)
- the tetra command can now be run directly on items that can be converted into a tetra item
[6.3.0] tetra 6.3.0
by mickelus on Oct 13, 2026
Download
__**New features:**__
__**Changes:**__
__**Fixes:**__
__**Technical changes:**__
- sickles with silk touch will now ignore crops that are no fully grown, and replant harvested crops
__**Changes:**__
- jab now swings even if it misses a target (and triggers cooldown, and some other effects)
- reduced efficiency and speed for sickles
- reduced efficiency for machete
- re-added cherry wood, but for vanilla cherry
__**Fixes:**__
- fixed sickles not breaking crops
- fixed holosphere map not rendering properly
- fixed extractor module advancement not triggering
- added missing localization for pristine amethyst
__**Technical changes:**__
- made it possible to define new types of modular items through data
[6.2.0] tetra 6.2.0
by mickelus on Oct 13, 2026
Download
__**Changes:**__
__**Fixes:**__
__**Technical changes:**__
- replaced all pristine gem textures (cred: rappenem)
- added pristine amethyst, found in tetra geodes
- reworked workbench visuals
- added aspect info to module details view
- changed sweeping strike drain: now drains 0.5 at a minimum rather than adding 0.5 to drain for each block
- efficiency honing for stonecutters to start out stronger (still hits 15 at rank V)
- the cobblestone material should now better match modded cobblestone
__**Fixes:**__
- fixed sweeping strike not alternating direction without truesweep
- fixed how reaching affects sweeping strike to align with tooltip (reduced the entire drain, not just drain from block hardness)
- added expanded tooltips for medial, lateral and axial limiters to explain what that actually means
- fixed spearheads accepting tool enchantments
- fixed looted stonecutter not being repairable with scrap
- clicking outside the holosphere filter button now blurs the input
- fixed holosphere material icons rendering in front of text (again?!)
- fixed typo in spearhead serrate hone schematics
__**Technical changes:**__
- added ModularLooseProjectilesEvent, fired before bow spawns projectiles
- added ModularProjectileSpawnEvent, fired for each projectile spawned by bows
- renamed all aspects from camelCase to snake_case
- moved chthonic extractor hammering config option to feature flag
- put multislot schematics in a working state
- moved some localization entries
- fixed multislot modules defaulting texture namespaces back to tetra
- fixed source information merging in the wrong direction
- fixed schematic module requirement not matching the material field
- fixed long and recurve bow not picking up improvements from their respective improvement folder
- added schematic requirement that's always false
- added feature flag system, with schematic support
- removed a bunch of old, unused config options
- fixed materials not transferring aspect data to modules
- tool action icons are now datadriven
- rearranged minor module glyphs
- moved stat indicators to glyph sheet, resized to 8px
- split several aspects, changed aspects for lots of modules
- added rarity field to module data
[5.6.0] tetra 5.6.0
by mickelus on Oct 13, 2026
Download
__**Changes:**__
__**Fixes:**__
- added source display in the schematic gui
__**Fixes:**__
- fixed incorrect dependency on mutil
[6.1.0] tetra 6.1.0
by mickelus on Oct 13, 2026
Download
__**Fixes:**__
__**Technical changes:**__
- added missing localization for extractor limiter tweaks
- fixed placed holosphere missing block name for mods that display that
- added core extractor pipe to creative inventory
__**Technical changes:**__
- added nbt outcome for crafting effects
- added module requirement for crafting effects
- added crafting effect outcome for conditionally choosing between sets of outcomes
[6.0.0] 6.0.0
by mickelus on Oct 13, 2026
Download
__**Changes:**__
__**Fixes:**__
__**Technical changes:**__
- updated to 1.20.1
- move most mod compat into a separate mod
- pristine sockets can now be repaired using regular gems (with increased xp cost)
- tweaked hardness for most fibre materials
- most modules that cost experience to craft now cost experience to repair (in addition to possible magic instability costs)
- bleeding now bypasses armor and iframes
- added source display in the schematic gui
- tweaked creative tabs
__**Fixes:**__
- added missing localization for rod materials
- fixed incorrect armor pen for tempered heavy blades
- fixed several issues relating to the holosphere sorting button
- tweaked serrate tooltip
- fixed modules settling not updating integrity until cache reset
- fixed crafted toolbelt having the wrong strap variant
- the tooltip for replacing the next module in the repair cycle no longer shows when the item has full durability (matches the underlying behavior)
- fixed rack advancement not working
- added missing localization for the holosphere block
- fixed tops of shafts and rooms in ancient ruins ending abruptly
__**Technical changes:**__
- cheesed in module dependent tags
- improved logging for faulty replacement data
- added datadriven block predicates for determining unlocks
- module textures now need to be placed within textures/item/[modules] (rather than textures/items/[modules])
- expect significant technical changes moving forward, if you make modpacks or addons and want to be kept in the loop please send me a DM
[5.5.1] tetra 5.5.1
by mickelus on Oct 13, 2026
Download
__**Fixes:**__
- fixed faulty and missing localization entries for ancient schematic content
[5.5.0] tetra 5.5.0
by mickelus on Oct 13, 2026
Download
__**Changes:**__
__**Fixes:**__
- tweaked rack inventory model
__**Fixes:**__
- fixed sculk taint actual chance being off by two decimal points, tweaked sculk taint proc chances
- fixed ruins not generating in modded cold biomes
[5.4.0] tetra 5.4.0
by mickelus on Oct 13, 2026
Download
__**New features:**__
__**Changes:**__
__**Fixes:**__
__**Technical changes:**__
- added command for modifying modular items
- implemented the ancient stonecutter schematic
__**Changes:**__
- added advancements for ancient schematic content
- made forge hammer rooms more common and sculk rooms less common
- removed temporary hammer tier bonus from obsidian and netherite hammer heads (should have been removed when the ruins were reintroduced)
- sword binding tweaks now affects tool efficiency
__**Fixes:**__
- fixed "required maintenance" advancement not triggering
- greatly increased despawn timer for thrown items
- removed ruin loot recipes
- fixed data reload not clearing model caches
- fixed striking effect indicator label not being localized
- fixed thermal cell advancement triggering for other items
- fixed "seconds between swings" value being based on harvest speed modifier rather than swing speed
- fixed incorrect tooltip for overpower defensive modifier
__**Technical changes:**__
- added support for perspective-specific module models
- added improvement crafting effect requirement
- fixed tmdev command not working after reload
[5.3.1] tetra 5.3.1
by mickelus on Oct 13, 2026
Download
- Fixes:**
- fixed botania mana repair
- hammering a holosphere now plays a different sound when swinging too fast
- fixed hammering a holosphere not progressing or damaging the hammer
- fixed howling effect overlay being incredibly laggy
- fixed long gone advancement triggering incorrectly
- Technical changes:**
- added enchanting outcome for crafting effects
- added schematic requirement for crafting effects
- changed crafting effect requirements to work the same way as schematic requirements (chaining and/or/not objects instead of an array for the field)
[5.3.0] tetra 5.3.0
by mickelus on Oct 13, 2026
Download
- __New features:__**
- The holosphere can now be placed on the ground
- placed with shift+rmb
- can be right clicked to open holosphere UI
- enabled holosphere lookup when near a workbench
- added percussion scanner module for the holosphere
- allow scan mode to be toggled for placed holospheres
- right clicking a holosphere in scan mode with a hammer scans nearby chunks for ruins
- chunks with ruins are indicated with a red/orange beam
- apprentice cartographers can now sell maps to the ancient ruins
- __Changes:__**
- tweaked keybind UI elements
- changed notification sounds when items settle and when honing becomes available
- __Fixes:__**
- diamond sockets now also improve hammer efficiency
- fixed "Thermal Transfer" advancement not triggering
- fixed shield model console warnings
- fixed sweeper not working on some resolution/fov combinations
- holosphere improvement schematics no longer show when the holosphere already has the improvement
- fixed Long Gone, Restored Machinery, Combustion Power-up and Magmatic Press Channel advancements not triggering
- fixed multiblock schematic creative logspam
- fixed good quality modifier making items able to perform actions they shouldn't
- fixed missing and faulty decoration in ruin worldgen
- fixed ruined schematics sometimes working without repairs
- fixed banners not rendering on heater shields
- fixed stonecutter accepting unapplicable improvements
- __Technical changes:__**
- added data merging functionality for module variants
- added per-model render layering sorting
- added secondary interaction system
