匿名
未登录
中文
讨论
贡献
创建账号
登录
Minecraft基岩版开发Wiki
搜索
致编者:请牢记我们的域名
wiki.mcbe-dev.net
!
致编者:欢迎加入本Wiki的官方交流
QQ群
或
Discord服务器
!
基岩版1.19.31
现已发布!(
了解更多
)
Inner Core
现已支持Xbox模组联机!(
了解更多
)
如果您是第一次来到本Wiki,欢迎
注册一个账户
点击顶部的“编辑”或“编辑源代码”按钮即可编辑当前页面
请知悉:在不登录时也可以编辑和新建页面,但是您当前的IP地址会记录在编辑历史中
编辑“
附加包
”
来自Minecraft基岩版开发Wiki
命名空间
页面
讨论
更多
更多
语言
变体
不转换
简体
繁體
大陆简体
香港繁體
澳門繁體
大马简体
新加坡简体
臺灣正體
页面操作
阅读
编辑
历史
刷新
警告:
您没有登录。如果您做出任意编辑,您的IP地址将会公开可见。如果您
登录
或
创建
一个账户,您的编辑将归属于您的用户名,且将享受其他好处。
反垃圾检查。
不要
加入这个!
'''附加包(Add-on)'''是[[mcwikizh:Mojang|Mojang]]官方支持的一种能够改变游戏运行规则的文件。 附加包一般由[[资源包]]与[[行为包]]两部分构成。资源包储存了游戏中的[[声音|音效]]、[[字体]]、[[纹理|纹理文件]]、[[UI|UI文件]]、[[模型]]、[[动画]]、[[动画#渲染控制器|渲染]]、[[闪烁标语]]以及[[语言#语言文件|语言文件]];行为包储存了游戏中的[[实体]]、[[方块]]、[[物品]]、[[配方]]、[[战利品表]]、[[交易|交易列表]]、[[函数_(附加包)|函数]]、[[命令]]、以及[[生物生成规则]]。 ==版本控制== 附加包需要通过不同的版本号来决定相应部分的读取方式。 ===基版本=== {{Stub|section=2}} ===格式版本=== [[格式版本]]普遍存在于附加包中,它用于确定当前文件的读取方式,通常是由三位数字组成的字符串(例如{{cd|"format_version": "1.13.0"}}),有时又是数组。错误的格式版本可能会导致游戏无法正常读取该文件的内容,并抛出[[内容日志]]信息;错误的[[清单文件]]格式版本会导致游戏在附加包信息中抛出警告或直接无法读取。 ===附加包版本=== 附加包版本由附加包的作者自定义,它是清单文件中{{samp|header}}对象里的一个名为{{samp|version}}的数组,由三个整数组成(例如{{cd|"version": [1,0,0]}})。附加包版本定义了这个附加包的版本,它会在附加包被成功读取后显示到附加包清单信息界面中。 [[File:Manifest_Validation_Screen_Simplified.png|thumb|游戏内的清单信息界面。]] 它还会影响附加包的升级和依赖。 ===模块版本=== ==子包== '''子包(Subpack)'''用于为附加包添加可选的加载内容。 子包文件放置在附加包根目录下的{{samp|subpacks}}文件夹内,其中每个文件夹为一个子包,子包内的文件结构与该附加包的文件结构相同,加载了子包后游戏将把该子包中的内容覆盖原附加包的内容。例如在子包文件夹中新建一个{{samp|/textures/blocks}}路径并向其内添加一张名为{{samp|stone.png}}的图片,那么游戏将在加载了该子包后将其添加到原附加包中一并加载或覆盖原有的{{samp|stone.png}}贴图。下方举例了一个基本的子包结构: <div class="treeview"> *{{File|<''附加包''>.mcpack}} **{{File|manifest.json}} **{{File|pack_icon.png}} **{{File|subpacks|folder}} ***{{File|<''subpack_0''>|folder}} ****'''……''' ***{{File|<''subpack_1''>|folder}} ***{{File|<''subpack_2''>|folder}} ***{{File|'''……'''|folder}} **'''……''' </div> [[File:Pack_settings_screen_simplified.png|附加包的设置界面|thumb]] 添加了子包的附加包会在该附加包的选项中显示[[File:Ui_gear.png]]按钮,点击后会打开附加包设置界面,滑动分辨率{{sic}}滑块即可更改该附加包使用的子包。 ===语法=== 子包由[[清单文件]]定义并显示在该附加包的设置选项中。通过向清单文件中添加{{cd|subpacks}}字段可对子包进行定义。下方给出了示例及相关注释: <syntaxhighlight lang="json" line> { "format_version": 2, "header": { "description": "", "name": "example_pack", "uuid": "e2a8a535-de94-42bc-99b3-07b73c76adf5", "version": [ 1, 0, 0 ], "min_engine_version": [ 1, 16, 0 ] }, "modules": [ { "description": "", "type": "resources", "uuid": "bbb9e40d-c8a6-44cb-b50f-2a2d33801bf3", "version": [ 1, 0, 0 ] } ], "subpacks":[ { "folder_name":"subpack_0", //String类型,该子包的文件夹名称。 "name":"Low", //String类型,该子包在游戏子包设置界面中显示的名称。 "memory_tier":1 //Int类型,该子包所需内存,数字从小到大所需内存依次升高。 }, { "folder_name":"subpack_1", "name":"Medium", "memory_tier":2 }, { "folder_name":"subpack_2", "name":"High", "memory_tier":3 } ] //Array类型,可选,添加该字段后可定义该附加包的子包。 } </syntaxhighlight> ==导入== ===自动导入=== 附加包文件可被Minecraft识别<ref group="注">文件后缀仅决定该文件能否被Minecraft识别并导入,不能决定该文件的[[清单文件#包类型|包类型]]。包类型由[[清单文件]]中<code>"type"</code>的值决定。</ref>对应后缀并自动导入游戏。以下是Minecraft可识别的附加包文件后缀: {| class="wikitable collapsible" ! rowspan="2" | 包类型!! rowspan="2" |文件后缀<ref group="注">一般情况下,附加包作者都会根据包类型使用对应的文件后缀,这样更便于使用者分清文件的包类型,但并不一定使用表中列出的对应文件后缀。</ref> ! colspan="2" |<div style="padding:0em 12em 0em 12em; white-space:nowrap;">导入路径</div> |- !Win10版 !安卓版 |- |资源包 |<code>.mcpack</code> |{{samp|%LOCALAPPDATA%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang\resource_packs}} |{{samp|/sdcard/Android/data/com.mojang.minecraftpe/files/games/com.mojang/resource_packs}}{{note|name=legacy|{{verlink|1.18.0.21}}之前的路径: *资源包:{{samp|/sdcard/games/com.mojang/resource_packs}} *行为包:{{samp|/sdcard/games/com.mojang/behavior_packs}} *皮肤包:{{samp|/sdcard/games/com.mojang/skin_packs}} *世界模板:{{samp|/sdcard/games/com.mojang/world_templates}}}} |- |行为包 |<code>.mcpack</code> |{{samp|%LOCALAPPDATA%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang\behavior_packs}} |{{samp|/sdcard/Android/data/com.mojang.minecraftpe/files/games/com.mojang/behavior_packs}}{{note|name=legacy}} |- |附加包(含资源包和行为包)<ref group="注">资源包和附加包需以文件夹的形式放在附加包文件内,不能有多余嵌套文件夹。 <div class="treeview"> *{{File|<''pack_name.mcaddon''>|mcaddon}} **{{File|<''behavior_pack''>|folder}} ***{{File|manifest.json}} ***{{File|pack_icon.png}} ***…… **{{File|<''resource_pack''>|folder}} ***{{File|manifest.json}} ***{{File|pack_icon.png}} ***…… </div></ref> |<code>.mcaddon</code> |'''(内部文件分别为资源包和行为包的路径)''' |'''(内部文件分别为资源包和行为包的路径)''' |- |皮肤包 |<code>.mcpack</code> |{{samp|%LOCALAPPDATA%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang\skin_packs}} |{{samp|/sdcard/Android/data/com.mojang.minecraftpe/files/games/com.mojang/skin_packs}}{{note|name=legacy}} |- |世界模板 |<code>.mctemplate</code> |{{samp|%LOCALAPPDATA%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang\world_templates}} |{{samp|/sdcard/Android/data/com.mojang.minecraftpe/files/games/com.mojang/world_templates}}{{note|name=legacy}} |} 在Win10版中,双击文件即可启动游戏并自动导入;在安卓版中,点击文件打开为“其他”(在其他第三方文件管理器中称呼可能不同,例如:“更多”、“类型”等。),选择Minecraft图标即可启动游戏并自动导入。 自动导入可能会面临导入失败的问题,游戏会在导入后在屏幕顶部显示相关的提示信息。下方列出了可能遇到的问题及解决方案: *缺少[[清单文件]]:添加正确的清单文件即可。 *附加包重复:该版本的附加包已经导入过了,无需再次导入。若是更新附加包,则需将附加包版本(清单文件中<code>"version"</code>对象的值)调高。 *清单文件格式错误:检查清单文件格式。清单文件中<code>"type"</code>对象的值可能不正确,对照[[清单文件#包类型|包类型表]]将<code>"type"</code>对象的值修改正确。 *游戏版本不适配:清单文件中<code>"min_engine_version"</code>对象中填写的游戏版本号大于了当前游戏的版本,降级游戏或修改<code>"min_engine_version"</code>对象的值至适配版本即可。 ===手动导入=== 部分附加包可能存在命名不规范和文件结构不规范的问题,这往往会导致自动导入失败,此时我们需要手动导入。 附加包通常打包为一个修改了后缀的压缩文件。手动导入需我们先将文件解压(部分平台需要先将文件后缀改为<code>.zip</code>才能解压),然后将解压后的文件按照[[附加包#自动导入|上表]]放到对应文件夹即可。如果文件未压缩,则直接将文件放入对应文件夹。 除了通过文件后缀名来辨别包类型,我们还可以通过文件名来辨别。如果文件名中包含“BE”、“BEH”、“BP”、“behavior”等字样,则该文件多为行为包;如果文件名中包含“RE”、“RES”、“RP”、“resource”等字样,则该文件多为资源包。若无法通过文件名来辨别包类型,还可以通过包中的[[清单文件]](文件名:<code>manifest.json</code>)来辨别。打开<code>manifest.json</code>,找到对象<code>"type"</code>,其值决定了该包的类型。根据[[清单文件#包类型|包类型]]将文件放入对应文件夹即可。 {{notelist}} ==使用== 附加包导入游戏后,其中[[资源包]]可在设置的“全局资源”一栏找到(若资源包[[清单文件]]中<code>"pack_scope"</code>的值为<code>world</code>,则不会在此处显示)。在此激活的资源包将在整个游戏中使用,例如游戏主界面、单人存档、多人联机、服务器(多人游戏中如果[[服务端]]启用了“强制纹理”则资源包将无法生效)。 在世界设置中,“资源包”和“行为包”两栏分别可以设置该世界中使用的[[资源包]]和[[行为包]],设置后不会作用于除此世界外的其他地方。勾选“资源包”菜单中的“要求玩家接受资源包才能加入”选项可以使此世界只使用“资源包”菜单中激活了的资源包,而不会受“全局资源”中已激活的资源包的影响。 已导入的[[皮肤包]]会在[[mcwikizh:角色创建器|角色创建器]]中“经典皮肤”目录的“已拥有”一栏显示,玩家可以在此处选择并使用皮肤包中的皮肤。 点击世界列表菜单栏中的“新建”按钮,在“创建”菜单下方“导入的模板”处会显示已导入的[[世界模板]]。点击世界模板进入世界设置可创建该模板中的世界,若清单文件中<code>"lock_template_options"</code>的值为<code>true</code>,则“游戏选项”菜单将会被锁上,点击“解锁模板世界选项”按钮可将该菜单解锁,但修改模板世界设置可能会导致游戏体验不能到达作者预期效果。 游戏设置的“存储”菜单中列出了所有的附加包,在此处可以管理和查看已拥有附加包。 ==你知道吗== *不同的平台有不同的路径长度限制。算上包或世界的路径,平台会计算导入到Minecraft里的目录长度。如果长度超出限制,包会导入失败并且会变成无效状态。正因如此,我们建议:保持路径长度为70字符或更少,即从包或世界模板的根目录到一个文件的最长路径长度应该只能有70字符长。路径中的每一部分(目录或文件名)必须小于60字符。否则,一些平台将无法识别这一部分。 {{Minecraft}} {{ModFormat}} {{Navbox Addon}}
摘要:
请注意您对Minecraft基岩版开发Wiki的所有贡献都被认为是在知识共享署名-非商业性使用-相同方式共享下发布,请查看在
Minecraft基岩版开发Wiki:版权
的细节。如果您不希望您的文字被任意修改和再散布,请不要提交。
您同时也要向我们保证您所提交的内容是您自己所作,或得自一个不受版权保护或相似自由的来源。
请勿私自提交受版权保护的材料!
您也可以将取自Mojang(及其网站、说明、指南、艺术概念、渲染图、出版物、第三方网站组件,以及其他此类Mojang已对外公开的受保护材料)的内容上传至Minecraft基岩版开发Wiki。所有权力、署名与利益在合适时仍归属Mojang,也不依照许可被授权。
取消
编辑帮助
(在新窗口中打开)
本页使用的模板:
Template:Ambox
(
查看源代码
)(受保护)
Template:Cd
(
编辑
)
Template:Code
(
编辑
)
Template:File
(
编辑
)
Template:File/sprite
(
编辑
)
Template:Minecraft
(
编辑
)
Template:ModFormat
(
编辑
)
Template:Msgbox
(
查看源代码
)(受保护)
Template:Navbox Addon
(
编辑
)
Template:Note
(
编辑
)
Template:Notelist
(
编辑
)
Template:Samp
(
编辑
)
Template:Sic
(
编辑
)
Template:SimpleNavbox
(
编辑
)
Template:Stub
(
编辑
)
Template:Tag
(
编辑
)
Template:Verlink
(
编辑
)
Template:Version link
(
编辑
)
Module:Arguments
(
编辑
)
Module:Array
(
编辑
)
Module:Autolink
(
编辑
)
Module:Autolink/Block
(
查看源代码
)(受保护)
Module:Autolink/Earth
(
编辑
)
Module:Autolink/Glossary
(
编辑
)
Module:Autolink/Item
(
查看源代码
)(受保护)
Module:Autolink/Other
(
查看源代码
)(受保护)
Module:Category handler
(
编辑
)
Module:Category handler/blacklist
(
编辑
)
Module:Category handler/config
(
编辑
)
Module:Category handler/data
(
编辑
)
Module:Category handler/shared
(
编辑
)
Module:Message box
(
查看源代码
)(受保护)
Module:Message box/configuration
(
编辑
)
Module:Namespace detect/config
(
编辑
)
Module:Namespace detect/data
(
编辑
)
Module:No globals
(
编辑
)
Module:ProcessArgs
(
编辑
)
Module:Sprite
(
编辑
)
Module:Yesno
(
编辑
)
我们提供服务需要使用Cookie。您使用我们的服务,即表示您同意我们使用Cookie。
更多信息
确定
导航
导航
首页
最近更改
随机页面
社区门户
新闻动态
计划
沙盒
关于
导航
开发
附加包
模组SDK
ModPE Installer
BlockLauncher
Inner Core
ModdedPE
基岩版专用服务器
ElementZero
Cloudburst Nukkit
合作伙伴
Mineprogramming Wiki
bedrock.dev
友情链接
中文 Minecraft Wiki
我的世界中文论坛
MCDevs Wiki
Inner Core 中文社区
wiki工具
wiki工具
特殊页面
页面工具
页面工具
用户页面工具
更多
链入页面
相关更改
页面信息
页面日志
其他项目
变体
不转换
简体
繁體
大陆简体
香港繁體
澳門繁體
大马简体
新加坡简体
臺灣正體