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