Este guia cobre como instalar o framework de modding Oxide/uMod ou Carbon no seu servidor Rust, adicionar plugins da comunidade e gerenciá-los via console. Para configuração geral do servidor e variáveis de inicialização, consulte o Guia de Configuração do Servidor Rust.

Instalando o Oxide/uMod ou Carbon

Oxide (agora mantido como uMod) e Carbon são frameworks de modding para Rust que permitem instalar plugins criados pela comunidade. Esses frameworks adicionam recursos como sistemas de economia, kits personalizados, recompensas por voto, zonas de proteção PvE e muito mais.

Você não precisa fazer upload de nenhum arquivo manualmente. O framework de modding é instalado automaticamente definindo uma única variável de inicialização:

1. Pare seu servidor pela aba Console do GPanel.
2. Faça login no GPanel e vá para a aba Startup.
3. Encontre a variável FRAMEWORK e defina como:
   • oxide — para Oxide/uMod (o framework mais amplamente utilizado, com a maior biblioteca de plugins)
   • carbon — para o framework Carbon (uma alternativa com seu próprio ecossistema de plugins)
   • vanilla — para rodar sem nenhum framework de modding
4. Inicie o servidor. Os arquivos do framework são baixados e aplicados automaticamente. Na primeira inicialização com Oxide, a estrutura de diretórios oxide/ é gerada.
5. Verifique o log do console por uma linha como Loaded plugin Oxide.Core para confirmar que o Oxide está ativo.

Instalando Plugins

Plugins são distribuídos como arquivos .cs (código-fonte C#). O Oxide os compila no servidor em tempo de execução — nenhuma pré-compilação é necessária.

1. Baixe o arquivo .cs do plugin em umod.org ou outra fonte confiável.
2. Faça upload do arquivo .cs para o diretório oxide/plugins/ no seu servidor usando SFTP ou o gerenciador de arquivos do GPanel. Para ajuda com SFTP, consulte Como Fazer Upload de Arquivos via SFTP.
3. Se o servidor estiver rodando, o plugin será detectado e compilado automaticamente em poucos segundos. Você verá uma saída no console confirmando que foi carregado, ex.: Loaded plugin MyPlugin v1.2.3 by Author.
4. Se o servidor não estiver rodando, o plugin será carregado na próxima inicialização.

Estrutura de Diretórios do Oxide

oxide/
  plugins/
    MyPlugin.cs       <- place plugin files here
    AnotherPlugin.cs
  config/             <- auto-generated plugin config files
  data/               <- plugin data files
  logs/               <- plugin log files

Configurando Plugins

A maioria dos plugins gera um arquivo de configuração JSON em oxide/config/ na primeira vez que são carregados. Para personalizar um plugin:

1. Deixe o plugin carregar pelo menos uma vez para que ele gere seu arquivo de configuração padrão.
2. Pare seu servidor (ou note que alguns plugins suportam recarga de configuração ao vivo).
3. Abra o arquivo de configuração do plugin em oxide/config/PluginName.json usando o gerenciador de arquivos do GPanel ou SFTP.
4. Edite as configurações e salve o arquivo.
5. Recarregue o plugin com oxide.reload PluginName ou reinicie o servidor.

Gerenciando Plugins via Console

Esses comandos podem ser executados pelo console do GPanel ou via um cliente RCON. Para configuração do RCON, consulte Acesso RCON e Comandos de Admin do Rust.

Atualizando Plugins

Para atualizar um plugin para uma versão mais recente:

1. Baixe o arquivo .cs atualizado da página do plugin em umod.org.
2. Faça upload do novo arquivo para oxide/plugins/, sobrescrevendo o arquivo existente.
3. Se o servidor estiver rodando, o Oxide detecta a alteração do arquivo e automaticamente recompila e recarrega o plugin. Alternativamente, execute oxide.reload PluginName.
4. Verifique o console para quaisquer erros. Algumas atualizações de plugins podem exigir alterações no arquivo de configuração em oxide/config/.

Removendo Plugins

Para remover um plugin completamente:

1. Execute oxide.unload PluginName para descarregar o plugin enquanto o servidor está rodando.
2. Delete o arquivo .cs de oxide/plugins/.
3. Opcionalmente, delete o arquivo de configuração do plugin de oxide/config/ e os arquivos de dados de oxide/data/ se você não precisar mais deles.

Plugins Populares

Solução de Problemas com Plugins

Se seus plugins não estão carregando, verifique o seguinte:

• Confirme que o Oxide está instalado e ativo. Na aba Startup do GPanel, a variável FRAMEWORK deve estar definida como oxide. O log do console deve mostrar Loaded plugin Oxide.Core durante a inicialização.
• Os arquivos de plugin devem ser colocados diretamente em oxide/plugins/ com a extensão exata .cs. Arquivos em subdiretórios ou com extensões erradas são ignorados.
• Verifique o console e oxide/logs/ para erros de compilação. Um plugin com erro de sintaxe falhará ao carregar e a mensagem de erro descreverá o problema.
• Alguns plugins têm dependências de outros plugins (ex.: muitos plugins de loja requerem Economics). Instale todas as dependências necessárias primeiro.

Para outros problemas comuns do servidor, consulte Solução de Problemas do Servidor Rust.

Precisa de Ajuda?

Se você encontrar um problema não coberto neste guia, nossa equipe de suporte está disponível para ajudar. Envie um ticket de suporte e inclua o ID do seu servidor, uma descrição do problema e qualquer saída relevante do console.