玩法系统 Java 支持基岩版不适用；基岩版对应附加包

资源包

Resource Pack

资源包是 Java 版用于自定义游戏视觉和听觉资源的系统。它可以在不修改游戏代码的情况下替换或扩展纹理、模型、声音、语言、字体、着色器和其他客户端资源。

资源包是 Java 版独有条目；基岩版的同类内容通常通过附加包处理。多个资源包同时启用时，资源包列表越靠上的包优先级越高。

机制说明

资源包用于改变 Minecraft Java 版客户端读取到的资源，而不是直接修改游戏逻辑代码。它常用于替换方块和物品纹理、修改模型、替换声音、补充语言、调整字体、改变粒子纹理或加入渲染相关文件。

资源包可以是一个文件夹，也可以是一个 .zip 文件。全局资源包放在 .minecraft/resourcepacks 目录；世界指定资源包放在存档根目录的 resourcepacks 目录并命名为 resources.zip；服务器指定资源包通过 server.properties 的 resource-pack 下载链接下发。

游戏加载多个资源包时会按资源包列表顺序处理。列表上层资源包拥有更高优先级，可以覆盖下层资源包，也可以与下层资源合并；如果上层包显式排除某些资源，下层对应资源也可能被移除。

资源包根目录至少需要 pack.mcmeta 来声明名称描述和兼容格式。新格式使用 min_format 与 max_format 表示兼容范围；旧的 pack_format 与 supported_formats 已被弃用但仍用于兼容旧包。

资源包的主要内容位于 assets/<命名空间> 目录。minecraft 命名空间用于覆盖原版资源，自定义命名空间可服务于其他资源引用。不同子目录承载不同资源类型，例如 textures、models、lang、sounds、font、shaders 和 texts。

资源包格式版本会随 Java 版资源结构变化而更新。26.2 对应的格式版本已经到 88.0；制作或安装资源包时，需要优先核对资源包声明的格式范围是否覆盖当前游戏版本。

完整内容

使用方式

资源包可以在选项菜单的资源包界面中启用、禁用和排序。列表越靠上的资源包优先级越高，游戏会在加载时按优先级决定最终使用哪一份资源。

全局、世界指定和服务器指定资源包都可能出现在加载链里。世界指定或服务器指定资源包通常作为更高优先级资源加载，适合地图作者或服务器统一视觉、声音和语言体验。

全局资源包

放在 .minecraft/resourcepacks 目录中。
可以是子文件夹，也可以是 .zip 文件。
可以在资源包界面中手动启用、禁用或调整顺序。

世界指定资源包

把资源包命名为 resources.zip。
放入 <存档根目录>/resourcepacks。
进入该世界时作为高优先级资源包加载，玩家不能在该世界中禁用或调整它。

服务器指定资源包

在 server.properties 中通过 resource-pack 指定 .zip 下载链接。
玩家加入服务器时可选择是否下载并使用。
使用后会作为高优先级资源包加载。

默认与内置资源包

默认资源包提供原版外观资源，不能被禁用。
Programmer Art 还原纹理更新前的旧纹理和模型。
高对比度资源包为 GUI 提供高对比度纹理，也可通过辅助功能入口开启。

资源包结构

一个典型资源包根目录包含 pack.mcmeta、可选的 pack.png，以及 assets 目录。assets 下按命名空间划分资源，原版资源通常位于 assets/minecraft。

资源包不需要包含所有文件。只要放入需要替换或新增的资源，其他未定义资源会继续由低优先级资源包或默认资源包提供。

<资源包名称>/pack.mcmeta：资源包元数据，声明描述和兼容格式。
<资源包名称>/pack.png：资源包列表中的图标，可选。
<资源包名称>/assets/<命名空间>/textures：纹理资源目录。
<资源包名称>/assets/<命名空间>/models：模型目录。
<资源包名称>/assets/<命名空间>/lang：语言文件目录。
<资源包名称>/assets/<命名空间>/sounds 与 sounds.json：声音文件和声音事件定义。

制作与兼容要点

制作资源包时应从目标 Java 版的资源结构和格式版本开始核对。若资源包声明的格式范围低于或高于当前版本，游戏会给出兼容性提示，某些文件也可能因为路径变更而失效。

从 1.20.2 开始，资源包可以通过 overlays 为不同格式范围提供叠加资源，适合同一个资源包同时兼容多个游戏版本。1.21.9 之后，格式版本加入次要版本概念，pack.mcmeta 也改为使用 min_format 与 max_format。

机制图示

默认纹理与自定义资源包对比

左侧为默认纹理，右侧为 Rodrigo's Pack 8x 自定义资源包。

基础数据

分类

玩法系统

适用版本

Java 版资源包；基岩版对应附加包

使用位置

.minecraft/resourcepacks、世界 resourcepacks 目录、server.properties

加载规则

列表上层资源包优先覆盖、合并或移除下层资源

兼容要求

pack.mcmeta 需声明 min_format 与 max_format，旧包可能使用 pack_format

资源范围

纹理、模型、声音、语言、字体、粒子、着色器、文本、路径点样式等

当前格式版本

26.2 对应 88.0；安装前应核对目标 Java 版范围

补充说明

资源包不直接修改游戏逻辑，主要改变客户端资源读取结果

机制表与对照数据

资源包启用位置

类型	放置或配置位置	是否可调整	加载特点
全局资源包	.minecraft/resourcepacks 中的文件夹或 .zip 文件	可启用、禁用和排序	适用于本地客户端，资源包名称来自文件夹或 .zip 文件名
世界指定资源包	<存档根目录>/resourcepacks/resources.zip	进入该世界时不可禁用或排序	作为高优先级资源包加载，常用于地图自带资源
服务器指定资源包	server.properties 的 resource-pack 下载链接	玩家可选择是否下载使用	使用后作为高优先级资源包加载，名称显示为世界指定资源包
默认资源包	游戏自带资源	不可禁用，可与其他包共同参与优先级	提供原版纹理、模型、声音、语言等基础资源
内置资源包	游戏内置 Programmer Art 与高对比度资源包	可启用、禁用和排序	用于旧纹理风格或高对比度 GUI

根目录与关键文件

路径或文件	作用	要求	说明
pack.mcmeta	资源包元数据	通常必需	声明资源包描述和兼容格式范围，使用 JSON 格式
pack.png	资源包图标	可选	显示在资源包列表中；缺失或加载失败时使用未知资源包纹理
assets	资源根目录	按需要创建	承载所有命名空间资源
assets/<命名空间>	命名空间目录	按需要创建	minecraft 用于覆盖原版资源，其他命名空间用于自定义引用
overlays/<目录>	叠加资源包目录	按兼容策略创建	配合 pack.mcmeta 的 overlays 在不同格式版本中加载不同资源
.zip 根目录	压缩包结构	pack.mcmeta 应位于压缩包顶层	如果 pack.mcmeta 被多包一层目录，游戏通常无法识别资源包

assets 常见目录与文件

目录或文件	资源类型	常见用途	备注
atlases	纹理图集	控制纹理图集引用不同纹理	通常位于 assets/minecraft/atlases
blockstates	方块状态映射	决定方块状态使用何种模型	常与 models/block 配合
equipment	装备资源	定义装备模型层与纹理映射	用于装备外观资源
font	字体定义	修改已有字体或添加自定义字体	影响文本渲染
items	物品模型映射	决定物品使用何种模型	新版本物品模型选择入口
lang	语言文件	添加或修改本地化文本	未定义键会继续使用低优先级资源
models	烘焙模型	修改方块和物品形状、纹理绑定	常见子目录包括 block 与 item
particles	粒子纹理定义	控制粒子类型可用纹理	不能新增粒子类型或修改生成逻辑
post_effect	后处理管线	定义后处理渲染效果	属于着色器相关资源
sounds	声音资源	替换或新增 .ogg 声音文件	声音事件仍需配合 sounds.json
sounds.json	声音事件定义	定义或覆盖声音事件	位于 assets/minecraft/sounds.json 时可覆盖原版事件
shaders	着色器	修改游戏渲染方式	不包含后处理管线目录
texts	文本文件	闪烁标语、终末之诗、鸣谢名单等	包含 splashes.txt、end.txt、postcredits.txt、credits.json
textures	纹理资源	方块、物品、实体和 GUI 纹理	除元数据外通常为 .png
waypoint_style	路径点样式	定义定位栏指示器图标样式	用于拥有路径点样式的生物
gpu_warnlist.json	GPU 警告列表	按渲染器、版本或厂商匹配警告	用于渲染环境兼容提示
regional_compliancies.json	地区合规性警告	按系统地区定时弹出合规提示	例如游玩时间提示

pack.mcmeta 关键字段

字段	类型	状态	作用
pack.description	文本组件	必选	资源包列表中显示的描述，通常最多显示两行
pack.min_format	整数或整数数组	必选	资源包兼容的最低格式版本，单个整数等价于主要版本号
pack.max_format	整数或整数数组	必选	资源包兼容的最高格式版本，单个整数会把次要版本视为最大可能值
pack.pack_format	整数	已弃用	旧版资源包格式版本字段，为兼容旧包保留
pack.supported_formats	整数、数组或范围	已弃用	旧版用于声明资源包支持格式范围
overlays.entries	列表	可选	定义按格式版本叠加加载的资源包数据
overlays.entries.directory	字符串	叠加项必选	叠加资源包相对于根目录的路径，zip 包中也表示 zip 内路径
filter	对象	可选	可按命名空间和正则表达式忽略低优先级资源中的匹配内容

资源包内容类型

内容	可改变内容	不能直接改变内容	常见场景
纹理	方块、物品、实体、GUI 等纹理图像	方块或实体的实际行为	高清纹理、低清风格、主题材质
模型	方块和物品显示形状、纹理绑定	碰撞箱与核心逻辑	3D 物品、方块外观改造
声音	声音文件与声音事件指向	游戏事件本身	替换音效、沉浸式音频包
语言	本地化键对应文本	逻辑条件和游戏规则	改名、梗语言、翻译补丁
字体	文本渲染所用字体和符号	文本触发逻辑	像素字体、图标字体
粒子纹理	粒子可用的贴图	粒子类型、生成方式和着色逻辑	视觉风格调整
着色器与后处理	部分渲染管线和画面效果	游戏玩法规则	视觉滤镜、特殊画面效果
文本	闪烁标语、终末之诗、鸣谢名单等文本资源	进入这些界面的触发条件	菜单彩蛋、地图叙事文本

资源包格式版本

格式版本	适用 Java 版范围
1	1.6.1快照13w24a到1.8.9
2	1.9快照15w31a到1.10.2
3	1.11快照16w32a到1.13快照17w47b
4	1.13快照17w48a到1.14.4快照19w46b
5	1.15预发布版1.15-pre1到1.16.2预发布版1.16.2-pre3
6	1.16.2发布候选1.16.2-rc1到1.16.5
7	1.17快照20w45a到1.18快照21w38a
8	1.18快照21w39a到1.18.2
9	1.19快照22w11a到1.19.2
11	1.19.3快照22w42a到22w44a
12	1.19.3快照22w45a到1.19.4快照23w07a
13	1.19.4预发布版1.19.4-pre1到1.20快照23w13a
14	1.20快照23w14a到23w16a
15	1.20快照23w17a到1.20.1
16	1.20.2快照23w31a
17	1.20.2快照23w32a到1.20.2-pre1
18	1.20.2预发布版1.20.2-pre2到1.20.3快照23w41a
19	1.20.3快照23w42a
20	1.20.3快照23w43a到23w44a
21	1.20.3快照23w45a到23w46a
22	1.20.3预发布版1.20.3-pre1到1.20.5快照23w51b
24	1.20.5快照24w03a到24w04a
25	1.20.5快照24w05a到24w05b
26	1.20.5快照24w06a到24w07a
28	1.20.5快照24w09a到24w10a
29	1.20.5快照24w11a
30	1.20.5快照24w12a
31	1.20.5快照24w13a到1.20.5-pre3
32	1.20.5预发布版1.20.5-pre4到1.20.6
33	1.21快照24w18a到24w20a
34	1.21快照24w21a到1.21.1
35	1.21.2快照24w33a
36	1.21.2快照24w34a到24w35a
37	1.21.2快照24w36a
38	1.21.2快照24w37a
39	1.21.2快照24w38a到24w39a
40	1.21.2快照24w40a
41	1.21.2预发布版1.21.2-pre1到1.21.2-pre2
42	1.21.2预发布版1.21.2-pre3到1.21.3
43	1.21.4快照24w44a
44	1.21.4快照24w45a
45	1.21.4快照24w46a
46	1.21.4预发布版1.21.4-pre1到1.21.4
47	1.21.5快照25w02a
48	1.21.5快照25w03a
49	1.21.5快照25w04a
50	1.21.5快照25w05a
51	1.21.5快照25w06a
52	1.21.5快照25w07a
53	1.21.5快照25w08a到25w09b
54	1.21.5快照25w10a
55	1.21.5预发布版1.21.5-pre1到1.21.5
56	1.21.6快照25w15a
57	1.21.6快照25w16a
58	1.21.6快照25w17a
59	1.21.6快照25w18a
60	1.21.6快照25w19a
61	1.21.6快照25w20a
62	1.21.6快照25w21a
63	1.21.6预发布版1.21.6-pre1到1.21.7发布候选1.21.7-rc1
64	1.21.7发布候选1.21.7-rc2到1.21.8
65.0	1.21.9快照25w31a
65.1	1.21.9快照25w32a
65.2	1.21.9快照25w33a
66.0	1.21.9快照25w34a到25w34b
67.0	1.21.9快照25w35a
68.0	1.21.9快照25w36a到25w36b
69.0	1.21.9快照25w37a到1.21.10
70.0	1.21.11快照25w41a
70.1	1.21.11快照25w42a
71.0	1.21.11快照25w43a
72.0	1.21.11快照25w44a
73.0	1.21.11快照25w45a
74.0	1.21.11快照25w46a
75.0	1.21.11预发布版1.21.11-pre1到1.21.11
76.0	26.1快照26.1-snapshot-1
77.0	26.1快照26.1-snapshot-2
78.0	26.1快照26.1-snapshot-3
78.1	26.1快照26.1-snapshot-4
79.0	26.1快照26.1-snapshot-5
80.0	26.1快照26.1-snapshot-6
81.0	26.1快照26.1-snapshot-7
81.1	26.1快照26.1-snapshot-8到26.1-snapshot-9
82.0	26.1快照26.1-snapshot-10
83.0	26.1快照26.1-snapshot-11
84.0	26.1预发布版26.1-pre-1到26.1.2
85.0	26.2快照26.2-snapshot-1到26.2-snapshot-2
86.0	26.2快照26.2-snapshot-3
86.1	26.2快照26.2-snapshot-4
86.2	26.2快照26.2-snapshot-5到26.2-snapshot-6
87.0	26.2快照26.2-snapshot-7到26.2-snapshot-8
88.0	26.2预发布版26.2-pre-1到26.2

关键版本历史

Java 版	变化	影响
1.6.1 / 13w24a	加入资源包，用于取代纹理包	资源包系统成为 Java 版自定义资源的正式入口
1.7.2 / 13w36a	允许同时使用多个资源包	资源包优先级和叠加加载变得重要
1.8 / 14w07a	世界可以指定资源包	地图可自带资源体验
1.8.8	识别资源包版本并显示错误	pack_format 开始影响兼容提示
1.11 / 16w32a	要求资源包内文件名使用小写字母	跨平台路径兼容更严格
1.19 / 22w11a	加入 filter 字段	资源包可忽略低优先级资源中的匹配内容
1.20.2 / 23w31a	加入 overlays，支持跨多个游戏版本兼容	同一资源包可按版本范围加载不同资源
1.21.9 / 25w31a	格式版本引入次要版本并调整 pack.mcmeta 格式	min_format 与 max_format 成为新版兼容声明重点
26.2	格式版本达到 88.0	安装或制作资源包时应核对最新格式版本

站内关联词条

下列词条与当前机制直接相关，已优先关联到站内本地百科页面。

返回列表