Passos

Passes permitem cobrar dos usuários uma taxa única de Robux para acessar privilégios especiais dentro de sua experiência, como entrada em uma área restrita, um item de avatar na experiência ou um power-up permanente.

Criar um passe

Para criar um passe:

1. Vá para Criações e selecione uma experiência.
2. Vá para Monetização > Passes .
3. Clique em Criar um Passe .
4. Carregue uma imagem para exibir como o ícone de passe.Certifique-se de que a imagem não exceda 512x512 pixels, não inclua detalhes importantes fora de seus limites circulares e esteja no formato .jpg, .png ou .bmp.
5. Insira um nome e uma descrição para o passe.
6. Clique em Criar Passe .

Obtenha o ID do passe

Para usar scripting, você precisa de um ID de passe. Para obter o ID de passe:

1. Vá para Monetização > Passes .

2. Passe o mouse sobre uma miniatura de um passe, clique no botão ⋯ e selecione Copiar ID de Recurso no menu de contexto.

   

Vender um passe

Você pode vender passes de duas maneiras:

• Dentro da sua experiência
• Fora da sua experiência

Dentro da sua experiência

Para implementar e vender um passe dentro de uma experiência, chame MarketplaceService funções.

Use GetProductInfo() para recuperar informações sobre um passe, como nome e preço, e depois exibir esse passe aos usuários.Você pode vender o passe dentro do mercado da sua experiência, por exemplo.Para passes, o segundo parâmetro deve ser Enum.InfoType.GamePass .

local MarketplaceService = game:GetService("MarketplaceService")

-- Substitua o ID do espaço reservado com o ID do seu passe
local productId = 000000

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


if success and productInfo then
	-- Verifique se o produto está à promoção/venda
	if productInfo.IsForSale then
	-- Exibir informações do produto
	-- Substitua as declarações de impressão por código de UI para exibir o passe
  	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

Use PromptPurchase() para solicitar uma compra de passe se o usuário ainda não tiver o passe em seu inventário.Você pode chamar essa função quando um usuário executa ações como pressionar um botão ou falar com um NPC fornecedor.

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

-- Substitua o ID do espaço reservado com o ID do seu passe
local passID = 0000000

-- Comprar passagem comprar
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
		-- Mostrar uma mensagem dizendo ao usuário que ele já possui o passe
	else
		-- Comprar passagem comprar
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Use PromptGamePassPurchaseFinished() para lidar com um prompt de passe concluído e comprar e atribuir ao usuário os privilégios associados ao passe.

Coloque o script dentro do ServerScriptService para que o servidor lidar com os privilégios de passe do usuário.

local MarketplaceService = game:GetService("MarketplaceService")

-- Substitua o ID do espaço reservado com o ID do seu passe
local passID = 0000000  -- Altere isso para o seu ID de Passe

-- Lidar com um prompt concluído e uma comprar
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
	if purchaseSuccess and purchasedPassID == passID then
		print(player.Name .. " purchased the Pass with ID " .. passID)
		-- Atribua ao usuário a capacidade ou bônus relacionada ao passe
	end
end

-- Conectar eventos PromptGamePassPurchaseFinished ao funcionamento
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)

Fora da sua experiência

Para vender um passe na aba Loja da página de detalhes da experiência:

1. Vá para Monetização > Passes .
2. Passe o mouse sobre o passe e clique no menu ⋯ .
3. Selecione o passe que você quer vender.
4. Selecione Vendas .
5. Ative para Item à Venda alternar.
6. No campo Preço em Robux , insira a quantidade de Robux que deseja cobrar dos usuários pelo passe.O preço que você insere afeta quanto Robux você ganha por promoção/venda.O preço que você insere afeta quanto Robux você ganha por promoção/venda.O preço mínimo é 1 Robux, e o preço máximo é 1 bilhão de Robux.
7. Clique em Salvar Alterações . O passe preenche na aba Loja da página de detalhes da experiência.

Atribuir privilégios de passe

Você deve atribuir manualmente privilégios de passe a usuários que comprarem seus passes.Para fazer isso, use quando um usuário se juntar à sua experiência para verificar se eles já possuem o passe e para atribuir-lhes as permissões de passe.

Coloque o script dentro do ServerScriptService para que o servidor lidar com os privilégios de passe do usuário.

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

-- Substitua o ID do espaço reservado com o ID do seu passe
local passID = 0000000

local function onPlayerAdded(player)
	local hasPass = false

	-- Verifique se o usuário já possui o passe
	local success, message = pcall(function()
		hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
	end)

	if not success then
		-- Emite um aviso e saia da função
		warn("Error while checking if player has pass: " .. tostring(message))
		return
	end

	if hasPass then
		-- Atribuir ao usuário a capacidade ou bônus relacionada ao passe
		print(player.Name .. " owns the Pass with ID " .. passID)
	end
end

-- Conectar eventos adicionados do jogador à função
Players.PlayerAdded:Connect(onPlayerAdded)

Dados analíticosde passes

Use a análise de dados de passe para analisar o sucesso de passes individuais, identificar tendências e prever potenciais ganhos futuros.

Com Dados analíticos, você pode:

• Veja seus principais passes durante um período de tempo selecionado.
• Mostre até oito itens mais vendidos em um gráfico de série temporal para analisar as vendas gerais e a receita líquida.
• Monitore seu catálogo e classifique itens por vendas e receita líquida.

Para acessar a Dados analíticospasses:

1. Vá para Criações e selecione uma experiência.
2. Vá para Monetização > Passes .
3. Selecione a aba Análise de Dados .