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

Instalar o Oxide/uMod ou Carbon

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

Não precisa de carregar nenhum ficheiro manualmente. O framework de modding é instalado automaticamente definindo uma única variável de arranque:

1. Pare o seu servidor a partir do separador Console do GPanel.
2. Inicie sessão no GPanel e vá ao separador Startup.
3. Encontre a variável FRAMEWORK e defina-a como:
   • oxide — para Oxide/uMod (o framework mais amplamente utilizado, com a maior biblioteca de plugins)
   • carbon — para o framework Carbon (uma alternativa com o seu próprio ecossistema de plugins)
   • vanilla — para funcionar sem nenhum framework de modding
4. Inicie o servidor. Os ficheiros do framework são descarregados e aplicados automaticamente. No primeiro arranque com Oxide, a estrutura de diretórios oxide/ é gerada.
5. Verifique o log da consola para uma linha como Loaded plugin Oxide.Core para confirmar que o Oxide está ativo.

Instalar Plugins

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

1. Descarregue o ficheiro .cs do plugin de umod.org ou outra fonte de confiança.
2. Carregue o ficheiro .cs para o diretório oxide/plugins/ no seu servidor usando SFTP ou o gestor de ficheiros do GPanel. Para ajuda com SFTP, consulte Como Carregar Ficheiros via SFTP.
3. Se o servidor estiver a funcionar, o plugin será detetado e compilado automaticamente em poucos segundos. Verá uma saída na consola confirmando que foi carregado, ex.: Loaded plugin MyPlugin v1.2.3 by Author.
4. Se o servidor não estiver a funcionar, o plugin será carregado no próximo arranque.

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

Configurar Plugins

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

1. Deixe o plugin carregar pelo menos uma vez para gerar o seu ficheiro de configuração predefinido.
2. Pare o seu servidor (ou note que alguns plugins suportam recarga de configuração em tempo real).
3. Abra o ficheiro de configuração do plugin em oxide/config/PluginName.json usando o gestor de ficheiros do GPanel ou SFTP.
4. Edite as definições e guarde o ficheiro.
5. Recarregue o plugin com oxide.reload PluginName ou reinicie o servidor.

Gerir Plugins via Consola

Estes comandos podem ser executados a partir da consola do GPanel ou via um cliente RCON. Para configuração do RCON, consulte Acesso RCON e Comandos de Admin do Rust.

Atualizar Plugins

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

1. Descarregue o ficheiro .cs atualizado da página do plugin em umod.org.
2. Carregue o novo ficheiro para oxide/plugins/, substituindo o ficheiro existente.
3. Se o servidor estiver a funcionar, o Oxide deteta a alteração do ficheiro e automaticamente recompila e recarrega o plugin. Em alternativa, execute oxide.reload PluginName.
4. Verifique a consola para quaisquer erros. Algumas atualizações de plugins podem requerer alterações no ficheiro de configuração em oxide/config/.

Remover Plugins

Para remover um plugin completamente:

1. Execute oxide.unload PluginName para descarregar o plugin enquanto o servidor está a funcionar.
2. Elimine o ficheiro .cs de oxide/plugins/.
3. Opcionalmente, elimine o ficheiro de configuração do plugin de oxide/config/ e os ficheiros de dados de oxide/data/ se já não precisar deles.

Plugins Populares

Resolução de Problemas com Plugins

Se os seus plugins não estão a carregar, verifique o seguinte:

• Confirme que o Oxide está instalado e ativo. No separador Startup do GPanel, a variável FRAMEWORK deve estar definida como oxide. O log da consola deve mostrar Loaded plugin Oxide.Core durante o arranque.
• Os ficheiros de plugins devem ser colocados diretamente em oxide/plugins/ com a extensão exata .cs. Ficheiros em subdiretórios ou com extensões erradas são ignorados.
• Verifique a consola e oxide/logs/ para erros de compilação. Um plugin com um 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 Resolução de Problemas do Servidor de Rust.

Precisa de Ajuda?

Se encontrar um problema não abordado neste guia, a nossa equipa de suporte está disponível para ajudar. Submeta um ticket de suporte e inclua o ID do seu servidor, uma descrição do problema e qualquer saída de consola relevante.