Sympathetic Attributes

A powerful, data-driven RPG attribute engine for NeoForge 1.21.1 — 35+ logical stats, a full mana system, a central damage pipeline, item & command grants, and deep mod compatibility. Works out of the box, and doubles as a library for other mods and datapacks.

🌟 Overview

Sympathetic Attributes turns Minecraft's flat combat and movement into a rich, moddable RPG stat system. Every stat — from critical damage and life steal to reach, mana, and even your character's body size — is a first-class logical attribute you can grant, stack, time-limit, and remove with total precision.

It runs perfectly on its own as a gameplay mod, and exposes a clean public API so other mods, skill trees, spells, quests, and datapacks can hook straight into the same system. No conflicts, no duplicated stats — one unified attribute layer for your whole pack.

Fully dedicated-server safe. Client-only code (HUD, screens) never touches the server.

✨ Highlights

35+ logical RPG attributes spanning combat, magic, movement, sustain, mana, curses, and body scaling.
Linear, predictable stacking — +25% and +10% and -5% always equal exactly +30%. No runaway multiplication.
Central damage transaction pipeline — crits, elemental splash, armor/protection pierce, life steal, execution, and max-HP damage resolved consistently in one place.
Complete mana system — max mana, per-second regeneration, mana-scaled magic damage, and a clean mana-bar HUD.
Flexible granting — commands, item/equipment grants, timed buffs, and death-aware persistence.
In-game attribute screen (press P) and a mana bar above the food bar.
Deep mod compatibility — actively integrates with Curios, Better Combat, the Apotheosis/Apothic family, Ice and Fire, and more; designed to coexist cleanly inside large modpacks.
English & Turkish localization out of the box.
Modder- and pack-friendly — public API + data-driven item grants.

🧬 How the Attribute System Works

Each logical attribute is backed by a real Minecraft attribute — a vanilla one where an exact meaning exists (e.g. mining speed → block_break_speed), or a custom attribute otherwise. This means Sympathetic reuses Minecraft's own stacking, syncing, and persistence — so your stats behave correctly on servers, across relogs, and alongside other attribute mods.

Values stack additively and are hard-clamped to safe ranges, so stats stay sane no matter how many sources pile on. Percentages accept both 25% and 0.25.

📊 Full Attribute Catalog

⚔️ Combat & Criticals

critical_chance, critical_damage — reliable crits independent of jump state
armor_pierce, armor_shred, protection_pierce, projectile_protection_pierce — cut through defenses
attack_speed_bonus, max_health_damage (damage scaling with your max HP)
execution_limit — finish off low-health foes

🏹 Ranged & Projectiles

draw_speed, arrow_damage, arrow_velocity
magic_projectile_damage, magic_projectile_protection

🔥 Elemental

fire_damage, cold_damage — auxiliary elemental splash with its own damage types (ignite / freeze)

❤️ Sustain

life_steal, health_regeneration, healing_received, overheal

✨ Magic & Mana

max_mana, mana_regeneration, mana_damage

🏃 Movement & Body

movement_speed_bonus, swim_speed, step_height, fall_resistance, jump_height
reach — scales all interaction range (block breaking, entity/attack reach — also picked up by Better Combat)
thickness & length — independently scale your body. These affect the real hitbox, eye height / camera, interaction reach, and collision — a giant actually bumps into blocks, and a tiny character fits through gaps.

🪓 Utility

mining_speed, experience_gained, hunger_efficiency

☠️ Curse

curse_proficiency, curse_protection

(Common aliases are supported for convenience, e.g. body_height → length.)

🔷 Mana System

A self-contained mana pool for magic gameplay:

Max mana and per-second regeneration as full attributes.
mana_damage — magic damage that scales with your current mana fraction.
A slim, segmented mana bar HUD rendered right above the food bar, showing your current mana and regen-per-second.
Regeneration can pause after taking damage (configurable behavior).

Sympathetic's mana is namespace-independent, so it happily coexists with other mana/resource mods without clashing.

🎛️ Applying Attributes

In-Game Commands

Operator-level commands with full tab-completion:

/sympatheticattribute add <targets> <attribute> <amount> [operation] [duration] [death_behavior] [source]

/sympatheticattribute remove entity <targets> <attribute|all> [source]

/sympatheticattribute get <target> <attribute>

/sympatheticattribute list <target>

/sympatheticattribute mana <get|set|add|consume|fill> <target> [amount]

/sympatheticattribute helditem <add|remove|list> ...

/sympatheticattributeitemgive <item> <activation> <grant_list> [count]

Timed grants (30s, 5m, 1h, or permanent) that auto-expire cleanly with no leftover "ghost" modifiers.
Death behavior per grant — keep or drop a buff on death.
Named sources so removing one grant never touches unrelated ones.

Item & Equipment Grants

Attach stats to any item: they activate when the item is held, worn, or placed in a Curios slot. Give ready-made items with /sympatheticattributeitemgive, and stats reconcile automatically as items move in and out of slots.

🖥️ In-Game Interface

Attribute Screen (press P) — a clean, readable overview of your current stats, organized by category.
Mana Bar HUD — thin, segmented, and unobtrusive, sitting just above the food bar.

🤝 Mod Compatibility

Sympathetic is built to be a good neighbor in big modpacks. Verified to load and coexist alongside 25+ popular mods, with active integrations for:

Curios — dynamic slot detection; wear items to activate their grants.
Better Combat — reach extends Better Combat's attack range automatically, with full client/server agreement.
Apotheosis / Apothic Attributes / Apothic Enchanting / Apothic Spawners / Apothic Combat — coexist without registry collisions or double-processing.
Ice and Fire: CE — dragon fire/ice and magic projectiles classified for the elemental/magic pipeline.
Tensura, Artifacts, Relics, and more — designed to slot in without replacing or subclassing their items.

Optional AttributeFix support: Sympathetic uses finite ranges + runtime clamps, so it behaves correctly with or without it.

If you find a compatibility issue, please report it — see below.

📦 For Modpack & Datapack Creators

Data-driven item grants — define stats on items via data maps, no code required.
Custom damage types shipped as data files, taggable and extendable by datapacks.
Everything is command- and data-configurable, making Sympathetic ideal as the stat backbone for questing, progression, and class packs.

Modpack use: ["Feel free to use in any modpacks."]

🧑‍💻 For Developers

Sympathetic exposes a stable public API so your mod can:

Grant/remove direct & timed attribute buffs from any source (skills, spells, auras, quest rewards).
Read and modify the mana pool.
Register against the same logical-attribute layer instead of inventing your own.

One shared, conflict-free attribute system for your whole ecosystem.

⚙️ Configuration

Server and client config files let you tune caps and behavior (e.g. percentage-bonus cap, damage-pipeline options, regeneration-on-damage rules) to fit your pack's balance.

🌍 Localization

Ships with English and Turkish. Translation contributions are welcome.

📋 Requirements

Minecraft 1.21.1
NeoForge (21.1.235+ recommended)
No other mods required — Sympathetic works standalone.

💾 Installation

Install NeoForge for Minecraft 1.21.1.
Drop the Sympathetic Attributes .jar into your mods folder.
Launch — press P in-game to open your attribute screen.

🐛 Issues & Feedback

Feel free to ask for any help or informantion on comments. I will reply.