Fiw Custom Items

Build custom server items from JSON.

Weapons. Armor. Food. Curses. Imbuements. Custom crafting. Infinite items. Awakening artifacts. Bound artifacts. Item commands. No Java. No restarts. Fabric and NeoForge builds are both supported.

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 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

Made by Fiw for custom SMP item progression.