{
  "schemaVersion": "1.0",
  "id": 118,
  "path": "/artigos/mods-client-side-no-servidor",
  "url": "https://ajuda.roxycloud.com.br/artigos/mods-client-side-no-servidor",
  "markdownUrl": "https://ajuda.roxycloud.com.br/artigos/mods-client-side-no-servidor.md",
  "jsonUrl": "https://ajuda.roxycloud.com.br/artigos/mods-client-side-no-servidor.json",
  "title": "Como resolver problemas com mods Client-Side no servidor",
  "seoTitle": "Resolver mods client-side no servidor | RoxyCloud",
  "description": "Servidor com mods dando crash ao iniciar? Veja como identificar mods client-side no console e nos crash-reports e removê-los do servidor.",
  "category": "minecraft-java",
  "categoryLabel": "Minecraft (Java)",
  "categoryUrl": "https://ajuda.roxycloud.com.br/categorias/minecraft-java",
  "datePublished": "2026-06-07",
  "dateModified": "2026-10-17",
  "readingMinutes": 3,
  "wordCount": 487,
  "h1": "Como resolver problemas com mods Client-Side no servidor",
  "excerpt": "Servidor com mods dando crash ao iniciar? Veja como identificar mods client-side no console e nos crash-reports e removê-los do servidor.",
  "author": "Equipe RoxyCloud",
  "language": "pt-BR",
  "toc": [
    {
      "id": "como-identificar-o-erro-no-console",
      "label": "Como identificar o erro no console?",
      "level": 2
    },
    {
      "id": "o-perigo-de-enviar-modpacks-inteiros",
      "label": "O perigo de enviar Modpacks Inteiros",
      "level": 2
    },
    {
      "id": "como-saber-se-um-mod-e-client-side",
      "label": "Como saber se um mod é Client-Side?",
      "level": 2
    },
    {
      "id": "lista-de-mods-client-side-populares-para-remover-do-servidor",
      "label": "Lista de mods Client-Side populares para REMOVER do servidor",
      "level": 2
    },
    {
      "id": "graficos-shaders-e-otimizacao",
      "label": "Gráficos, Shaders e Otimização",
      "level": 3
    },
    {
      "id": "mapas-e-interfaces-hud",
      "label": "Mapas e Interfaces (HUD)",
      "level": 3
    },
    {
      "id": "praticidade-e-informacoes-de-itens",
      "label": "Praticidade e Informações de Itens",
      "level": 3
    },
    {
      "id": "estetica-e-imersao",
      "label": "Estética e Imersão",
      "level": 3
    },
    {
      "id": "como-resolver-o-problema-na-roxycloud",
      "label": "Como resolver o problema na RoxyCloud",
      "level": 2
    }
  ],
  "faqs": [],
  "howToSteps": [
    "Desligue o servidor através do painel de controle.",
    "Acesse a aba Gerenciador de Arquivos e entre na pasta mods.",
    "Localize o mod client-side que está causando o conflito e exclua-o.",
    "Vá até o Console e clique em Iniciar. O seu servidor agora deverá ligar normalmente!"
  ],
  "relatedGuides": [
    {
      "title": "Como fazer backup e restaurar mundo no painel RoxyCloud (Java)",
      "url": "https://ajuda.roxycloud.com.br/artigos/como-fazer-backup-e-restaurar-mundo-no-painel-roxycloud-java",
      "markdownUrl": "https://ajuda.roxycloud.com.br/artigos/como-fazer-backup-e-restaurar-mundo-no-painel-roxycloud-java.md"
    },
    {
      "title": "Servidor Minecraft com lag: checklist no painel RoxyCloud",
      "url": "https://ajuda.roxycloud.com.br/artigos/servidor-minecraft-com-lag-checklist-no-painel-roxycloud",
      "markdownUrl": "https://ajuda.roxycloud.com.br/artigos/servidor-minecraft-com-lag-checklist-no-painel-roxycloud.md"
    },
    {
      "title": "Erro \"Failed to bind to port\" no servidor Minecraft: como resolver",
      "url": "https://ajuda.roxycloud.com.br/artigos/erro-failed-to-bind-to-port-no-servidor-minecraft-como-resolver",
      "markdownUrl": "https://ajuda.roxycloud.com.br/artigos/erro-failed-to-bind-to-port-no-servidor-minecraft-como-resolver.md"
    },
    {
      "title": "Guia completo: servidor Minecraft Java no painel RoxyCloud",
      "url": "https://ajuda.roxycloud.com.br/artigos/guia-completo-servidor-minecraft-java-no-painel-roxycloud",
      "markdownUrl": "https://ajuda.roxycloud.com.br/artigos/guia-completo-servidor-minecraft-java-no-painel-roxycloud.md"
    },
    {
      "title": "Como Instalar o SkinsRestorer no Minecraft",
      "url": "https://ajuda.roxycloud.com.br/artigos/como-instalar-skinsrestorer-no-minecraft",
      "markdownUrl": "https://ajuda.roxycloud.com.br/artigos/como-instalar-skinsrestorer-no-minecraft.md"
    }
  ],
  "relatedProducts": [],
  "content": {
    "format": "markdown",
    "body": "Este artigo se aplica às versões:\n\n- **Java Edition (Forge / Fabric / NeoForge / Quilt)** ✅\n- **Bedrock Edition** ❌\n\nUm dos erros mais comuns ao montar um servidor com mods é a inclusão acidental de mods **client-side** (exclusivos para o cliente) nos arquivos do servidor. Esses mods alteram apenas a parte visual do jogo local (como interface, shaders e texturas) e não possuem funções para um servidor dedicado, fazendo com que ele sofra um **crash** instantâneo ao iniciar.\n\n## Como identificar o erro no console?\n\nSe o seu servidor na RoxyCloud não está iniciando após a colocação de novos mods, verifique o **Console** ou a aba **Arquivos > crash-reports**.\n\nO erro mais clássico causado por esse problema costuma conter uma mensagem parecida com esta:\n\n> `A fatal error has occurred, this connection is terminated` ou apresentando o termo: `invalid dist DEDICATED_SERVER`\n\nNo exemplo acima, o erro acontece porque o servidor tentou carregar um mod feito exclusivamente para rodar no computador do jogador, e não no sistema da hospedagem.\n\n## O perigo de enviar Modpacks Inteiros\n\nEsse problema é muito frequente quando um jogador tenta instalar um Modpack no servidor, mas em vez de enviar o **Server Pack** (que contém apenas os arquivos otimizados para o servidor), ele envia a pasta de mods do seu próprio jogo local (que vem cheia de mods visuais e de otimização para computadores).\n\n## Como saber se um mod é Client-Side?\n\nAntes de subir qualquer arquivo para o seu gerenciador, verifique a página oficial de download do mod:\n\n- **No Modrinth:** Procure pela tag indicada na lateral da página que aponta se o mod é voltado para o cliente ou para o servidor.\n- **No CurseForge:** Essa informação geralmente fica explícita logo nas primeiras linhas da descrição ou nas configurações de ambiente (*Environment: Client*).\n\n## Lista de mods Client-Side populares para REMOVER do servidor\n\nSe você encontrar qualquer um dos mods abaixo dentro da pasta `/mods` do seu painel RoxyCloud, **remova-o imediatamente**:\n\n### Gráficos, Shaders e Otimização\n\n- Oculus / Iris\n- OptiFine\n- Sodium / Rubidium / Embeddium\n- Reese’s Sodium Options\n- Fusion\n\n### Mapas e Interfaces (HUD)\n\n- Xaero's Minimap\n- Xaero's World Map\n- JourneyMap *(a versão cliente possui funções visuais que podem crashar se mal configuradas)*\n- Custom HUD\n- Better F3\n- Inventory HUD+\n- Cobblemon UI Tweaks\n\n### Praticidade e Informações de Itens\n\n- Mouse Tweaks\n- Controlling\n- AppleSkin\n- Enchantment Descriptions\n- Legendary Tooltips\n- Durability Viewer\n- ShulkerBoxTooltip\n\n### Estética e Imersão\n\n- Dynamic Surroundings\n- ItemPhysic Lite\n- Name Pain\n- Better Third Person\n- Light Overlay\n\n## Como resolver o problema na RoxyCloud\n\n1. **Desligue o servidor** através do painel de controle.\n2. Acesse a aba **Gerenciador de Arquivos** e entre na pasta `mods`.\n3. Localize o mod client-side que está causando o conflito e **exclua-o**.\n4. Vá até o Console e clique em **Iniciar**. O seu servidor agora deverá ligar normalmente!\n\n**Dicas para concluir este passo na RoxyCloud**\n\nNão remova mods em lote apenas pelo nome. Confira na página de cada mod se ele funciona em servidor e teste uma cópia antes de retirar arquivos do seu servidor da RoxyCloud."
  },
  "jsonLd": [
    {
      "@type": "Article",
      "@id": "https://ajuda.roxycloud.com.br/artigos/mods-client-side-no-servidor#article",
      "headline": "Resolver mods client-side no servidor",
      "description": "Servidor com mods dando crash ao iniciar? Veja como identificar mods client-side no console e nos crash-reports e removê-los do servidor.",
      "url": "https://ajuda.roxycloud.com.br/artigos/mods-client-side-no-servidor",
      "articleSection": "Minecraft (Java)",
      "inLanguage": "pt-BR",
      "isAccessibleForFree": true,
      "mainEntityOfPage": {
        "@type": "WebPage",
        "@id": "https://ajuda.roxycloud.com.br/artigos/mods-client-side-no-servidor#webpage"
      },
      "image": [
        "https://ajuda.roxycloud.com.br/og-ajuda.png"
      ],
      "author": {
        "@type": "Organization",
        "name": "RoxyCloud"
      },
      "publisher": {
        "@type": "Organization",
        "name": "RoxyCloud",
        "logo": {
          "@type": "ImageObject",
          "url": "https://cdn.roxycloud.com.br/logo.png"
        }
      },
      "datePublished": "2026-06-07T22:48:45.831Z",
      "dateModified": "2026-10-17T09:37:25.494Z"
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Início",
          "item": "https://ajuda.roxycloud.com.br"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "Minecraft (Java)",
          "item": "https://ajuda.roxycloud.com.br/categorias/minecraft-java"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "name": "Como resolver problemas com mods Client-Side no servidor",
          "item": "https://ajuda.roxycloud.com.br/artigos/mods-client-side-no-servidor"
        }
      ]
    }
  ]
}