Products and Bundles
Produtos e Pacotes
A loja do Cobblemon BattleHUB é dividida em duas partes: a vitrine estática (produtos fixos e pacotes) e a roleta de rotação. O arquivo shop.json é responsável por gerenciar a parte estática, onde você pode vender itens, bundles de Pokémon, cosméticos (via comandos) ou benefícios (VIPs).
Caminho do Arquivo
config/cobblemon_battlehub/shop.json
Estrutura do JSON
Abaixo, um exemplo da estrutura que o mod gera, com um bundle (pacote que roda vários comandos) e um item comum:
{
"shop": [
{
"id": "example_bundle",
"name": "Tinkaton Bundle",
"type": "bundle",
"description": "Adquira este incrível pacote rosa com a linha evolutiva completa!",
"price": 1500.0,
"discount": 15,
"currency": "Dollars",
"currencyName": "<green><bold>%price%$</bold></green>",
"featured": true,
"scale": 1.3,
"offsetX": 0,
"offsetY": 0,
"width": 120,
"height": 160,
"maxPurchases": 1,
"imageUrls": ["https://i.imgur.com/ZGNJEw7.png"],
"includedItems": ["Shiny Tinkaton com IVs Perfeitos", "5x Diamantes"],
"commands": [
"pokegiveother %player% tinkaton s min_perfect_ivs=6",
"give %player% diamond 5"
]
},
{
"id": "abilitypatch",
"name": "AbilityPatch",
"type": "item",
"description": "Altera a habilidade do seu Pokémon para a Hidden Ability.",
"price": 1000.0,
"discount": 0,
"currency": "Dollars",
"currencyName": "<green><bold>%price%$</bold></green>",
"featured": false,
"scale": 1.0,
"offsetX": 0,
"offsetY": 0,
"width": 60,
"height": 60,
"maxPurchases": 0,
"imageUrls": ["https://i.imgur.com/T9VPbyx.png"],
"includedItems": ["1x Ability Patch"],
"commands": ["give %player% cobblemon:ability_patch"]
}
]
}
Explicação dos Parâmetros
1. Identificação e Metadados
id: String única que identifica o produto no banco de dados.
Atenção
Nunca altere o ID de um produto depois que jogadores já o compraram, senão eles perdem o histórico de compra e podem burlar os limites.
name: O nome do produto (suporta MiniMessage e cores legadas).type: Só afeta o selo dos cards em destaque —"bundle"mostra a tag "Bundle", qualquer outro valor mostra "Item". Não muda comportamento; um card com várioscommandsfunciona seja qual for otype.description: O texto de descrição exibido na dica de ferramenta (tooltip) do item.featured: (true/false) Se for verdadeiro, o produto aparecerá em destaque na prateleira superior da loja em tamanho maior.
2. Economia e Valores
price: Valor base do produto.discount: Valor em porcentagem de desconto (Ex: 15 \= 15% de desconto). O mod exibirá uma etiqueta de promoção visual.currency: O ID interno da moeda que o sistema ImpactorBridge irá cobrar do jogador.currencyName: A formatação visual de como a moeda e o preço aparecem no menu. Use %price% onde o número deve ser inserido.
3. Renderização Visual (GUI)
imageUrls: Lista de links diretos para imagens (ex: Imgur). O mod faz o download, armazena em cache (via WebImageCache) e as renderiza no menu. Se tiver mais de uma, elas atuarão como um GIF animado.width / height: Resolução base na qual a imagem será desenhada no menu.scale: Multiplicador de tamanho do ícone no menu (Padrão: 1.0).offsetX / offsetY: Ajustes finos em pixels para mover a imagem caso ela fique descentralizada no card.
4. Limites e Recompensas
maxPurchases: Limite máximo de vezes que um jogador pode comprar este item na vida. Se definido como 0, o item pode ser comprado infinitas vezes.includedItems: Uma lista de textos exibida no menu flutuante (tooltip) mostrando o que vem no pacote.commands: A lista de comandos executada pelo console quando a compra é aprovada. A variável %player% é substituída pelo nick de quem comprou.