Manual › FH VIRTUAL PAINEL › DCoins: saldo, moeda física e recarga

DCoins: saldo, moeda física e recarga

Todas as formas de o jogador ganhar DCoins e como o administrador consulta e corrige saldos.

Nesta páginaDe onde vêm as DCoins Arquivo de saldo Moeda física (FHShopCoin)Recompensa por tempo online Recarga com dinheiro real

De onde vêm as DCoins

Fonte	Como
Saldo inicial	`StartCurrency`, uma vez, quando o arquivo do jogador é criado.
Moeda física	Item `FHShopCoin` convertido na loja (abaixo).
Recompensa por tempo	Pagamento periódico a quem está online.
Recarga com dinheiro real	Pacotes pagos pelo site (opcional, precisa de licença de pagamento).
Admin	Edição do arquivo de saldo.

Arquivo de saldo

Shop/Players/PlayerDatabase/<SteamID64>.json

{ "SteamID64": "76561198XXXXXXXXX", "NamePlayer": "Nick", "Balance": 500 }

O arquivo é relido toda vez que o jogador abre a loja: dá para editar o Balance com o servidor ligado; vale na próxima abertura.
O campo SteamID64 tem que ser igual ao nome do arquivo. Nunca copie o arquivo de um jogador para outro sem trocar esse campo, e nunca deixe vazio — senão o saldo deixa de ser salvo.

Dar moedas a um jogador

Peça o SteamID64 do jogador (ou veja na loja dele, que mostra o ID).
Abra PlayerDatabase/<ID>.json e some no Balance.
Salve. O jogador fecha e abre a loja para ver.

Se o jogador nunca entrou no servidor, o arquivo ainda não existe. Peça para ele entrar uma vez antes.

Moeda física (FHShopCoin)

Item "Moeda de Ouro", empilha até 100.
Com a pilha cheia (100) nas mãos, aparece a ação "Converter Moedas para Loja Virtual" (5 s, agachado).
Converte 1 moeda = 1 DCoin e o item some. Reabra a loja para ver o saldo novo.
O mod não coloca a moeda no mapa: adicione no types.xml, em trader, missões, airdrops etc.

Recompensa por tempo online

No Shop/Config.json:

"ActiveReward": 1,
"TimeReward": 1800,
"CoinReward": 10,
"MessageReward": "Você foi recompensado com %1 %2! Continue jogando para mais."

A cada TimeReward segundos, todos os jogadores online naquele momento recebem CoinReward (não é proporcional ao tempo jogado).
Notificação na tela com MessageReward (%1 = quantidade, %2 = nome da moeda).
CoinReward 0 = ninguém ganha. Mudou? Reinicie.

Recarga com dinheiro real

Opcional. Usa a plataforma de pagamentos Spark e precisa de licença de pagamento.

ConfigPayment.v1.json

Campo	O que faz
`AtivarPagamento`	Liga a recarga real.
`LicensePrivateKey`	Chave da sua conta de pagamentos.
`AtivarWebhookDiscord / UrlWebhookDiscord`	Aviso de pagamento no Discord (enviado pela plataforma).
`NomeDaLoja / ImagemURLDaLoja`	Nome e logo na página de pagamento.
`Pagamentos`	Formas de pagamento e dados — preenchidos pela plataforma no primeiro start com licença válida.

No console do servidor aparece [FHShop] Pagamentos Validados! ou Pagamentos Desativados: motivo.

ConfigPaymentPacks.v1.json (pacotes)

Criado só depois que a licença de pagamento é validada.

{
  "NomePack": "Pacote Nome",
  "DescCoins": "300 Moedas",
  "ValorPack": "R$ 1,50",
  "ImagemPath": "FH-Shop/src/data/gui/pacote.edds",
  "Gateway_NomePack": "300 Moedas",
  "Gateway_Valor": 1.50,
  "Gateway_Moedas": 300
}

NomePack, DescCoins, ValorPack e ImagemPath = só o que aparece na tela.
Gateway_Valor = valor cobrado de verdade (R$). Gateway_Moedas = DCoins creditadas.
Fábrica: 300 / R$ 1,50 · 600 / R$ 3,00 · 900 / R$ 4,50.

Como o jogador recarrega

Na loja, clica em Recarregar e escolhe o pacote.
"Gerando pagamento e Abrindo site externamente!" — o navegador abre a página de pagamento.
Paga. O servidor confere os pagamentos a cada 5 minutos e credita as DCoins.

Avise os jogadores que o crédito pode levar até 5 minutos e que é preciso reabrir a loja para ver o saldo.