Cardboard: Executando Plugins Bukkit em Servidores Fabric

O que Cardboard Faz (e Não Faz)

Cardboard é um projeto Java que permite instalar plugins Bukkit em um servidor Fabric. Essa é a proposta. Se você já quis executar o ecossistema de mods Fabric junto com a biblioteca de plugins histórica do Bukkit, Cardboard preenche essa lacuna. Com 1.161 estrelas no GitHub, tem uma comunidade sólida por trás, mas vale a pena entender o que você realmente está obtendo antes de configurar um servidor de produção.

Aqui está o verdadeiro apelo: mods Fabric e plugins Bukkit resolvem problemas diferentes. Fabric oferece desenvolvimento de mods de baixo nível com integração profunda ao mecanismo do jogo. Plugins Bukkit são mais leves, executam em um ambiente isolado e dominam o ecossistema de plugins para ferramentas de administrador, sistemas de permissões e mecânicas de jogo. Cardboard permite que você tenha ambos em um servidor.

Por que Você Quereria Isso

Pense no que um servidor de comunidade típico precisa. Você quer proteção contra vandalismo (plugin Bukkit). Alguém quer aprimoramentos visuais ou mecânicas baseadas em mods (mods Fabric). Alguém quer gerenciamento de permissões e sistemas de patentes (plugins Bukkit). Alguém quer otimizações de desempenho que existem apenas como mods Fabric. Normalmente, você teria que escolher.

Se você já executou um servidor Spigot ou Paper antes, o apelo é óbvio. Cardboard permite que você reutilize todo esse conhecimento e todos esses plugins que já configurou, enquanto também executa mods Fabric que não existem como plugins Bukkit. A alternativa é manter dois servidores completamente separados ou reescrever plugins do zero como mods Fabric - o que é muito trabalho.

O problema é a compatibilidade.

Suporte de Versão Atual e Verificação de Realidade

Cardboard atualmente suporta Fabric 1.21.8 (desenvolvimento ativo), 1.21.4 (suporte baixo) e 1.21.1 (suporte baixo). Versões 1.20 e anteriores não são mais suportadas. Se você está em uma versão antiga, precisará atualizar seu servidor primeiro.

"Suporte baixo" significa que correções de bugs e adições de recursos acontecem principalmente para 1.21.8. Se você relatar um problema em 1.21.1, não espere o mesmo tempo de resposta. Este é um projeto dirigido por voluntários com recursos limitados, então eles estão focando na versão mais recente.

Nem todo plugin Bukkit funcionará perfeitamente. Cardboard implementa a API Bukkit em cima do Fabric. Isso significa que ele deve traduzir entre duas arquiteturas fundamentalmente diferentes. Alguns plugins dependem muito do código interno do Spigot (chamado NMS, ou net.minecraft.server). Cardboard pode remapear essas classes automaticamente, mas como os desenvolvedores observam, o sistema "está longe de ser perfeito".

Como Configurar

A instalação não é tão simples quanto deixar um JAR na pasta de plugins porque Cardboard É seu servidor. Aqui está o processo:

1. Baixe o build Cardboard para sua versão do Minecraft em cardboardpowered.org.
2. Crie um novo diretório de servidor e coloque o JAR Cardboard lá.
3. Execute o servidor uma vez para gerar server.properties e outros arquivos de configuração.
4. Pare o servidor e coloque seus plugins Bukkit na pasta de plugins - assim como você faria em qualquer servidor Bukkit.
5. Inicie o servidor novamente e configure seus plugins conforme necessário.

Para testar antes de você se comprometer com a produção, pegue um subdomínio gratuito usando a ferramenta Free Minecraft DNS em Minecraft.How. Leva dois minutos e permite que você aponte um domínio para seu servidor de teste sem pagar por hospedagem.

A curva de aprendizado é mínima se você já usou Bukkit ou Spigot antes. Se você é novo em administração de servidores, isso adiciona uma camada extra de complexidade que você provavelmente não precisa. Comece com Fabric vanilla ou Spigot regular primeiro.

Compatibilidade de Plugins: O Que Pode Quebrar

Antes de migrar um servidor de produção, teste seus plugins essenciais em uma instância de preparação. Isso é inegociável.

Alguns plugins dependem de recursos do Bukkit que Cardboard implementa. Outros dependem de detalhes internos que o remapeamento do Cardboard não consegue lidar. O projeto usa SpecialSource e SrgLib para remapear classes Spigot para seus equivalentes Fabric, o que lida com muitos casos, mas nem todos. Se um plugin modifica o comportamento de entidade alcançando profundamente os detalhes internos do Minecraft, ele pode quebrar ou exigir correções.

Os mantenedores mantêm um canal Discord com indicadores de progresso fixados mostrando o que é conhecido por funcionar e o que ainda é bruto. Verifique lá antes de testar plugins. Saber antecipadamente que "plugin X tem problemas com remapeamento NMS" economiza horas de depuração.

Na verdade, até mesmo plugins populares às vezes têm problemas. Um plugin de permissões que funciona perfeitamente em Paper pode se comportar mal em Cardboard devido a diferenças sutis em como os eventos disparam ou como o tick do servidor funciona. E é por isso que o staging é essencial.

Dicas Práticas e Armadilhas

Aqui está o que mais confunde as pessoas: assumir que compatibilidade Bukkit significa "tudo funciona". Não funciona. Trate como "a maioria das coisas funciona, teste primeiro".

Segunda armadilha: misturar mods Fabric e plugins Bukkit pode criar interações estranhas. Se um mod Fabric modifica quebra de bloco e um plugin Bukkit quer impedir quebra de bloco, você pode encontrar casos extremos. O mod atua em um nível mais baixo que o plugin, portanto pode contornar alguma lógica do plugin. Teste cenários realistas.

Terceiro: o projeto está em desenvolvimento ativo mas focado na versão mais recente. Se você está em 1.21.4 e encontra um bug, atualizar para 1.21.8 pode corrigi-lo, mas você nem sempre pode manter versões antigas.

Se você está configurando permissões complexas ou proteção contra vandalismo, não assuma que plugins Bukkit projetados para Paper simplesmente funcionarão. Spigot NMS é uma camada de compatibilidade; o remapeamento de Cardboard é outro. Duas camadas de compatibilidade significam dois lugares onde as coisas podem subtilmente quebrar.

Quando Usar Cardboard (e Quando Não Usar)

Se você está executando um pequeno servidor de amigos e quer tanto mods Fabric quanto plugins Bukkit, Cardboard vale a pena testar. Se você quer apenas Fabric, não o use; apenas execute Fabric. Se você quer plugins puros Bukkit com zero mods, use PaperMC em vez disso.

O ponto ideal é: você tem um conjunto de plugins Bukkit que ama, existem mods Fabric que você também quer, e você está disposto a testar compatibilidade antes de ir ao vivo. Se qualquer uma dessas três coisas não for verdadeira, uma opção mais simples provavelmente existe.

Servidores públicos grandes frequentemente evitam Cardboard porque o risco de compatibilidade é maior e o retorno nem sempre vale a pena. Se você está hospedando para centenas de jogadores, fique com Paper ou Spigot. Se você está hospedando para amigos, Cardboard vale a pena experimentar.

Alternativas e Comparações

Se você quer plugins sem mods, Paper é mais simples e estável. Se você quer mods sem plugins, use Fabric diretamente ou Quilt. Se você quer um sistema de plugins Fabric, procure pela especificação de plugin do Quilt Loader ou pelo sistema de módulos da Fabric API.

Cadix é outro projeto com objetivos similares, mas é menos maduro. Mohist tentou algo similar para Forge e lutou com manutenção. Cardboard funciona em parte porque a API Bukkit é bem documentada e as ferramentas de remapeamento - SpecialSource e SrgLib - já existiam.

A real vantagem do Cardboard em relação a construir algo você mesmo é o trabalho da comunidade já feito. Você não está reinventando compatibilidade de plugins; você está usando anos de esforço dos times Bukkit, Spigot e Paper.

A Comunidade e O Que Vem Depois

O projeto tem um Discord com mantenedores ativos e testadores. Apex Hosting executa um servidor de teste público em cardboardmod.apexmc.co:25666 se você quiser vê-lo em funcionamento antes de configurar o seu. Isso é genuinamente útil para entender que impressão dá um servidor Cardboard em funcionamento.

Para ferramentas de administrador e configuração, a ferramenta de pesquisa de blocos em Minecraft.How é útil para procurar rapidamente IDs e propriedades de blocos ao configurar plugins Bukkit ou mods Fabric.

O desenvolvimento está em andamento. O projeto credita os times Bukkit, Spigot e Paper (cuja licença GPL-3.0 o projeto herda), mais Glowstone para o carregador de bibliotecas e os desenvolvedores por trás de SpecialSource e SrgLib. É um esforço da comunidade construído em anos de trabalho anterior.

Se você está considerando Cardboard, junte-se ao Discord, teste uma lista de plugins em um servidor de preparação e verifique os indicadores de progresso para sua versão. Se seus plugins funcionam e você testou mods junto com eles, você tem um servidor híbrido sólido. Se algo quebrar, o fallback é direto: mova seus plugins para um servidor PaperMC em vez disso.