Passes

Passes deixam você cobrar uma taxa única de Robux para que os usuários acesso 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.

Criando Passes

Para criar um passe:

1. Vá para Criações e selecione uma experiência.
2. Vá para Monetização >.
3. Clique em Criar um Passe .
4. Faça o upload de 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 em .jpg , .png ou .bmp format.
5. Insira um nome e uma descrição para o passe.
6. Clique em Criar Passe .

Obtendo IDs de Passe

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

1. Vá para Monetização >.

2. Passe o mouse sobre o passe e clique no menu ⋯ .

3. Clique em Copiar ID do Recurso para copiar o ID para sua área de transferência.

   

Vendendo Passes

Você pode vender passes dentro ou fora de uma experiência.

Fora de uma Experiência

Para vender um passe na página Loja de uma experiência:

1. Vá para Monetização >.
2. Passe o mouse sobre o passe e clique no menu ⋯ .
3. Selecione o passe que você deseja vender.
4. Selecione Vendas .
5. Habilite 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ê definir afeta quanto Robux você ganha por promoção/venda. O preço que você definir 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 é popularizado na página Loja da experiência.

Dentro de uma Experiência

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

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

local MarketplaceService = game:GetService("MarketplaceService")

-- Substitua o ID de espaço reservado pelo seu ID de 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 com código da 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 não já tiver o passe no 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 de vendedor.

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

-- Substitua o ID de espaço reservado pelo seu ID de passe
local passID = 0000000

-- Exigir comprarde passe
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
		-- Mostre uma mensagem dizendo ao usuário que já possui o passe
	else
		-- Exigir comprarde passe
		MarketplaceService:PromptGamePassPurchase(player, passID)
	end
end

Use PromptGamePassPurchaseFinished() para lidar com uma solicitação de passe concluída 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 usuário.

local MarketplaceService = game:GetService("MarketplaceService")

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

-- Gerencie um prompt concluído e compre
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 relacionado ao passe
	end
end

-- Conecte eventos PromptGamePassPurchaseFinished à função
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)

Atribuindo Privilégios ao Passe

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

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

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

-- Substitua o ID de espaço reservado pelo seu ID de 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
		-- Issue a warning e exit the function
		warn("Error while checking if player has pass: " .. tostring(message))
		return
	end

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

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

Análises de Dados de 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:

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

Para acessar a Dados analíticosde Dados de Passes:

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