Minecraft Wiki

除另有声明,转载时均必须注明出处若簡繁轉換出錯,請以遊戲內為準请勇于扩充与修正内容有兴趣逛逛我们的微博沟通交流,欢迎到社区专页需要协助,请在告示板留言

了解更多

Minecraft Wiki
Advertisement
Information icon
此特性为基岩版独有。
Dark Oak Sapling
此条目仍需完善。

你可以帮助我们扩充关于该主题的更多信息。
原因:缺少历史段落

Minecraft.net Generic Enderman Avatar

一般来说,附加包基本就是一捆让你更改Minecraft世界运行规则的文件。想要身长八尺的小鸡?当然可以!想招募一支身着褶裙、听命于你的僵尸猪人大军?怪是够怪的,不过也可以!若你还想了解更多有关于附加包功能的示例,来看看我们的附加包单独页面。它们真的太给力了!

——Michael Ott[1]

附加包(Add-on)基岩版加入新内容或修改原有内容的一种手段,受Mojang官方支持。

概述[]

附加包允许玩家更改世界的纹理样貌、实体的模型、行为规则等,是实现Minecraft全版本自定义(即数据驱动)的坚实一步。

行为包是一种用于改变实体的行为、掉落物、生成规则、物品合成配方与村民交易表等的附加包。行为包不仅可以改变现有内容,还可以创建新的实体、方块及物品。为了实现版本控制,基岩版的部分新内容便是以附加包形式实现的,这些附加包在选项内被统一归类为“原版附加包”而无法移除。强制移除它们会导致游戏出现图形或者崩溃问题。

除了玩家社区自定义的玩法外,基岩版市场中的地图也常常会使用附加包。市场中的内容均由Minecraft官方合作伙伴提供,并经内容团队审核。购买地图后,其所需要的所有附加包会在下载时被自动下载并添加到世界中。这些附加包依然可以被用于其他地图,但这始终取决于它的开发者是否允许。目前并没有单独购买附加包的官方途径。

结构层次[]

附加包有行为包、资源包、皮肤包与世界模板等不同的形式,它们的结构层次也各不相同。要构成一个有效的附加包,这个文件夹的根目录必须包含一个有效的manifest.json文件。除此之外,其他文件或文件夹的存在与否与该附加包的功能相关。

资源包[]

资源包一般存储于com.mojang文件夹中的resource_packs文件夹。

  • 资源包名称或其内部ID
    • animation_controllers
    • animations
    • attachables
    • cameras
    • entity
    • fogs
    • font
    • items
    • library
    • materials
    • models
    • particles
    • render_controllers
    • sounds
      • music_definitions.json
      • sound_definitions.json
    • texts
      • language_names.json
      • languages.json
    • textures
      • flipbook_textures.json
      • item_texture.json
      • terrain_texture.json
      • textures_list.json
    • ui
    • biomes_client.json
    • blocks.json
    • bug_pack_icon.png
    • contents.json
    • loading_messages.json
    • manifest.json
    • manifest_publish.json
    • pack_icon.png
    • sounds.json
    • splashes.json

行为包[]

行为包一般存储于com.mojang文件夹中的behavior_packs文件夹。

  • 行为包名称或其内部ID
    • behavior_trees
    • entities
    • feature_rules
    • features
    • items
    • loot_tables
    • recipes
    • scripts
    • spawn_rules
    • structures
    • texts
      • language_names.json
      • languages.json
    • trading
    • contents.json
    • manifest.json
    • manifest_publish.json
    • pack_icon.png

文档索引[]

教程[]

  • 基岩版开发指南
  • 制作行为包
  • 制作资源包
  • 自定义物品
  • 自定义方块
  • 自定义实体
  • 自定义音效
  • 修改实体模型

模板[]

资源包和行为包实例[]

脚本API实例[]

Blue Beaker BE1
本段落包含基岩版实验性玩法中出现的内容。

这些内容可能会在未来版本中正式实现,但在当前版本中需要开启“测试版 API”选项才可使用。

组件[]

组件(Component)是基岩版附加包中自定义一个对象的重要手段,大部分可自定义的对象都可以由一些组件在JSON文件中拼接而成,这些组件在游戏内部通过ECS(Entity-Component-System实体-组件-系统)架构被添加至自定义的对象上,并成为其属性的一部分。有一些自定义对象的组件较为特殊,但他们仍然在形式上或本质上是一种组件。比如实体的生成规则中的条件(Condition),其本质是一种组件。组件被分为很多种,除了比较特殊的条件之外,组件一般有最一般的基础组件、触发器、属性(Property)、特性(Attribute)、AI意向等。有些分类是因为其在游戏内部的本质不同,比如属性(Property)和特性(Attribute),有些分类则单纯是因为其表现有异。

物品[]

基础组件
名称
可用性
实验性玩法
走出实验版本
描述
minecraft:allow_off_hand 可用 假日创作者功能 1.20.20 允许物品装备在副手槽。
minecraft:animates_in_toolbar 已移除 假日创作者功能 未走出 设置物品栏动画。
minecraft:armor 已弃用 假日创作者功能 未走出 决定护甲物品的防护等级。
minecraft:block_placer 可用 假日创作者功能 1.20.10 该物品在指定方块上可以放置出什么方块。
minecraft:can_destroy_in_creative 可用 假日创作者功能 1.20.10 设置挥舞此物品时是否能在创造模式下破坏方块。
minecraft:chargeable 可用 假日创作者功能 未走出 设置物品为可蓄力物品。
minecraft:cooldown 可用 假日创作者功能 1.20.10 设置物品的使用类型,并且设置使用后的冷却时间。
minecraft:creative_category 已弃用 假日创作者功能 未走出 注册物品到创造模式物品栏及其分组。
minecraft:damage 可用 假日创作者功能 1.20.20 设置物品的攻击伤害。
minecraft:digger 可用 假日创作者功能 1.20.20 设置物品的挖掘属性。
minecraft:display_name 可用 假日创作者功能 1.20.0 设置物品的本地化键名。
minecraft:durability 可用 假日创作者功能 1.20.0 设置物品的耐久度。
minecraft:dye_powder 可用 未知 未知 设置可作为染料使用。
minecraft:enchantable 可用 假日创作者功能 1.20.30 设置物品的附魔属性。
minecraft:entity_placer 可用 假日创作者功能 1.20.0 设置生成指定实体。
minecraft:explodable 已移除 假日创作者功能 未走出 设置物品的实体形式是否可以被爆炸摧毁。
minecraft:food 可用 假日创作者功能 1.20.30 设置物品为食物。
minecraft:frame_count 可用 未知 未知 设置物品的动画帧数。
minecraft:fuel 可用 假日创作者功能 1.20.0 设置物品为燃料。
minecraft:glint 可用 假日创作者功能 1.20.0 使物品拥有附魔光泽。
minecraft:hand_equipped 可用 假日创作者功能 1.20.20 设置物品是否以工具或武器的方式渲染(即手持时贴图竖直渲染)。
minecraft:hover_text_color 可用 假日创作者功能 1.20.10 设置物品悬浮文本的颜色。
minecraft:icon 可用 假日创作者功能 1.20.0 设置物品的图标纹理。
minecraft:icon_variant 可用 未知 未知
minecraft:icon_atlas 可用 未知 未知
minecraft:ignores_permission 已移除 假日创作者功能 未走出
minecraft:item_storage 可用 假日创作者功能 未走出 设置物品为收纳袋。
minecraft:interact_button 可用 假日创作者功能 未走出 设置物品的移动端HUD交互按钮。
minecraft:knockback_resistance 已移除 假日创作者功能 未走出 物品的击退抗性。
minecraft:liquid_clipped 可用 假日创作者功能 1.20.20 设置物品是否可与流体互动。
minecraft:max_stack_size 可用 假日创作者功能 1.20.10 设置物品的最大堆叠数量。
minecraft:mining_speed 已弃用 假日创作者功能 未走出 设置物品挖掘速度。
minecraft:mirrored_art 已移除 假日创作者功能 未走出 设置物品的纹理是否镜像翻转。
minecraft:portfolio 可用 未知 未知 设置物品为公文包。
minecraft:projectile 可用 假日创作者功能 1.20.10 允许物品作为弹射物的物品形式。
minecraft:record 可用 假日创作者功能 1.20.10 设置物品为唱片。
minecraft:render_offsets 已弃用 假日创作者功能 未走出 设置物品的渲染偏移量。
minecraft:repairable 可用 假日创作者功能 1.20.10 允许物品被修复。
minecraft:requires_interact 已移除 假日创作者功能 未走出
minecraft:shooter 可用 假日创作者功能 1.20.10 设置物品可被装填(即远程填装发射武器,例如弓)。
minecraft:should_despawn 可用 假日创作者功能 1.20.20 设置物品的实体形式是否可以超时消失。
minecraft:stacked_by_data 可用 假日创作者功能 1.20.20 是否根据数据值堆叠物品。
minecraft:throwable 可用 假日创作者功能 1.20.10 设置物品为投掷物。
minecraft:use_animation 可用 假日创作者功能 1.20.20 设置物品的使用动画。
minecraft:use_duration 可用 假日创作者功能 1.20.20 设置物品的使用时间。
minecraft:weapon 已弃用 假日创作者功能 未走出 设置物品为武器。这会自动添加伤害信息和攻击事件。
minecraft:wearable 可用 假日创作者功能 1.20.20 设置物品为装备。
触发器
名称
可用性
实验性玩法
走出实验版本
描述
minecraft:on_use 已弃用 假日创作者功能 未走出 物品使用后触发事件。
minecraft:on_use_on 已弃用 假日创作者功能 未走出 物品在方块上使用后触发事件。

方块[]

基础组件
名称
可用性
实验性玩法
走出实验版本
描述
minecraft:breakonpush 已移除 假日创作者功能 未走出
minecraft:breathability 已移除 假日创作者功能 未走出 设置该方块的透气性,以及是否将其视为固体或空气的属性。
minecraft:collision_box 可用 假日创作者功能 1.19.50 设置方块的碰撞箱。
minecraft:crafting_table 可用 假日创作者功能 1.19.50 设置与方块互动时打开一个合成界面。
minecraft:creative_category 已弃用 假日创作者功能 未走出 注册方块到创造模式物品栏及其分组。
minecraft:destructible_by_explosion 可用 N/A N/A 设置方块是否可被爆炸破坏以及防爆属性。
minecraft:destructible_by_mining 可用 N/A N/A 设置方块是否可被挖掘破坏以及破坏时间。
minecraft:display_name 可用 假日创作者功能 1.19.60 设置方块物品显示的悬浮文本。
minecraft:flammable 可用 N/A N/A 设置方块的可燃性。
minecraft:friction 可用 N/A N/A 设置方块的摩擦力。
minecraft:geometry 可用 假日创作者功能 1.19.40 设置方块模型。
minecraft:immovable 已移除 假日创作者功能 未走出
minecraft:light_dampening 可用 N/A N/A 设置方块减弱的光照强度。(调整方块的透光强度,如果不设置,默认为不透光)
minecraft:light_emission 可用 N/A N/A 设置方块发出的光照强度。
minecraft:loot 可用 N/A N/A 设置方块的掉落物。
minecraft:map_color 可用 N/A N/A 设置方块在地图上显示的颜色。
minecraft:material_instances 可用 假日创作者功能 1.19.40 将模型文件中的面或渲染映射到实际的纹理。
minecraft:onlypistonpush 已移除 假日创作者功能 未走出
minecraft:part_visibility 已弃用 即将到来的创作者功能 未走出 设置方块在指定条件下显示部分模型。
minecraft:placement_filter 可用 假日创作者功能 1.19.60 设置方块被放置时应满足的条件。
minecraft:preventsjumping 已移除 假日创作者功能 未走出
minecraft:queued_ticking 可用 假日创作者功能 未走出 计划刻计时器。
minecraft:random_ticking 可用 假日创作者功能 未走出 随机刻计时器。
minecraft:rotation 可用 假日创作者功能 未走出 设置方块围绕方块中心的旋转角度。
minecraft:selection_box 可用 假日创作者功能 1.19.60 设置方块的击中箱。
minecraft:unit_cube 可用 假日创作者功能 未走出 设置方块为单位方块。
minecraft:unwalkable 可用 假日创作者功能 未走出 设置该方块是否不能被越过。
触发器
名称
可用性
实验性玩法
走出实验版本
描述
minecraft:on_fall_on 可用 假日创作者功能 未走出 设置活动对象摔落到该方块上时执行的事件。
minecraft:on_interact 可用 假日创作者功能 未走出 设置玩家与该方块互动(例如右键点击)时执行的事件。
minecraft:on_placed 可用 假日创作者功能 未走出 设置该方块被放置时执行的事件。
minecraft:on_player_destroyed 可用 假日创作者功能 未走出 设置玩家破坏该方块时执行的事件。
minecraft:on_player_placing 可用 假日创作者功能 未走出 设置玩家放置该方块时执行的事件。
minecraft:on_step_off 可用 假日创作者功能 未走出 当实体离开该方块时执行的事件。
minecraft:on_step_on 可用 假日创作者功能 未走出 当实体踩上该方块时执行的事件。

实体[]

与物品和方块组件不同,一些实体组件通过JSON文件定义后会在游戏内部被挂接在实体实例上,并随实体一同保存至存档中。一些实体组件在JSON文件中可以通过分组的形式打包在一起,被称为实体的组件组(Component Group)。一个实体在世界中活动时,会通过某些逻辑向自己添加或移除一些组件组,并通过该方式更新自己的组件,这些添加和移除操作也会作为一个实体的定义一并存储在实体的存档中。

参见[]

参考[]

外部链接[]

语言

Advertisement