Game Center

アプリのアチーブメント、リーダーボード、リーダーボードセットを、言語、画像、並び順とともに管理します。それぞれ ID（ゲームが使う vendor identifier）、参照名、または Apple ID で指定します。

テキストと画像はバージョンに属します。新しいアチーブメント、リーダーボード、セットは Prepare for Submission のバージョン 1 から始まり、バージョンはアプリと一緒に App Review に送られます。公開済みのものを変更する場合、コマンドは確認のうえ、まず次のバージョンを作成します。

Game Center をオンにする

ascelerate game-center <bundle-id>                      # オン・オフ、件数、デフォルトのリーダーボード
ascelerate game-center enable <bundle-id>
ascelerate game-center version <bundle-id> --enabled true   # App Store バージョンの Game Center スイッチ

App Store Connect API では、一度オンにしたアプリの Game Center をオフに戻せません。Bundle ID には Game Center の機能が必要です。version は準備中のバージョン、または --version で指定したバージョンを対象にします。

アチーブメント

ascelerate game-center achievements <bundle-id> [--json]
ascelerate game-center achievements info <bundle-id> first.win
ascelerate game-center achievements create <bundle-id> --id first.win --name "First Win" --points 10 [--hidden] [--repeatable]
ascelerate game-center achievements update <bundle-id> first.win --points 20 --hidden false
ascelerate game-center achievements update <bundle-id> first.win --archived true
ascelerate game-center achievements delete <bundle-id> first.win

アプリのアチーブメントは合計 1,000 ポイントを分け合い、1 つあたり 1〜100 ポイントです。--hidden を付けると、プレイヤーが獲得するまで非表示になります。公開されたことのあるアチーブメントは削除できないため、代わりにアーカイブしてください。

リーダーボード

ascelerate game-center leaderboards <bundle-id> [--json]
ascelerate game-center leaderboards create <bundle-id> --id high.score --name "High Score"
ascelerate game-center leaderboards create <bundle-id> --id weekly.time --name "Weekly Time" \
  --formatter elapsed-time-second --sort low --submission recent --min 0 --max 3600 \
  --recurrence-start 2026-12-07T00:00:00Z --recurrence-duration PT168H --recurrence-rule "FREQ=DAILY;INTERVAL=7"
ascelerate game-center leaderboards update <bundle-id> weekly.time --hidden true
ascelerate game-center leaderboards default <bundle-id> high.score

デフォルトでは、スコアは整数で、高いスコアが上位になり、各プレイヤーのベストスコアが使われます。--formatter には integer、decimal-point-1-place〜decimal-point-3-place、elapsed-time-centisecond、elapsed-time-second、elapsed-time-minute、または money-dollar-decimal などの通貨を指定できます。

定期リーダーボードは一定の間隔でリセットされます。期間は時間または分で指定し（PT24H、1 週間なら PT168H）、ルールは分・時間・日単位で繰り返します（FREQ=DAILY;INTERVAL=7 で毎週リセット）。スコア範囲は --min "" --max "" でまとめてのみ消去できます。

最初のリーダーボードが、Game Center を開いたときに表示されるデフォルトになります。default で変更できます。

リーダーボードセット

ascelerate game-center sets <bundle-id>
ascelerate game-center sets create <bundle-id> --id all.scores --name "All Scores" --leaderboards high.score,weekly.time
ascelerate game-center sets update <bundle-id> all.scores --leaderboards weekly.time,high.score

--leaderboards は、セットのリーダーボードを指定した順序で設定し、現在のものと置き換えます。

アクティビティ

アクティビティは、レベルやモードなど、プレイヤーを直接招待できるゲームの一部です。そのアチーブメントとリーダーボードは、アクティビティに属するものです。

ascelerate game-center activities <bundle-id> [--json]
ascelerate game-center activities create <bundle-id> --id duel --name "Duel" --play-style sync \
  --min-players 2 --max-players 2 [--party-code true] [--properties mode=duel] [--fallback-url https://example.com/duel]
ascelerate game-center activities update <bundle-id> duel --max-players 4 --fallback-url ""
ascelerate game-center activities link <bundle-id> duel --achievements first.win --leaderboards high.score
ascelerate game-center activities link <bundle-id> duel --leaderboards high.score --remove

--play-style は sync（一緒にプレイ）または async（交代でプレイ）です。--properties は、アクティビティに対するゲーム独自のキーと値のプロパティを置き換えます。フォールバック URL はゲームを持っていないプレイヤー向けの Web ページで、最新のバージョンに属します。

チャレンジ

チャレンジでは、プレイヤーがアプリのリーダーボードのスコアを超えるよう友達に挑戦できます。

ascelerate game-center challenges <bundle-id> [--json]
ascelerate game-center challenges create <bundle-id> --id beat.score --name "Beat My Score" --leaderboard high.score --repeatable
ascelerate game-center challenges update <bundle-id> beat.score --leaderboard weekly.best

App Store Connect のルール（コマンドが事前に確認します）：リーダーボード 1 つにつきチャレンジは 1 つまでで、各プレイヤーのベストスコアを使うものである必要があり、--repeatable でないチャレンジには定期リーダーボードが必要です。

言語と画像

アチーブメント、リーダーボード、セット、アクティビティ、チャレンジには同じ言語・画像コマンドがあります。achievements を leaderboards、sets、activities、または challenges に置き換えてください。

ascelerate game-center achievements localizations <bundle-id> first.win
ascelerate game-center achievements localizations set <bundle-id> first.win --locale en-US \
  --name "First Win" --before-earned "Win a round." --after-earned "You won a round."
ascelerate game-center achievements localizations export <bundle-id> first.win --output first-win.json
ascelerate game-center achievements localizations import <bundle-id> first.win --file first-win.json
ascelerate game-center achievements localizations delete <bundle-id> first.win --locale tr

ascelerate game-center achievements image upload <bundle-id> first.win --locale en-US icon.png
ascelerate game-center achievements image delete <bundle-id> first.win --locale en-US

アチーブメントに新しい言語を追加するには、名前と 2 つの説明が必要です。リーダーボードの言語には、名前、任意の説明、言語ごとの --formatter、スコアの後に付く単位（--suffix " points"、--suffix-singular " point"）があります。セットの言語には名前が、アクティビティとチャレンジの言語には名前と説明（--name、--description）があります。

画像は 1 つの言語に属します。アチーブメント、リーダーボード、セットでは正方形で 512×512 以上（通常は 512×512 または 1024×1024）、アクティビティとチャレンジではちょうど 3840×2160 にしてください。アクティビティとチャレンジのバージョンにはデフォルト画像も設定できます（image upload --default）。形式は PNG または JPEG です。アップロードすると現在の画像が置き換えられ、Apple の確認を待つので、却下された画像はすぐに報告されます。

並び順と App Review

ascelerate game-center achievements reorder <bundle-id> first.win,high.five
ascelerate game-center achievements submit <bundle-id> first.win [--platform ios]

reorder（アチーブメント、リーダーボード、セット）は指定したものをその順序で先頭に置き、残りは今の順序のまま続きます。submit は項目の新しいバージョンをアプリの下書きの提出に追加します（なければ作成します）。下書きを ascelerate apps review submit で提出すると App Review に送られます。 apps review submit も審査待ちの変更があるすべての項目を表示し、提出に追加するか確認します。件数は game-center <bundle-id> で確認できます。

グループ

グループは、チームのアプリ間でアチーブメント、リーダーボード、リーダーボードセット、アクティビティ、チャレンジを共有します。グループは参照名または ID で指定します。

ascelerate game-center groups [--json]                  # the team's groups with their apps
ascelerate game-center groups create --name "My Games"
ascelerate game-center groups rename "My Games" --name "Our Games"
ascelerate game-center groups delete "Our Games"
ascelerate game-center groups add-app "Our Games" <bundle-id> --dry-run

アプリをグループに追加すると元に戻せません。アプリはグループから外れることができず、アチーブメントやリーダーボードなどはグループに移ります。add-app はその旨を表示してから確認するので、まず --dry-run で試してください。グループに属するアプリでは、ほかの game-center コマンドがグループの項目を一覧、作成、並べ替えし、leaderboards default はそのアプリで Game Center を開いたときのグループのリーダーボードを設定します。

マッチメイキング

ルールベースのマッチメイキングは 1 つのアプリではなくチームに属するため、これらのコマンドには Bundle ID を指定しません。ルールセットはプレイヤー数、ルール、チームを定め、キューはゲームがマッチリクエストを送る先で、1 つのルールセットでマッチングします。ルールセットとキューは参照名または ID で指定します。

ascelerate game-center matchmaking rule-sets [--json]
ascelerate game-center matchmaking rule-sets create --name Ranked --min 2 --max 4
ascelerate game-center matchmaking rule-sets info Ranked
ascelerate game-center matchmaking rules add Ranked --name SameVersion --type compatible \
  --expression "requests[0].appVersion == requests[1].appVersion" --description "Same app version"
ascelerate game-center matchmaking rules add Ranked --name Skill --type distance \
  --expression "requests[0].properties.skill" --description "Close skill" --weight 2
ascelerate game-center matchmaking teams add Ranked --name Red --min 1 --max 2
ascelerate game-center matchmaking queues create --name RankedQueue --rule-set Ranked [--experiment-rule-set RankedB] [--classic-apps com.example.MyApp]
ascelerate game-center matchmaking queues update RankedQueue --experiment-rule-set none
ascelerate game-center matchmaking test Ranked --file requests.json

ルールは JMESPath をベースにした Apple のルール言語で書きます（JMESPath には算術演算子がありません）。互換性ルール（compatible）は requests[0] と requests[1] を比較し、距離ルール（distance）は requests[0] について数値を返し、数値の近いリクエストから先にマッチします。プレイヤーのプロパティは requests[0].properties.<キー> として読み取られます。App Store Connect は保存時に式の構文しか確認しないので、ルールセットを使う前にテストしてください。

test はサンプルのリクエストをルールセットに通し、Apple が作るマッチを各プレイヤーのチームとともに表示します。何も保存されません。ファイルは JSON 配列です。

[
  {"requestName": "alice", "bundleId": "com.example.MyApp", "platform": "IOS", "appVersion": "1.0",
   "secondsInQueue": 5, "locale": "EN-US", "players": [{"playerId": "alice", "properties": {"skill": "10"}}]},
  {"requestName": "bob", "bundleId": "com.example.MyApp", "platform": "IOS", "appVersion": "1.0",
   "secondsInQueue": 8, "locale": "EN-US", "players": [{"playerId": "bob", "properties": {"skill": "12"}}]}
]

リクエストには latitude、longitude、playerCount、minPlayers、maxPlayers も指定できます。キューが使っているルールセットは削除できないため、先にキューを変更するか削除してください。