Ideias e funcionalidades do jogo

A tua próxima funcionalidade

Mercado

Troque um item original entre dois jogadores.

SDK: developRequer uma sessão de jogador
Godot
Ilustração de Mercado
O resultado visível

O comprador recebe o mesmo item e o vendedor recebe o preço combinado menos a taxa configurada.

Vídeo em breve

Este passo ainda não tem vídeo. O guia e o pedido MCP já podem ser usados.

Mercado

Preparar o mesmo projeto

  1. Seleciona no painel o mesmo projeto que na configuração do teu jogo.

    Mercado →
  2. O primeiro pedido não exige outra definição. Um resultado vazio é válido enquanto faltarem dados do jogo.

    Definam uma moeda, uma taxa e pelo menos uma regra de preço ativa.

    Use dois jogadores autenticados no mesmo projeto. Configure a moeda, a taxa e a regra de preço, anuncie um item não equipado e confirme explicitamente a compra.

    Itens →Valores do jogador →

Integra esta funcionalidade

Podes consultar o guia. Para o executar, precisas de uma chave de projeto ativa. Preparar o projeto

SDK instalado, configuração do projeto importada e jogador com sessão iniciada.

Este exemplo do SDK usa develop. Verifica se as API necessárias existem no SDK instalado.

Concluam a ligação do início rápido com o jogador escolhido. Chamem read_listing(listing_id) através de um botão ou ação explícita da cena. Abrir o ficheiro não envia pedidos.

GDScript
res://scripts/marketplace.gd
Chamada ao horizOn
1extends Node
2​
3const MarketStart = preload("res://addons/horizon_sdk/examples/features/marketplace_quickstart.gd")
4# Attach marketplace_example.gd to this screen, set its stable project_id,
5# and use the existing authenticated Horizon session for this project.
6@export var screen: Node
7​
8func read_listing(listing_id: String) -> Dictionary:
9 return await MarketStart.read_one_listing(screen, listing_id)
10​
11# Wire only to explicit Buy confirmation after displaying a successful read.
12func confirm_purchase(listing_id: String) -> Dictionary:
13 return await MarketStart.buy_reviewed_listing(screen, listing_id)
14​
15# Unknown outcome: await screen.retry_pending() or recover_original_operation().
16# Keep the original until Inventory, Values and Marketplace have refreshed.
17# Never delete a pending operation or unknown send-owner lock to buy again.
Abrir o exemplo SDK completo ↗

Testar com dois jogadores

Use dois jogadores autenticados no mesmo projeto. Configure a moeda, a taxa e a regra de preço, anuncie um item não equipado e confirme explicitamente a compra.

Use a sessão já autenticada. Após uma compra não confirmada, guarde e repita o mesmo pedido original e atualize depois o inventário e os saldos.

O cancelamento protege o item original até que seu proprietário o resgate. A recuperação só está disponível se o proprietário anterior tiver sido excluído.

Os anúncios e a proteção contra repetições são armazenados uma única vez no projeto. Os jogadores mantêm referências e dados de estado limitados.

Testa a tua nova funcionalidade.

O comprador recebe o mesmo item e o vendedor recebe o preço combinado menos a taxa configurada.

Seleciona no painel o mesmo projeto que na configuração do teu jogo.

Endpoints da API
  • GET/marketplace/limits
  • GET/marketplace/rules
  • GET/marketplace
  • GET/marketplace/listings
  • GET/marketplace/listings/{listingId}
  • POST/marketplace/listings
  • POST/marketplace/listings/{listingId}/buy
  • POST/marketplace/listings/{listingId}/cancel
  • GET/marketplace/operations/{operationId}
  • POST/marketplace/listings/{listingId}/retry-return
Todos os endpoints na referência da API
Ilustração de Tabelas de classificação
A nossa sugestão para o próximo passo

Dá uma pontuação máxima a cada partida.

Guarda a pontuação depois de uma partida e mostra quem está à frente. Continua a usar a ligação e a sessão do jogador.