Fiw Custom Items
通过 JSON 构建自定义服务器物品。
武器、护甲、食物、诅咒、附魔、自定义合成、无限物品、觉醒神器、绑定神器、物品指令。
无需 Java,无需重启。同时支持 Fabric 和 NeoForge 版本。
简介
Fiw Custom Items 允许服务器管理员通过 JSON 创建自定义物品:将文件放入 config/fiw_tools/items/ 目录,执行 /fiwtools reload,即可让自定义物品生效。
它不是一个固定的物品包。它让你能够构建自己的进度体系:自定义显示效果、描述文本、属性、超越原版上限的附魔、耐久度、食物、工具规则、主动能力、被动护甲效果、诅咒、附魔以及持久化升级。
它还可与 FIW Bosses 配合使用。Boss 可以通过 toolId 装备或掉落特定的 Fiw Custom Items 条目;如果未安装 Fiw Custom Items,该 Boss 模组会安全地跳过这些条目。
Fiw Custom Items 仅服务于服务端——没有客户端代码。只需在服务端(Fabric 或 NeoForge)安装即可;玩家无需安装此模组也能加入服务器。纯原版客户端可以在两个加载器下连接。
为了兼容现有服务器和集成,内部模组 ID、配置文件夹、/fiwtools 命令以及 FiwToolsAPI 的名称均保持为 fiw_tools / Fiw Tools。
六十秒打造你的第一个物品
config/fiw_tools/items/storm_blade.json
{
"id": "storm_blade",
"base": "minecraft:diamond_sword",
"displayName": "&b&lStorm Blade",
"lore": ["&7右键以召唤闪电。"],
"rarity": "epic",
"abilities": [
{
"type": "lightning_strike",
"trigger": "on_right_click",
"cooldownTicks": 120,
"params": { "range": 18, "damage": 10 }
}
]
}
/fiwtools reload
/fiwtools give @s storm_blade
调整文件,重载,再次尝试。
你可以构建的内容
自定义装备 - 将原版基底转化为命名的武器、护甲、饰品、工具、食物和催化剂。
主动能力 - 右键施法、攻击触发、击杀特效、受伤反应以及破坏方块特效。
诱饵 - 放置一个穿着你装备的替身。决定当它出现、被击中、死亡、过期或每隔几秒时发生什么:可以加速消失并隐身,拉拽攻击者并爆炸,惩罚每次攻击,或者执行任何指令。
元素状态 - 对敌人施加 FROZEN(冻结)、SOAKED(浸湿)或 SHOCKED(触电)。叠加状态以产生交互效果:例如先冻结再 thaw_burst(解冻爆裂)引发火焰爆炸,或先浸湿再 storm_chain(风暴链)在目标间传导闪电。
套装加成 - 为物品标记 resonanceId。装备足够数量的部件后,额外的被动能力将自动解锁。每个能力可设置 minPieces 以实现分级——同一套装备中可以有 2 件套和更强力的 4 件套加成。
灵魂系统 - 物品可在击杀时存储灵魂。一次性消耗所有灵魂以获得按比例缩放的 AOE 伤害爆发。
被动装备 - 手持或穿戴时的增益光环、盟友光环、防御脉冲、紧急生存触发器以及条件性效果。
诅咒物品 - 惩罚非白名单持有者,扫描末影箱,阻止研磨机/铁砧滥用,并防止在世界中放置。
附魔(Imbuements) - 基于催化剂的升级,具有权重结果、充能次数、目标上限、属性变化、新能力以及保留历史记录(即使重载也不会丢失)。
自定义合成 - 在 config/fiw_tools/recipes/ 中使用 JSON 配方,每个文件可包含多个配方,支持形状合成和无形状合成。可以从原版合成自定义物品,从自定义合成原版,或在任意合成网格中从自定义合成自定义——完全在服务端运行。配方可以将原料上的附魔转移到成品上(合并/保留旧版/保留新版,冲突策略,过滤器,等级上限),使升级合成保留玩家的附魔。每个物品的 enchanting 权限决定哪些工作台接受该物品(附魔台/铁砧/研磨机/锻造台),并可以锁定名称以防止铁砧重命名。
无限物品 - 永不耗尽的食物,射出后立即返回的箭矢,消耗耐久度而非被消耗的物品,或使用后转化为其他形态的物品(keep / damage / replace 模式)。在 Minecraft 1.21.1 中,无限支持仅限于食物和箭矢,因为该版本早于通用的原版 use_remainder 组件。
多方块挖掘 - 通过 mining 字段将工具转变为矿脉矿工、3x3 锤或向前掘进隧道。vein 泛洪填充连接的相同方块(矿石或用于伐树的日志),area 打破面向你的平面,tunnel 向前延伸。掉落物、经验值、效率/精准采集以及耐久度的行为均正常;可按方块 ID 或标签过滤,限制数量,按住潜行键可只挖掘一个方块。不可破坏或无限工具可免费挖掘整个矿脉。
击杀回充 - 将击杀转化为超级的修复:修复损伤、重置冷却时间、增加最大耐久度,或使物品不可破坏。适用于手槽或背包槽位,可针对怪物、玩家、特定实体 ID 或任何生物。
觉醒神器 - 当持有者证明其资格时自动升级的物品:击杀 N 次 Boss、击杀特定玩家、造成足够的总伤害,或踏入某个维度。可链接阶段以实现多重觉醒神器,或通过自定义配方进行觉醒。
绑定神器 - 物品与首次使用或拾取它的玩家绑定。其他人无法触发其能力——并且如果带有可选的诅咒,窃贼每持有一秒就会流血。
物品指令 - run_command 能力在任何触发条件下静默运行任何服务器指令,并支持占位符。on_shift_right_click 触发器为每个物品提供第二个右键功能集。
充能与消耗 - 物品拥有可恢复的充能池;技能使用时可消耗充能、耐久度、生命值、饥饿值、经验等级或物品。
冷却组 - 技能和物品共享一个冷却时间。不再允许叠加三个闪烁饰品。
触发组 - 具有相同 procGroup 的技能在单一触发时互斥:仅进行一次加权随机抽取,触发其中一个技能,而非全部。
技能缩放 - scaling 块根据持有者的构建(连杀层数、附魔次数、充能数量或最大生命值)放大任何技能的数值。
附魔控制 - 针对工作台、铁砧、研磨台和锻造台的自定义规则。allowEnchant 阻止添加新附魔但保留重命名和修复功能,且在通过铁砧或锻造台处理后,配置的属性会被重新写入,防止被覆盖。
十种生命周期触发器 - 响应进食、拾取、丢弃、死亡、重生、维度旅行、装备/卸下以及击杀首领(支持 FIW Bosses)。on_boss_phase 会在附近 FIW Bosses 的首领进入新阶段时触发。
条件 - 为任何技能设置前置条件:低血量、夜晚、暴风雨、特定维度、潜行、附近有敌人、处于战斗中等等。
动态描述 - 实时更新的物品描述:所有者、充能、灵魂、觉醒进度、耐久度。
自动技能描述 - "autoLore": true 会自动将类似 右键点击:雷电之雨(6秒冷却) 的技能行写入工具提示中。
导出物品 - /fiwtools export <newId> 将你手中的物品转换为可直接编辑的 JSON 配置文件。
首领杀手 - 提供 bonusVsBosses / bonusVsMinions 伤害乘数和 whenTargetIsBoss 条件,专为对抗 FIW Bosses 和原版首领打造的装备。
原版视觉效果 - 药水颜色、皮革染色和物品模型直接源自 JSON 配置。
热重载 - 实时更新配置,同时保留玩家所做的更改:耐久度、重命名、额外附魔(包括通过铁砧升级的配置附魔)、反诅咒标记、附魔日志、灵魂、连杀计数、姿态、充能、觉醒进度、绑定所有者以及任何属性修改器、盔甲纹饰或玩家添加的染色、命令或其他模组的效果。相同的状态会延续到神器觉醒和制作升级配方中,因此升级后的物品绝不会是丢失属性的复制品。
技能亮点
| 技能 |
功能说明 |
arc_slash |
动画粒子斩击,移植自 FIW Bosses |
lightning_strike |
召唤闪电或在远处造成伤害 |
lightning_rain |
按照自定义时间表在准星圆圈范围内降下雷暴 |
lightning_ray |
直线前进的连续闪电束 |
teleport_behind |
瞬移至目标身后,可选造成终结伤害 |
homing_bolt |
向最近敌人弯曲飞行的投射物 |
aegis_shield |
按需生成的屏障,吸收一定量伤害 |
decoy |
在装备中留下替身承受攻击;可在其挂钩上连锁爆炸、牵引、效果和命令 |
stun_strike |
真正的硬控锁定 |
apply_effect |
对自身或目标施加任何药水效果 |
boss_phase |
管理工具:在不改变血量的情况下切换 FIW Bosses 首领的阶段 |
repair |
修理包物品,用于修复另一只手中的受损物品 |
projectile_burst |
自定义粒子投射物,可选范围伤害 (AoE) |
frost_nova |
冻结附近的敌人 |
riptide_dash |
朝注视方向进行移动爆发 |
chain_lightning |
在目标之间弹跳造成伤害 |
gravity_well |
产生牵引区域效果 |
last_stand |
低血量生存被动技能 |
uncurse |
可消耗的移除诅咒道具 |
imbue |
催化剂升级引擎 |
freeze / soak / shock |
施加元素状态;每种状态均有被动持续效果 |
thaw_burst |
消耗 FROZEN 状态,在目标周围引发火焰范围爆炸 |
storm_chain |
消耗 SOAKED 状态,对附近敌人释放弧形闪电伤害 |
soul_collector |
击杀时吸收灵魂;最多存储 soulCapacity 个灵魂至物品中 |
soul_surge |
消耗所有已存储的灵魂,造成按比例放大的范围魔法伤害 |
soul_lash |
每次命中消耗一个灵魂,造成额外伤害并吸血 |
blood_pact |
牺牲生命值以倍增下一次攻击的伤害 |
sanguine_strike |
吸血效果,随目标缺失生命值比例而增强 |
hemorrhage |
受伤时:对攻击者施加流血持续伤害 (DoT) |
flame_dash |
向前瞬移,点燃路径上的敌人 |
meteor_strike |
在光标位置进行射线检测并造成范围伤害 |
ember_burst |
击杀时:在尸体处引发火球新星,点燃附近敌人 |
geyser_burst |
在指定点进行射线检测,产生范围伤害、击飞效果并施加 SOAKED 状态 |
run_command |
静默执行来自物品的任意服务器命令 |
完整架构及所有技能参数请参阅文档。
支持版本
| 加载器 |
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 |
| NeoForge |
26.1.2 |
25 |
| Fabric |
26.3 |
25 |
| NeoForge |
26.3 |
25 |
Fabric 构建需要 Fabric API 和 Fabric Language Kotlin。
NeoForge 构建已将 Kotlin 运行时包含在 Fiw Custom Items jar 包内。仅在 NeoForge 服务器上安装即可;客户端无需安装该模组,也无需单独安装 KotlinForForge 模组。
命令
/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
由 Fiw 制作,用于自定义 SMP 物品成长系统。
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. Fully vanilla clients can connect on both loaders.
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.
Decoys - leave a stand-in wearing your gear. Decide what happens when it appears, is hit, dies, expires or every few seconds: vanish with speed and invisibility, drag attackers in and explode, punish every hit, or run any command.
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 <newId> 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
| 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 |
decoy |
Leaves a stand-in in your gear that soaks hits; chain explosions, pulls, effects and commands onto its hooks |
stun_strike |
True hard crowd-control lock |
apply_effect |
Apply any potion effect to self or target |
boss_phase |
Admin tool: shift a FIW Bosses boss's phase without touching HP |
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 |
| NeoForge |
26.1.2 |
25 |
| Fabric |
26.3 |
25 |
| NeoForge |
26.3 |
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.
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
Made by Fiw for custom SMP item progression.
评论 0
登录后参与评分
还没有评论,来抢沙发吧