Перейти к содержимому
Mineforgian

StatTweaks

A mod that dynamically modifies vanilla item attributes. Fully compatible with other mods, it lets you easily adjust damage, speed, durability, armor, and more, making it ideal for custom modpacks and advanced balance tuning.

Загрузки
566
Подписчики
4
Обновлён
11 июля 2026 г.
Лицензия
MIT

Опубликован 8 января 2026 г.

Исходный кодСообщить об ошибке

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

Ченджлог

1.0.0Релиз1.21.9 · 11 июля 2026 г.

StatTweaks - Changelog

[1.0.0] - 2026-07-11

✨ Features

  • ✅ Item Adjustments: Modify damage, attack speed, durability, efficiency, stack size and more
  • ✅ Entity Adjustments: Change max health, speed, attack damage and detection range of any mob
  • ✅ Data Components: Full support for 1.20.5+ Data Components (rarity, food, fire resistance, etc.)
  • ✅ Tag Support: Apply changes to entire groups of items or entities using tags (#minecraft:swords, #minecraft:skeletons)
  • ✅ Hot-Reload: Use /stattweaks reload to apply changes instantly
  • ✅ Base Display Mode: Option to see exact final values in tooltips instead of relative bonuses
  • ✅ Mod Compatibility: Full support for modded items and entities from any mod

🎯 Supported Versions

  • Minecraft 1.21.9
  • Fabric (requires Fabric API)
  • NeoForge

🛠️ Configuration

  • Single JSON configuration file: config/CPT_StatTweaks_Config.json
  • Dynamic stat modifications without rewriting code
  • Support for both vanilla and modded items/entities
  • Tooltip mode selection (relative or base display)

📋 Commands

  • /stattweaks reload — Reloads configuration and applies changes (Permission Level 2/OP required)

⚠️ Known Issues & Limitations

  • Minecraft 1.21.9: The /stattweaks reload command does not work correctly. You must exit and re-enter the world to apply any changes to the JSON configuration
  • Some durability changes are visual only on already-created items
  • Requires installation on both server and clients for proper synchronization
1.0.0Релиз1.21.9 · 11 июля 2026 г.

StatTweaks - Changelog

[1.0.0] - 2026-07-11

✨ Features

  • ✅ Item Adjustments: Modify damage, attack speed, durability, efficiency, stack size and more
  • ✅ Entity Adjustments: Change max health, speed, attack damage and detection range of any mob
  • ✅ Data Components: Full support for 1.20.5+ Data Components (rarity, food, fire resistance, etc.)
  • ✅ Tag Support: Apply changes to entire groups of items or entities using tags (#minecraft:swords, #minecraft:skeletons)
  • ✅ Hot-Reload: Use /stattweaks reload to apply changes instantly
  • ✅ Base Display Mode: Option to see exact final values in tooltips instead of relative bonuses
  • ✅ Mod Compatibility: Full support for modded items and entities from any mod

🎯 Supported Versions

  • Minecraft 1.21.9
  • Fabric (requires Fabric API)
  • NeoForge

🛠️ Configuration

  • Single JSON configuration file: config/CPT_StatTweaks_Config.json
  • Dynamic stat modifications without rewriting code
  • Support for both vanilla and modded items/entities
  • Tooltip mode selection (relative or base display)

📋 Commands

  • /stattweaks reload — Reloads configuration and applies changes (Permission Level 2/OP required)

⚠️ Known Issues & Limitations

  • Minecraft 1.21.9: The /stattweaks reload command does not work correctly. You must exit and re-enter the world to apply any changes to the JSON configuration
  • Some durability changes are visual only on already-created items
  • Requires installation on both server and clients for proper synchronization
2.0.0Релиз1.21.1 · 11 июля 2026 г.

StatTweaks - Changelog

[2.0.0] - 2026-07-11

✨ Features

  • ✅ Item Adjustments: Modify damage, attack speed, durability, efficiency, stack size and more
  • ✅ Entity Adjustments: Change max health, speed, attack damage and detection range of any mob
  • ✅ Data Components: Full support for 1.20.5+ Data Components (rarity, food, fire resistance, etc.)
  • ✅ Tag Support: Apply changes to entire groups of items or entities using tags (#minecraft:swords, #minecraft:skeletons)
  • ✅ Hot-Reload: Use /stattweaks reload to apply changes instantly without restarting
  • ✅ Base Display Mode: Option to see exact final values in tooltips instead of relative bonuses
  • ✅ Mod Compatibility: Full support for modded items and entities from any mod

🎯 Supported Platforms

  • Minecraft 1.21.1
  • Fabric (requires Fabric API)
  • NeoForge

🛠️ Configuration

  • Single JSON configuration file: config/CPT_StatTweaks_Config.json
  • Dynamic stat modifications without rewriting code
  • Support for both vanilla and modded items/entities
  • Tooltip mode selection (relative or base display)

📝 Commands

  • /stattweaks reload — Reloads configuration and applies changes in real-time

⚠️ Known Limitations

  • Minecraft 1.21.9: Reload command requires world rejoin to apply changes
  • Some durability changes are visual only on already-created items
  • Requires installation on both server and clients for proper synchronization
2.0.0Релиз1.21.1 · 11 июля 2026 г.

StatTweaks - Changelog

[2.0.0] - 2026-07-11

✨ Features

  • ✅ Item Adjustments: Modify damage, attack speed, durability, efficiency, stack size and more
  • ✅ Entity Adjustments: Change max health, speed, attack damage and detection range of any mob
  • ✅ Data Components: Full support for 1.20.5+ Data Components (rarity, food, fire resistance, etc.)
  • ✅ Tag Support: Apply changes to entire groups of items or entities using tags (#minecraft:swords, #minecraft:skeletons)
  • ✅ Hot-Reload: Use /stattweaks reload to apply changes instantly without restarting
  • ✅ Base Display Mode: Option to see exact final values in tooltips instead of relative bonuses
  • ✅ Mod Compatibility: Full support for modded items and entities from any mod

🎯 Supported Platforms

  • Minecraft 1.21.1
  • Fabric (requires Fabric API)
  • NeoForge

🛠️ Configuration

  • Single JSON configuration file: config/CPT_StatTweaks_Config.json
  • Dynamic stat modifications without rewriting code
  • Support for both vanilla and modded items/entities
  • Tooltip mode selection (relative or base display)

📝 Commands

  • /stattweaks reload — Reloads configuration and applies changes in real-time

⚠️ Known Limitations

  • Minecraft 1.21.9: Reload command requires world rejoin to apply changes
  • Some durability changes are visual only on already-created items
  • Requires installation on both server and clients for proper synchronization
1.0.0Бета1.21.1 · 8 января 2026 г.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[1.0.0] - 2026-01-07

Added

  • Initial commit and core item balancing system.
  • Implemented STBalanceManager for dynamic runtime statistic modification.
  • Added JSON configuration loader (CPT_StatTweaks_Config.json) using GSON serialization.
  • Created StatAccessor Mixin to allow injection into DataComponentMap (Minecraft 1.21.1).
  • Implemented logic for modifying attributes:
    • Damage
    • Speed
    • Reach
  • Implemented logic for modifying item properties:
    • Durability
    • Stack Size
  • Added support for both Item Tags and specific Registry IDs.
  • Implemented backup and restore system to support safe hot-reloading via the /reload command.
1.0.0Бета1.21.1 · 8 января 2026 г.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[1.0.0] - 2026-01-07

Added

  • Initial commit and core item balancing system.
  • Implemented STBalanceManager for dynamic runtime statistic modification.
  • Added JSON configuration loader (CPT_StatTweaks_Config.json) using GSON serialization.
  • Created StatAccessor Mixin to allow injection into DataComponentMap (Minecraft 1.21.1).
  • Implemented logic for modifying attributes:
    • Damage
    • Speed
    • Reach
  • Implemented logic for modifying item properties:
    • Durability
    • Stack Size
  • Added support for both Item Tags and specific Registry IDs.
  • Implemented backup and restore system to support safe hot-reloading via the /reload command.

Комментарии

Загружаем…