GerenciamentoPlugins e Datapacks

    Plugins e Datapacks

    A ceu.gg possui uma biblioteca integrada para buscar e instalar plugins e datapacks diretamente pelo painel, com recursos do CurseForge e Modrinth.

    Importante

    Plugins só funcionam em servidores Paper, Spigot, Purpur ou similares. Servidores Vanilla não suportam plugins. Datapacks funcionam em qualquer tipo de servidor Minecraft Java.

    Instalando plugins

    Passo 1 - Acesse a aba Plugins

    Entre no painel do seu servidor e vá em Configurações → aba Plugins.

    Essa aba só aparece em servidores compatíveis com plugins (Paper, Spigot, Purpur). Se o servidor for Vanilla, a aba não estará disponível.

    Passo 2 - Escolha a fonte

    No canto superior da biblioteca, um seletor permite escolher entre CurseForge e Modrinth.

    As duas plataformas possuem catálogos diferentes. Se não encontrar um plugin em uma, tente na outra. Trocar de fonte limpa as seleções.

    Passo 3 - Busque o plugin

    Use o campo de busca para pesquisar por nome ou descrição. Os resultados aparecem automaticamente enquanto você digita.

    Cada plugin mostra: nome, descrição, ícone, categoria, número de downloads e autor.

    Passo 4 - Selecione plugins e versão

    Clique no plugin desejado para selecioná-lo. Você pode selecionar vários plugins de uma vez. Plugins selecionados ficam destacados com uma borda e aparecem como badges no topo.

    Ao selecionar um plugin, um dropdown de versão aparece à direita. Por padrão, a versão mais recente é selecionada. Se precisar de uma versão específica, altere no dropdown.

    Passo 5 - Adicionar ao servidor

    Com os plugins selecionados, clique em "Adicionar Plugins".

    Um diálogo de confirmação mostra a lista de plugins e versões escolhidos. Clique em "Adicionar agora" para confirmar.

    A instalação mostra uma barra de progresso com o status de cada plugin (Pendente → Adicionando → Adicionado).

    Passo 6 - Reinicie o servidor

    Após a instalação, os plugins são copiados para a pasta /plugins do servidor. Eles serão carregados na próxima inicialização.

    Reinicie o servidor para ativar os plugins. Verifique o console para confirmar que carregaram sem erros.

    Dica

    Instale poucos plugins por vez (1–3) e reinicie entre cada lote. Isso facilita identificar qual plugin causa problemas se algo der errado.

    Instalando datapacks

    O fluxo para datapacks é idêntico ao de plugins, com estas diferenças:

    • Acesse a aba Datapacks (em vez de Plugins).
    • Datapacks funcionam em qualquer tipo de servidor (incluindo Vanilla).
    • Os datapacks são instalados na pasta do mundo (geralmente /world/datapacks).
    • Reinicie o servidor para ativar os datapacks.

    Mods e Modpacks

    Em desenvolvimento

    O suporte a mods (Forge/Fabric) e modpacks (CurseForge/Modrinth) está em desenvolvimento. Acompanhe o progresso no Roadmap.

    Boas práticas

    • Verifique compatibilidade - Confirme que o plugin/datapack é compatível com a versão do seu Minecraft e tipo de servidor (Paper/Spigot).
    • Instale em lotes pequenos - 1 a 3 por vez, reiniciando entre cada lote. Facilita identificar problemas.
    • Faça backup antes - Especialmente antes de instalar plugins que mexem em mundos, economia ou permissões.
    • Cheque o console - Após reiniciar, verifique o console para confirmar que tudo carregou sem erros.
    • Prefira fontes confiáveis - CurseForge e Modrinth são integrados ao painel. Evite baixar plugins de fontes desconhecidas.
    • Nunca use /reload - Após instalar ou atualizar plugins, sempre reinicie o servidor. O comando /reload pode causar erros e instabilidade.

    Problemas comuns

    Plugin não carrega após instalar

    Verifique no console se há erros como Could not load plugin ou InvalidPluginException. Geralmente é incompatibilidade de versão ou dependência faltando.

    Veja: Compatibilidade de plugins

    Aba Plugins não aparece

    A aba só é visível em servidores compatíveis com plugins (Paper, Spigot, Purpur). Se o servidor for Vanilla, use datapacks em vez de plugins.

    Mensagem "Sem permissão"

    Apenas membros com cargo Administrador ou Dono podem adicionar plugins e datapacks. Peça para alguém com permissão alterar seu cargo.

    Veja: Cargos e permissões

    Datapack não funciona

    Confirme que o datapack é compatível com a versão do Minecraft. Verifique o console por erros como Failed to load datapacks.

    Veja: Datapacks: diagnóstico

    Quem pode instalar?

    A instalação de plugins e datapacks requer cargo Administrador ou Dono na comunidade. Membros e Moderadores não possuem essa permissão.

    Veja a matriz completa em Cargos e permissões.