手册:数据驱动

From Minecraft基岩版开发Wiki

< 行为包 | 查看行为包教程 >

实体[edit]

实体客户端文档[edit]

描述

名称 描述
identifier 实体(材质,纹理,模型等)的标识符。行为包中的实体行为json中对应的标识符为实体提供了行为。
min_engine_version 该实体可以被运行的最低游戏版本
materials 待补充
textures 该实体的纹理

示例:

         "textures": {
            "default": "textures/feibiao/iron_feibiao"
//后面是textures文件夹中路径
         }
animations 待补充
animation_controllers 待补充
scripts 待补充

示例:

"scripts": {
  "pre_animation": [
    "variable.ZRot = !query.is_in_water ? Math.cos((query.time_stamp + global.frame_alpha) * 14.32) * 90 : 0.0;",
    "variable.AnimationAmountBlend = Math.lerp(variable.AnimationAmountPrev, variable.AnimationAmount, global.frame_alpha);"
  ]
},

待补充

示例:

"scripts": {
  "scale": "0.35"
},
particle 待补充
render_controllers 该实体的渲染控制器

示例:

  "render_controllers": [
         "controller.render.translucence"
//填render_controllers文件夹中定义的
]


locators 待补充

示例:

"locators": {
  "lead": { "head": [ 0.0, 14.0, -6.0 ] }
}
enable_attachables 待补充

示例:

"enable_attachables": true
spawn_egg 待补充

16进制刷怪蛋示例:

"spawn_egg": {
  "base_color": "#53443E",
  "overlay_color": "#2E6854"

待补充

指定纹理刷怪蛋示例:

"spawn_egg": {
  "texture": "spawn_egg", 
  "texture_index": 2
}

实体服务端文档[edit]

AI

名称 描述
待补充 待补充

特性

名称 描述
待补充 待补充

内置事件

名称 描述
待补充 待补充

组件

名称 描述
minecraft:addrider 给该实体添加骑手,需要minecraft:rideable组件。
minecraft:admire_item 使生物在指定时间内无视攻击目标。
minecraft:ageable 添加一个用于实体成长的计时器。
minecraft:ambient_sound_interval 设置实体播放环境音效的延迟。
minecraft:angry 使用计时器定义该实体的“愤怒”状态。
minecraft:annotation.break_door 若旗标是为组件在寻路AI中使用而设置的,则允许活动对象破坏门。
minecraft:annotation.open_door 若旗标是为组件在寻路AI中使用而设置的,则允许活动对象打开门。
minecraft:area_attack 当实体进入范围时,造成伤害的组件。
minecraft:attack 定义一个实体的近战攻击和附加效果。
minecraft:attack_cooldown 为生物增加冷却时间,这个冷却时间的目的是用来防止实体试图获取新的攻击目标。
minecraft:barter 使组件能够将物品进行交换。
minecraft:block_sensor 当方块列表中的方块在传感器范围内被破坏时触发指定的事件。
minecraft:boostable 定义可骑乘实体提升的条件和行为。
minecraft:boss 使生物拥有boss血条。
minecraft:break_blocks 指定该实体在移动时可以破坏的方块。
minecraft:breathable 定义该实体可以呼吸的方块并给予它们窒息的能力。
minecraft:breedable 定义实体进入“发情”状态的方式。
minecraft:bribeable 定义实体进入“被诱骗”状态的方式。
minecraft:buoyant 使实体在指定的液体方块上漂浮。
minecraft:burns_in_daylight 使实体在阳光下自燃。
minecraft:can_climb 允许该实体攀爬。
minecraft:can_fly 设置实体为能够飞行,寻路时不会被限制在其路径下方需要固体方块。
minecraft:can_power_jump 允许实体像马那样进行蓄力跳跃。
待补充 待补充

实体定义属性

名称 描述
待补充 待补充

实体描述属性

名称 描述
待补充 待补充

触发器

名称 描述
待补充 待补充

生成规则[edit]

待补充

组件

名称 描述
待补充 待补充

过滤器[edit]

名称 描述
待补充 待补充

方块[edit]

属性[edit]

用于确定如何解析并初始化此方块。

类型
名称
默认值
描述
字符串 identifier 设置此方块的标识符。须包含命名空间但不得使用minecraft:作为命名空间
布尔值 register_to_creative_menu false 设置此方块是否出现在创造模式物品栏。(基岩版1.15.0至今由于不明原因导致此API失效,目前由minecraft:creative_category替代)
布尔值 is_experimental false 设置该方块是否为实验性的。实验性方块只能通过实验性玩法获得。

组件[edit]

基本组件[edit]

名称
描述
minecraft:block_light_absorption 设置此方块吸收的光照等级。对于冰块,它描述了冰块将在什么光照等级融化。
minecraft:block_light_emission 设置方块发出的光照等级。
minecraft:breakonpush 设置方块被活塞推动时,方块是否被破坏。
minecraft:breathability 设置该方块的透气性,以及是否将其视为固体或空气的属性。
minecraft:crafting_table 设置与方块互动时打开一个合成界面。
minecraft:creative_category 注册方块到创造模式物品栏及其分组。
minecraft:destroy_time 设置方块破坏所需时间。
minecraft:display_name 设置方块物品显示的悬浮文本。
minecraft:entity_collision 设置方块的实体碰撞箱。
minecraft:explosion_resistance 设置方块的爆炸抗性。
minecraft:flammable 设置方块的可燃性。
minecraft:friction 设置方块的摩擦力。
minecraft:geometry 设置方块模型。
minecraft:immovable 设置方块是否不能被活塞推动。
minecraft:loot 设置方块的掉落物。
minecraft:map_color 设置方块在地图上显示的颜色。
minecraft:material_instances 将模型文件中的面或渲染映射到实际的纹理。
minecraft:onlypistonpush 设置方块是否不会被粘性活塞拉动。
minecraft:part_visibility 设置方块在指定条件下显示部分模型。
minecraft:pick_collision 设置方块的选取碰撞箱。
minecraft:placement_filter 设置方块被放置时应满足的条件。
minecraft:preventsjumping 防止玩家在该方块上行走时跳跃。
minecraft:random_ticking 随机刻计时器。
minecraft:rotation 设置方块围绕方块中心的旋转角度。
minecraft:ticking 计划刻计时器。
minecraft:unit_cube 设置方块为单位方块。
minecraft:unwalkable 设置该方块是否不能被越过。

事件[edit]

名称
描述
add_mob_effect 给目标添加状态效果。
damage 对目标造成伤害。
decrement_stack 使物品数量递减。
die 清除目标。如果目标为self,并且这个事件由另一个方块执行,那么将摧毁该方块。
play_effect 产生相对于目标位置的粒子效果。
play_sound 在相对目标位置播放音频。
remove_mob_effect 将目标移除状态效果。
run_command 执行命令或命令列表。
set_block 将该方块设置为另一种方块。
set_block_at_pos 在相对于该方块的位置将一个方块设置为另一种方块。
set_block_property 设置该方块的属性。
spawn_loot 生成战利品。
swing 使活动对象摇晃。
teleport 将目标随机传送到目的地周围。
transform_item 将一个物品转换为另一个物品。

触发器[edit]

名称
描述
minecraft:on_fall_on 设置活动对象摔落到该方块上时执行的事件。
minecraft:on_interact 设置方块被右键后执行的事件。
minecraft:on_placed 设置方块被放置时执行的事件。
minecraft:on_player_destroyed 设置玩家破坏该方块时执行的事件。
minecraft:on_player_placing 设置玩家放置该方块时执行的事件。
minecraft:on_step_on 当玩家踩上该方块时执行的事件。
minecraft:on_step_off 当玩家离开该方块时执行的事件。

物品[edit]

属性[edit]

用于确定如何解析并初始化此物品。

组件[edit]

基本组件[edit]

名称 描述
minecraft:allow_off_hand
minecraft:animates_in_toolbar
minecraft:armor 设置物品给予的盔甲值。
minecraft:block
minecraft:block_placer 允许放置方块。
minecraft:camera
minecraft:can_destroy_in_creative 设置物品是否能在创造模式下破坏方块。
minecraft:cooldown 设置物品使用后的冷却时间。
minecraft:creative_category 注册物品到创造模式物品栏及其分组。
minecraft:damage 设置物品的攻击伤害。
minecraft:digger 设置物品的挖掘属性。
minecraft:display_name 设置物品的显示名称(允许使用本地化键名)。
minecraft:durability 设置物品的耐久度。
minecraft:dye_powder 设置可作为染料使用。
minecraft:enchantable
minecraft:entity_placer 设置生成指定实体。
minecraft:explodable 设置物品的实体形式是否可以被爆炸摧毁。
minecraft:foil 使物品拥有附魔光泽。
minecraft:food 设置物品为食物。
minecraft:frame_count
minecraft:fuel 物品的燃料组件。
minecraft:hand_equipped 设置物品是否以工具/武器的方式渲染(即手持时贴图竖直渲染)。
minecraft:hover_text_color
minecraft:icon
minecraft:icon_variant
minecraft:icon_atlas
minecraft:ignores_permission 待补充。
minecraft:knockback_resistance 物品的击退抗性。
minecraft:liquid_clipped
minecraft:max_stack_size
minecraft:mining_speed
minecraft:mirrored_art
minecraft:projectile 允许物品作为弹射物的物品形式。
minecraft:record
minecraft:render_offsets 设置物品的渲染偏移量。
minecraft:repairable 允许物品被修复。
minecraft:requires_interact
minecraft:seed
minecraft:shooter 允许物品被装填。
minecraft:should_despawn 设置物品的实体形式是否可以超时消失。
minecraft:stacked_by_data
minecraft:throwable 允许物品被投掷。
minecraft:use_animation 设置物品的使用动画。
minecraft:use_duration 设置物品的使用时间。
minecraft:weapon 显示物品伤害信息并添加攻击事件。
minecraft:wearable 允许物品被装备。

事件[edit]

名称 描述

触发器[edit]

名称
描述
minecraft:on_use 物品使用后触发事件。
minecraft:on_use_on 物品在方块上使用后触发事件。

配方[edit]

属性[edit]

定义配方的种类。系统将用于确定如何解析并初始化此配方。

名称 描述
minecraft:recipe_shaped 有序合成
minecraft:recipe_shapeless 无序合成
minecraft:recipe_furnace 烧炼配方
minecraft:recipe_brewing_container 酿造配方首次加工
minecraft:recipe_brewing_mix 酿造配方多次加工

交易表[edit]

待补充

战利品表[edit]

待补充

生物群系[edit]

待补充

Template:Navbox Addon