StatTweaks

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