---

The pitch

Fiw Custom Items gives server owners custom items from JSON: drop a file into config/fiw_tools/items/, run /fiwtools reload, and a custom item is live.

It is not a fixed item pack. It lets you build your own progression: custom display, lore, attributes, enchantments above vanilla caps, durability, food, tool rules, active abilities, passive armor effects, curses, imbuements, and persistent upgrades.

It also pairs with FIW Bosses. Bosses can equip or drop Fiw Custom Items entries by id through toolId, and the boss mod safely skips those entries if Fiw Custom Items is not installed.

Fiw Custom Items is server-side only — it has no client-side code. Install it on the server (Fabric or NeoForge); players do not need the mod to join. On Fabric, even fully vanilla clients can connect.

The internal mod id, config folder, /fiwtools command, and FiwToolsAPI names stay as fiw_tools / Fiw Tools for compatibility with existing servers and integrations.

---

Sixty seconds to your first item

config/fiw_tools/items/storm_blade.json

{
  "id": "storm_blade",
  "base": "minecraft:diamond_sword",
  "displayName": "&b&lStorm Blade",
  "lore": ["&7Right-click to call lightning."],
  "rarity": "epic",
  "abilities": [
    {
      "type": "lightning_strike",
      "trigger": "on_right_click",
      "cooldownTicks": 120,
      "params": { "range": 18, "damage": 10 }
    }
  ]
}

/fiwtools reload
/fiwtools give @s storm_blade

Tweak the file, reload, try again.

---

What you can build

Custom gear - turn vanilla bases into named weapons, armor, trinkets, tools, food, and catalysts.

Active abilities - right-click casts, attack procs, kill effects, hurt reactions, and block-break effects.

Elemental status - apply FROZEN, SOAKED, or SHOCKED to enemies. Stack statuses for interactions: freeze then thaw_burst for a fire explosion, soak then storm_chain to arc lightning between targets.

Set bonuses - tag items with a resonanceId. Equip enough pieces and extra passive abilities unlock automatically.

Soul system - items can store souls on kill. Spend them all at once for a burst of scaled AoE damage.

Passive equipment - held or worn buffs, ally auras, defensive pulses, emergency survival triggers, and conditional effects.

Cursed items - punish non-whitelisted holders, scan ender chests, block grindstone/anvil abuse, and prevent world placement.

Imbuements - catalyst-based upgrades with weighted outcomes, charges, target caps, stat changes, new abilities, and history that survives reloads.

Custom crafting - JSON recipes in config/fiw_tools/recipes/, many per file, shaped or shapeless. Craft custom items from vanilla, vanilla from custom, or custom from custom — in any crafting grid, fully server-side.

Infinite items - food that never runs out, arrows that return the instant they're fired, items that spend durability instead of being consumed, or transform into something else on use (keep / damage / replace modes). On Minecraft 1.21.1, infinite support is limited to food and arrows because that version predates the generic vanilla use_remainder component.

Recharge on kill - turn kills into busted mending: repair damage, recharge cooldowns, grow max durability, or make the item unbreakable. Works from hands or inventory slots and can target mobs, players, specific entity ids, or anything living.

Awakening artifacts - items that auto-upgrade when their holder proves worthy: kill a boss N times, slay a specific player, deal enough total damage, or set foot in a dimension. Chain stages for multi-awakening artifacts, or awaken via a custom recipe.

Bound artifacts - an item binds to the first player who uses or picks it up. Nobody else can trigger its abilities — and with the optional curse, thieves bleed for every second they hold it.

Item commands - the run_command ability silently runs any server command(s) on any trigger, with placeholders. The on_shift_right_click trigger gives every item a second right-click kit.

Charges & costs - items carry a regenerating charge pool; abilities can cost charges, durability, health, hunger, XP levels, or items per use.

Cooldown groups - one shared cooldown across abilities and items. No more stacking three blink trinkets.

Ten lifecycle triggers - react to eating, pickup, drop, death, respawn, dimension travel, equip/unequip, and boss kills (FIW Bosses aware).

Conditions - gate any ability: low health, night, storm, dimension, sneaking, enemies nearby, in combat, and more.

Dynamic lore - lore that updates live: owner, charges, souls, awakening progress, durability.

Vanilla visuals - potion colors, leather dye, and item models straight from JSON.

Hot reload - update configs live while preserving player changes like durability, renames, extra enchants, uncurse flags, imbuement logs, awakening progress, and binding owners.

---

Ability highlights

Ability	What it does
arc_slash	Animated particle slash, ported from FIW Bosses
lightning_strike	Calls lightning or damage at range
projectile_burst	Custom particle projectile with optional AoE
frost_nova	Freezes nearby enemies
riptide_dash	Movement burst in the look direction
chain_lightning	Bounces damage between targets
gravity_well	Pulling zone effect
last_stand	Low-health survival passive
uncurse	Consumable curse removal
imbue	Catalyst upgrade engine
freeze / soak / shock	Apply elemental status; each has passive tick effects
thaw_burst	Consume FROZEN for a fire AoE explosion around the target
storm_chain	Consume SOAKED to arc lightning damage to nearby enemies
soul_collector	Absorb a soul on kill; stored in the item up to soulCapacity
soul_surge	Spend all stored souls for scaled AoE magic damage
blood_pact	Sacrifice HP to multiply next attack damage
sanguine_strike	Lifesteal that scales with the target's missing HP
hemorrhage	On-hurt: inflict bleed DoT on whoever hit you
flame_dash	Teleport forward, igniting enemies along the path
meteor_strike	Raycast impact AoE at cursor position
run_command	Silently run any server command(s) from an item

Full schema and every ability parameter are in the documentation.

---

Supported versions

Loader	Minecraft	Java
Fabric	1.21.1	21
NeoForge	1.21.1	21
Fabric	1.21.11	21
NeoForge	1.21.11	21
Fabric	26.1.2	25

Fabric builds need Fabric API and Fabric Language Kotlin.

NeoForge builds include the Kotlin runtime inside the Fiw Custom Items jar. Install it on the NeoForge server only; clients do not need the mod, and no separate KotlinForForge mod is required.

The repo module is named fabric-26.2.1 as requested, but Fabric's official metadata currently rejects the 26.2.1 game coordinate. The buildable target is 26.1.2 until Fabric publishes a valid 26.2.1 coordinate.

---

Commands

/fiwtools give <players> <itemId> [count]   /fiwtools list
/fiwtools info <itemId>                     /fiwtools reload
/fiwtools recipes
/fiwtools curse add|remove|list ...
/fiwtools uncurse_held
/fiwtools imbue best|roll|reset|clear|log

---