Fiw Custom Items

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). on_boss_phase reacts when a nearby FIW Bosses boss enters a new phase.

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.

Auto ability lore - "autoLore": true writes ability lines like Right-click: Lightning Rain (6s cooldown) into the tooltip for you.

Export items - `/fiwtools export ` turns the item in your hand into a ready-to-edit JSON config.

Boss slayer - bonusVsBosses / bonusVsMinions damage multipliers and whenTargetIsBoss conditions for gear built to take down FIW Bosses and vanilla bosses.

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

Full schema and every ability parameter are in the documentation.

Supported versions

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 export <newId>
/fiwtools recipes
/fiwtools curse add|remove|list ...
/fiwtools uncurse_held
/fiwtools imbue best|roll|reset|clear|log