Ideias e funcionalidades do jogo

A tua próxima funcionalidade

Valores do jogador

Moedas, contadores e energia geridos pelo servidor. Defina saldos, ofertas e alterações verificadas por projeto.

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

O jogo mostra os saldos e as ofertas configurados. As compras devolvem o estado atual do jogador.

Vídeo em breve

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

Valores do jogador

Preparar o mesmo projeto

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

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

    Valores
    coins: initialBalance=100, maxBalance=1000000; energy: initialBalance=10, maxBalance=100
    Permitir alterações diretas
    false
    Ofertas
    energy-pack: costs=[{"key":"coins","amount":20}], rewards=[{"key":"energy","amount":5}]

    O saldo inicial é atribuído uma única vez por chave. As alterações diretas começam desativadas. Validated Actions mantém os limites por partida; os limites diários e de saldo vêm destas definições. Um limite opcional vazio significa sem limite.

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

GDScript
res://scripts/player_values.gd
Chamada ao horizOn
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5func run_reviewed_action() -> void:
6 if not Horizon.auth.isSignedIn():
7 return
8 var user_id: String = Horizon.auth.getCurrentUser().userId
9 var current: Dictionary = await Horizon.playerValues.getState(user_id)
10 if not current.success:
11 push_error(current.errorCode)
12 return
13 print(current.state.values)
14 # Authoritative balances only; never add a copied historical reward locally.
15 # Purchases and exact original retry use the official player_values_example.gd
16 # and pending_purchase.gd. Persist the original user/offer/operationId before send.
17 # Keep an uncertain or expired original; do not silently create another ID.
Abrir o exemplo SDK completo ↗

Testa a tua nova funcionalidade.

O jogo mostra os saldos e as ofertas configurados. As compras devolvem o estado atual do jogador.

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

Endpoints da API
  • GET/player-values
  • GET/player-values/offers
  • POST/player-values/purchase
  • POST/player-values/adjust
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.