StatTweaks

Balance your game. Your rules.

StatTweaks is a powerful and flexible mod that lets you fully customize items and entities using a simple JSON config file.

Whether you're building a modpack or fine-tuning gameplay, StatTweaks gives you complete control over attributes, mechanics, and behavior — all without writing a single line of code.

✨ What You Can Do

🔹 Rebalance any item Modify stats like damage, speed, armor, durability, stack size, and more.

🔹 Modify entities Adjust base stats like health, attack damage, and movement speed.

🔹 Use modern Data Components Directly control internal item behavior using Minecraft’s component system.

🔹 Conditional modifiers Create dynamic bonuses depending on conditions (e.g. dimension).

🧩 Supported Attributes (Items & Entities)

StatTweaks supports ANY attribute registered in the game (vanilla or modded).

Below are common examples (not limited to):

Attribute ID	Effect in-game
`minecraft:generic.attack_damage`	Increases the damage dealt to entities when attacking.
`minecraft:generic.attack_speed`	Controls how fast the player can attack (higher = faster hits).
`minecraft:generic.max_health`	Changes total health (mainly used for entities).
`minecraft:generic.movement_speed`	Affects walking/running speed.
`minecraft:generic.armor`	Reduces incoming damage when worn.
`minecraft:generic.armor_toughness`	Reduces effectiveness of high-damage attacks.
`minecraft:generic.knockback_resistance`	Reduces how far entities are pushed when hit.
`minecraft:generic.attack_knockback`	Increases knockback dealt to enemies.

⭐ Special StatTweaks Attributes

Attribute	Effect
`stattweaks:durability`	Sets item durability (number of uses before breaking).
`stattweaks:efficiency`	Modifies tool mining speed and behavior.

🧪 Data Components (Advanced Customization)

StatTweaks supports ANY registered Data Component, including modded ones.

Below are common examples:

Component ID	Effect in-game
`minecraft:max_stack_size`	Changes how many items can stack in one slot.
`minecraft:max_damage`	Defines durability for damageable items.
`minecraft:rarity`	Changes item name color (common, rare, epic, etc.).
`minecraft:food`	Turns item into food with hunger/saturation effects.
`minecraft:enchantments`	Applies enchantments directly to the item.
`minecraft:stored_enchantments`	Used for enchanted books.
`minecraft:unbreakable`	Prevents item from losing durability.
`minecraft:tool`	Defines tool mining rules and effectiveness.
`minecraft:weapon`	Defines weapon behavior internally.
`minecraft:damage`	Tracks current durability damage.
`minecraft:use_cooldown`	Adds delay between uses.
`minecraft:use_remainder`	Defines item left after use.
`minecraft:tooltip_style`	Controls tooltip appearance.
`minecraft:tooltip_display`	Controls how stats are shown in tooltips.

⚠️ StatTweaks does not limit components — any valid component can be used as long as the JSON matches its codec.

🧬 Entity Customization

Modify entity base attributes:

Health (max_health)
Damage (attack_damage)
Speed (movement_speed)

✔ Works with vanilla and modded entities ⚠️ Does not modify AI or behaviors

⚙️ Simple Configuration

All changes are made in:

config/CPT_StatTweaks_Config.json

Structure:

{
  "tooltip_mode": "relative",
  "items": { ... },
  "entities": { ... }
}

Tooltip Modes

"relative" → shows modifiers (e.g. +5 Damage)
"base" → shows final values

🎯 Perfect For

✔ Modpack creators ✔ Game balance adjustments ✔ Progression tuning ✔ Cross-mod compatibility fixes ✔ Custom gameplay experiences

⚠️ Good to Know

Some changes (like durability or stack size) may require a game restart
In certain versions, you may need to leave and re-enter the world (or fully restart the game) for changes to apply correctly
Use full IDs like minecraft:generic.attack_damage
Invalid component formats may not apply correctly
For more details, examples, and updates, check the project’s GitHub repository