player.dat格式

此特性為Java版獨有。

<player>.dat檔案被用於伺服器以儲存玩家資訊。這種格式也在level.dat檔案中使用以儲存單人模式的狀態，它的優先級高於<player>.dat檔案。這些檔案都採用了NBT格式。

NBT結構[]

根標籤。在level.dat檔案裡，它叫作「Player」。
- 實體共通標籤
- 活體共通標籤
- abilities：玩家擁有的能力。可能不存在。
  - flying：表示玩家是否正在飛行。
  - flySpeed：飛行速度。
  - instabuild：表示玩家是否可以瞬間摧毀方塊。
  - invulnerable：表示玩家是否能抵消除虛空傷害所有傷害和有害的效果。（由/kill命令造成的傷害視為虛空傷害）
  - mayBuild：表示玩家是否可以摧毀及放置方塊。
  - mayfly：表示玩家是否能飛行。
  - walkSpeed：步行速度。
- DataVersion：數據版本。
- Dimension：玩家所處維度的命名空間ID。
- EnderItems：玩家的終界箱裡的物品。
  - ：終界箱裡的一個物品。
    - 物品共通標籤
- enteredNetherPosition：在玩家進入地獄時其在主世界的位置，用於進度觸發器minecraft:nether_travel中。在玩家每次從主世界透過地獄傳送門進入地獄時都會設定該標籤，通過傳送門返回主世界時不會移除或更新標籤。不使用傳送門進入地獄不會更新標籤。如果傳送門在終界，使用其進入地獄將移除標籤。可能不存在。
  - x：X座標。
  - y：Y座標。
  - z：Z座標。
- foodExhaustionLevel：玩家的飢餓等級。詳見飢餓條目。
- foodLevel：玩家的飢餓值，最大為20。
- foodSaturationLevel：玩家的飽食度。
- foodTickTimer：玩家的食物計刻器。
- Inventory：玩家的物品欄。其中欄位0-8代表快捷鍵槽，欄位9-35代表物品存放槽，欄位100-103代表靴、護腳、胸甲和頭盔，欄位150（表示為-106）代表非慣用手。
  - ：物品欄中的一個物品。
    - 物品共通標籤
- LastDeathLocation：玩家上次死亡的地點。
  - dimension：死亡地點的維度的命名空間ID。
  - pos：死亡地點的座標，用三個int代表XYZ座標。
- playerGameType：這個數據指明了玩家的遊戲模式。0表示生存模式，1指創造模式，2指冒險模式，3指旁觀模式。
- previousPlayerGameType：玩家的上一個遊戲模式，用於F3 + N在上一個模式和旁觀模式中切換。
- recipeBook：包含一個JSON對象，説明了玩家已解鎖的配方。
  - 詳見配方手冊#數據值。
- RootVehicle：玩家騎着的根實體。可能不存在。
  - Attach：玩家騎着的實體的UUID，以長度為4的整型陣列儲存。
  - Entity：玩家騎着的實體的NBT數據。
    - 詳見實體格式。
- Score：玩家在死亡畫面中顯示的分數。
- seenCredits：表示玩家是否曾透過返回傳送門前往主世界。
- SelectedItem：玩家正在選擇的快捷欄中的物品。只能透過/data來訪問，不會儲存。
  - 物品共通標籤
- SelectedItemSlot：玩家正在選擇的快捷欄。
- SleepTimer：自玩家開始睡覺之後經過的刻。控制繪製效果和貓給予禮物。
- ShoulderEntityLeft：玩家左肩上的實體。永遠顯示為一隻鸚鵡。
  - 詳見實體格式。
- ShoulderEntityRight：玩家右肩上的實體。永遠顯示為一隻鸚鵡。
  - 詳見實體格式。
- SpawnAngle：玩家的重生時的角度。
- SpawnDimension：玩家重生點所處的維度的命名空間ID。該標籤僅在玩家嘗試重生但沒有有效的牀或重生錨時移除。它不會因為玩家破壞了重生點或玩家的死亡被影響。可能不存在。
- SpawnForced：表示玩家是否將被強制復活在重生點上。可能不存在。
- SpawnX：玩家的重生點的X座標。如果玩家重生在一個無效的重生點時此標籤將被移除。重生點被破壞和玩家死亡不影響這些座標。可能不存在。
- SpawnY：玩家的重生點的Y座標。
- SpawnZ：玩家的重生點的Z座標。
- warden_spawn_tracker：追蹤該玩家在沉靈守衞生成機制中的進程。
  - cooldown_ticks：警吿等級能夠再次增加前的冷卻時間。每刻減少1。警吿等級增加後會被重設為200遊戲刻（10秒）。
  - ticks_since_last_warning：距玩家上次被沉靈守衞生成機制警吿後的刻數。每刻增加1。12000遊戲刻（10分）後會被重設為0，並將警吿等級減少1。
  - warning_level：警吿等級，位於0至3之間（含）。沉靈守衞會在第3級生成。
- XpLevel：玩家的經驗值。
- XpP：需增長多少經驗（百分數）才可升到下一級。
- XpSeed：附魔台選取附魔使用的隨機數種子。
- XpTotal：玩家所獲得的經驗總數，用於計算分數。

物品結構[]

物品結構可以用於玩家的物品欄和終界箱物品欄、儲物箱中的實體附加值、跌落物品實體、熔爐方塊實體、釀造台方塊實體和村民交易內容中。有時Slot標籤會被用來指定物品所在的欄位，例如在儲物箱中；在其他時候也可能會沒有Slot標籤，例如跌落的物品。

- Count：堆疊在目前物品欄中的物品數量。任何物品都能被堆疊，包括工具、盔甲、運輸工具。數值為1時不被遊戲顯示，小於1則在載入區塊或生成物品時變更為空氣。
- id：物品/方塊ID。若未指定，遊戲會在載入區塊或者生成物品時將其變更為空氣。
- Slot：目前物品所在的物品欄位。
- tag：關於目前物品的額外資訊，詳細內容請見物品結構章節。此標籤對於多數物品來説都是非必須項。

通用標籤[]

物品可以使用多個標籤控制其工具提示資訊，影響玩家屬性。這些標籤同樣記錄了物品的附魔和累積懲罰。對於有耐久的物品，下面的這些標籤可以記錄物品的損害值或使其無法破壞。

tag：父標籤。

- AttributeModifiers：包含了物品的屬性修飾符。它將修改佩戴者或持有者的屬性，如果物品不在 Slot指定的欄位上則不起效果。如果物品本身具有這些屬性，則此列表會覆蓋原物品的修飾屬性。
  - ：單個屬性修飾符。
    - Amount：計算中修飾符調整基礎值的數值。
    - AttributeName：此修飾符的屬性名稱，是一個命名空間ID。
    - Name：修飾符的名稱。
    - Operation：屬性修飾符的運算方法。
    - Slot：指定修飾符產生效果的欄位。值只能為mainhand（慣用手）、offhand（非慣用手）、head（頭盔）、chest（胸甲）、legs（護腳）或feet（靴）。如果此值不存在，則上述6個欄位上此屬性修飾符都可以發揮作用。
    - UUID：屬性的UUID，以4個32位元整數的形式儲存。
- CanDestroy：冒險模式的玩家可以使用這個物品破壞的方塊列表。
  - ：這個方塊的命名空間ID或標籤。
- CustomCreativeLock：無子標籤。在創造模式儲存的物品欄中擁有此標籤的物品將無法互動，但仍可透過快捷鍵儲存或載入到快捷欄，除此之外與正常物品沒有區別。此標籤預設附加到「已儲存的快捷欄」中代表沒有快捷欄資訊的紙物品上。
- CustomModelData：用於物品模型的覆蓋。見物品標籤述詞。
- Damage：物品的損害值。預設為0。
- display：物品顯示屬性。
  - color：物品的染色資訊，僅對皮革盔甲有實際作用。如果停用高級工具提示，則工具提示將顯示「已染色」，否則將顯示十六進制顏色值。顏色值可以用以下公式計算：紅色值 × 65536 + 綠色值 × 256 + 藍色值 × 1。
  - Lore：物品顯示的資訊。
    - ：一行顯示資訊，是一個JSON文字。
  - Name：物品的名稱，是一個JSON文字。
- Enchantments：包含影響物品特徵的附魔資訊。
  - ：一條附魔。
    - id：附魔的命名空間ID。
    - lvl：附魔的等級，1表示等級1。讀取時會將數值限定到0至255之間（含邊界）。
- HideFlags：決定隱藏顯示物品的哪些資訊，以按位或二進制進行儲存。1代表隱藏 Enchantments的附魔資訊，2代表隱藏 AttributeModifiers的屬性修飾符資訊，4代表隱藏 Unbreakable的無法破壞資訊，8代表隱藏 CanDestroy的可破壞方塊資訊，16代表隱藏 CanPlace的可放置方塊資訊，32代表隱藏其他附加資訊，64代表隱藏 display.color的染色資訊，128代表隱藏 Trim的盔甲紋飾資訊。當此值為255時，所有附加資訊都不顯示。
- RepairCost：當在鐵砧上修理、合併或重新命名目前物品時，表示在基礎等級消耗之上額外增加的附魔等級。
- Trim：盔甲紋飾，如果物品不是盔甲則這個標籤沒有作用。
  - material：材料的命名空間ID。
  - pattern：盔甲紋飾的命名空間ID。
- Unbreakable：表示物品是否無法破壞。

方塊標籤[]

方塊可以被賦予標籤指定冒險模式的玩家可以放在哪些方塊上面，並且可以指定放置時附加上哪些方塊實體標籤。

tag：父標籤。

- CanPlaceOn：冒險模式的玩家可以將方塊放置在其表面的方塊。
  - ：這個方塊的命名空間ID或標籤。
- BlockEntityTag：方塊放置後應用的方塊實體的NBT標籤。可以透過在創造模式下按住ctrl（mac上為⌘ Cmd）並按下選取方塊鍵來取得擁有方塊實體標籤的方塊物品。對於指示牌、講台、命令方塊和生成籠，由於安全問題，非管理員權限或非創造模式的玩家放置這些方塊時此標籤數據不會寫入方塊實體中。
  - 對應方塊的方塊實體的標籤，不包含方塊實體共通標籤。
- BlockStateTag：方塊放置後應用的方塊屬性。
  - <一項方塊屬性>：設定方塊屬性的鍵值對。例如facing:east。

盔甲紋飾[]

盔甲的紋飾數據。

tag：父標籤。

- Trim：紋飾盔甲的屬性。
  - material：盔甲紋飾的材料，決定了紋飾的顏色。
  - pattern：紋飾圖案。

盔甲座、物品展示框和生成蛋[]

盔甲座、物品展示框和生成蛋可能包含內部實體的數據。

tag：父標籤。

- EntityTag：儲存了建立實體時應用於實體上的實體數據。對於掉落的方塊、命令方塊礦車和生成籠礦車，由於安全問題，非管理員權限玩家使用物品生成實體時此標籤內數據不會寫入到生成的實體中。
  - 參見實體格式。

收納袋[]

收納袋使用NBT標籤儲存收納袋中收納的物品。

tag：父標籤。

- Items：收納袋內物品的列表。
  - ：一個物品。
    - 物品共通標籤

指南針[]

指南針使用NBT格式儲存可能存在的磁石指南針相關的數據。

tag：父標籤。

- LodestoneDimension：磁石指南針指向的座標的所在維度。
- LodestonePos：磁石指南針指向的座標。
  - X：X座標。
  - Y：Y座標。
  - Z：Z座標。
- LodestoneTracked：表示指南針是否綁定在一個磁石上。為false時，當磁石被破壞後 LodestoneDimension和 LodestonePos不會被自動移除，指南針仍然指向該位置。

弩[]

弩使用NBT標籤儲存弩中裝載的物品。

tag：父標籤。

- Charged：表示弩是否已被裝填。
- ChargedProjectiles：弩裝填的物品。每個物品的堆疊數量會被忽略，在弩發射時會全部被清除。
  - ：裝填的物品。
    - 物品共通標籤

除錯棒[]

除錯棒使用NBT格式儲存對每個方塊編輯的方塊狀態。

tag：父標籤。

- DebugProperty：除錯棒編輯的方塊和其狀態的列表。
  - <方塊的命名空間ID>：方塊和此方塊將要修改的屬性的鍵值對。例如"minecraft:grass_block":"snowy"。

附魔書[]

附魔書使用NBT標籤儲存內部含有的附魔。

tag：父標籤。

- StoredEnchantments：附魔書儲存的附魔。
  - ：一條儲存着的附魔。
    - id：附魔的命名空間ID。
    - lvl：附魔的等級，1表示等級1。讀取時會將數值限定到0至255之間（含邊界）。

煙花球[]

煙花球儲存有關其效果的資訊。

tag：父標籤。

- Explosion：一個煙火樣式，來自煙花球。
  - Colors：表示爆裂時的粒子顏色。如果自訂顏色代碼被使用，遊戲將在提示框中顯示為「自訂」，不過爆裂時會產生正確的顏色。
  - FadeColors：表示爆裂後的淡化粒子顏色。
  - Flicker：表示煙火是否出現閃爍效果（使用螢石粉合成時）。
  - Trail：表示煙火是否有拖曳痕跡（使用鑽石合成時）。
  - Type：爆裂時的形態。0 = 小型球狀、1 = 大型球狀、2 = 星形、3 = 苦力怕形、4 = 爆裂。其他值將會被認定為未知，均為小型球狀。

煙花[]

煙花儲存有關其效果的資訊。

tag：父標籤。

- Fireworks：煙花的參數。
  - Flight：煙花的飛行的時間，單位為「火藥」（即表現為和在工作台上合成煙花時所用的火藥數相等），預設為0b。注意：這個標籤的取值範圍比工作台大得多，最大是127b，更大的值將會變為-128 + 其與128的差，結果大於-1的將強制變為-1，比如128變為-128，200變為-56，512變為-1。如果值為-2b或更小（包括上文提到的，「轉換」過後的值），煙花看上去基本不會飛行。
  - Explosions：包含煙花包含的每個爆裂的複合標籤列表。
    - ：一個煙火樣式，來自煙花球。
      - Colors：表示爆裂時的粒子顏色。如果自訂顏色代碼被使用，遊戲將在提示框中顯示為「自訂」，不過爆裂時會產生正確的顏色。
      - FadeColors：表示爆裂後的淡化粒子顏色。
      - Flicker：表示煙火是否出現閃爍效果（使用螢石粉合成時）。
      - Trail：表示煙火是否有拖曳痕跡（使用鑽石合成時）。
      - Type：爆裂時的形態。0 = 小型球狀、1 = 大型球狀、2 = 星形、3 = 苦力怕形、4 = 爆裂。其他值將會被認定為未知，均為小型球狀。

魚鐵桶[]

魚鐵桶可能包含內部實體的數據。

tag：父標籤。

- BucketVariantTag：鐵桶中熱帶魚的種類數據。僅用於熱帶魚鐵桶。
- Glowing：表示鐵桶中魚是否發光。
- Health：鐵桶中魚的生命值。
- Invulnerable：表示鐵桶中魚是否對除虛空傷害外的傷害免疫。
- NoAI：表示鐵桶中魚的AI是否被停用。
- NoGravity：表示鐵桶中魚是否不受重力影響。
- Silent：表示鐵桶中魚是否不會發出任何聲音。

山羊角[]

山羊角使用NBT標籤儲存種類。

tag：父標籤。

- instrument：山羊角的種類。

知識之書[]

知識之書使用NBT標籤儲存內部的配方數據。

tag：父標籤。

- Recipes：知識之書中包含的所有配方。
  - ：配方的命名空間ID，例如minecraft:gold_nugget或minecraft:gold_ingot_from_nuggets。

地圖[]

地圖儲存了對應地圖的資訊。

tag：父標籤。

- Decorations：地圖上顯示的圖示。在重新載入世界之前，刪除或修改的圖示不會被更新。
  - ：一個圖示。
    - id：識別圖示的隨機唯一字串。
    - type：要顯示的地圖圖示的ID。
    - x：圖示在世界上所在的X座標。
    - z：圖示在世界上所在的Z座標。
    - rot：圖示的旋轉角度，範圍從0.0到360.0，方向為順時針。與圖示紋理中的外觀相比，旋轉角度為0.0所顯示的圖示上下顛倒。
- display：物品顯示屬性。
  - MapColor：物品欄內地圖紋理上的顏色。
- map：地圖編號。
- map_scale_direction：地圖縮放等級，僅在縮放地圖時由內部使用，之後直接刪除。如果強制設定此值，將改變工具提示中的比例尺和等級資訊。
- map_to_lock：表示此地圖是否已經鎖定，僅在鎖定地圖時由內部使用，之後直接刪除。如果強制設定此值，將改變工具提示中的鎖定資訊。

藥水效果[]

藥水、飛濺藥水、滯留藥水和藥水箭可以透過custom_potion_effects標籤擁有多個自訂效果。如果存在，這些效果將加入到Potion標籤內的預設效果中。此外，可以使用custom_potion_effects標記設定藥水顏色。

tag：父標籤。

- custom_potion_effects：目前藥水或藥水箭所含有的自訂狀態效果。從此標籤獲得效果的藥水或藥水箭會分別被命名為「水樽」或「飛濺之箭」。
  - ：一項效果
    - 狀態效果
- Potion：藥水效果。
- CustomPotionColor：目前物品使用這項自訂顏色，範圍效果雲、箭、噴濺與滯留藥水會使用該值作為其粒子效果顏色。但是，此顏色不會延伸到最終受到該效果作用的實體放出的粒子顏色。數字顏色代碼由紅綠藍組分透過下列算式計算：紅<<16 + 綠<<8 + 藍。對於大於0x00FFFFFF的正值，最高字節會被略去。所有的負值都表示白色。

盾牌[]

盾牌儲存了加入在其上的橫額的資訊。

tag：父標籤。

- Base：盾牌的底色。
- BlockEntityTag：盾牌上加入的橫額的資訊。
  - 見橫額的方塊實體格式。

玩家頭顱顱[]

玩家的頭顱可以被一名指定使用者名稱的玩家的外觀頭顱取代。僅在手持該物品時會隨着這名玩家的外觀改變而改變。在此部分中，一個頭顱的「所有者」表示被取得其頭顱的玩家，「持有者」表示在物品欄內擁有頭顱的玩家。

tag：父標籤。

- SkullOwner：玩家名稱或一個玩家配置資訊標籤。當儲存時，玩家名稱會自動解析為玩家配置資訊標籤。
  - Id：（可選）擁有者的UUID。
  - Name：（可選）擁有者的使用者名稱。
  - Properties：玩家配置屬性。
    - textures：玩家紋理屬性。
      - ：一個獨立的紋理。
        Signature： Value使用「Yggdrasil」私鑰的簽名後得到的Base64字串。可能不存在。
        
        Value：Base64字串，其中包含玩家所有的紋理（外觀和披風）。在解密之後，能獲得下面的JSON對象：
        紋理對象。
        profileId：玩家的UUID，不帶連字元。
        
        profileName：玩家名稱。
        
        signatureRequired：如果 Signature存在，此項也存在。代表是否已被簽名。
        
        textures：紋理。
        SKIN：外觀紋理。如果這名玩家沒有自訂外觀，這項不存在。
        metadata：外觀的元數據。可能不存在。
        model：固定值「slim」。當外觀模型為「Alex」時這一項才存在，模型為「Steve」則無該元數據。
        
        url：外觀紋理的URL連結。
        
        CAPE：披風紋理。如果這名玩家沒有披風，這項不存在。
        url：披風紋理的URL連結。預設沒有披風，僅當Mojang在玩家的帳户數據中輸入了披風時，才會顯示披風。
        
        timestamp：Unix時間戳，以毫秒為單位，時間為請求玩家配置數據的時間。

可疑嘅燉湯[]

可疑嘅燉湯儲存了它們的狀態效果。

tag：父標籤。

- effects：這個可疑嘅燉湯擁有的狀態效果。
  - ：其中一種效果。
    - duration：（可選，預設為160遊戲刻（8秒））效果的持續時間。
    - id：狀態效果的命名空間ID。

書和羽毛筆[]

書和羽毛筆的內容資訊都儲存在tag標籤裡。

tag：父標籤。

- pages：書和羽毛筆的各個頁面。
  - ：一個單頁。每一頁是一個字串，不能超過32767個字元，且使用\n作為換行符。

寫好嘅書[]

寫好嘅書的內容資訊和作者資訊等都儲存在tag標籤裡。

tag：父標籤。

- author：寫好嘅書的作者。
- filtered_pages：已過濾的頁面資訊。
  - <頁數>：代表某頁的字串過濾後的結果。如果玩家開啟了過濾，則此字串優先於 pages內的字串。
- filtered_title：已過濾的標題。無實際作用。
- generation：決定寫好嘅書是否為副本。0 = 原作，1 = 原作的副本，2 = 複本的複本，3 = 破舊的。預設寫好嘅書為「原作」。
- pages：寫好嘅書的各個頁面。
  - ：寫好嘅書的一個單頁，是一個JSON文字。
- resolved：表示這本寫好嘅書是否是第一次被打開，決定是否要進行寫好嘅書內文字的解析。
- title：寫好嘅書的標題，不能超過32個字元。

歷史[]

此段落需要更新。

理由：丟失了大量歷史資訊，請在加入後刪除此標籤.

Java版
1.7.2	?	對物品加入了 Unbreakable。
1.8	14w06a	對物品加入了 CanDestroy。
	14w06a	對物品加入了 HideFlags。
	14w07a	對所有方塊加入了 BlockEntityTag。
	14w10a	加入了一個隱藏藥水效果的第5位（值為32）的 HideFlags。
	14w33a	對所有物品加入了`SelectedItem`。
1.12	pre1	對玩家加入了 enteredNetherPosition，用於進度觸發器`minecraft:nether_travel`。
1.13	18w01a	Name標籤現在使用JSON文字。
	18w01a	移除 LocName標籤，現在使用JSON文字進行代替。
	18w21a	ench標籤重新命名為 Enchantments。
1.14	18w43a	Lore標籤的內容現在使用JSON文字。
1.14	19w06a	對方塊的物品形式加入了 BlockStateTag。
1.16	20w12a	對玩家加入了 SpawnDimension、 SpawnForced、 SpawnX、 SpawnY和 SpawnZ標籤，用於控制玩家重生點。
	20w21a	對玩家加入了 Dimension標籤表示玩家所在的維度。
	pre6	對玩家加入了 SpawnAngle標籤表示玩家重生時的角度。
1.16.2	20w27a	將Flag 64加入到 HideFlags以隱藏皮革盔甲的染色資訊。
1.16.2	20w29a	對玩家加入了 previousPlayerGameType標籤表示切換之前的遊戲模式。
1.17.1	pre1	Enchantments.lvl標籤現在按照short讀取，並且值會被限定到0至255之間。^[1]
1.19.3	22w42a	對玩家加入了 warden_spawn_tracker標籤控制沉靈守衞的生成。
1.19.4	23w04a	將Flag 128加入到 HideFlags以隱藏盔甲的盔甲紋飾資訊。

參考[]

↑ MC-131290

語言

[1] MC-131290

[1]

Minecraft Wiki