roblox-monetization について
roblox-monetizationは、Robloxゲームに購入機能や収益化関連機能を追加する開発者向けのスキルです。サーバー側での付与、レシート処理、購入資格の確認、失敗時の対応を解説します。
主な機能
- 01パスと製品の付与処理
- 02サーバー側レシートハンドラーの使用
- 03購入資格ポリシーの確認
- 04Creator Rewardsの個別追跡
- 05重複付与や中断のテスト
活用シーン
- 01Game Pass特典の追加
- 02反復購入可能なDeveloper Productsの付与
- 03購入レシートの失敗や重複への対応
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/roblox-monetizationを入力して読み込まれたか確認します。
同梱ファイルreferences/full.md
詳細
roblox の収益化
読み込むタイミング
ゲームパス、開発者製品、サブスクリプション、プライベートサーバー、Creator Rewards に関連する製品の判断、または購入資格の確認を追加するときに読み込みます。
クイックリファレンス
- 購入のプロンプトはクライアントから表示しますが、価値の付与はサーバーが所有するコードからのみ行います。
- ゲームパス：サーバーが所有する ID→特典レジストリを1つ用意します。参加時と購入時の更新には、同じ冪等な特典付与処理を使います。full.md §2a。
- 開発者製品：繰り返し購入できる消耗品です。
ProcessReceipt、またはEnum.ReceiptType.DeveloperProductを指定したBindReceiptHandlerのいずれかを使い、サーバーが所有するレシートハンドラーから付与します。PromptProductPurchaseFinishedは購入確認ではありません。 - 失敗したレシートは
NotProcessedYetのままにします。再試行の方法は、独自にタイマーを作るのではなく、選択したレシート API によって決まります。full.md を参照してください。 - 購入資格に関わる場合は、
PolicyServiceと最新の Roblox ガイダンスを確認します。有料のランダムアイテムに関する制限が適用される場合は、獲得可能な報酬、内容が既知の非ランダムな順番、または直接購入など、文書化されている選択肢をユーザーに提示します。機能を非表示にしたりブロックしたりすることを既定の対応にしないでください。影響を受ける購入経路に対処しつつ、関係のない作業は止めないでください。 - Creator Rewards はプラットフォームのプログラムであり、付与 API ではありません。購入やインベントリとは別に、資格、アトリビューション、エンゲージメント、ダッシュボードのレポートを追跡します。
- 付与の失敗や重複、プレイヤーが不在の場合、中断された保存をテストします。移転、サブスクリプションの変更、動的価格設定については full.md を参照してください。
- レシートハンドラーが存在するだけでは、正しく実装されている証拠にはなりません。その所有者、永続的かつ冪等な付与処理、未知の製品やプレイヤー不在時の再試行経路を確認してください。
詳細が必要ですか？ 購入フローと失敗時の処理については、references/full.md を読み込んでください。
コメント
Markdown 対応