cu_item_set_property zh

设置物品属性

概述

修改自定义物品的某项属性。这是对已注册物品的后置修改积木，用于微调物品的性能数据。通常放在 当mod启动 事件下的注册积木之后执行。

插槽

插槽	类型	说明
TARGET_ITEM	物品插槽	要修改的目标物品。填入 物品/自定义物品 取值积木
PROP	下拉框插槽	要修改的属性项（见下）
VALUE	组合插槽	属性新值。类型随所选属性而变化：数值属性填数字，可使用/可穿戴/零耐久销毁/可放置填布尔，名称/描述填字符串

连接

连接	类型	说明
顶部 / 底部	语句	可加入语句链执行

下拉框选项

选项	值	含义
耐久(condition)	condition	物品当前耐久
重量(weight)	weight	物品重量
价值(value)	value	物品价值
可使用(usable)	usable	是否可被使用
可穿戴(wearable)	wearable	是否可穿戴
左手使用(useLimbAction)	useLimbAction	是否用左手肢体动作使用
零耐久销毁(destroyAtZeroCondition)	destroyAtZeroCondition	耐久归零时是否销毁
可放置(placeable)	placeable	是否可放置为建筑/地块

典型用法

• 调整自定义武器的重量与价值
• 把自定义物品设为可放置并与建筑注册联动
• 禁止物品在耐久归零时被销毁

生成代码

按所选属性生成对应赋值语句，如 item.weight = 2.5;；可放置 还会附加开关 tags 与 usable。

示例

当mod启动
├── 注册物品 id "customSword" 名称 "示例剑" 描述 "测试剑" 精灵图 "sword.png"
└── 设置物品 自定义物品"customSword" 属性 重量(weight) 为 2.5

Block ID: cu_item_set_property

---

English | 注册积木 | 积木参考