Como migrar a loja do servidor da Tebex ou CentralCart

Migrar a loja do servidor tem três partes: levar o catálogo (categorias, produtos, preços e comandos), reconectar os pagamentos na plataforma nova e trocar o plugin de entrega no servidor. O catálogo é a parte rápida, porque várias plataformas importam direto da Tebex ou da CentralCart. O que dá trabalho, e o que costuma dar errado, é o resto: comandos que não vêm junto, assinaturas que continuam na plataforma antiga e entregas que ainda estão na fila quando o plugin antigo sai do servidor.

Os exemplos abaixo usam um servidor de Minecraft.

O que vai junto e o que fica para trás

Antes de começar, separe o que uma importação traz do que você refaz à mão.

Na Gamecart, a página de migração mostra exatamente isso: da CentralCart vêm categorias, produtos, preços, descrições e comandos; da Tebex vem tudo isso menos os comandos. Variáveis, descontos e configuração de servidores são refeitos.

Faça o inventário antes de mexer

Exporte ou anote, produto por produto:

• os comandos de cada evento (compra, expiração, renovação, estorno);
• as variáveis que o produto usa no checkout, como cor de tag ou nome de kit;
• cupons e descontos ativos;
• quantos jogadores têm assinatura ativa e quando cada uma renova.

Esse inventário serve de gabarito na hora de revisar a loja nova. Sem ele, um comando esquecido só aparece quando um jogador paga e não recebe nada.

Pegue a credencial certa

Tebex. A importação usa o Public Token. A documentação da Tebex indica onde ele fica: entre em creator.tebex.io e abra Integrations > API Keys. Segundo a Tebex, esse token foi feito para ser visível e "only allows reading store data and managing baskets", sem acesso a dados financeiros. Não confunda com a chave secreta do plugin, que nunca deve sair do servidor.

CentralCart. A CentralCart usa chaves de API por loja. Pela documentação de autenticação, você cria a chave em Configurações > Integrações, marca as permissões e copia na hora, porque ela "aparece uma única vez". Cada chave pode ser revogada sozinha, então vale criar uma só para a migração e revogar quando terminar.

Importe o catálogo

Na Gamecart, a importação fica em Sua loja > Produtos, no botão Importar:

1. Escolha a origem (Tebex ou CentralCart) e cole a credencial. Ela só é usada para ler o catálogo e não fica salva.
2. Revise a prévia. Os produtos aparecem agrupados por categoria, com avisos do que não vai junto.
3. Marque o que quer trazer e importe. As categorias e os produtos são criados juntos.

Três detalhes que pegam gente desprevenida:

• Moeda. O preço mantém o número na moeda da loja nova. Um VIP de US$ 4,99 na Tebex vira R$ 4,99 numa loja em reais. Ajuste antes de importar se as moedas forem diferentes.
• Limite do plano. O que você importa conta no limite de produtos. No plano Grátis da Gamecart são até 3 categorias e 50 produtos (veja os planos).
• Duplicados. Dá para importar aos poucos, mas a Gamecart não confere duplicados entre importações. Deixe de fora o que já trouxe.

Revise cada comando

Mesmo quando os comandos vêm junto, os placeholders mudam de plataforma para plataforma. Um comando com o placeholder antigo roda com o texto literal no lugar do nick, e o VIP vai para ninguém.

Na importação da CentralCart, a Gamecart já troca {client_identifier} por {identifier} nos comandos. Ainda assim, abra cada comando e confira: outros placeholders, eventos e o texto do comando em si precisam de revisão. Comandos da Tebex não vêm na importação, então você os escreve de novo com {identifier} (por exemplo, lp user {identifier} parent add vip).

Os eventos também precisam de par. Na Tebex existem comandos de compra, expiração, renovação, chargeback e reembolso. Na Gamecart, os gatilhos são On Purchase, On Expiration e On Dispute, e este último também cobre reembolso, rejeição e cancelamento. Para o On Expiration rodar, preencha a duração do produto em dias.

Dois ajustes por comando, no ícone de engrenagem:

• Offline delivery: ligue só se o comando funciona com o jogador fora do servidor. Um give não funciona; um comando de permissão costuma funcionar.
• Ignore quantity: ligue quando o comando deve rodar uma vez só, mesmo que o jogador compre duas unidades.

Se o seu VIP usa LuckPerms, o guia VIP automático no Minecraft explica o addtemp ... accumulate e por que ele importa em renovações.

Pagamentos e assinaturas

As contas de pagamento não migram. Na Gamecart, o dinheiro cai direto na sua conta de cada provedor, então você conecta cada uma em Configurações, na parte de gateways. Em loja que vende em reais, dá para usar Pix por Mercado Pago ou Efí, além de cartão; o guia como receber Pix na loja do servidor cobre essa parte.

Assinaturas pedem mais cuidado. Na Tebex, a página Recurring Payments lista cada assinatura com a próxima data de cobrança, e o status Active quer dizer que ela "will automatically renew at the next billing date". Nenhuma importação leva essa cobrança junto. O jogador cancela pelo próprio portal de pagamentos da Tebex, como diz a página de assinaturas.

Na prática, há dois caminhos: manter a loja antiga ativa até as assinaturas vencerem, ou avisar os assinantes, dar um prazo e pedir que cancelem lá e assinem de novo na loja nova. Não desligue a loja antiga com assinatura ativa sem decidir isso antes.

Troque o plugin sem perder entregas

A troca do plugin é onde se perde VIP. A Tebex, por padrão, só executa o comando quando o jogador está online, segundo a página de solução de problemas. Quem comprou e ainda não entrou no servidor tem comando esperando na fila da Tebex. Se você tirar o plugin da Tebex antes, esse comando não roda.

A ordem que evita isso:

1. Instale o plugin da Gamecart. Crie o servidor em Integrations > Servers, baixe o JAR da sua plataforma (Spigot, Paper, Folia, BungeeCord, Velocity ou Fabric) e cole o token em serverToken, como no guia do conector.
2. Rode gamecart status no console e faça uma compra de teste em cada tipo de produto.
3. Pare de vender na loja antiga: esconda os produtos ou desative a loja, sem apagar.
4. Espere a fila antiga esvaziar e confira no painel dela se ainda há comandos pendentes.
5. Só então remova o plugin antigo.

Use um token da Gamecart por instalação. Dois servidores com o mesmo token disputam os mesmos comandos.

Domínio e anúncio

No plano Grátis, a loja fica num subdomínio gamecart.shop. Domínio próprio começa no Pro, e o guia de domínio pede dois registros: um CNAME para dns.gamecart.gg e um TXT de verificação. No Cloudflare, os dois ficam como DNS only.

Se o domínio da loja já apontava para a plataforma antiga, troque o DNS por último, depois das compras de teste. Assim o link que os jogadores já conhecem passa a abrir a loja nova sem período fora do ar. Depois, atualize o link no Discord, no MOTD e nos comandos /loja do servidor.

Se ainda está decidindo para onde ir, o comparativo Gamecart vs Tebex mostra taxas e repasses lado a lado, e a página do Minecraft lista as plataformas de servidor suportadas.