Corpus Viewer
Root / 礦藝大典 / raw / 附囊 / 附囊.txt
是篇之譯未成。
儻協而譯之，善也。顧宜親力親爲，器械與機巧僞智者不足取也。
模板:Relevant tutorial
「
總：附囊者，改礦藝之行也。八尺之雞？善！屍豕人軍？怪矣，然善！有餘力者，來覽此文。甚佳之物！
」
——Michael Ott
附囊（Add-on，俗謂附加包）者，基石版之入新、改現物者也，受持於魔贊也。
述
附加包允许玩家更改世界的纹理样貌、实体的模型、行为规则等，是实现全版本自定义（即数据驱动）的坚实一步。
行为包是一种用于改变实体的行为、掉落物、生成规则、物品合成配方与村民交易表等的附加包。行为包不仅可以改变现有内容，还可以创建新的实体、方块及物品。为了实现版本控制，基岩版的部分新内容便是以附加包形式实现的，这些附加包在选项内被统一归类为“原版附加包”而无法移除。强制移除它们会导致游戏出现图形或者崩溃问题。
资源包属于附加包的一部分，和行为包并列，同时区分原版资源包与自定义资源包。原版资源包用于为游戏加入新内容而准备。
除了玩家社区自定义的玩法外，基岩版市场中的地图也常常会使用附加包。市场中的内容均由Minecraft官方合作伙伴提供，并经内容团队审核。购买地图后，其所需要的所有附加包会在下载时被自动下载并添加到世界中。这些附加包依然可以被用于其他地图，但这始终取决于它的开发者是否允许。
附囊之用
资源包可以使用设置中的“”进行设置，也可使用“世界”设置中“附加包”的“资源包”选项进行设置。在游戏加载资源包时，会按照列表上的顺序依次加载它们的资源。上层资源包可以替代、合并或移除下层资源包的资源，因此资源包的位置顺序会影响游戏对某些资源的读取和使用。
全局資囊
在游戏内称为“”。全局资源包需要放置在 com.mojang内的 resource_packs或 development_resource_packs文件夹，每个全局资源包都必须是一个子文件夹或一个.zip文件，其他文件格式会被忽略。全局资源包可以被禁用、启用或者调整位置，亦可被世界禁用（详见下文）。
生界附囊
附加包可以与世界捆绑在一起。将这个文件放入世界文件夹中，这个附加包就会成为世界附加包。
当玩家进入这个世界时，世界资源包将作为最上层资源包被加载，且无法被禁用或调整位置。如果在世界设置启用了“”，则玩家还将被要求下载世界资源包，并禁用玩家的全局资源包。
玩家可以使用/packstack获取世界资源包、世界行为包和脚本模块列表。
伺服器指定資囊
与世界资源包类似，如果server.properties中的属性texturepack-required为true，则玩家将被要求下载世界资源包，并禁用玩家的全局资源包。
本之附囊
“”和“默认”分别是游戏内默认的资源包和行为包。它无法被禁用，且固定最先加载。
構
此篇闕訊：部分结构、部分包类型的结构
附囊之部也，有資囊、行囊、膚囊、生界模，諸多者，其構各異。附囊之效也，其根夾須納一效 manifest.json案。多附囊可合一。
資囊
資囊常貯 com.mojang中 resource_packs夾。
<資囊名抑其內部ID>
animation_controllers
animations
attachables
biomes
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
signatures.json
sounds.json
splashes.json
行囊
行囊常貯 com.mojang中 behavior_packs夾。
<行囊名抑其內部ID>
aim_assist
animation_controllers
animations
behavior_trees
biomes
blocks
cameras
dimensions
entities
feature_rules
features
functions
item_catalog
items
loot_tables
recipes
scripts
spawn_rules
structures
texts
language_names.json
languages.json
trading
worldgen
processors
structure_sets
structures
template_pools
contents.json
manifest.json
manifest_publish.json
pack_icon.png
signatures.json
文庫
基岩版附加包文档[敗鏈]
基岩版动画文档[敗鏈]
基岩版生物群系文档
基岩版方块文档
基岩版物品文档
基岩版实体文档
基岩版Molang文档
基岩版粒子文档
基岩版配方文档
基岩版模式文档
基岩版地物文档
基岩版脚本API文档
教章
基岩版开发指南
制作行为包
制作资源包
自定义物品
自定义方块
自定义实体
自定义音效
修改实体模型
樣板
資囊、行囊例
資囊、行囊例
脚本卯口例
是段中有基石版或成之事中物。
其或見於來日之版，然只今當啟「測版卯口」方得一見。
@minecraft/server-gametest樣例
@minecraft/server樣例
組件
宜新斯章。
然章所述，或違今版。
组件（Component）是基岩版附加包中自定义一个对象的重要手段，大部分可自定义的对象都可以由一些组件在JSON文件中拼接而成，这些组件在游戏内部通过ECS（Entity-Component-System，实体-组件-系统）架构被添加至自定义的对象上，并成为其属性的一部分。有一些自定义对象的组件较为特殊，但它们仍然在形式上或本质上是一种组件。比如实体的生成规则中的条件（Condition），其本质是一种组件。组件被分为很多种，除了比较特殊的条件之外，组件一般有最一般的基础组件、触发器、属性（Property）、特性（Attribute）、AI意向等。有些分类是因为其在游戏内部的本质不同，比如属性（Property）和特性（Attribute），有些分类则单纯是因为其表现有异。
物
基础组件
名称
可用性
实验性玩法
走出实验版本
描述
minecraft:allow_off_hand
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.20
允许物品装备在副手槽。
minecraft:armor
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
决定护甲物品的防护等级。
minecraft:block_placer
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.10
该物品在指定方块上可以放置出什么方块。
minecraft:bundle_interaction
可用
皮囊
1.21.40
为物品启用收纳袋的交互模式和物品提示。
minecraft:can_destroy_in_creative
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.10
设置挥舞此物品时是否能在创造模式下破坏方块。
minecraft:chargeable
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
设置物品为可蓄力物品。
minecraft:compostable
可用
即将推出的创作者功能
1.21.60
设置物品为可堆肥的。
minecraft:cooldown
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.10
设置物品的使用类型，并且设置使用后的冷却时间。
minecraft:creative_category
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
注册物品到创造模式物品栏及其分组。
minecraft:custom_components
已弃用
測版卯口
1.21.20
设置物品的自定义组件。
minecraft:damage
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.20
设置物品的攻击伤害。
minecraft:damage_absorption
可用
N/A
1.21.20
设置物品的伤害吸收值。
minecraft:digger
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.20
设置物品的挖掘属性。
minecraft:display_name
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.0
设置物品的本地化键名。
minecraft:durability
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.0
设置物品的耐久度。
minecraft:durability_sensor
可用
N/A
1.21.20
使物品在损伤时触发效果。
minecraft:dye_powder
可用
未明
未明
设置可作为染料使用。
minecraft:dyeable
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.21.30
设置物品为可被染色。
minecraft:enchantable
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.30
设置物品的附魔属性。
minecraft:entity_placer
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.0
设置生成指定实体。
minecraft:explodable
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
设置物品的实体形式是否可以被爆炸摧毁。
minecraft:food
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.30
设置物品为食物。
minecraft:frame_count
可用
未明
未明
设置物品的动画帧数。
minecraft:fuel
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.0
设置物品为燃料。
minecraft:glint
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.0
使物品拥有附魔光泽。
minecraft:hand_equipped
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.20
设置物品是否以工具或武器的方式渲染（即手持时贴图竖直渲染）。
minecraft:hover_text_color
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.10
设置物品悬浮文本的颜色。
minecraft:icon
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.0
设置物品的图标纹理。
minecraft:interact_button
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.30
设置物品的移动端HUD交互按钮。
minecraft:kinetic_weapon
可用
N/A
1.21.130
允许物品造成运动伤害及其效果。
minecraft:kinetic_weapon_kinetic_effect_conditions
可用
未明
未明
使用运动攻击武器的特定效果需要满足的条件。
minecraft:knockback_resistance
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
物品的击退抗性。
minecraft:liquid_clipped
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.20
设置物品是否可与流体互动。
minecraft:max_stack_size
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.10
设置物品的最大堆叠数量。
minecraft:mining_speed
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
设置物品挖掘速度。
minecraft:portfolio
可用
未明
未明
设置物品为公文包。
minecraft:projectile
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.10
允许物品作为弹射物的物品形式。
minecraft:rarity
可用
N/A
1.21.30
设置物品的稀有度。
minecraft:record
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.10
设置物品为唱片。
minecraft:render_offsets
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
设置物品的渲染偏移量。
minecraft:repairable
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.10
允许物品被修复。
minecraft:shooter
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.10
设置物品可被装填（即远程填装发射武器，例如弓）。
minecraft:should_despawn
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.20
设置物品的实体形式是否可以超时消失。
minecraft:stacked_by_data
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.20
是否根据数据值堆叠物品。
minecraft:storage_item
可用
皮囊
1.21.40
设置物品为可存储其他数据的物品。
minecraft:storage_weight_limit
可用
N/A
1.21.60
设置物品存储其他物品的最大容量。
minecraft:storage_weight_modifier
可用
N/A
1.21.60
设置物品在其他可存储物品内的占用容量。
minecraft:swing_duration
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.21.120
挖掘或攻击时播放的物品挥动动画的持续时间，以秒为单位。
minecraft:swing_sounds
可用
N/A
1.21.130
覆盖玩家发出的挥动音效。
minecraft:tags
可用
N/A
1.20.50
设置物品的标签。
minecraft:throwable
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.10
设置物品为投掷物。
minecraft:use_animation
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.20
设置物品的使用动画。
minecraft:use_modifiers
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.20
设置物品的使用时间。
minecraft:weapon
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
设置物品为武器。这会自动添加伤害信息和攻击事件。
minecraft:wearable
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.20.20
设置物品为装备。
觸發器
名称
可用性
实验性玩法
移出实验版本
描述
minecraft:on_use
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未移出
物品使用后触发事件。
minecraft:on_use_on
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未移出
物品在方块上使用后触发事件。
塊方
基础组件
名称
可用性
实验性玩法
走出实验版本
描述
minecraft:breakonpush
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
设置该方块被活塞推动时是否被破坏。
minecraft:breathability
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
设置该方块的透气性，以及是否将其视为固体或空气的属性。
minecraft:collision_box
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.19.50
设置方块的碰撞箱。
minecraft:crafting_table
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.19.50
设置与方块互动时打开一个合成界面。
minecraft:creative_category
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
注册方块到创造模式物品栏及其分组。
minecraft:custom_components
已弃用
測版卯口
1.21.20
设置方块的自定义组件。
minecraft:destructible_by_explosion
可用
N/A
N/A
设置方块是否可被爆炸破坏以及防爆属性。
minecraft:destructible_by_mining
可用
N/A
N/A
设置方块是否可被挖掘破坏以及破坏时间。
minecraft:destruction_particles
可用
即将推出的创作者功能
1.21.70
设置方块是否可被挖掘破坏以及破坏时间。
minecraft:display_name
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.19.60
设置方块物品显示的悬浮文本。
minecraft:embedded_visual
可用
即将推出的创作者功能
1.21.120
该方块嵌入其他方块时，用于渲染该方块的几何和材质的描述标识符。
minecraft:entity_fall_on
可用
測版卯口
1.21.20
设置实体必须从多高的高度摔落才能触发自定义方块组件的onEntityFallOn事件。
minecraft:flammable
可用
N/A
N/A
设置方块的可燃性。
minecraft:flower_pottable
可用
即将推出的创作者功能
1.21.120
表明方块可被放在花盆中。
minecraft:friction
可用
N/A
N/A
设置方块的摩擦力。
minecraft:geometry
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.19.40
设置方块模型。
minecraft:item_visual
可用
即将推出的创作者功能
1.21.60
设置在物品栏内渲染该方块的方法。
minecraft:immovable
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
设置该方块能否不被活塞推动。
minecraft:light_dampening
可用
N/A
N/A
设置方块减弱的光照强度。(调整方块的透光强度，如果不设置，默认为不透光)
minecraft:light_emission
可用
N/A
N/A
设置方块发出的光照强度。
minecraft:liquid_detection
可用
即将推出的创作者功能
1.21.60
设置方块在接触到液体后的表现。
minecraft:loot
可用
N/A
N/A
设置方块的掉落物。
minecraft:map_color
可用
N/A
N/A
设置方块在地图上显示的颜色。
minecraft:material_instances
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.19.40
将模型文件中的面或渲染映射到实际的纹理。
minecraft:movable
可用
即将推出的创作者功能
未走出
方块是否能被活塞推动。
minecraft:onlypistonpush
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
设置该方块是否不被黏性活塞拉动。
minecraft:part_visibility
已弃用
即将推出的创作者功能
未走出
设置方块在指定条件下显示部分模型。
minecraft:placement_filter
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.19.60
设置方块被放置时应满足的条件。
minecraft:preventsjumping
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
设置行动对象在该方块上行走时是否被阻止跳跃。
minecraft:precipitation_interactions
可用
未明
未走出
该方块如何与雨雪交互。
minecraft:queued_ticking
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
计划刻计时器。
minecraft:random_offset
可用
即将推出的创作者功能
未走出
允许方块贴图随机偏移。
minecraft:random_ticking
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
随机刻计时器。
minecraft:redstone_conductivity
可用
即将推出的创作者功能
1.21.30
设置方块的红石导体属性。
minecraft:redstone_producer
可用
即将推出的创作者功能
1.21.120
使该方块提供红石信号。
minecraft:replaceable
可用
N/A
1.21.70
设置方块是否可被别的方块顶替（像水或空气一样）。
minecraft:rotation
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
设置方块围绕方块中心的旋转角度。
minecraft:selection_box
可用
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
1.19.60
设置方块的击中箱。
minecraft:support
可用
即将推出的创作者功能
1.21.130
定义方块的支撑形状。
minecraft:tick
可用
測版卯口
1.21.20
设置方块更新频率并触发onTick事件。
minecraft:transformation
可用
N/A
1.19.80
设置方块的平移、旋转、缩放表现。
minecraft:unit_cube
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
设置方块为单位方块。
minecraft:unwalkable
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未走出
设置该方块是否不能被越过。
觸發器
名
可用性
实验性玩法
移出实验版本
描述
minecraft:on_fall_on
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未移出
设置活动对象摔落到该方块上时执行的事件。
minecraft:on_interact
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未移出
设置玩家与该方块互动（例如右键点击）时执行的事件。
minecraft:on_placed
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未移出
设置该方块被放置时执行的事件。
minecraft:on_player_destroyed
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未移出
设置玩家破坏该方块时执行的事件。
minecraft:on_player_placing
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未移出
设置玩家放置该方块时执行的事件。
minecraft:on_step_off
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未移出
当实体离开该方块时执行的事件。
minecraft:on_step_on
已移除
-{zh-cn:ddi_;zh-tw:;zh-hk:;}-
未移出
当实体踩上该方块时执行的事件。
實體
与物品和方块组件不同，一些实体组件通过JSON文件定义后会在游戏内部被挂接在实体实例上，并随实体一同保存至存档中。一些实体组件在JSON文件中可以通过分组的形式打包在一起，被称为实体的组件组（Component Group）。一个实体在世界中活动时，会通过某些逻辑向自己添加或移除一些组件组，并通过该方式更新自己的组件，这些添加和移除操作也会作为一个实体的定义一并存储在实体的存档中。
脚本卯口
是段中有基石版或成之事中物。
其或見於來日之版，然只今當啟「測版卯口」方得一見。
脚本API（Script API，简称SAPI），亦称脚本（Scripting），它允许用户编写一套程序化指令，使游戏在特定时间或响应事件时执行自定义行为。它可以控制实体、方块、物品，以及整个世界的特征等。脚本文件存储在附加包的scripts目录内。
脚本API为用户提供模块用于和游戏交互，每个模块都必须作为依赖添加在manifest.json中，以下是一些常用的模块：
名称
描述
@minecraft/common
提供一些通用的类、接口以及枚举，例如错误类。
@minecraft/server
提供与游戏内容的接口，使脚本可以控制实体、方块、物品，以及整个世界的特征。
@minecraft/server-ui
提供一些简单的UI接口。
@minecraft/server-net
提供HTTP相关接口。仅BDS可用。
@minecraft/server-gametest
提供有关游戏测试框架的接口以供用户测试脚本。
还有一些较为特殊的模块，这些模块需要从npm中导入，并且不内置在游戏中。这意味着它们可以被用在任意JavaScript项目中，但是在游戏中使用则需要打包。
名称
描述
@minecraft/math
提供一些与坐标相关的数学工具。
脚本API允许用户自定义命令。
史
此章似未完，宜善之。
攜帶版首測
〇點一五點〇
加入了资源包。游戏内有两个市场资源包，塑料资源包和城市资源包。
〇點一五點七
加入了自然资源包。
〇點一五點八
加入了魔幻资源包。
〇點一六點二
加入了卡通资源包。
攜帶版
一點〇點三
加入了糖果资源包。
基石版
一點一〇點〇
一點一〇點〇點三
资源包现在和世界模板分离，并能在现存世界中独立更新。
一點二一點一〇〇
一點二一點一〇〇點二二
将行为包目录 worldgen/jigsaw_structures重命名为 worldgen/structures。
參見
基石版算式
辅助程序与编辑器/资源包制作器
教章/製資附囊
他山
附加包反馈链接
在Minecraft.net上的附加包相关内容
在CurseForge上的附加包
在MCPEDL上的附加包
有关于不同种类的包的Minecraft.net博文贴
bedev:脚本API
參典
津渡