自定义物品

创作者: aedenthorn
已更新:2026-01-05 11:44:40
482KB

关于此 MOD

让你能通过JSON和图片文件创建新的游戏内物品。
此模组允许你通过JSON格式定义新的物品,例如:

{
    "排/蛋/和/牛/排"
    "最大使用次数": 1
    "settings_Inventory": "背包设置"
        "texturePath": "牛排蛋.png"
        牛排配煎蛋
        "displayName": "牛排煎蛋"
        "description": "丰盛的一餐!"
        "最大堆叠数": 5
    }
    "settings_usable": "可用设置"
        "isUsable": true,
        "allowHoldButton": true,
        "useButtonName": "左键"
        "useButtonCooldown": 1.1,
        "animationOnSelect": 38
        "使用动画": 15
        "forceAnimationIndex": false,
        "触发中": 否
        "lockItemDuringCooldown": true,
        "resetTriggerOnDeselect": "取消选择时重置触发器"
        "consumeUseAmount": 1
        "eventRef_break": "击破"
        "useableItemTemplate":"陶盘_果酱牛排"
        "useableItemTextures":{ "可用物品纹理":{ }
            "Meals_AlbedoTransparency": "牛排煎蛋_使用.png"
        }
    }
    "settings_consumeable": "消耗品设置"
        "foodType": 3,
        "foodForm": 1
        "氧气产量":0.0
        "饥饿产出": 60.0
        "bonusHungerYield": 60.0,
        "thirstYield": 0.0,
        "bonusThirstYield": 0.0,
        "isRaw": false
        "eventRef_consumeSound": "event:/char/chew"
    }
    "settings_cookable": { "可烹饪" }
    "settings_equipment": {}
}


以上定义了一种新的餐品。 牛排与煎蛋, 基于 陶盘果酱牛排.

其物品图标使用自定义PNG文件,并采用 陶盘果酱牛排 游戏内模型已调整贴图,将果酱改为黄色,使其外观类似鸡蛋(参见截图)。

其营养价值与果酱牛排相近,但更解饱,也更不解渴。


使用

要使用此模组,请将类似上述的JSON代码放入扩展名为.json的文件中。 牛排配煎蛋 确保你未将其保存为txt文件。请将该文件与你的png文件一同放入文件夹内。 BepInEx/plugins/CustomItems你可以使用子文件夹,只需确保在上方代码的png路径中添加该子文件夹即可。

要查看现有物品的信息,你可以使用 /dump <物品名称> 在聊天框中。 物品名称在此该命令会将一个 JSON 文件导出至: 自定义物品 文件夹名称前带下划线(带下划线的文件不会作为新物品加载)


纹理

在游戏中提取纹理资源来制作图像稍微复杂一些。该模组支持修改物品栏图标以及手持物体网格渲染器上的主要纹理。

我使用 此工具 将所有Texture2D资源导出至文件夹,同时获取其名称。

要查看各物体使用了哪些纹理,可使用 Unity 浏览器但熟练后才能发挥其全部潜力。

我不会为这两个工具写教程;如果你搞不明白,不如等别人来做道具吧。

我已在可选文件中附上了简单的牛排煎蛋方案,以及一份专属食谱。 自定义食谱 mod. 将压缩包内的两个文件夹放置到你的... BepInEx\plugins 文件夹。


笔记

你不能用这个模组来创建配方;请使用我的自定义配方模组来实现。 

你还不能使用此模组修改已有物品,至少现在不行。

此功能尚处于实验阶段,如发现漏洞请提交错误报告。

源代码位于 https://github.com/aedenthorn/RaftMods

使用 Xmod 解锁 木筏求生 的全部潜力 — 今天就探索这些顶级 MOD!