物品函数

物品函数用于修改战利品表和交易表中物品的属性。

TODO 附魔前缀是否可以使用minecraft:/whatever格式？

函数说明 ​

注：以下所有测试仅在交易表中进行 仅适用于战利品表和交易表 是以function和其他属性构成的对象... 均不支持Molang表达式 Java版特有的附加函数或属性均未生效 所有函数均可使用任意文本前缀加冒号，例如minecraft:exploration_map或d1245436576u:fio2ejfoijfiowejf::::::exploration_map

通用函数 ​

以下基础物品属性函数适用于所有物品。

数量设置 ​

set_count函数用于设置物品条目数量。

{
    "function": "set_count",
    "count": {
        "min": 2,
        "max": 4
    }
}

"count"属性决定生成物品的数量，可以是整数或范围对象。设置的数量可以超过物品的堆叠上限。当这种情况发生时，在容器中会溢出到其他槽位，掉落在地面时会分成多个物品堆。该属性默认值为0，因此必须显式设置。

名称设置 ​

使用set_name函数可以设置物品名称。名称会在用户悬停时显示，玩家也可以通过铁砧修改名称。

{
    "function": "set_name",
    "name": "诅咒之弓"
}

通过字符串"name"属性设置物品名称。默认名称显示为斜体，但支持格式代码，可以在文本开头插入§r重置为非斜体。不支持原始文本，可使用\n换行。

描述文本 ​

set_lore函数用于设置物品的描述文本。

{
    "function": "set_lore",
    "lore": ["", ""]
}

"lore"属性配置描述文本，可以是字符串或字符串数组。所有描述文本支持格式代码但不支持本地化。在数组形式中，每个字符串代表一行新文本，每行的格式上下文独立。默认使用紫色斜体文本，可通过在每行开头添加重置格式代码(§r)来修改。在字符串内使用\n可保持当前格式换行。

数据值 ​

set_data设置物品的数据值，类似于/give命令中的参数。用于方块时设置方块数据值，用于物品时设置辅助值。但与命令不同，set_data不能设置物品耐久度（需使用durability）。

{
    "function": "set_data",
    "data": 2
}

"data"属性设置物品数据值，未提供时默认为0。可以是整数或范围对象。

整数形式：

"data": 1

范围对象形式：

"data": {
    "min": 0,
    "max": 5
}

对象形式会在每次选择该物品条目时，在最小最大值之间（含边界）随机选取一个数据值。

方块状态 ​

random_block_state设置方块的单个状态值。

{
    "function": "random_block_state",
    "block_state": "wiki:color",
    "values": 3
}

设置方块的某个状态值 block_state 必需的字符串，表示方块状态名称 values 可以是数字或min/max对象 默认为0...如果省略似乎没有意义？不确定...

辅助值 ​

random_aux_value

{
    "function": "random_aux_value",
    "values": {
        "min": 2,
        "max": 4
    }
}

设置物品的辅助值 values 可以是整数或min/max对象 min/max对象会均匀随机选择 仅用于辅助值；例如不会设置工具的耐久度，但会设置羊毛颜色 会覆盖标识符中的辅助值后缀，如minecraft:wool:10 也适用于方块数据

耐久度 ​

使用set_damage函数设置物品耐久度。

{
    "function": "set_damage",
    "damage": {
        "min": 0.5,
        "max": 1
    }
}

"damage"属性设置物品耐久度，可以是数字或范围对象。值范围通常为0到1，其中0表示物品最低耐久，1表示未损坏。

物品特定数据 ​

某些函数仅适用于特定物品集合。各函数说明中会注明适用物品。

熔炼物品 ​

furnace_smelt

{
    "function": "furnace_smelt"
}

隐含条件是实体死亡时必须处于燃烧状态 原版文件使用函数条件实现，但即使移除该条件，仍要求实体必须在燃烧状态下死亡才能触发furnace_smelt函数

书册内容 ​

set_book_contents

{
    "function": "set_book_contents",
    "title": "",
    "author": "",
    "pages": ["", ""]
}

设置书册数据 仅适用于writable_book或written_book author 字符串，作者名称 title 字符串，书名 pages 字符串数组 - 每个字符串代表一页内容 最多支持50个字符串，每页798个字符 所有页面总字符限制为12,800 使用\n（非\\n）换行 不能使用制表符 支持颜色代码；每页字符串的颜色代码上下文独立

探险地图 ​

exploration_map

{
    "function": "exploration_map",
    "destination": "village"
}

交易表信息： destination 目前仅支持monument和mansion 不支持其他类型，包括沉船宝藏（虽然地图名称显示正确而非"未知地图"，但不会标记位置）

战利品表信息： destination 支持所有/locate定位点（参见旧版配方说明中的注意事项；适用于容器战利品表） 仅在正确维度生效 如果是海底神殿或林地府邸，会正确命名、着色并显示对应图标标记 如果无效或未指定目标，地图不显示标记但仍保留河流和海洋线条 适用于容器以及实体装备和掉落物 注意交易商只支持2种定位点

旗帜类型 ​

set_banner_details

{
    "function": "set_banner_details"
}

设置banner类型（仅适用于此物品） type 只能是0或1 0是普通白色旗帜 1是灾厄旗帜

随机染色 ​

random_dye

{
    "function": "random_dye"
}

随机染色皮革盔甲或马铠 不适用于羊毛等其他物品

刷怪蛋 ​

set_actor_id

{
    "function": "set_actor_id"
}

适用于刷怪蛋 id 应为生物标识符 在交易表中默认为交易者的实体类型

容器内容 ​

fill_container

{
    "function": "fill_container"
}

设置容器方块的内容 loot_table 从行为包根目录到战利品表文件的路径

需要loot_table否则就是普通物品 不能指向当前战利品表 适用于容器以及实体相关内容和方块

附魔功能 ​

交易附魔书 ​

enchant_book_for_trading

{
    "function": "enchant_book_for_trading"
}

交易表中已有文档说明

等级附魔 ​

enchant_with_levels使用附魔台逻辑为物品附魔，可选择允许宝藏附魔。

{
    "function": "enchant_with_levels",
    "levels": {
        "min": 15,
        "max": 21
    },
    "treasure": true
}

按照给定等级为书册附魔（如同附魔台） 与附魔台不同，不限制在30级，其他方面似乎相同 等级99999会生成极其强大的附魔书...几乎包含所有可能的附魔 treasure 启用该物品可能获得的宝藏附魔 布尔值，默认为false 如果为false，诅咒不可能出现；如果为true，则可能 levels 可以是数字或min/max对象 默认为0 可以是负数，但会被视为0

随机附魔 ​

enchant_randomly

{
    "function": "enchant_randomly"
}

随机选择附魔数量及其强度 treasure 启用该物品可能获得的宝藏附魔 布尔值，默认为false

装备附魔 ​