---

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. A per-ability minPieces enables tiers — a 2-piece and a stronger 4-piece bonus on one set.

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. Recipes can transfer the ingredients' enchantments onto the result (merge/keep-old/keep-new, conflict policies, filters, level caps) so upgrade crafts keep players' enchantments. Per-item enchanting permissions decide which stations accept each item (table/anvil/grindstone/smithing) and can lock the name against anvil renames.

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.

Multi-block mining - turn a tool into a vein-miner, 3x3 hammer, or forward tunnel-borer with the mining field. vein flood-fills connected matching blocks (ores, or logs for a tree-feller), area breaks a plane facing you, tunnel extends it forward. Drops, XP, Fortune/Silk Touch and durability all behave normally; filter by block id or tag, cap the count, hold sneak to mine one block. Unbreakable or infinite tools mine whole veins for free.

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.

Proc groups - abilities sharing a procGroup on one trigger are mutually exclusive: a single weighted roll fires just one of them, not all.

Ability scaling - a scaling block grows any ability's numbers with the holder's build: killstreak tier, imbue count, charges, or max health.

Enchanting control - per-station rules for table, anvil, grindstone, and smithing. allowEnchant blocks adding enchantments while keeping rename and repair, and configured attributes are re-stamped after anvil/smithing so they can't be overwritten.

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: durability, renames, extra enchants (including anvil-upgraded config enchants), uncurse flags, imbuement logs, souls, killstreaks, stances, charges, awakening progress, binding owners, and any attribute modifiers, armor trim or dye added by players, commands or other mods. The same state carries through artifact awakenings and crafting upgrade recipes, so an upgraded item is never a stripped-down copy.

---

Ability highlights

Ability	What it does
arc_slash	Animated particle slash, ported from FIW Bosses
lightning_strike	Calls lightning or damage at range
lightning_rain	Rains bolts over a crosshair circle on a custom schedule
lightning_ray	Sequential bolts marching forward in a line
teleport_behind	Blink behind your target, optional finisher damage
homing_bolt	Projectile that curves toward the nearest enemy
aegis_shield	On-demand barrier that absorbs a pool of damage
stun_strike	True hard crowd-control lock
apply_effect	Apply any potion effect to self or target
repair	Repair-kit item that mends a damaged item in your other hand
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
soul_lash	Spend one soul per hit for bonus damage + lifesteal
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
ember_burst	On-kill: fire nova at the corpse ignites nearby enemies
geyser_burst	Raycast AoE launch + damage + SOAKED at a targeted point
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.8	21
NeoForge	1.21.8	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

---