世界テンプレートのパッケージ化

2022-04-28

このチュートリアルでは、次の内容を学びます。

世界テンプレートの内容と使用方法。
世界テンプレートの作成に必要なフォルダーおよびファイル構造。

世界テンプレートは、テンプレートに基づいて新しい世界を作成するために使用できるフレームワークです。テンプレートによって作成される各世界は同一であり、これはサバイバルスポーンに特に役立ちます。マーケットプレイスの世界は、すべて世界テンプレートです。世界テンプレートのファイル拡張子は .mctemplate で、通常の世界ファイル (.mcworld) とは構造が若干異なります。

世界テンプレートをパッケージ化するには、世界ファイル (manifest.json を含む db フォルダー、level.dat、world_behavior_packs.json、world_resource_packs.json、world_icon.jpeg (キーアート) など) が格納された world_template フォルダーを作成します。ビヘイビアーパックがある場合は、パッケージ化されたビヘイビアーパックを world_template フォルダー内に配置します (ビヘイビアーパックの作成方法については、「ビヘイビアーパックの概要」を参照してください)。

また、リソースパックフォルダーおよびビヘイビアーパックフォルダーの名前は 10 文字以下にする必要があります。これは、パスが長いとリソースパックまたはビヘイビアーパックが適切に読み込まれなくなるという問題が Xbox で発生する可能性があるためです。パックのフォルダー名には、コンテンツのタイトルを表す頭字語を使用することをお勧めします。

警告

1.18 のリリースに伴い、1.17.4 以前のバージョンのゲーム本編で作成されたテンプレートが更新され、世界生成ツールが新しくなります。そのため、そのようなテンプレートを基に新しいマップを作成すると、コンテンツが破損する場合があります。

こうしたシナリオの詳細については、「世界テンプレートのゲーム本編のバージョンを 1.18 に更新する」をご覧ください。

世界テンプレートのフォルダー構造

世界テンプレートのフォルダー構造を次の図に示します。

世界テンプレート全体のフォルダー構造

重要

Windows 10 でのファイルパスの最大長は、デフォルトでは 260 文字です。フォルダーディレクトリを設定する際はこの点を考慮し、文字数上限が近い場合は、名前付け規則を短くしてください。

manifest.json

コンテンツを世界テンプレートとして定義する、manifest.json という名前の JSON ファイルを作成します。

name: このフィールドは常に次の値になります。 pack.name
description: このフィールドは常に次の値になります。 pack.description
version: これにより、このパックのバージョンがゲームに伝えられます。新しいコンテンツは常に次の形式を使用して作成します。 [1, 0 ,0]
uuid: このサイト (https://www.uuidgenerator.net/version4) から 2 つの異なる UUID を生成する必要があります。
type: これにより、このパックが世界テンプレートとして処理されるようにゲームに伝えられます。

世界テンプレートの manifest.json:

{
  "header": {
    "name": "pack.name",
    "description": "pack.description",
    "version": [1, 0, 0],
    "uuid": "<GENERATE A UUID>"
  },
  "modules": [
    {
      "version": [1, 0, 0],
      "type": "world_template",
      "uuid": "<GENERATE A UUID>"
    }
  ],
  "format_version": 2
}

world_behavior_packs.json および world_resource_packs.json

作成する世界にリソースパックまたはビヘイビアーパック、あるいはその両方が必要な場合は、パックの uuid を使用してそれらをここで明示的に定義する必要があります。これらの JSON ファイルではいずれも同じ形式を使用しますが、各ファイルに正しい uuid を入力していることを確認する必要があります。

pack_id: 必要なリソースまたはビヘイビアーパックの uuid です。
world_resource_packs.json には必要なリソースパックのみを含め、world_behavior_packs.json には必要なビヘイビアーパックのみを含めるようにしてください。
version: リソースまたはビヘイビアーパックのバージョンです。これはパックの manifest.json で定義します。

テンプレートの world_behavior/resource_packs.json:

[
    {
        "pack_id": "<UUID FROM REQUIRED PACK>",
        "version": [1, 0, 0]
    }
]

world_icon.jpeg

これは、テンプレートから世界が作成された際に表示される画像です。マーケットプレイスの世界テンプレートについては、このアイコンをキーアートと同じスタイルにする必要があります。マーケットプレイス以外のテンプレートに世界アイコンは不要ですが、テンプレートが既存の世界から作成されている場合、世界アイコンは既に使用可能になっています。

ディメンション: 800 x 450 ピクセル
ファイル形式: JPEG

texts フォルダー

world_template フォルダー内の texts フォルダーには、作成する世界の名前と説明を定義した en_US.lang ファイルを配置します。

texts フォルダーの構造

en_US.lang

ここには、作成する世界の名前と説明を定義します。次の 2 行を .lang ファイルに指定する必要があります。

パックの名前: pack.name=[name of pack]
パックの説明: pack.description=[description of pack]
- コンテンツの内容を一目で把握できる簡潔な説明を使用します。

テンプレートの en_US.lang:

= の後の名前が、ゲームの UI に表示されます。

pack.name=Western World
pack.description=Howdy partner

languages.json

このファイルによって、スキンパックがサポートする言語がゲームに伝えられます。必須は英語のみです。他の言語をサポートする場合は、別の xx_YY.lang ファイルを作成して編集し、それらの言語がサポートされることをゲームに伝えます。

テンプレートの languages.json:

[
    "en_US"
]