TCTB

Place your Tinkers' Construct tools into the Tetra workbench and customize them with Tetra's modules and improvements!

Notice

Version 1.0.2 and above requires the core service library TCTB Services (tctb-services). Please ensure that both JAR files are placed in your mods folder, otherwise tool abilities will not function properly.

Stat Calculations

v1.0.2+ introduces a wide range of configuration options. All values below can be adjusted in the config file.

TCTB integrates directly into Tinkers' Construct's stat reconstruction phase (rebuildStats), seamlessly fusing Tetra module stats with Tinkers' native stats:

• Attack Damage: Base attack damage combines with Tetra module flat bonuses and is scaled by Tetra multipliers.
• Attack Speed: Supports either multiplicative or additive combining modes. Double heads and multiple speed modules receive a diminishing speed penalty by default.
• Durability: Tetra module durability is scaled into Tinkers' durability and affected by Tinkers' durability multipliers, with a configurable cap to prevent stat inflation.
• Mining Speed: Calculated as Final Mining Speed = (Tinkers' Native Speed + Highest Tetra Module Efficiency) ÷ Mining Divisor (Default: 1.5).
• Harvest Tier: Tool actions granted by Tetra modules carry genuine harvest levels and are validated against Forge's tier sorting registry, preventing tier-skipping exploits.
• Bow Stats: Draw speed, arrow velocity, projectile damage, and spread/accuracy are fully converted and balanced against Tinkers' ranged stats.

Integrity Calculation

Tinkers' Construct tools lack an integrity system natively. TCTB dynamically computes base integrity using the following formula:

• Base Integrity = Material Tier Score + Head/Handle Quality Score + Installed Module Modifiers
• Material Tier Score: The highest tier among all component materials used in the tool, capped at 4.
• Head/Handle Quality Score: Rounded result of 0.001 × Head Average Durability + Head Average Mining Speed + Head Average Attack Damage + Handle Multipliers Average.
• Final Integrity: The base integrity plus all integrity provided by installed modules, minus the integrity consumed by modules.

Slot Rules

Tinkers' parts are automatically mapped to corresponding Tetra slots (e.g., blades, handles, guards, bow staves, bowstrings, etc.). Swords will automatically expand with a dedicated Fuller slot when eligible.

When a tool possesses multiple identical slots (such as double-headed tools or multi-limb bows) and modules are installed in each:

• Attack Damage / Durability / Bow Limb Stats: Takes the average of the $N$ modules and multiplies it by a stacking bonus: 1 + (N - 1) × 10%.
  • Example: Two heads each equipped with a +5 damage module → (5 + 5) / 2 × (1 + 0.1) = +5.5 final bonus.
• Attack Speed: Each additional module in the same group incurs a 10% speed penalty by default (double-headed tools default to ×0.9).
• Extra Attributes (Reach, etc.): Averaged across modules and modified by configurable stacking bonuses.
• Tool Actions (Harvest Types): Takes the union of all installed modules, using the highest available harvest tier.