Ideias e funcionalidades do jogo

A tua próxima funcionalidade

Itens

Equipamento único com propriedades, regras de catálogo e inventário do projeto selecionado.

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

Depois de guardar, o catálogo contém starter_sword. Após a compra revista, o inventário atual contém o seu instanceId único.

Vídeo em breve

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

Itens

Preparar o mesmo projeto

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

    Itens →
  2. Criem ou reutilizem estas entradas de teste no formulário do painel. São valores de exemplo, não dados atuais.

    Chave
    starter_sword
    Nome
    Quickstart Sword
    Tipo
    equipment
    Raridade
    common
    Ativo
    true
    Propriedades base
    {"damage":5}
    Regras de propriedades
    []

    Os itens têm identidade e propriedades próprias. Recursos contáveis ficam nos Valores do jogador; elementos apenas cosméticos ficam no Perfil do jogador.

    Preparem coins com o guia de valores. Guardem a oferta ativa starter-sword: custo de 10 coins, recompensa de 1 starter_sword.

    Valores do jogador →
  3. Guardem, recarreguem e verifiquem as entradas antes do exemplo. Preservem as restantes definições.

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_catalog_page(), read_inventory() através de um botão ou ação explícita da cena. Abrir o ficheiro não envia pedidos.

GDScript
res://scripts/items.gd
Chamada ao horizOn
1extends Node
2​
3# Connect and restore the existing player first. Each function is an explicit action.
4func read_inventory() -> void:
5 var user = Horizon.auth.getCurrentUser()
6 if user == null:
7 return
8 var result = await Horizon.items.getInventory(user.userId)
9 if not result.success:
10 push_warning(result.errorCode)
11 return
12 for item in result.data.instances:
13 print(item.instanceId, ": ", item.itemKey)
14 # Keep result.data.revision for a separately reviewed mutation.
15​
16func read_catalog_page() -> void:
17 var user = Horizon.auth.getCurrentUser()
18 if user == null:
19 return
20 var result = await Horizon.items.getCatalog(user.userId, "", 1)
21 if not result.success:
22 push_warning(result.errorCode)
23 return
24 print("Catalog revision: ", result.data.revision)
25 # Explicit Next retains revision and nextAfterKey; no automatic page loop.
26# Durable mutations: addons/horizon_sdk/examples/features/items_example.gd.
27# Preserve original instance/body/revision and the original PV purchase operationId.
28# Initial success may include item references; retained replay may return empty applied/items.
29# Read the current inventory separately; never reconstruct earlier item references.
30# A failed refresh never authorizes another purchase or a local item grant.
Abrir o exemplo SDK completo ↗

Usar o item guardado

Importem o exemplo oficial e os seus auxiliares. Revejam a oferta e executem a sequência com o jogador atual. Aguardem cada passo e confirmem a compra uma vez. Preservem o pedido original após uma resposta incerta.

items_example.gd: load_catalog_page() → review_offer("starter-sword") → purchase_reviewed_offer() → refresh_inventory()

Testa a tua nova funcionalidade.

Depois de guardar, o catálogo contém starter_sword. Após a compra revista, o inventário atual contém o seu instanceId único.

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

Endpoints da API
  • GET/items
  • GET/items/catalog
  • POST/items/adjust
  • POST/items/equip
  • POST/items/discard
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.