# FIW Tools<\/p>\n
**A data-driven custom item framework for Fabric \u2014 fully server-side, JSON-driven, vanilla items only.**<\/p>\n
Define fully custom items, weapons, and armor entirely through JSON files. No coding, no client install, no server restarts \u2014 drop a config, run `\/fiwtools reload`, and your item is live.<\/p>\n
—<\/p>\n
## Why FIW Tools?<\/p>\n
Most “custom item” solutions for Fabric require client mods, register new item ids that desync with vanilla clients, or are tied to specific RPG frameworks. FIW Tools fills the gap \u2014 pure server-side, vanilla clients connect with no install, and every customization rides on **vanilla data components** so items survive uninstalls cleanly. Built as the sibling mod to FIW Bosses: use them standalone or together.<\/p>\n
—<\/p>\n
## Supported Loaders<\/p>\n
| Loader | Minecraft | Status |
\n|—|—|—|
\n| **Fabric** | **26.1.2** | **Active \u2014 primary development target** |
\n| **Fabric** | **1.21.11** | **Active \u2014 primary development target** |<\/p>\n
NeoForge and earlier Minecraft versions are not currently supported. The codebase only touches vanilla data components and Fabric API events, so a future port is possible but not planned.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **JSON-driven items** \u2014 create any item without writing a single line of code
\n– **Vanilla data components** \u2014 custom name, lore, rarity, attributes (per-slot, every operation), enchantments at uncapped levels, durability, food, tool, hide-tooltip flags, free-form custom NBT
\n– **8 player-balanced abilities** \u2014 animated arc slash with layered particle sweep, riptide dash, cosmetic lightning strike, ground shockwave, heal on hit, short blink teleport, particle projectile burst, and frost nova
\n– **5 ability triggers** \u2014 right-click, on attack, on kill, on hurt, on block break
\n– **Per-player cooldown tracker** \u2014 every ability has its own cooldown per player per item slot
\n– **Keep on death** \u2014 flagged items survive respawn even when the keepInventory gamerule is off
\n– **Color codes** \u2014 & prefix for colors and styles in display name and lore, matching FIW Bosses syntax
\n– **Hot reload** \u2014 one command swaps the registry atomically with no server restart
\n– **Tab completion** \u2014 every command tab-completes loaded item ids
\n– **Public API** \u2014 other mods can look up items by id through a stable static API
\n– **Pairs with FIW Bosses** \u2014 bosses can drop or equip FIW Tools items by id when both are installed; soft dependency that silently degrades if one is missing
\n– **Server-side only** \u2014 vanilla 26.1.2 clients connect with no install required<\/p>\n
—<\/p>\n
## Quick Start<\/p>\n
1. Drop the JAR into your server’s mods folder alongside Fabric API and Fabric Language Kotlin
\n2. Start the server \u2014 folder generates at config\/fiw_tools\/items
\n3. Copy an example item from the examples folder into config\/fiw_tools\/items
\n4. Run the reload command
\n5. Give it to yourself with the give command<\/p>\n
—<\/p>\n
## Commands<\/p>\n
– **give** \u2014 build the item from JSON and hand it to one or more players, with an optional count
\n– **list** \u2014 list every loaded item id
\n– **info** \u2014 print a one-line summary of an item’s definition
\n– **reload** \u2014 re-read every JSON file and atomically swap the registry without a restart<\/p>\n
All commands are at permission level 2 (operator) and tab-complete loaded item ids.<\/p>\n
—<\/p>\n
## Customization Summary<\/p>\n
Every item JSON is a flat object. Only id and base are required.<\/p>\n
| Section | Fields |
\n|—|—|
\n| Identity | id, base, displayName, lore, rarity |
\n| Stack | stackSize, repairCost |
\n| Durability | unbreakable, maxDamage, damage |
\n| Visual | enchantmentGlint, hideFlags |
\n| Power | enchantments (uncapped), attributes (per-slot, all operations) |
\n| Persistence | keepOnDeath, customData |
\n| Use | food, tool |
\n| Behavior | abilities |<\/p>\n
—<\/p>\n
## Pair with FIW Bosses<\/p>\n
When both mods are installed, FIW Bosses can reference FIW Tools items by id from its loot tables and equipment slots \u2014 boss loot entries can pull a Tools item by id, and equipment slots can equip one by id. If FIW Tools is missing the lookup is silently skipped, so boss configs never crash. Each mod also works fully on its own.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
| | |
\n|—|—|
\n| Minecraft | 26.1.2, 1.21.11 |
\n| Fabric Loader | 0.19.2 or newer |
\n| Fabric API | 0.148.0+26.1.2 or newer |
\n| Fabric Language Kotlin | latest |
\n| Java | 21, 25 |
\n| Server-side only | Yes |<\/p>\n
—<\/p>\n
## Documentation<\/p>\n
Full configuration reference with every field, every ability parameter, and complete examples available on the GitHub repository.<\/p>\n
—<\/p>\n
## License<\/p>\n
Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0). You may share and adapt the material with attribution and a link to the original repository, for non-commercial use, under the same license. For commercial use, contact Fi3w0 to request permission.<\/p>\n
—<\/p>\n
*Made by Fi3w0 \u2014 built for a private SMP, shared with everyone.*
\n*Developed with assistance from Claude Opus 4.7.*<\/p>\n","protected":false},"excerpt":{"rendered":"
A data-driven custom items framework for Fabric. Define NBT, Attributes, configurable abilities entirely through JSON no coding, no restarts.<\/p>\n","protected":false},"featured_media":70667,"template":"","meta":{"_minecraft_slug":"fiw-tools","_minecraft_project_id":"VHLQczbA","_minecraft_author":"Fi3w0","_minecraft_license":"CC-BY-SA-4.0","_minecraft_downloads":15,"_minecraft_follows":1,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"fiw-tools.zip","_minecraft_size_bytes":225047,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T12:38:46.530106Z","_minecraft_date_created":"2026-05-11T20:10:40.966397Z","_minecraft_date_modified":"2026-05-16T00:15:09.717958Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/fiw-tools","_minecraft_icon_attachment_id":70667,"_minecraft_imported_at":"2026-06-04T00:27:44+00:00","_minecraft_import_hash":"2782fd7cf96c8e5f5975ca9af79e0fe8","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,88,97,85,89,92],"mod_loader":[99],"minecraft_version":[41,163],"class_list":["post-70666","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-equipment","mod_category-fabric","mod_category-food","mod_category-game-mechanics","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-11","minecraft_version-26-1-2"],"yoast_head":"\n