Instalar plugins Rust – guia uMod/Oxide

Instalas plugins Rust através do uMod/Oxide ativando o framework, descarregando um ficheiro .cs adequado da página oficial de plugins uMod e enviando-o para /oxide/plugins/. Depois verificas a configuração, as permissões e a consola. Um processo controlado é importante, porque plugins com erros podem afetar a jogabilidade, os direitos ou a estabilidade do servidor.

Requisitos

Precisas de um servidor Rust com acesso a ficheiros, acesso à consola e framework uMod/Oxide ativável. Na game-serverhosting, a sequência típica é: ativar o framework no painel, deixar o servidor iniciar, enviar os ficheiros do plugin e depois definir a configuração e os direitos. Não planeies alterações diretamente durante períodos de muita atividade de jogadores; se possível, testa primeiro com poucos jogadores ou numa configuração separada.

A página oficial do uMod é a fonte principal para plugins Rust e documentação. Para downloads, usa a visão geral de plugins disponível em umod.org/plugins?game=rust. Para a lógica de utilização do uMod, a documentação oficial em umod.org/documentation também é determinante. Verifica sempre aí se um plugin continua a ser mantido ativamente e que permissões ou dependências são indicadas.

Se ainda estás a trabalhar na configuração base do teu servidor Rust, o guia interno Alugar e configurar um servidor Rust ajuda-te. Para RAM, definições e planeamento de plugins, encontras informação complementar no guia Alugar um servidor Rust: RAM, definições e plugins.

Instalar uMod/Oxide

uMod é um framework de plugins para Rust. Ele adiciona ao servidor uma camada de plugins através da qual plugins C# podem ser carregados, configurados e receber permissões.

1. No dashboard -> Mods -> ativar uMod/Oxide
2. O servidor é atualizado automaticamente
3. Agora os plugins podem ser instalados

Depois da ativação, espera até o servidor estar totalmente iniciado. Só depois deves enviar ficheiros para /oxide/plugins/. Se pastas como /oxide/config/, /oxide/data/ ou /oxide/logs/ ainda não existirem, talvez o uMod ainda não tenha sido totalmente inicializado ou o servidor precise de ser iniciado uma vez corretamente.

Instalar plugin

1. Visita umod.org/plugins?game=rust
2. Descarrega o plugin (ficheiro .cs)
3. Envia para /oxide/plugins/
4. Em regra, o plugin é carregado automaticamente; muitas vezes não é necessário um reinício completo, mas pode fazer sentido em alterações maiores

Envia sempre o ficheiro .cs original do plugin e não alteres o nome do ficheiro sem necessidade. Depois do upload, deves observar a consola do servidor. Normalmente, o uMod indica aí se o plugin foi compilado e carregado ou se existem erros de sintaxe, dependências em falta ou problemas de versão.

Top 20 plugins Rust

A tabela seguinte contém uma seleção de plugins para orientação; a atualidade e a compatibilidade devem ser verificadas na página de cada projeto. Os números de downloads são instantâneos ou valores públicos arredondados e devem ser conferidos na respetiva página do plugin antes da instalação.

Não instales demasiados plugins ao mesmo tempo. Começa com um conjunto base, verifica a consola depois de cada instalação e documenta que comandos, direitos e alterações de jogabilidade cada plugin introduz. Plugins de teleporte, kits, economia, taxas de recolha ou zonas de construção alteram bastante a sensação de jogo.

Configuração do plugin

Cada plugin cria uma config em /oxide/config/. O ficheiro surge normalmente no primeiro carregamento bem-sucedido do plugin. Abre-o só depois de o plugin ter sido carregado uma vez e garante que o JSON continua sintaticamente válido.

// GatherManager.json
{
  "Default Multiplier": 3.0,
  "Quarry Multiplier": 3.0,
  "Pumpjack Multiplier": 3.0
}

Altera apenas valores cujo significado conheces. Depois de uma alteração, podes recarregar o plugin ou reiniciar o servidor, dependendo do plugin e da alteração. Se a consola indicar erros JSON depois de guardar, verifica primeiro vírgulas, aspas e parênteses/chavetas.

Permissões de plugins

Muitos plugins Rust ficam instalados sem direitos definidos corretamente, mas não podem ser usados pelos jogadores. O uMod trabalha com permissões para utilizadores e grupos. Muitas vezes, a página do plugin indica que permissão precisa de ser atribuída.

oxide.grant user <steamid> <permission>
oxide.grant group default <permission>
oxide.revoke user <steamid> <permission>

user é adequado para administradores individuais ou testers. group default afeta, em princípio, jogadores normais e deve ser usado com cuidado. Atribui direitos apenas com a amplitude necessária, especialmente para funções de admin, teleporte, kits, remoção ou economia.

Verificar o resultado

Depois da instalação, deves controlar três coisas: primeiro, o plugin tem de carregar na consola sem erros de compilação. Segundo, oxide.plugins deve mostrar o plugin na lista de plugins carregados. Terceiro, o comando ou efeito relevante dentro do jogo tem de funcionar com uma conta de teste.

Verifica também se foi criado um ficheiro de config em /oxide/config/ e se os ficheiros de log contêm indicações de erros. Se vários plugins foram alterados ao mesmo tempo, testa-os individualmente. Assim descobres mais depressa se o problema vem do próprio plugin, de uma permissão, de uma config com erro ou de um conflito.

Troubleshooting

• Plugin não carrega: Verifica a versão do Oxide, a versão do servidor Rust e as notas na página do plugin.
• Erro na consola: Lê a mensagem de erro concreta e verifica se o plugin está atualizado. Em erros de plugins, a respetiva página em umod.org é o ponto de partida adequado.
• Performance: oxide.plugins mostra todos os plugins carregados. Remove temporariamente plugins desnecessários se aparecerem lags depois de uma alteração.
• Conflitos: Testa plugins individualmente, especialmente quando vários plugins alteram chat, teleporte, kits, zonas ou inventário.
• Config é sobrescrita: Para o servidor, altera a config, guarda o ficheiro e depois reinicia ou recarrega o plugin de forma direcionada.
• Jogadores não conseguem usar comandos: Verifica os nomes das permissões na página do plugin e atribui-os corretamente com oxide.grant.

Verificação, limites e retorno seguro

O guia “Instalar plugins Rust – guia uMod/Oxide” aplica-se ao tipo de servidor descrito no artigo e ao estado de versões visível no momento da verificação. Nomes de menus, versões disponíveis, compatibilidade de mods ou plugins e recursos necessários podem mudar após atualizações. Por isso, não transfiras valores para outra versão de jogo, loader ou servidor sem os verificar.

Cria um backup dos ficheiros afetados antes de alterações ao mundo, ao estado do jogo, à configuração ou a extensões. Depois altera apenas um passo relacionado de cada vez e verifica-o com a mesma versão de cliente e servidor com que queres jogar mais tarde.

Um teste individual bem-sucedido não é garantia de desempenho ou disponibilidade. Tamanho do mundo, mods, plugins, número de jogadores, rota de rede e carga simultânea podem alterar o resultado. Documenta a versão, a alteração e o resultado do teste para conseguires perceber desvios posteriores.

FAQ

Tenho de reiniciar o servidor Rust depois de cada plugin?

Nem sempre. Muitos plugins uMod são carregados automaticamente depois do upload para /oxide/plugins/. Em alterações maiores, dependências ou erros inexplicáveis, um reinício controlado continua a fazer sentido.

Onde encontro os ficheiros de config?

A maioria das configurações de plugins fica em /oxide/config/. Normalmente, elas são criadas depois de o plugin ter sido carregado com sucesso pela primeira vez.

Porque é que um comando de plugin não funciona no jogo?

Na maioria das vezes falta uma permissão ou o comando tem outro nome do que o esperado. Verifica a página do plugin, define os direitos com oxide.grant e depois controla a consola.

Posso instalar vários plugins Rust ao mesmo tempo?

Tecnicamente sim, mas na prática deves avançar passo a passo. Instala um plugin, verifica a consola e a função, e só depois continua com o seguinte.

O que faço se tiver problemas de performance depois de uma instalação?

Desativa individualmente os plugins instalados por último, observa a consola do servidor e verifica oxide.plugins. Assim consegues perceber se a causa é um plugin específico ou uma combinação.