Alguns mods são exclusivos do cliente, ou client-side, como chamamos. Eles mudam só coisas que acontecem no seu jogo, como a interface, texturas, gráficos e sons, e não têm função nenhuma em um servidor. Por isso, você pode usar esses mods no seu jogo normalmente, mas eles não devem ser colocados na pasta de mods do servidor, porque podem fazer ele crashar e não iniciar.
Neste artigo:
- Como reconhecer o erro
- Instalando um modpack? Use o server pack
- Como resolver
- Como saber se um mod é client-side
- Lista de mods client-side comuns
Como reconhecer o erro
Em servidores Forge e NeoForge, quando existe um mod client-side na pasta de mods, o servidor crasha ao iniciar com um erro parecido com este:
Attempted to load class net/minecraft/client/... for invalid dist DEDICATED_SERVER
No exemplo da imagem, o mod Oculus foi colocado no servidor. Ele é um mod de shaders, que só funciona no jogo do jogador, e por isso o servidor não consegue iniciar.
Em servidores Fabric esse problema é mais raro, porque o Fabric ignora automaticamente os mods marcados como client-side. Mesmo assim, alguns mods não vêm marcados corretamente e podem causar crash. Nesse caso o erro costuma citar net/minecraft/client, como NoClassDefFoundError: net/minecraft/client/...
Instalando um modpack? Use o server pack
O motivo mais comum desse erro é instalar no servidor os arquivos do modpack de cliente, que vem com vários mods client-side. Para o servidor, o certo é usar o server pack, uma versão do modpack que já vem só com os arquivos que o servidor precisa.
- No painel: se o modpack estiver disponível nos templates do painel, esse é o jeito mais fácil, porque a instalação já vem pronta para servidor.
- No CurseForge: na página do modpack, abra a aba Files, clique na versão desejada e procure o arquivo Server Pack nos arquivos adicionais.
- No Modrinth: confira a descrição do modpack, onde o autor costuma explicar como baixar a versão para servidor.
Se o modpack não tiver server pack, você vai precisar instalar os mods manualmente e remover os client-side seguindo os passos abaixo.
Como resolver
1 - No gerenciador de arquivos, abra a pasta crash-reports do servidor e abra o arquivo mais recente. Se não houver crash report, veja o erro no console.
2 - Procure no erro o nome do mod que causou o problema. Ele costuma aparecer em linhas como Mod File ou Suspected Mods.
3 - Remova esse mod da pasta mods do servidor. Ele continua funcionando normalmente no seu jogo.
4 - Inicie o servidor de novo. Se aparecer um erro com outro mod, repita os passos até o servidor iniciar.
Como saber se um mod é client-side
A forma mais fácil é olhar a página de download do mod. No Modrinth, a página mostra se o mod é usado no cliente, no servidor ou nos dois:
No CurseForge, essa informação costuma aparecer na descrição do mod:
Uma boa dica: se o mod só muda algo que você vê ou ouve no seu jogo (gráficos, HUD, menus, minimapa, sons), quase sempre ele é client-side.
Lista de mods client-side comuns
Os mods abaixo não precisam estar no servidor. Alguns deles causam crash se forem colocados lá, outros apenas não fazem nada. Se você encontrar algum deles na pasta de mods do servidor, pode remover.
Gráficos e desempenho
- Embeddium
- Iris
- Oculus
- OptiFine
- Reese’s Sodium Options
- Sodium
HUD, interface e menus
- AppleSkin
- Better F3
- Cobblemon UI Tweaks
- Controlling
- Custom HUD
- Durability Viewer
- Enchantment Descriptions
- Inventory HUD+
- Legendary Tooltips
- Light Overlay
- Mouse Tweaks
- Name Pain
- ShulkerBoxTooltip
Mapas
- Xaero's Minimap
- Xaero's World Map
Visual, câmera e sons
- Better Third Person
- Dynamic Surroundings
- Fusion
- ItemPhysic Lite
Essa lista não inclui todos os mods client-side que existem. Se o servidor continuar crashando, siga os passos de Como resolver para descobrir qual mod está causando o problema.