特典の付与・更新・失効
Discordロールとゲーム内特典の反映方法、実行するタイミング、管理画面での確認先を説明します。
更新日：
商品には、購入者へ付与するDiscordロールやゲーム内特典を設定します。支払い、特典の有効化、外部サービスへの反映は別々の状態として確認します。
Discordロールを付与する
1つの商品に複数のロールを設定できます。例えば、サポーター表示用と専用チャンネル用のロールをまとめて付与する商品を作れます。チャンネルの閲覧・投稿権限はDiscord側で設定してください。
Botの権限とロール順の設定は、Discordロール販売の手順を参照してください。Discordロールだけの商品には、ゲームサーバー側のAgentやRCON設定は不要です。
ゲーム内に特典を反映する
ゲームサーバー側の接続プログラム（Agent）が、商品に設定したRCONコマンドを実行します。
- Monetaが反映する処理を作成する。
- Agentが処理を取得し、購入者のゲームIDを使ってコマンドを実行する。
- Agentから返された結果をMonetaの処理履歴で確認する。
| 設定 | 指定する内容 |
|---|---|
| 送信先 | 利用するAgentと、対象のゲームサーバー・マップ |
| 購入者 | 商品に必要なゲームIDの種類。購入時に確認したIDを実行対象に使う |
| 特典の内容 | 対象ゲームや導入済みプラグインが提供するコマンド |
公開前にゲーム側で確認
利用できる特典は、ゲームのRCON対応状況やプラグインによって異なります。接続先とコマンドの動作を確認してから商品を公開してください。
付与・更新・剥奪のタイミング
ゲーム内特典には、それぞれのタイミングで実行するコマンドを設定できます。
| タイミング | 設定する処理の例 |
|---|---|
| 付与 | 購入者にVIP権限を付ける |
| 更新 | 継続課金の更新に合わせて、ゲーム側の有効期間を延長する |
| 剥奪 | 特典が失効したときに、VIP権限を外す |
上記は設定例です。実際の処理には、その操作に対応するゲーム側のコマンドが必要です。特典の状態が変わったことと、ゲーム側で処理が完了したことを分けて確認してください。
特典の有効期間と更新停止の扱いは、商品の価格・更新間隔・有効期間で説明しています。
特典の状態と処理結果を確認する
管理するサーバーを選び、特典と処理履歴を確認します。
| 確認先 | 調べる内容 |
|---|---|
| 特典 | 購入者、商品、有効状態、有効期間。関連する処理や監査ログもたどる |
| 処理履歴 | 待機中・実行中・完了・失敗・タイムアウト、実行コマンド、Agentから返された結果 |
特典は状態・商品・購入者、処理は状態・ゲーム・期間などで絞り込めます。
反映されていない場合は、運営者の確認手順へ進みます。タイムアウトではゲーム側の処理が済んでいる場合もあるため、結果が分からないまま繰り返し実行しないでください。