minecraft-bedrock-json-schemas/resource/entity/entity.json

{"$schema":"http://json-schema.org/draft-07/schema","$id":"blockception.minecraft.resource.entity","defaultSnippets":[{"label":"New entity","body":{"format_version":"${1:1.10.0}","minecraft:client_entity":{"description":{"identifier":"$2:${3:${TM_FILENAME/[\\.].*//}}","materials":{"default":"entity_alphatest"},"textures":{"default":"textures/entity/${3:${TM_FILENAME/[\\.].*//}}"},"geometry":{"default":"geometry.${3:${TM_FILENAME/[\\.].*//}}"},"render_controllers":["controller.render.default"]}}}}],"examples":[{"format_version":"1.10.0","minecraft:client_entity":{"description":{"identifier":"minecraft:entity","materials":{"default":"entity_custom"},"textures":{"default":"textures/entity/custom/entity"},"geometry":{"default":"geometry.entity"},"animations":{},"particle_effects":{},"scripts":{},"render_controllers":["controller.render.entity"],"spawn_egg":{"base_color":"#288483","overlay_color":"#2B7135"}}}}],"if":{"properties":{"format_version":{"type":"string","const":"1.8.0"}}},"then":{"$ref":"#/definitions/A"},"else":{"$ref":"#/definitions/F"},"definitions":{"B":{"description":"Minecraft 实体标识符。","examples":["namespace:entity_name"],"pattern":"^[0-9a-zA-Z:_\\.\\-]+$","title":"Entity Identifier","type":"string","defaultSnippets":[{"label":"New Identifier","body":"$1:$2"}]},"C":{"title":"Material","description":"实体或附件材质","type":"string","examples":["entity_static","entity_flat_color_line","entity_loyalty_rope","entity","opaque_block","opaque_block_color","opaque_block_color_uv2","alpha_block","alpha_block_color","entity_nocull","entity_change_color","entity_alphatest","entity_alphatest_one_sided","map","on_screen_effect","item_in_hand_entity_alphatest","item_in_hand_entity_alphatest_color","item_in_hand_entity_alphatest_one_sided_color","entity_alphablend","entity_alphablend_nocolor","guardian_ghost","player_spectator","entity_emissive","glow_squid","entity_emissive_alpha","entity_emissive_alpha_one_sided","entity_custom","item_in_hand","item_in_hand_multicolor_tint","map_decoration","map_marker","charged_creeper","item_in_hand_glint","entity_glint","entity_alphatest_glint","entity_alphatest_glint_item","entity_change_color_glint","entity_alphatest_change_color","entity_alphatest_change_color_glint","entity_alphatest_multicolor_tint","beacon_beam","beacon_beam_transparent","conduit_wind","entity_multitexture","entity_multitexture_color_mask","entity_multitexture_alpha_test","entity_multitexture_multiplicative_blend","entity_multitexture_alpha_test_color_mask","entity_lead_base","entity_multitexture_masked","moving_block","moving_block_seasons","moving_block_alpha_seasons","moving_block_alpha_single_side","moving_block_alpha","moving_block_double_side","moving_block_blend","entity_beam","entity_beam_additive","entity_dissolve_layer0","entity_dissolve_layer1","banner","banner_pole","agent","armadillo","armor","armor_leather","armor_enchanted","armor_leather_enchanted","armor_stand","arrow","axolotl","axolotl_limbs","bat","bat_v2","bed","bee","bell","blaze_head","blaze_body","boat","chalkboard","chest","chicken","chicken_legs","cow","creeper","dragon_head","dragon_head_glint","drowned","egg","elytra","elytra_glint","enchanting_table_book","ender_crystal","ender_dragon","enderman","enderman_invisible","endermite","eye_of_ender_signal","ender_pearl","evoker","fang","fireball","fireworks_rocket","fishing_hook","fox","frog","cat","clownfish","cod","conduit","pufferfish","salmon","tropicalfish","ghast","guardian","horse","horse_leather_armor","husk","husk_clothes","ravager","iron_golem","magma_cube","leash_knot","lingering_potion_enchanted","llama","llama_spit","minecart","mob_head","mob_head_glint","mooshroom","mooshroom_mushrooms","npc","ocelot","parrot","pig","hoglin","zoglin","shield","shield_glint","trident","trident_riptide","trident_glint","piston_arm","player","player_alphatest","polar_bear","panda","rabbit","sheep","shulker","shulker_box","shulker_bullet","sign","silverfish","silverfish_layers","skeleton","pillager","piglin","piglin_brute","goat","allay","warden","warden_bioluminescent_layer","chest_boat","slime","slime_outer","snowball","snow_golem","snow_golem_pumpkin","spider","spider_invisible","splash_potion_enchanted","squid","dolphin","phantom","phantom_invisible","stray","stray_clothes","strider","tadpole","turtle","camera","trial_spawner","vex","villager","villager_v2","villager_v2_masked","vindicator","wandering_trader","witch","wither_boss","wither_boss_armor","wither_skull","wolf","wolf_armor","xp_bottle","zombie","zombie_villager","zombie_villager_v2","zombie_villager_v2_masked","player_animated","experience_orb","sniffer","camel","pattern","pattern_glint","breeze","breeze_eyes","breeze_wind","breeze_wind_charge","bogged","bogged_clothes"]},"D":{"type":"string","title":"Molang","description":"Molang 定义。","format":"molang","examples":["query.variant","(1.0)","query.","variable.=;"],"defaultSnippets":[{"label":"New Molang","body":"$1"}]},"E":{"title":"Molang Number","description":"Minecraft 的 Molang 定义，结果为浮点数。","anyOf":[{"type":"string","minLength":0},{"type":"number"}],"examples":["(1.0)","(0.0)"],"defaultSnippets":[{"label":"New Molang","body":"$1"}]},"A":{"type":"object","title":"Actor Entity 1.8.0","description":"客户端实体定义。","additionalProperties":false,"required":["format_version","minecraft:client_entity"],"properties":{"format_version":{"title":"1.8.0 Format Version","type":"string","const":"1.8.0","description":"告诉 Minecraft 读取此文件时可以预期的数据格式类型的版本。"},"minecraft:client_entity":{"type":"object","additionalProperties":false,"title":"Client Entity","description":"用于客户端渲染、动画和模型的实体描述。","required":["description"],"properties":{"description":{"additionalProperties":false,"title":"Description","description":"用于客户端渲染、动画和模型的实体描述。","type":"object","required":["identifier"],"properties":{"animations":{"title":"Animations","description":"这些名称由动画控制器 JSON 使用。玩家可以引用原版 Minecraft 资源包中的动画，也可以创建自己的动画。自定义动画应该放在资源包根目录的 animation 文件夹中。","type":"object","minProperties":1,"examples":[{"basic":"controller.generic.basic"}],"additionalProperties":{"type":"string","description":"这些名称由动画控制器 JSON 使用。玩家可以引用原版 Minecraft 资源包中的动画，也可以创建自己的动画。自定义动画应该放在资源包根目录的 animation 文件夹中。","title":"Animation Reference","examples":["controller.","animation."]}},"animation_controllers":{"type":"array","minItems":1,"description":"动画控制器的引用。","title":"Animation Controllers","items":{"type":"object","description":"动画控制器集合。","title":"Animation Controllers","additionalProperties":{"type":"string","description":"动画引用。","title":"Animation Reference","examples":[{"basic":"controller.generic.basic"}]}}},"enable_attachables":{"type":"boolean","description":"未记录：启用附件功能。","title":"Enable Attachables"},"geometry":{"title":"Geometry","description":"在 `<resource pack>/models/` 中定义的模型引用。","type":"object","propertyNames":{"pattern":"[a-zA-Z0-9_\\.\\-]+"},"minProperties":1,"additionalProperties":{"type":"string","description":"模型引用。","title":"Geometry Reference"}},"hide_armor":{"type":"boolean","default":true,"title":"Hide Armor","description":"隐藏或显示可能的盔甲。"},"held_item_ignores_lighting":{"type":"boolean","default":false,"title":"Held Item Ignores Lighting","description":"这决定了实体持有的物品是否应该完全照亮渲染（如果为 true），或者根据周围光照。"},"identifier":{"type":"string","description":"实体标识符。","title":"Identifier","$ref":"#/definitions/B"},"materials":{"type":"object","additionalProperties":{"type":"string","description":"材质引用。","title":"Material","$ref":"#/definitions/C"},"description":"材质定义集合。","title":"Materials"},"min_engine_version":{"type":"string","pattern":"[0-9]+\\.[0-9]+\\.[0-9]+","description":"要使用的最低引擎版本。","title":"Minimum Engine Version"},"particle_effects":{"type":"object","minProperties":1,"additionalProperties":{"type":"string","description":"粒子引用。","title":"Particle"},"description":"键是必需的，需要与动画控制器中的所有其他键保持唯一。玩家可以引用原版 Minecraft 资源包中的粒子，也可以创建自己的粒子。自定义粒子应该放在资源包根目录的 particle 文件夹中。","title":"Particle Effects"},"particle_emitters":{"type":"object","minProperties":1,"additionalProperties":{"type":"string","description":"粒子发射器引用。","title":"Particle Emitter"},"description":"粒子发射器定义集合。","title":"Particle Emitters"},"render_controllers":{"type":"array","description":"玩家可以引用原版 Minecraft 资源包中的渲染控制器，也可以创建自己的渲染控制器。自定义渲染控制器应该放在资源包根目录的 textures 文件夹中。","title":"Render Controllers","minItems":1,"items":{"oneOf":[{"type":"string","title":"Render Controller","description":"单个渲染控制器定义。"},{"type":"object","additionalProperties":{"type":"string","description":"按条件激活的渲染控制器。","title":"Render Controller"}}]}},"scripts":{"additionalProperties":false,"type":"object","title":"Scripts","description":"指定变量以及要运行的动画/控制器的地方。","properties":{"pre_animation":{"type":"array","description":"在动画处理之前立即评估的客户端脚本。","title":"Pre Animation","items":{"pattern":";$","$ref":"#/definitions/D","description":"在动画期间要评估的客户端 Molang 变量。","title":"Pre Animation"}},"parent_setup":{"type":"string","description":"未记录：父级设置。","title":"Parent Setup","$ref":"#/definitions/E"},"scale":{"type":"string","description":"设置生物模型的缩放比例。","title":"Scale","$ref":"#/definitions/E"},"scalex":{"$ref":"#/definitions/E","title":"Scale X"},"scaley":{"$ref":"#/definitions/E","title":"Scale Y"},"scalez":{"$ref":"#/definitions/E","title":"Scale Z"}}},"sound_effects":{"title":"Sound Effects","description":"音效定义集合。","type":"object","minProperties":1,"additionalProperties":{"type":"string","description":"音效定义。","title":"Sound Effect"}},"spawn_egg":{"additionalProperties":false,"type":"object","description":"生成蛋图标外观的定义。","title":"Spawn Egg","dependencies":{"texture_index":["texture"],"base_colour":["overlay_color"],"overlay_color":["base_color"]},"examples":[{"base_color":"#FFFFFF","overlay_color":"#000000"},{"texture":"example_egg","texture_index":0}],"properties":{"base_color":{"type":"string","description":"蛋的基本颜色。","title":"Base Color","format":"color-hex","examples":["#FFFFFF"]},"overlay_color":{"type":"string","description":"蛋上斑点的颜色。","title":"Overlay Color","format":"color-hex","examples":["#FFFFFF"]},"texture":{"type":"string","description":"item_texture.json 中的纹理引用。","title":"Texture"},"texture_index":{"type":"integer","description":"纹理的索引。","title":"Texture Index","default":0}}},"textures":{"type":"object","additionalProperties":{"type":"string","description":"资源包中纹理的引用。","title":"Texture"},"description":"资源包中纹理的引用集合。","title":"Textures"}}}}}}},"G":{"title":"Format Version","description":"告诉 Minecraft 读取此文件时可以预期的数据格式类型的版本。","pattern":"^([1-9]+)\\.([0-9]+)\\.([0-9]+)$","type":"string","default":"1.21.60","examples":["1.21.50","1.20.80","1.20.40","1.19.0","1.12.0","1.10.0","1.8.0"],"defaultSnippets":[{"label":"New Format version","body":"1.${1|8,10,12,17,18,19,20|}.${3|2|0|}"}]},"F":{"type":"object","title":"Actor Entity 1.10.0","description":"客户端实体定义。","additionalProperties":false,"required":["format_version","minecraft:client_entity"],"properties":{"format_version":{"$ref":"#/definitions/G"},"minecraft:client_entity":{"type":"object","additionalProperties":false,"title":"Client Entity","description":"用于客户端渲染、动画和模型的实体描述。","required":["description"],"properties":{"description":{"additionalProperties":false,"title":"Description","description":"用于客户端渲染、动画和模型的实体描述。","type":"object","required":["identifier"],"properties":{"animations":{"title":"Animations","description":"这些名称由动画控制器 JSON 使用。玩家可以引用原版 Minecraft 资源包中的动画，也可以创建自己的动画。自定义动画应该放在资源包根目录的 animation 文件夹中。","type":"object","minProperties":1,"examples":[{"basic":"controller.generic.basic"}],"additionalProperties":{"type":"string","description":"这些名称由动画控制器 JSON 使用。玩家可以引用原版 Minecraft 资源包中的动画，也可以创建自己的动画。自定义动画应该放在资源包根目录的 animation 文件夹中。","title":"Animation Reference","examples":["controller.","animation."]}},"enable_attachables":{"type":"boolean","description":"是否启用附件功能。","title":"Enable Attachables"},"geometry":{"title":"Geometry","description":"在 `<resource pack>/models/` 中定义的模型引用。","type":"object","propertyNames":{"pattern":"[a-zA-Z0-9_\\.\\-]+"},"minProperties":1,"additionalProperties":{"type":"string","description":"模型引用。","title":"Geometry Reference"}},"queryable_geometry":{"title":"Queryable Geometry","description":"未记录。","type":"string"},"hide_armor":{"type":"boolean","default":true,"title":"Hide Armor","description":"隐藏或显示可能的盔甲。"},"held_item_ignores_lighting":{"type":"boolean","default":false,"title":"Held Item Ignores Lighting","description":"这决定了实体持有的物品是否应该完全照亮渲染（如果为 true），或者根据周围光照。"},"identifier":{"type":"string","description":"实体标识符。","title":"Identifier","$ref":"#/definitions/B"},"materials":{"type":"object","additionalProperties":{"type":"string","description":"材质引用。","title":"Material","$ref":"#/definitions/C"},"description":"材质定义集合。","title":"Materials"},"min_engine_version":{"type":"string","pattern":"[0-9]+\\.[0-9]+\\.[0-9]+","description":"要使用的最低引擎版本。","title":"Minimum Engine Version"},"particle_effects":{"type":"object","minProperties":1,"additionalProperties":{"type":"string","description":"粒子引用。","title":"Particle"},"description":"粒子定义集合。","title":"Particle Effects"},"particle_emitters":{"type":"object","minProperties":1,"additionalProperties":{"type":"string","description":"粒子发射器引用。","title":"Particle Emitter"},"description":"粒子发射器定义集合。","title":"Particle Emitters"},"render_controllers":{"type":"array","description":"渲染控制器定义集合。","title":"Render Controllers","minItems":1,"items":{"oneOf":[{"type":"string","title":"Render Controller","description":"单个渲染控制器定义。"},{"type":"object","additionalProperties":{"type":"string","description":"按条件激活的渲染控制器。","title":"Render Controller"}}]}},"scripts":{"additionalProperties":false,"type":"object","title":"Scripts","description":"指定变量以及要运行的动画/控制器的地方。","properties":{"animate":{"type":"array","title":"Animate","description":"要动画化的项目数组。","minItems":1,"items":{"oneOf":[{"type":"string","description":"要运行的单个动画或动画控制器。","title":"Animation (Controller)"},{"type":"object","minProperties":1,"maxProperties":1,"title":"Animation (Controller) Condition","description":"按条件运行的单个动画或动画控制器。","additionalProperties":{"oneOf":[{"type":"string","description":"Molang 条件。","title":"Molang"},{"type":"number","description":"混合权重。","title":"Blend Weight"}]}}]}},"initialize":{"type":"array","description":"在实体创建期间要评估的客户端 Molang 变量。","title":"Initialize","minItems":1,"items":{"pattern":";$","$ref":"#/definitions/D","description":"在实体创建期间要评估的客户端 Molang 变量。","title":"Initialize"}},"pre_animation":{"type":"array","description":"在动画期间要评估的客户端 Molang 变量。","title":"Pre Animation","items":{"pattern":";$","$ref":"#/definitions/D","description":"在动画期间要评估的客户端 Molang 变量。","title":"Pre Animation"}},"parent_setup":{"type":"string","description":"未记录：父级设置。","title":"Parent Setup","$ref":"#/definitions/E"},"scale":{"type":"string","description":"设置生物模型的缩放比例。","title":"Scale","$ref":"#/definitions/E"},"scalex":{"$ref":"#/definitions/E","title":"Scale X"},"scaley":{"$ref":"#/definitions/E","title":"Scale Y"},"scalez":{"$ref":"#/definitions/E","title":"Scale Z"},"should_update_bones_and_effects_offscreen":{"title":"Should Update Bones And Effects Offscreen","description":"如果此表达式返回除 0.0 以外的任何值，则即使实体在屏幕外，骨骼和效果仍将更新。","oneOf":[{"type":"boolean"},{"type":"string","$ref":"#/definitions/D"}]},"should_update_effects_offscreen":{"title":"Should Update Effects Offscreen","description":"如果此表达式或 `should_update_bones_and_effects_offscreen` 返回除 0.0 以外的任何值，则即使实体在屏幕外，效果仍将更新。","oneOf":[{"type":"boolean"},{"type":"string","$ref":"#/definitions/D"}]},"variables":{"title":"Variables","description":"需要应用特定设置的变量列表。目前，对于客户端，仅支持 `public`。","type":"object","minProperties":1,"propertyNames":{"pattern":"variable.[a-zA-Z_][a-zA-Z0-9_]*"},"additionalProperties":{"title":"Variable","description":"如果变量是公共的，其他生物可以读取它。有关详细信息，请参阅 molang `->` 运算符。","type":"string","enum":["public"]}}}},"sound_effects":{"title":"Sound Effects","description":"音效定义集合。","type":"object","minProperties":1,"additionalProperties":{"type":"string","description":"音效定义。","title":"Sound Effect"}},"spawn_egg":{"additionalProperties":false,"type":"object","description":"生成蛋图标外观的定义。","title":"Spawn Egg","dependencies":{"texture_index":["texture"],"base_colour":["overlay_color"],"overlay_color":["base_color"]},"examples":[{"base_color":"#FFFFFF","overlay_color":"#000000"},{"texture":"example_egg","texture_index":0}],"properties":{"base_color":{"type":"string","description":"蛋的基本颜色。","title":"Base Color","format":"color-hex","examples":["#FFFFFF"]},"overlay_color":{"type":"string","description":"蛋上斑点的颜色。","title":"Overlay Color","format":"color-hex","examples":["#FFFFFF"]},"texture":{"type":"string","description":"item_texture.json 中的纹理引用。","title":"Texture"},"texture_index":{"type":"integer","description":"纹理的索引。","title":"Texture Index","default":0}}},"textures":{"type":"object","additionalProperties":{"type":"string","description":"资源包中纹理的引用。","title":"Texture"},"description":"资源包中纹理的引用集合。","title":"Textures"}}}}}}}}}