教學:外觀包

外觀包

獨立教學

難易度

初級

前置知識

• 開始之前
• 包的構建
• 執行、除錯與匯出
• 外觀包
• 外觀

實踐裝置

所需軟體

  本頁面介紹的是自訂外觀包教學。關於外觀包開發資訊，請見「外觀包」。

在閱讀本教學前，請先確保自身已有一定的資源包基礎。在瀏覽完本教學之後，你將學會如何建立一個屬於自己的外觀包。

檔案

外觀包包含以下檔案：

geometry.json

外觀的幾何檔案。

關於幾何的製作方法，請參照幾何模型的教學。

manifest.json

外觀包的清單檔案。

屬性名稱	描述
format_version	定義了清單的目前版本。除非有需要，否則請勿變更。
header	清單的頭部物件，用於定義包的一些基本資訊。 屬性名稱 資料型別 描述 name String 該外觀包的名稱。 uuid String 一種特殊的識別碼，是一種區分外觀包的好方法。建議使用uuid生成器來生成以保證其獨特性。 version Vector[ a, b, c] 外觀包的版本號，格式為[主版本，副版本，修訂版](x.x.x)匯入同一個外觀包時會用到，如果新的外觀包版本更高，那麼就替換為新版本；如果新的外觀包版本低於舊版，則忽略。
modules	描述了外觀包的模組。 屬性名稱 資料型別 描述 uuid String 一種特殊的識別碼，格式同header。注意，每個模組的的 uuid 都應該各不相同。 version Vector[ a, b, c] 此模組的版本號，格式同header。 type String 模組的型別，外觀包填寫為skin_pack。

範例：

{
  "format_version": 1,
  "header": {
    "name": "Persona",
    "uuid": "86efe7ee-a28e-4d6c-9892-8a0270257554",
    "version": [0, 0, 1]
  },
  "modules": [
    {
      "type": "skin_pack",
      "uuid": "e204cca7-36e6-4c8a-8872-8689ad16ded5",
      "version": [0, 0, 1]
    }
  ]
}

skins.json

外觀定義檔案。

範例：

{
  "geometry": "skinpacks/skins.json",
  "skins": [
    {
      "localization_name": "GREEN",//皮肤名称
      "geometry": "geometry.humanoid.custom",//皮肤使用的模型（原版粗手臂）
      "texture": "green.png",//皮肤材质
      "cape": "red_cape.png",//披风材质（仅在修改安装包或从市场中下载的皮肤包中有效）
      "type": "free"//皮肤类型
    },
    {
      "localization_name": "NANCY",
      "geometry": "geometry.humanoid.customSlim",//皮肤使用的模型（原版细手臂）
      "texture": "Nancy_skin.png",
      "type": "free"
    },
    {
      "localization_name": "Butterfly",
      "geometry": "geometry.customButterfly",//皮肤使用的模型（自定义模型，仅在修改安装包的情况下有效）
      "texture": "butterfly.png",
      "type": "free"
    }
  ],
  "serialize_name": "TestlSkinPack",//市场内皮肤包显示名称
  "localization_name": "TestSkinPack"//皮肤包名称
}

.lang

外觀包語言檔案，用於在地化外觀或外觀包名稱。

外觀包內檔案路徑：/texts/.lang 。

外觀包名稱在地化格式：skinpack.<皮肤包名称>=<本地化键名>

外觀名稱在地化格式：skin.<皮肤包名称>.<皮肤名称>=<本地化键名>

範例：

skinpack.TestSkinPack=My skin pack

skin.TestSkinPack.GREEN=GREEN
skin.TestSkinPack.NANCY=Nancy
skin.TestSkinPack.Butterfly=I Am a Butterfly

材質貼圖

外觀和披風的材質均直接放在外觀包目錄下，不需要放在內部資料夾中。

關於材質貼圖的製作方法，請參照教學/材質紋理。

披風

披風只能在修改安裝包的情況下，透過在skins.json裡的外觀物件中加入"cape": "<custom_cape.png>"來自訂。（見上方範例）

每款披風與一個外觀繫結，不能切換。

註：為了不在使玩家多人遊戲工作階段中造成不公平優勢，自基岩版1.5.3之後官方修復了允許自訂外觀具有自訂和不可見幾何體的錯誤，已不會讓自訂外觀包出現披風了。