Packs com marca d'água
Entregue resource packs, mapas e plugins com uma cópia identificada por comprador e descubra quem vazou um arquivo.
O serviço de packs da MinePag entrega arquivos ZIP (resource packs, mapas, plugins .jar) com uma marca d'água por comprador. Se uma cópia aparecer em um site de vazamentos, você envia o arquivo ao inspetor e descobre de qual compra ele saiu.
O serviço é hospedado e operado pela MinePag e funciona como um serviço externo da loja. Cada loja recebe uma instalação própria: você não instala nada, só ativa o serviço, cadastra os arquivos e configura o produto.
O que a marca d'água faz e o que não faz
A marca d'água é rastreio e dissuasão, não proteção contra cópia.
| Faz | Não faz |
|---|---|
| Grava em cada cópia um identificador de licença assinado, em três lugares do arquivo. | Não impede que o comprador use, copie ou repasse o arquivo. |
| Permite descobrir a compra de origem de uma cópia vazada. | Não é DRM: o pack funciona normalmente em qualquer Minecraft. |
| Desencoraja o vazamento, porque o comprador sabe que a cópia leva a compra dele. | Não resiste a quem abrir o ZIP e apagar as marcas de propósito. |
| Funciona sem recompactar o arquivo: o conteúdo original fica idêntico. | Não grava e-mail, nome, IP ou qualquer dado pessoal do comprador no arquivo. |
As três marcas, em ordem de confiança:
- Comentário do ZIP (
MP1:<licença>:<assinatura>), assinado com HMAC. - Manifesto em
META-INF/minepag/license.json, com a licença, o arquivo e a data de emissão, também assinado. - Seção
minepagnopack.mcmeta, quando o arquivo é um resource pack. O Minecraft ignora seções desconhecidas, então o pack não muda.
Recompactar o arquivo apaga o comentário, mas o manifesto e o pack.mcmeta continuam. Só quem conhece o mecanismo e apaga as três marcas consegue uma cópia sem rastro.
Arquivos aceitos
- ZIP sem Zip64: até 4 GiB e 65.535 entradas;
- ZIP sem criptografia;
- até 100 MB por envio.
Arquivos fora disso são recusados no envio.
Como o comprador recebe
A forma recomendada é o benefício Download com a marca d'água ligada:
Envie o arquivo nos dois lugares
Envie o arquivo em Catálogo › Arquivos na MinePag e também na página do lojista do serviço de packs (veja Enviar os arquivos base). Use o mesmo arquivo nos dois: a área do cliente mostra o nome e o tamanho do arquivo da MinePag, mas o comprador baixa o que está vinculado ao produto no serviço de packs.
Configure o benefício
Na aba Entrega do produto, clique em Adicionar benefício, escolha Download, marque o arquivo e ligue Marca d'água por comprador. A validade do link vale na área do cliente. O limite de downloads que conta é o do vínculo no serviço de packs (veja Vincule ao produto): com a marca d'água, a MinePag não desconta downloads da cópia personalizada.
O comprador baixa na área do cliente
Depois do pagamento, a MinePag pede a cópia personalizada ao serviço. Enquanto ela não fica pronta, o arquivo aparece em Minha conta › Biblioteca com o aviso "Sua cópia personalizada está sendo preparada. Tente de novo em alguns minutos." Quando o serviço confirma, o download leva o comprador à página de downloads dele no serviço de packs.
A MinePag usa o primeiro serviço externo ativo da loja para personalizar os downloads. Se a loja não tiver nenhum, o comprador vê "Este arquivo não está disponível no momento. Fale com a loja." e a entrega registra o aviso "Marca d'água pedida, mas a loja não tem serviço externo ativo."
Cada compra entregue com marca d'água conta uma unidade em "entregas com marca d'água" na sua fatura, inclusive pedidos gratuitos, com 100 por mês incluídas. Só conta a entrega em que o serviço de packs confirma que aplicou a marca; reenvios e links comuns de outros serviços externos não contam. Veja Preços.
A lista de verificação do produto avisa quando um benefício pede marca d'água e a loja não tem serviço externo ativo: nesse caso, o produto não pode ser publicado.
Benefício Serviço externo não mostra o link ao comprador
Você também pode usar o benefício Serviço externo apontando para o serviço de packs. Nesse caso, o link da página de downloads fica só no detalhe da entrega no painel e no evento delivery.completed; a área do cliente não mostra. Prefira Download com marca d'água.
A página de downloads do comprador
- O endereço da página é estável e pode ser reenviado ao comprador.
- Cada clique em baixar gera um link próprio que vale por 5 minutos.
- O limite de downloads é controlado de forma atômica: dois cliques ao mesmo tempo nunca passam do limite.
- Retomar um download interrompido com o mesmo link não gasta o limite, por até 24 horas.
- Se você trocar o arquivo base, os compradores passam a baixar a versão nova, já com a marca d'água deles.
Ativar o serviço
Peça a ativação
Abra um chamado em Suporte pedindo o serviço de packs para a loja. A equipe da MinePag cria a instalação da sua loja e responde com o endereço dela, por exemplo https://packs-sualoja.minepag.com. Nunca envie chaves ou segredos no chamado.
Crie a chave de API
Em Desenvolvedores › Chaves de API, crie uma chave secreta com o escopo deliveries:write. O serviço usa essa chave para confirmar as entregas, e você usa a mesma chave para entrar na página do lojista do serviço. Guarde a chave: ela só aparece uma vez.
Adicione o serviço externo
Em Entregas › Serviços externos, clique em Adicionar serviço e use a URL https://<endereço do serviço>/webhooks/minepag. Mantenha os eventos delivery.requested, entitlement.revoked e order.refunded.
Conclua a instalação com a equipe
A instalação só funciona com a chave e o segredo whsec_… do serviço externo da sua loja. Na resposta do chamado, a equipe da MinePag explica como entregar esses dois valores por um canal seguro. Nunca cole chaves ou segredos no chamado. Quando a equipe confirmar, siga Enviar os arquivos base.
Enviar os arquivos base
O serviço tem uma página simples para o lojista em https://<endereço do serviço>/admin.
Entre com a chave
Em Acesso, cole a chave secreta da loja no campo Chave secreta da loja na MinePag e clique em Entrar. A chave fica só naquela aba do navegador e é apagada ao fechá-la.
Cadastre o arquivo
Em Arquivos › Novo arquivo, preencha Nome exibido ao comprador e Nome do arquivo baixado (por exemplo, MeuPack.zip) e clique em Cadastrar arquivo. Depois, escolha o .zip na linha do arquivo e clique em Enviar. O serviço valida o arquivo e recusa ZIPs com Zip64 ou criptografia.
Vincule ao produto
Em Produtos, preencha ID do produto na MinePag, escolha o Arquivo, o Limite de downloads por compra e a Validade em dias (vazio = sem prazo), e clique em Adicionar ao produto. Salvar substitui todos os vínculos daquele produto.
O ID do produto aparece no endereço da página do produto no painel da MinePag: /<loja>/catalog/products/<ID do produto>.
Um produto pode ter vários arquivos. O comprador recebe uma licença por arquivo, e todos aparecem na mesma página de downloads.
Descobrir quem vazou
Envie o arquivo encontrado
Na página do lojista, em Inspecionar vazamento, escolha o .zip em Arquivo suspeito (.zip) e clique em Inspecionar. O serviço lê só o índice do ZIP e as entradas pequenas onde ficam as marcas, com limite de descompressão: arquivos maliciosos, como zip bombs, não têm efeito.
Leia o relatório
O relatório mostra quais marcas foram encontradas, se a assinatura confere e a licença identificada, com o pedido, o cliente, o produto e o arquivo. Marcas assinadas (comentário e manifesto) têm prioridade; a do pack.mcmeta sozinha não tem assinatura e serve só como pista.
Encontre a compra na MinePag
Use o ID do pedido para abrir a compra em Vendas › Pedidos. Lá você vê o cliente e pode revogar o acesso dele.
Revogue a licença
Revogue a licença em Licenças: busque pelo pedido, entitlement (acesso liberado) ou cliente, digite o ID completo da licença e clique em Revogar licença. A página de downloads daquela compra para de funcionar. Uma licença revogada não volta a valer.
Os arquivos enviados ao inspetor são apagados depois de 30 dias. Se quiser receber um aviso pack.leak_detected (assinado no padrão Standard Webhooks) a cada vazamento identificado com marca assinada, peça à equipe da MinePag pelo Suporte.
Revogação automática
O serviço revoga as licenças sozinho quando:
- recebe
entitlement.revoked: o acesso do cliente terminou (reembolso total, contestação, cancelamento ou revogação manual); - recebe
order.refundedcomfullyRefunded: true: revoga todas as licenças do pedido.
Dados guardados
- No arquivo: só identificadores opacos (licença, arquivo, data de emissão).
- No banco do serviço: IDs do pedido, do cliente e do produto, sem e-mail nem nome.
- Downloads: IP truncado (/24 no IPv4, /48 no IPv6) e país, por 365 dias.
- Eventos recebidos: apagados 30 dias depois de processados.
Trocar chaves e reenviar links
- Chave de API ou segredo do serviço externo: antes de revogar a chave ou rotacionar o segredo na MinePag, abra um chamado para a equipe atualizar a instalação da sua loja. Durante a troca do segredo, a instalação aceita o antigo e o novo.
- Chaves de marca d'água e de links: ficam com a equipe da MinePag, que guarda as antigas para continuar reconhecendo as cópias já vendidas.
- Reenviar um link: no detalhe da entrega, use Reenviar ao serviço externo (ou Reenviar pelo canal na entrega de download). Pela API, use
POST /api/v1/deliveries/{id}/resendcom uma chavedeliveries:write. O link novo substitui o antigo e o reenvio não conta no faturamento.
Solução de problemas
| Situação | O que fazer |
|---|---|
A entrega falha com product_not_configured | O produto não tem arquivo vinculado no serviço. Vincule em Produtos na página do lojista. A MinePag tenta de novo sozinha. |
A entrega falha com license_revoked | As licenças daquela compra foram revogadas. Uma licença revogada não é reativada. |
| O comprador vê "Sua cópia personalizada está sendo preparada" por muito tempo | Abra a entrega do serviço externo em Entregas › Todas as entregas e veja o último erro. Confira se o serviço está Ativo em Entregas › Serviços externos. |
| O envio do arquivo é recusado | O ZIP usa Zip64, tem criptografia ou passa do tamanho máximo. Recompacte sem senha e confira o limite. |
| O serviço recusa os eventos da MinePag | O segredo do serviço externo provavelmente foi rotacionado sem atualizar a instalação. Abra um chamado em Suporte. |