Corpus Viewer
Root / 礦藝大典 / raw / 資囊 / 資囊.txt
是文文辭，有欠雅正。請予斧正，一月爲期，殊深銘感。
This article is not written in Classical Chinese. Speedy deletion will be requested if it still has not been translated to Classical Chinese within a month.
此文章非文言，应在一个月之内翻译为文言，否则将会被删除。
此模板置於協調世界時丙午年四月初七日寅正三十二分（西曆二〇二六年五月二三日 （六） 〇四時三二分 (UTC)），請更易文辭，以免速刪。
此篇乃爪哇版獨有也。
資源包（Resource Pack）之制，允戲者自定遊戲內目之所見、耳之所聞，不須更易程式碼也。
用資源包
資源包可於「選項」菜單中之「資囊⋯」設之。遊戲載資源包時，依列表之序依次載其資源。上層之包可替、合、或去下層之包之資源，故包之順序影響遊戲讀取資源焉。
全域資源包
全域資源包須置於.minecraft內之resourcepacks文件夾。各全域資源包或為子文件夾，或為.zip檔，他類之檔則略而不載。包可廢、用、或調其序。包之名即為文件夾或.zip檔之名（含擴展名），可用格式化代碼飾之。
世界指定資源包
資源包可與世界相縛。易其名曰resources.zip，置於<存檔根目錄>/resourcepacks中，則此包即為世界指定資源包。
當戲者入此世界，此包將為最上層之包而載，不可廢、不可調序。其名顯為「資囊於此生界既定也」。
伺服器指定資源包
於伺服器屬性檔server.properties中，設resource-pack為一.zip檔之下載鏈接，即可定伺服器之資源包。戲者可擇用否，或不下載。
若擇用，此包將為最上層之包而載，不可廢、不可調序。其名顯為「資囊於此生界既定也」。
預設資源包
預置者，遊戲本然之貌也。不可廢，唯可調序。
內置資源包
遊戲內置二資源包，戲者可擇用、廢、或調序。
碼師之藝者，復紋理更新前之紋理及模型者也。其貌不隨版本而更。
分明者，為遊戲之圖形界面供高對比之紋理者也。此包亦可在輔助功能之設中啟之。
目錄之構
<資源包之名>：根目錄。
pack.mcmeta：資源包元數據。
pack.png：資源包圖標。
assets
<命名空間>
atlases：紋理圖集之檔也。
blockstates：方塊狀態映射之檔也。
equipment：裝備模型之檔也。
gpu_warnlist.json：GPU警告列表之檔也。
font：字體定義之檔也。
items：物品模型映射之檔也。
lang：語言之檔也。
models：烘焙模型之檔也。
particles：粒子紋理定義之檔也。
post_effect：後處理管線之程也。
regional_compliancies.json：地區合規性警告之檔也。
sounds：聲音資源之檔，皆當為.ogg也。
sounds.json：聲音事件定義之檔也。
shaders：著色器之檔，不包後處理管線。
texts：文本之目也。
textures：紋理資源之檔，除元數據外皆當為.png也。
waypoint_style：路徑點樣式之檔也。
資源包之本構
資源包元數據
資源包須具元數據，遊戲方可載而析之。元數據置於包之根目，名曰pack.mcmeta，用JSON之式，具下列之元素：
Pack.mcmeta
示例
如下乃pack.mcmeta示例：
模板:Pack.mcmeta
模板:Pack.mcmeta
模板:Pack.mcmeta
資源包格式之版
資囊/版
資源包圖標
資源包根目錄下可添pack.png為其圖標，此圖標將顯於選項菜單中之資源包列表。
遊戲讀包之時，圖標於戲內受一獨特之命名空間ID，其式為minecraft:pack/<去除非[a-z0-9-_./]之包名>/<包名之SHA-1散列字串>/icon。當遊戲導出動態紋理，則依此圖標檔之命名空間ID，以_代/及:，以此字串加後綴.png為導出紋理之名。
若包無圖標，或載圖標有誤，遊戲則用未知資源包紋理assets/minecraft/textures/misc/unknown_pack.png為此包之圖標。
資源包之內容
紋理圖集
資源包可改紋理圖集之內容，令遊戲引用他紋理。改紋理圖集之檔皆在assets/minecraft/atlases之目。
紋理
資源包內可定紋理多端，以改遊戲內方塊、物品、實體、界面之顯。紋理皆在assets/<命名空間>/textures之子目。
模型
烘焙模型可改方塊及物品之形與所附紋理。烘焙模型之檔在assets/<命名空間>/models內。
為定方塊或物品用何模型，遊戲有模型擇取之制：方塊之檔在assets/<命名空間>/blockstates，物品之檔在assets/<命名空間>/items。
裝備模型
裝備模型定各預設模型層用何紋理之映射，可改裝備之紋理。裝備模型之檔在assets/<命名空間>/equipment內。
字體
資源包可改既有之字體，亦增自定義字體，以變各處文本之渲染。字體皆在assets/<命名空間>/font之子目。
粒子
資源包可改粒子所用之紋理，然不能增粒子之新類，亦不能改其生成、著色等。特定ID之粒子類可用之紋理，由assets/minecraft/particles/<粒子類型ID>.json制之，其式如下：
：根對象
textures：此粒子類可用之紋理。
：（命名空間ID）一粒子紋理。
著色器
著色器者，資源包改遊戲渲染之法也，用OpenGL著色器語言（GLSL）書之，在assets/minecraft/shaders。
後處理管線亦為渲染之效，在assets/minecraft/post_effect。
聲音
資源包可改遊戲內之聲音及對應之聲音事件定義。資源包可定assets/minecraft/sounds.json以改原版之聲，亦可在assets/<命名空間>/sounds內改聲音之檔。
語言
資源包可增或改語言。語言之檔用以定翻譯文本，依下式定之：
JSON檔之根元素
<本地化鍵名>：定對應本地化鍵名之文本。
本地化鍵名者，遊戲讀文本所需之識別符也，常具一定命名之式。例如，遊戲讀石頭之名時，用block.minecraft.stone此本地化鍵名。假設當前語言環境為en_us，查語言檔後，遊戲可尋此鍵名對應之文本Stone，而以之為石頭之名。
各本地化鍵名對應之文本亦有格式之求。因文本或帶參數，故文本本身為格式化字串。其式可參Java文檔。然遊戲實未嘗用上述Java標準庫；若格式化字串內含%f或%d及帶序之形，遊戲載語言檔時，自動以s代此等格式字串中之f、d。故真正生效之格式字串，唯%s及%%及其帶序之形耳。遊戲不代他格式字串，然析此等字串時，將生TranslatableFormatException之異，報錯曰Unsupported format: '<格式字串>'。
若多資源包同有一語言檔，例如多包內皆有assets/minecraft/lang/en_us.json，則遊戲依包之序自上而下，取首個定某本地化鍵名之語言檔，以對應文本為終譯。若所有包內皆無此鍵名，遊戲徑以鍵名本身為譯文。此讀取之式，使資源包不必盡定所有本地化鍵名，唯定所需者即可，未定者自動用他包之文。
增一語言，須二步：
於資源包元數據中定所欲增之語言。
書對應之語言檔。
設於元數據中定zh_meme之語言，則須書assets/<命名空間>/lang/zh_meme.json語言檔。命名空間為何不影響語言之載，遊戲遍歷一切可能之命名空間以載語言檔。
鍵之除與易
除英語（美國）之語言檔外，遊戲自帶之語言檔以散列資源檔之形，在多版本間共之。為於各版本中擇正譯，各版客戶端檔中有一檔，在assets/minecraft/lang/deprecated.json，標此版中所替或所除之譯鍵。此檔非資源包所能易。其式如下：
根元素
removed：所除之鍵。
：該鍵之名。
renamed：所易之鍵。
<舊鍵名>：所易至之新鍵名。
載各語言檔時，遊戲先除removed中之鍵，然後依次易renamed中之各鍵名。易時，若舊鍵不在，縱新鍵已在，遊戲亦不用新鍵。
文本
在assets/minecraft/texts內有四檔，三為文本檔，一為JSON檔。遊戲自上而下掃資源包，取首遇之對應檔載之，下層之檔則略。
splashes.txt制遊戲之標題屏幕內之閃爍標語，內中每句標語以行分隔符分之。標語析時，自動去兩端之白字符，且可用格式化代碼飾文。若一句標語之哈希碼為125780783，則此句永不顯。
end.txt載終末之詩，即戲者初由末地入末地傳送門歸主世界時所顯之文。postcredits.txt載鳴謝名單顯畢後所現之引言。此二檔式同：文中所有PLAYERNAME皆代以當前戲者之名，且可用格式化代碼飾文。若一行之顯寬逾256，遊戲析時自動換行，以保不逾屏而顯。
credits.json載Minecraft之製作人員名單，具下式：
JSON檔根數組
：人員名單中之一部。
*section：此部之標題。
*disciplines：各部。
：一部之信息。
*discipline：部之名稱。
*titles：職位之列。
：職位列中之一職。
*title：此職之名。
*names：職員之列。
：一職員之名。
GPU警告列表
遊戲可查當前所用之渲染器，依assets/minecraft/gpu_warnlist.json判當否警戲者：當前渲染環境或不能全支Minecraft之渲染。此檔具下式：
JSON檔之根元素
*renderer：當渲染器之名匹配內中任一正則表達式，則遊戲示渲染器之警。
：一正則表達式。
*version：當渲染器之版匹配內中任一正則表達式，則遊戲示渲染器版之警。
：一正則表達式。
*vendor：當渲染器廠商之名匹配內中任一正則表達式，則遊戲示渲染器廠商之警。
：一正則表達式。
地區合規性警告
assets/minecraft/regional_compliancies.json者可依遊戲運行之時，定時彈窗。此檔具下構：
JSON檔之根元素
<ISO 3166-1三位字母地區代碼>：對指定之系統地區，定對應之定時彈窗。
：一彈窗之設。
delay：（預設0）初彈窗之遊戲運行時，以分計。
*period：彈窗之週期，以分計。
*title：彈窗標題之本地化鍵名。
*message：彈窗信息之本地化鍵名。
路徑點樣式
資源包可改及定路徑點樣式。生物有此樣式時，於定位欄上顯異指示器之圖標。路徑點樣式之檔在assets/<命名空間>/waypoint_style。
沿革
爪哇版
一點六點一
一三週二四甲
始加資源包，代紋理包之功。Mojang供Minecraft Texture Ender，以易1.5版之紋理包為資源包。
一點七點二
一三週三六甲
今可並用多資源包。
一三週四二甲
移assets/minecraft/music至assets/minecraft/sounds/music，assets/minecraft/sound中之檔亦移入assets/minecraft/sounds。
一點八
一四週〇七甲
今世界可指其所用之資源包。
一點八點八
預
今可識資源包之版而示誤。此時，資源包所需之版號為1。
一點九
一五週三一甲
因模型之制更（如加物品標籤謂詞、加Multipart、改顯示標籤），資源包版號改為2。
一五週四三甲
加聲事逾百五十，舊聲事亦易名。
一點一一
一六週三二甲
資源包版號改為3，令包內檔名皆用小寫。
一點一三
一七週四三甲
預設資源包今可如他包上下移序。
一七週四八甲
因扁平化，資源包版號改為4。
預三
包中textures/blocks之目易名為textures/block。
包中textures/items之目易名為textures/item。
一點一四
一八週四五甲
加「Programmer Art」內置包，可復紋理更新前之舊紋。
一九週〇六甲
顯增資源包載速。
一九週〇九甲
今粒子所用之紋理可由資源包改。
一點一五
預一
因前快照中旗幟圖案、盾牌、附魔光效與箱子等紋理機之改，資源包版號改為5。
一點一六
預五
加assets/minecraft/gpu_warnlist.json，以記GPU警告之列。
一點一六點二
候一
為解MC-197275，資源包版號改為6。
一點一七
二〇週四五甲
因部分紋理文件名之改，資源包版號改為7。
預一
assets/minecraft/texts中之credits.txt易為credits.json，式由純文易為有構之JSON。
一點一八
二一週三九甲
資源包版號改為8，蓋inventory.png今附一額外之圖，為物品欄中狀態效果列表之簡版。
一點一八點二
二二週〇六甲
加assets/minecraft/regional_compliancies.json，以制遊玩計時器及提示文，從韓國法之求（預設唯用於韓國）。
一點一九
二二週一一甲
於pack.mcmeta中加filter之欄，以依命名空間及正則表達式，略下層數據包中之匹配內容。
資源包版號改為9。
一點一九點三
二二週四二甲
資源包版號改為11。
去適於版號3及4（即扁平化前之版）之資源包之自動升級功，即遊戲不復試將此等版之包調為當版。
一點一九點四
預一
加「高對比」內置包，以增UI控件之對比。
一點二〇
二三週一七甲
改credits.json之式。
一點二〇點二
二三週三一甲
今資源包可與多遊戲版相容。
加疊加目錄之支，使同一包可於不同版載不同資源，須pack.mcmeta中之overlays部以定。
一點二一點二
二四週三三甲
加assets/minecraft/lang/deprecated.json，以標此版所棄及所易之譯鍵名。
一點二一點六
二五週一五甲
移部分生物之聲資源檔，由entity入mob之目。
二五週一七甲
加waypoint_style之目。
一點二一點九
二五週三一甲
為資源包版號加次版之概念，併改pack.mcmeta之式。
爾可知否
舊版預設資源包之pack.png取自Java版Alpha v1.2.2，種子3257840388504953787。
截圖在坐約X=49、Z=0，面向RX=-119.23、RY=-8.297處攝。
如何生完全相同之世並製完全相同之截圖：[一]。
其於2020年9月5日 4:04（UTC）為「Minecraft@Home」社之玩者所發。其時，去其發布已近十年矣。
未知資源包之紋理，用18w43a更新後至18w50a更新前之圓石紋也。
畫廊
參見
Tutorial:製資源包
輔助程序與編輯器/資源包製作器
引據
導航
模板:Navbox Java customizable