Fiw Custom Items

模组

· 作者 Fi3w0

一个基于数据的自定义物品框架,适用于 Fabric 或 NeoForge。通过 JSON 定义 NBT、属性、可配置能力、机制、诅咒、升级等内容,无需编写代码,也无需重启游戏。

0 本站下载 0 关注 更新于 4 天前

最新 1.3.4 · 1.21.1 · NeoForge

一键开服(送7天)

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 物品成长系统。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源