Bulk Importer and Exporter Tool

スタッツおよびアチーブメント管理を支援するツールです。

Bulk Importer/Exporter Tool を使って、製品の スタッツアチーブメント を管理することができます。このツールは、CSV 形式のデータを含む .zip アーカイブを使用するため、既存のプログラムまたは独自のツールを幅広く使用して、スタッツおよびアチーブメントの表示および編集が可能になります。

このツールは、スタッツとアチーブメントの定義のみ影響を与えます。ユーザーの進行状況に対する追加、削除、変更は一切行いません。スタッツまたはアチーブメントの定義を削除し再作成しても、ユーザーのスタッツとアチーブメント進行状況はそのまま残ります。

このツールは、Developer Portal[Games Services] > [Achievements] にあります。上部の [Player Lookup] ボタンと [Create New] ボタンの間に [Bulk Import/Export] ボタンがあります。

エクスポートする (ステップ 1)

エクスポート処理により、ダウンロード可能な zip アーカイブが作成されます。このアーカイブには、製品のすべての既存のスタッツとアチーブメントの .csv ファイルと画像ファイルが含まれます。

これらのファイルは標準の .csv 形式に準拠しているので、ほとんどのスプレッドシート ソフトウェア パッケージで簡単にエクスポート/インポートすることができます。画像ファイルはエクスポート前に標準の .png 形式にする必要があります。

[Export Current Achievements (現在のアーカイブをエクスポートする)] を選択するだけでエクスポートが開始します。自動的にダウンロードが始まり、ダウンロード コンテンツが通常格納される場所に .zip フォルダが作成されます。

データのエクスポートのみを行う場合は、[Export Current Achievements] を選択し、このステップでモーダルをキャンセルまたは終了することができます。

[Next] を選択することで、エクスポートをスキップすることもできます。現在のアーカイブのバックアップがない場合は、このステップをスキップすることは 推奨しません

インポートする (ステップ 2 とステップ 3)

アチーブメントとスタッツをインポートすると、現在のアチーブメントとスタッツが消去されオーバーライドされます。変更をリバートする必要が出てきた時のために、アチーブメントとスタッツのバックアップを取るようにしてください。

インポート処理では、エクスポート処理と同じファイル形式を使用します。インポート用の .zip ファイルには次のファイルが含まれていなければなりません。

ファイル名

目次

stats.csv

各スタッツを定義する「名前とタイプ」のペアのリスト

achievementDefinitions.csv

アチーブメント名のリストとそれらが参照するスタッツ

achievementLocalizations.csv

アチーブメント ローカリゼーション ロケール キーとそれらのアイコンのファイル名

One or more .png files

achievementDefinitions.csv で参照されるアイコン

インポート用に .zip ファイルを準備するために、インポートする .zip テンプレートをアップロードする Developer Portal から .zip テンプレートをダウンロードすることができます (Download EOS Achievements Zip Template を選択します)。または こちら をクリックしてください。いずれの方法でも、適切に編成されたコンテンツを含むサンプル「BulkTemplate.zip」フォルダの自動ダウンロードが開始されます。

Sample of the EOS Achievements Bulk Import template

インポート処理の開始前に、CSV ファイルと [画像]#アイコンの要件) ファイルの両方の要件を見直してください。

ファイルをインポートする準備ができたら、Bulk Import プロセスのステップ 2 の [Choose File to Upload (アップロードするファイルを選択)] を選択します。インポートによりすべての既存のアチーブメントが除去され、製品のすべてのスタッツがクリアされる注記を確認してください。

[Next] を選択すると、インポートされたコンテンツに対する検証チェックが始まります。チェックが完了すると、バックエンド サービスはすべての既存のスタッツとアチーブメントを削除し、zip ファイルの中にあるものに置き換えます。新しいアチーブメントがバックエンド サービスで使用するアイコン キャッシュの構築も行われます。

インポート処理の最後に、アチーブメントとスタッツの成功に関する詳細がモーダルに表示されます。

ライブ デプロイメントへのインポート操作中に、スタッツとアチーブメントの定義が不完全な状態になる場合があります。その結果、ユーザーはスタッツの記録またはアチーブメントのアンロックができない場合があります。エンドユーザーの混乱や予期しない動作を最小限に抑えるために、ライブ デプロイメントのメンテナンス ウィンドウ中にデータをインポートすることを推奨します。

CSV 形式の要件

アップロードする .csv ファイルが検証チェックに合格するには、各ファイル タイプに対して以下に示されるデータ形式を使用し、空白行を残さないようにします。すべての CSV ファイルは UTF-8 エンコードにする必要があります。

stats.csv 形式

stats.csv ファイルには、1 つのスタッツに対して 2 つの列があります。スタッツの名前、およびその集計タイプです。集計タイプでサポートされている値は、SUMMINMAXLATEST です。以下は `stats.csv`ファイルのサンプルです。

name,aggregationType
numTreesChopped,SUM
lastTreesChopped,LATEST
maxTreesChopped,MAX
minTreesChopped,MIN
numAxesUsed,SUM

スタッツ名はキャメルケースで、集計ライプはすべて大文字、それぞれの行にスペースはありません。

詳細については「Stats Interface」を参照してください。

achievementDefinitions.csv 形式

achievementsDefinitions.csv は 3 つの列を使用して、それぞれのアチーブメントと、アチーブメントをロック解除するための要件を定義します。最初の 2 列は、アチーブメントの内部名と、アチーブメントの表示 / 非表示を示すブール値を保持します。

3 列目はオプションです。空の場合、EOS SDK からの明示的なコマンドによってのみアチーブメントのロック解除が可能です。3 列目 (存在する場合) は、スタッツ名としきい値のリストです、次の Achievements.csv ファイルのサンプルが示すように、 Stat1:Threshold1; Stat2:Threshold2; StatN:ThresholdN という形式になります。

name,hidden,statThresholds
achvTutorial,FALSE,
achvLumberjack,FALSE,numTreesChopped:3
achvWoodsman,TRUE,numTreesChopped:100;numAxesUsed:5

内部名はキャメルケース、2 番目の列は TRUE または FALSE、3 番目の列はオプションでコロン (:) としきい値基準を使用してキャメルケースでスタッツを使用します。それぞれの行にスペースはありません。

詳細については Achievements インターフェース を参照してください。

achievementLocalizations.csv 形式

ユーザーへ表示されるアチーブメントに関するすべての情報は、ローカリゼーションの対象となります。

achievementLocalizations.csv は、それぞれのアチーブメントをさまざまなロケールのユーザーに説明するためにシステムが必要とする、すべてのデータを設定します。含まれるデータは、アチーブメントとロケールの内部名、続いてロックされたときのタイトルと説明、ロック解除されたときのタイトルと説明、フレーバー テキスト、ロックされたアイコンとロック解除されたアイコンです。次のサンプル achievementLocalizations.csv ファイルは、同じアチーブメント セットのデフォルト (2 列目が空) とドイツ語 (2 列目が「de」) バージョンです。

name,locale,lockedTitle,lockedDescription,unlockedTitle,unlockedDescription,flavorText,lockedIcon,unlockedIcon
achvTutorial,,Intro,Complete the Tutorial,Intro,Completed the Tutorial,Onwards!,locked.png,tutorial.png
achvTutorial,de,Einführung,Schließe die Einführung ab,Einführung,Die Einführung abgeschlossen,Weiter!,locked.png,tutorial.png
achvLumberjack,,Lumberjack,Chop 3 trees,Lumberjack,Chopped 3 trees,Timber!,locked.png,lumberjack.png
achvLumberjack,de,Holzfäller,Fälle drei Bäume,Holzfäller,Drei Bäume gefällt,Holz!,locked.png,lumberjack_de.png
achvWoodsman,,Woodsman,Roam the woods,Woodsman,Travelled the woods and chopped some trees,,lockedSecret.png,woodsman.png
achvWoodsman,de,Waldmensch,Durschtreife die Wälder,Waldmensch,Die Wälder bereist und Bäume gefällt,,lockedSecret.png,woodsman.png

値の最初または最後にスペースがないことを確認してください。ロックされた説明やロックされていない説明など、値にはスペースが含まれている場合があります。

Csv ファイルのロケール (2 番目の) 欄に入力するテキストは以下のタグ形式と一致しなければなりません。

ロケール

タグ

Arabic

ar

Danish

da

Dutch

nl

English (America)

en-US

English (United Kingdom)

en-GB

Finnish

fi

French

fr

German

de

Italian

it

Japanese

ja

Korean

ko

Norwegian

no

Polish

pl

Portuguese (Brazil)

pt-BR

Russian

ru

Simplified Chinese

zh-Hans

Spanish (Mexico)

es-MX

Spanish (Spain)

es-ES

Swedish

sv

Thai

th

Traditional Chinese

zh-Hant

Turkish

tr

2021 年 2 月 23 日、英語 (英国)、スウェーデン語、繁体字中国語、および簡体字中国語のロケールコードが更新されました。この日付けより前に .zip をインポートしないでください。新しいロケールコードと一致するようにこれらのファイルを更新するか、新しくデータをエクスポートしてください。

アイコンの要件

achievementDefinitions.csv で参照するアイコンは、インポートする現在の zip アーカイブに存在する必要があります。これは、それまで存在するすべてのコンテンツが新しいインポート時に消去されるためです。すべてのアイコンは .png 形式であること、そしてアーカイブのルート レベルに存在しなければなりません。.zip ファイルにはサブフォルダを入れないでください。

アイコン ファイル名には、以下の文字を含むことはできません。含まれた場合は Developer Portal エラーが発生します。 \ { \^ } % ` ] > [ \~ < # | & $ \@ = 、 : + 、 \? 、スペース ' '

ユーザーが重複してダウンロードを排除するために、同じアイコン ファイルを参照している場合、アチーブメントはアイコンを共有できます。非表示のアチーブメントの「ロックされた」アイコンのように、複数のアチーブメントが同じ画像を使用する場合は、この機能を使用してください。