Storage
Configuração de Banco de Dados
O sistema de armazenamento do Cobblemon BattleHUB permite salvar com segurança o progresso das missões, o histórico de compras de loja e as estatísticas competitivas (Elo/Glicko-2) de todos os jogadores. O mod oferece suporte nativo tanto a SQLite (banco local) quanto a MySQL (banco remoto para redes de servidores).
Como Configurar Passo a Passo
Opção A: Utilizar SQLite (Sem Configurações adicionais)
Não há necessidade de fazer absolutamente nada! Basta iniciar o seu servidor e o mod criará o arquivo local battlehub_database.db no caminho:
config/cobblemon_battlehub/storage/battlehub_database.db
Opção B: Utilizar Conexão MySQL (Recomendado para Redes)
- Acesse o gerenciador de bancos de dados do seu painel de hospedagem de servidores e crie uma nova database limpa (ex:
cobblemon_battlehub). - Desligue o seu servidor físico de Minecraft.
- Abra o arquivo
storage.jsondo mod. - Altere
"storageType"para"mysql". - Preencha o
"host","port","database","username"e"password"com as credenciais geradas pela sua hospedagem. - Inicie o servidor físico.
Aviso Importante sobre Mudança de Driver
Mudar o driver de armazenamento (sqlite para mysql ou vice-versa) exige que o servidor passe por uma inicialização/reinicialização completa para que os drivers de conexão e as queries iniciais sejam processadas de forma segura. Não utilize apenas o comando /bh reload ao alternar os drivers de banco.
Caminho do Arquivo
config/cobblemon_battlehub/storage/storage.json
Modelo Padrão de Configuração
Abaixo está a estrutura gerada automaticamente na primeira inicialização do mod:
{
"storageType": "sqlite",
"host": "localhost",
"port": 3306,
"database": "cobblemon_battlehub",
"username": "admin",
"password": "password",
"tablePrefix": "bhub_"
}
Explicação Detalhada dos Parâmetros
1. Tipo de Armazenamento (storageType)
storageType(Valores aceitos:"sqlite"ou"mysql"| Padrão:"sqlite"):sqlite: Cria um banco de dados em arquivo local de forma totalmente automática. Ideal para servidores em fase de testes ou isolados. Não requer nenhuma configuração externa.mysql: Conecta a um servidor de banco de dados remoto (externo). É a opção recomendada se você utiliza redes de servidores (como Velocity ou BungeeCord) para permitir a sincronização de dados instantânea dos jogadores entre os mundos.
2. Credenciais de Conexão (Apenas para MySQL)
host(Padrão:"localhost"): O endereço de IP ou domínio onde o seu servidor de banco de dados MySQL está hospedado.port(Padrão:3306): A porta de conexão de rede do seu servidor MySQL (geralmente 3306).database(Padrão:"cobblemon_battlehub"): O nome da database dentro do servidor SQL onde as tabelas do mod serão criadas. (Você precisa criar este banco manualmente no seu painel antes do mod se conectar!)username(Padrão:"admin"): O usuário de acesso do banco de dados MySQL que possui permissão de leitura e escrita.password(Padrão:"password"): A senha de acesso correspondente ao usuário configurado.
3. Organização de Tabelas
tablePrefix(Padrão:"bhub_"):
O prefixo adicionado antes do nome de cada tabela no banco. Isso é muito útil para evitar conflitos de nomes se você compartilhar o mesmo banco de dados com outros plugins ou mods.
Estrutura das Tabelas Criadas
Assim que o banco de dados é conectado com sucesso, o mod executa automaticamente as queries de criação de tabelas (CREATE TABLE IF NOT EXISTS). A estrutura é composta por:
<prefixo>quest_progress:Salva o progresso individual e o histórico de conclusão das missões diárias e mensais de cada jogador.<prefixo>player_stats:Guarda todos os dados estatísticos competitivos, histórico de Elo, vitórias e derrotas.<prefixo>shop_history:Registra o histórico e limites de compra de cada usuário na loja.