パス

パス は、ユーザーに特別な特権にアクセスするための一度限りの Robux 料金を請求できます。たとえば、禁止エリア への入場、経験内のアバターアイテム へのアクセス、または永続的なパワーアップなどです。

パスを作成中

パスを作成するには：

1. クリエーション に移動し、エクスペリエンスを選択します。
2. Go to 収益化 >) パス .
3. クリックします パスを作成する 。
4. パスアイコンとして表示するイメージをアップロードします。画像が 512x512 ピクセルを超えていないことを確認し、.jpg 、.png 、または .bmp 形式の外部詳細を含まないことを確認してください。
5. パスに名前と説明を入力します。
6. クリックします パスを作成 。

パスID を取得する

スクリプトをスクリプト作成用するには、パス ID が必要です。パス ID を取得するには：

1. Go to 収益化 >) パス .

2. パスにカーソルを置き、 ⋯ メニューをクリックします。

3. クリックして、 アセット ID をコピー をクリップボードにコピーします。

   

パスを販売する

パスをエクスペリエンス外でまたは中で販売できます。

エクスペリエンスの外

エクスペリエンスの ストア ページでパスを販売するには：

1. Go to 収益化 >) パス .
2. パスにカーソルを置き、 ⋯ メニューをクリックします。
3. 売りたいパスを選択します。
4. Select セールス 。
5. 有効にすると 売り物 for Sale トグルを切り替える。
6. [Robux 価格] フィールドに、 パスのユーザーに請求したい Robux の量 を入力します。入力した価格は、販売ごとに獲得する Robux の量に影響します。入力した価格は、1 Robux あたりの収益、および1 億 Robux の価値に影響します。
7. クリックします 変更を保存する。パスはエクスペリエンスの ストア ページに人気になります。

エクスペリエンス内

エクスペリエンス内のパスを実装し、販売するには、MarketplaceService 関数を呼び出します。

Use GetProductInfo() を使用して、パスの名前と価格などの情報を取得し、ユーザーに表示します。パスはエクスペリエンスのマーケットプレイスで販売できます。たとえば、パス内の Enum.InfoType.GamePass は、パスの 2つ目のパラメーターが

local MarketplaceService = game:GetService("MarketplaceService")

-- 入場用のID をパスID に置き換える
local productId = 000000

local success, productInfo = pcall(function()
	return MarketplaceService:GetProductInfo(productId, Enum.InfoType.GamePass)
end)


if success and productInfo then
	-- 製品が販売中されているかどうかをチェック
	if productInfo.IsForSale then
	-- 製品情報を表示
	-- 印刷ステートメントを UI コードに置き換えて、パスを表示する
  	print("Pass Name: " .. productInfo.Name)
  	print("Price in Robux: " .. productInfo.PriceInRobux)
  	print("Description: " .. productInfo.Description)
	else
		print("This product isn't for sale")
	end
end

ユーザーがパスを所有していない場合は、PromptPurchase() を使用してパスの購持ち物リストを促します。ユーザーがボタンを押すなどのアクションを実行すると、この関数を呼び出すことができます。ユーザーが NPC のようなアクションを実行すると、この関数を呼び出すことができます。

local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")

-- 入場用のID をパスID に置き換える
local passID = 0000000

-- パスの購入を促す
local function promptPurchase()
	local player = Players.LocalPlayer
	local hasPass = false

	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		warn("Error while checking if player has pass: " .. tostring(message))
		return
	end

	if hasPass then
		-- ユーザーがすでにパスを所有していることを示すメッセージを表示
	else
		-- パスの購入を促す
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Use PromptGamePassPurchaseFinished() を使用して、パスのプロンプトを処理し、ユーザーにパスに関連する特権を割り当てます。

Class.ServerScriptService 内のスクリプトを置くことで、サーバーはユーザーのパス特権を処理できます。

local MarketplaceService = game:GetService("MarketplaceService")

-- 入場用のID をパスID に置き換える
local passID = 0000000  -- 変更このをパス ID に

-- 完了したプロンプトと購入を処理する
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
	if purchaseSuccess and purchasedPassID == passID then
		print(player.Name .. " purchased the Pass with ID " .. passID)
		-- ユーザーにパスに関連するアビリティまたはボーナスを割り当てる
	end
end

-- Connect PromptGamePassPurchaseFinished イベントを関数に接続します
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)

パス特権を割り当てる

パスを購入するユーザーにパス特権をマニュアルで割り当てる必要があります。これをするには、ユーザーがエクスペリエンスに参加するときに PlayerAdded を使用して、パスをすでに所有しているかどうかをチェックし、パス特権を割り当てます。

Class.ServerScriptService 内のスクリプトを置くことで、サーバーはユーザーのパス特権を処理できます。

local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")

-- 入場用のID をパスID に置き換える
local passID = 0000000

local function onPlayerAdded(player)
	local hasPass = false

	-- ユーザーがすでにパスを所有しているかどうかチェック
	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		-- 警告を発行し、関数を終了します
		warn("Error while checking if player has pass: " .. tostring(message))
		return
	end

	if hasPass then
		-- ユーザーにパスに関連するアビリティまたはボーナスを割り当てる
		print(player.Name .. " owns the Pass with ID " .. passID)
	end
end

-- PlayerAdded イベントを機能に接続
Players.PlayerAdded:Connect(onPlayerAdded)

パスアナリティクス

パスアナリティクスを使用して、個々のパスの成功を分析し、トレンドを識別し、将来の潜在的な収益を予測します。

アナリティクスを使用すると、次のことができます:

• 選択した期間のトップパスを表示します。
• 時系列グラフに最大 8つのトップセラーアイテムを表示し、全体的な収益と売上を分析します。
• カタログを監視し、売上と純収益でアイテムをソートします。

パスアナリティクスにアクセスするに解析：

1. クリエーション に移動し、エクスペリエンスを選択します。
2. Go to 収益化 >) パス .
3. Select the アナリティクス tab.