Como instalar mods no Rust em servidor com Oxide

Para instalar mods Rust em um servidor com Oxide, instale o framework Oxide (uMod) na raiz do servidor. Depois coloque os plugins .cs em oxide/plugins, ajuste as configurações em oxide/config e distribua as permissões com oxide.grant. A cada wipe forçado, atualize primeiro o Rust e depois o Oxide. Na Fly-Serv, o Oxide é instalado com 1 clique.

Abaixo está o passo a passo na ordem certa, com as pastas exatas e os comandos para copiar.

Em resumo

• O Oxide é o framework. Os mods são plugins em C# (.cs) que o próprio servidor compila.
• Os plugins vão em oxide/plugins e são carregados a quente, sem reiniciar.
• Sem permissão, a maioria dos comandos de plugin responde "You don't have permission". Dê as permissões a um grupo, não jogador por jogador.
• Depois de um wipe forçado, a ordem é: backup, atualização do Rust, atualização do Oxide e verificação dos plugins.
• Os jogadores não precisam instalar nada.

Oxide, uMod e plugins: o que saber antes de começar

O Oxide, hoje conhecido pela marca uMod, é o framework que se acrescenta ao servidor Rust e o ensina a carregar extensões. Os plugins são arquivos .cs que o servidor compila ao carregá-los. O Oxide se apoia no Harmony, a biblioteca de modificação de código incluída no servidor dedicado. Este guia fica no Oxide, que é o framework que quase todos os tutoriais pressupõem.

Tudo acontece no servidor. Seus jogadores entram com o jogo normal e não baixam nada.

Um servidor com plugins aparece na aba Modded do navegador de servidores. A lista oficial de tags da Facepunch traz as tags Modded e Oxide, definidas pela variável server.tags. Por padrão, o Oxide marca o servidor como moddado ("Modded": true em oxide/oxide.config.json). Deixe esse valor como está: kits, teleportes e taxas de coleta alteram a jogabilidade.

Como instalar o Oxide/uMod para rodar mods Rust?

Há dois caminhos: o clique no painel ou o procedimento manual.

Com 1 clique no FlyPanel

Abra o FlyPanel, vá à seção de mods e frameworks, escolha Oxide/uMod, instale e reinicie o servidor. Em seguida, abra o console em tempo real. A linha de carregamento do Oxide deve aparecer, e a pasta oxide/ deve existir nos seus arquivos.

Na hora de contratar, você também define a seed, o tamanho do mapa e até 200 jogadores. Tudo isso está na página Hospedagem Rust: alugue seu servidor Rust.

Instalação manual (servidor dedicado ou VPS)

Se você administra sua própria máquina ou um VPS Pterodactyl, siga estes passos:

1. Pare o servidor.
2. Atualize o RustDedicated (app Steam 258550) com o SteamCMD:

   ./steamcmd.sh +force_install_dir /srv/rust +login anonymous +app_update 258550 validate +quit
   

3. Baixe a build Oxide.Rust do seu sistema (Windows ou Linux) na página do Rust em umod.org, o repositório oficial.
4. Extraia o arquivo na raiz do servidor e aceite sobrescrever os arquivos de RustDedicated_Data/Managed.
5. Reinicie e digite oxide.version no console.

O erro clássico é colocar uma build de Windows em um servidor Linux. O servidor liga, mas o Oxide não carrega.

Em qual pasta colocar os plugins do Rust?

Na primeira inicialização, o Oxide cria sua estrutura de pastas ao lado do executável:

Pasta	Conteúdo
oxide/plugins	Os plugins .cs: é aqui que você coloca seus arquivos
oxide/config	As configurações .json, geradas no primeiro carregamento do plugin
oxide/data	Os dados persistentes (kits, clãs, homes…)
oxide/lang	As traduções: úteis para passar um plugin para o português
oxide/logs	Os registros do Oxide e os erros

O carregamento é a quente. Você solta o arquivo, o plugin compila e inicia sem reiniciar o servidor. Para controlar tudo pelo console:

oxide.plugins
oxide.load NomDoPlugin
oxide.unload NomDoPlugin
oxide.reload NomDoPlugin

Para mudar uma configuração, edite o .json em oxide/config e rode oxide.reload. Nunca mexa no .cs: sua alteração sumiria na próxima atualização do plugin. Quando um plugin se recusa a iniciar, o console mostra um erro de compilação, e os detalhes ficam em oxide/logs.

Como dar permissões aos plugins do Oxide?

Uma permissão é uma etiqueta (kits.use, por exemplo) que você associa a um jogador ou a um grupo. O Oxide traz no mínimo os grupos default (todos os jogadores) e admin. O método mais limpo é criar grupos, dar as permissões a eles e só então colocar os jogadores dentro.

oxide.grant user 76561198000000000 kits.use
oxide.grant group default kits.use
oxide.revoke group default kits.use
oxide.group add vip
oxide.usergroup add 76561198000000000 vip
oxide.show perms
oxide.show user 76561198000000000

Use o SteamID64 em vez do nick, que gera confusão. O alias o. também funciona (o.grant).

Um caso concreto: um kit inicial para todo mundo e um kit VIP para alguns jogadores. Dê kits.use ao grupo default, crie o grupo vip, atribua a ele a permissão do kit VIP e adicione seus jogadores com oxide.usergroup add. Para tirar um VIP, basta um comando.

Não confunda essas permissões com ownerid e moderatorid. Esses comandos nativos do Rust concedem direitos de administração do jogo, não permissões de plugin. O nome exato de uma permissão aparece na página do plugin, no arquivo .cs (procure por RegisterPermission) ou com oxide.show perms.

Por que os mods param de funcionar depois de um wipe forçado?

O wipe forçado cai na primeira quinta-feira do mês, junto com a atualização mensal da Facepunch. Segundo o acompanhamento das datas de wipe, ela sai às 19h, no horário do Reino Unido. Em Brasília, que não tem horário de verão, isso dá 15h durante o horário de verão britânico (de fim de março a fim de outubro) e 16h no resto do ano.

A atualização substitui os arquivos do jogo que o Oxide havia modificado. O resultado: o Oxide deixa de ser carregado ou fica incompatível com a nova versão. E ainda é preciso esperar a publicação da build do Oxide correspondente, que nem sempre sai na hora do patch.

Os sintomas costumam ser os mesmos: nenhuma linha do Oxide na inicialização, comandos oxide.* desconhecidos ou plugins com erro depois de uma mudança de API.

O wipe apaga o mapa. Quanto às blueprints, depende da sua configuração. Já em oxide/data, cada plugin decide: alguns apagam seus dados no wipe, outros os mantêm.

Como atualizar o Oxide depois de uma atualização do Rust?

Siga esta ordem, sem pular etapas:

1. Faça backup de oxide/config, oxide/data e do mapa. Na Fly-Serv, a opção Backup é cobrada à parte. Veja os preços e opções (Backup, Anti-DDoS avançado).
2. Atualize o Rust. No modo manual, rode de novo app_update 258550 validate, que também restaura os arquivos originais.
3. Reinstale ou atualize o Oxide: 1 clique no FlyPanel ou a última build Oxide.Rust extraída na raiz.
4. Atualize os plugins que aparecerem com erro.
5. Leia o console e teste seus comandos principais (kit, teleporte) antes de abrir para os jogadores.

Não anuncie a reabertura para o minuto exato do patch. Deixe uma margem para os plugins teimosos. As noites de wipe também atraem ataques, e por isso a proteção Anti-DDoS já incluída faz diferença.

Boas práticas para um servidor Rust moddado estável

• Adicione os plugins um por um, olhando o console a cada vez.
• Evite funções duplicadas: dois plugins de teleporte sempre acabam atrapalhando um ao outro.
• Fique de olho na carga de CPU. O Rust depende principalmente de um único núcleo e cada plugin tem um custo. O Ryzen 9 7950X3D e seu V-Cache ajudam a aguentar.
• Guarde uma cópia de oxide/config e oxide/data.

Para escolher seus plugins, procure os melhores mods para servidor Rust. E se você também administra um servidor de sobrevivência em outro jogo, vale ver como instalar mods em um servidor DayZ.

Perguntas frequentes

Os jogadores precisam instalar mods para entrar em um servidor Rust moddado?

Não. Os plugins do Oxide funcionam apenas no servidor. Os jogadores se conectam com o jogo normal, sem baixar nada.

Um servidor Rust com Oxide aparece na categoria Modded?

Sim, por padrão. O Oxide marca o servidor como moddado em oxide/oxide.config.json. Os servidores Community são reservados a ferramentas de administração que não mexem na jogabilidade.

É preciso reiniciar o servidor depois de adicionar um plugin do Oxide?

Não. Coloque o arquivo .cs em oxide/plugins e ele é carregado a quente. Para aplicar uma configuração alterada, basta oxide.reload NomDoPlugin.

Os plugins do uMod para Rust são gratuitos?

Muitos plugins do repositório oficial do uMod são gratuitos, mas alguns são pagos. Você só paga a hospedagem do servidor, exceto pelos plugins pagos.

O Oxide é o único framework de mods para servidor Rust?

Na Fly-Serv, o Oxide/uMod é o framework oferecido com 1 clique no FlyPanel. É também o mais antigo, com mais documentação e mais plugins disponíveis.

Os dados dos plugins são apagados em um wipe?

Não automaticamente. O wipe apaga o mapa, mas oxide/data depende de cada plugin. Alguns apagam os dados no wipe, outros os mantêm. Leia a documentação deles e faça backup antes.

Suba seu servidor Rust com mods ainda hoje

Antes do próximo wipe, faça um ensaio: instale o Oxide, adicione um único plugin, dê a permissão dele a um grupo e teste o comando. Na primeira quinta-feira do mês, você já vai saber ler o console e reagir rápido.

Para isso, a página Hospedagem Rust: alugue seu servidor Rust reúne tudo o que você precisa. O Oxide/uMod é instalado com 1 clique, o console e os logs em tempo real apontam o plugin com problema, e o Anti-DDoS está incluído. A entrega leva menos de 60 segundos e não há fidelidade. A gente cuida do resto.