Item attributes and changer

Item Attributes

Version: 1.4.1-legacy · Minecraft: 1.20.1 · Loader: Forge

What this mod does

Item Attributes lets players (and admins) customize any item — vanilla or modded — using XP levels as currency. Everything is stored in the item's own NBT, so no new items, blocks, or recipes are added; a plain diamond sword or leather boots can become a build-defining piece of gear.

The system has four layers, roughly in order of power:

1. Attributes — set attack damage, attack speed, attack range, or armor to an exact value.
2. Effects — attach vanilla or modded potion effects that trigger while held, while worn as armor, or on a melee hit.
3. Rank — every attribute and effect on an item counts as one "modification." Enough of them pushes the item's rank from E all the way to SSS.
4. Flux Cores — once an item hits SSS rank, it can be assigned one of 12 rare cores (7 for weapons, 5 for armor), each with its own passive kit, and in several cases, unique abilities.

Everything is priced in XP levels, and almost every number in the system — costs, drop rates, cooldowns, damage, terrain destruction — is server-configurable.

Progression

Rank

RankUtil counts how many real modifications are on an item (Damage/Speed/Range/Armor each count as one if set, plus one per Hold/Armor/Hit effect):

Reaching SSS for the first time on an item automatically rolls it a random Flux Core (from the correct pool for that item's type — weapon cores for weapons/tools, armor cores for armor pieces) and grants the God Forge advancement.

Cost

Every modification costs XP levels, computed per-attribute and multiplied by a global cost multiplier (default 2x):

• Damage/Speed/Range/Armor: cost scales with the requested value (per-point cost, configurable).
• Hold/Armor/Hit effects: base cost per tier-1 vanilla effect (default 30), doubled for modded effects, and multiplied per amplifier tier above 1 (default 3x per tier).
• Setting a specific Flux Core costs a flat amount (default 500); rolling a random one costs less (default 50).
• An optional max level cost cap can clamp any single modification's cost down to a ceiling, regardless of how expensive the raw calculation would otherwise be.

Weapon Flux Cores

Rolled or set on whatever is in the mainhand or offhand slot. Only one weapon core is active per item; Godfather can only exist once server-wide (see below).

True damage in all cases bypasses armor, resistance, and invulnerability frames. Ultimate abilities (Divide, Demonic Claw, Draconic Shockwave, Almighty Slash, Almighty Push) each have their own independently configurable cooldown and damage value, and Almighty Slash/Push broadcast a big bold title to every player's screen when triggered.

Terrain-clearing abilities respect a global destruction toggle and percentage scale (see Config).

Godfather's singleton rule

Only one Godfather-cored item can exist at any time across the whole server. Setting Godfather on a new item clears the claim from wherever it previously was. If the item is ever lost/destroyed without going through the mod's own clear logic, an admin can force-reset the claim with /itemattr forcerest godfather.

Armor Flux Cores

A completely separate pool from weapon cores, rolled/set on helmet/chestplate/leggings/boots. Stat bonuses are applied as real attribute modifiers tied to what's currently equipped — take a piece off and the bonus disappears that same tick, no lingering potion effect.

Weapon cores never work on armor pieces and armor cores never work on weapons/tools — enforced both in the GUI (buttons gray out) and server-side (can't be bypassed by a modified client).

Omniframe extras

• Repel (keybind, default R): a sonic-boom knockback burst. Requires at least one Omniframe piece. Scales with how many pieces you're wearing (1–4):
  • Radius: 8 → 32 blocks.
  • Knockback strength increases.
  • Cooldown: 45s at 1 piece down to 5s at a full 4-piece set (both ends configurable).
  • Anything launched takes true damage in a small explosion when it lands back on the ground (catches anything else standing nearby too).
  • The caster gets 5 seconds of invincibility.
• Bonus XP: wearing Omniframe multiplies all XP gains — 1 piece = 2x, scaling linearly to a full 4-piece set = 5x.

Global Item Templates

Server-wide default attributes/cores for every instance of an item type — e.g. "all diamond swords start with 15 attack damage." Configured with /itemattr global or directly in the config.

• Applies without ever touching an item's NBT, so it never counts as a "modification" and never affects rank.
• The moment a player explicitly sets their own value for that same attribute/core on their specific item (via command or menu), their value takes priority for that item from then on — the global default keeps applying to every other untouched instance of that item type.
• Supports Damage, Speed, Range, Armor, a default weapon core, or a default armor core. Godfather can't be set as a global default since only one can ever exist.
• The mod automatically validates item/attribute compatibility (e.g. you can't set armor on a sword, or a weapon core on a helmet).

Commands

All commands are under /itemattr. Commands marked (op) require permission level 2+.

Keybinds

Both are registered under an "Item Attributes" category in Controls:

Ultimate weapon-core abilities aren't separate keybinds — they piggyback on vanilla's attack/use keys: Shift+Attack, Shift+Use, and Alt+Attack (see the Weapon Flux Cores table above for what each core does with them).

Configuration

Generated at config/itemattributes-common.toml on first launch. All values below are defaults.

[costs]

[survival]

[weaponFluxCores] / [armorFluxCores]

[abilities]

[destruction]

[cooldowns] (all in seconds)

[materialRequirements]

A list of strings, one per rule: "ACTION:modid:itemid:count", e.g. "SET_FLUX_CORE:minecraft:nether_star:1" requires 1 Nether Star (in addition to XP) to set a weapon core. Valid ACTION values: SET_DAMAGE, SET_SPEED, SET_RANGE, SET_ARMOR, ADD_HOLD_EFFECT, ADD_ARMOR_EFFECT, ADD_HIT_EFFECT, SET_FLUX_CORE, SET_ARMOR_FLUX_CORE, RANDOM_FLUX_CORE, RANDOM_ARMOR_FLUX_CORE.

[globalItemTemplates]

A list of strings, one per item: "itemid;Key=Value;Key=Value...", e.g. "minecraft:diamond_sword;Damage=15;Core=reaper". Valid keys: Damage, Speed, Range, Armor (numbers), Core (weapon flux core, Godfather rejected), ArmorCore (armor flux core). Easier to manage with /itemattr global in-game than by hand-editing this list.

Notes for admins

• Every number in this mod is tunable without recompiling — see the Configuration section above.
• The rank/SSS system and Flux Core gacha are the only things gated by cost and progress; global item templates and admin force-set commands bypass that entirely by design (they're admin/server decisions, not player grinding).
• Terrain-clearing ultimate abilities don't check land claims or world protection plugins — if griefing is a concern, use terrainDestructionEnabled=false or a low destructionScalePercent.
• Cooldowns, roll weights, and ban lists reload from the config file; runtime /itemattr block and /itemattr destruction changes are written back into the config automatically.