Rust: instalando plugins Oxide/uMod e executando um wipe

Duas coisas que quase todo proprietário de servidor Rust precisa: a estrutura de modding Oxide (uMod) para que você possa executar plugins, e uma rotina confiável de wipe para quando a Facepunch lançar a atualização forçada mensal. Este guia cobre ambos.

Instalar Oxide (uMod)

Oxide (também chamado uMod) é a estrutura de plugins que quase todo servidor Rust modificado executa. No ServerPrism, a maneira mais fácil de obtê-lo é integrada ao seu tipo de servidor:

1. Abra seu servidor e vá para a aba Startup.
2. Procure por uma opção de modding framework / Oxide (muitos "eggs" de Rust têm um "toggle" ou uma variável de "build" como Oxide/Carbon).
3. Defina-o para Oxide e, em seguida, reinstale ou reinicie para que a estrutura seja baixada.
4. Após a inicialização, o console mostra a versão do Oxide na inicialização, e uma pasta oxide/ aparece no "File Manager".

Se o seu tipo de servidor não expõe um "toggle", abra um ticket de suporte e nós o mudaremos para a "build" do Oxide.

Instalar plugins

Os plugins do Rust são arquivos .cs únicos.

1. Baixe o arquivo .cs do plugin em umod.org.
2. No File Manager, coloque-o em oxide/plugins/.
3. O Oxide carrega "hot-loads" plugins — sem necessidade de reiniciar. O console imprime Loaded plugin <Name> em poucos segundos.

Arquivos de configuração e dados são gerados em oxide/config/ e oxide/data/ no primeiro carregamento. Edite a configuração e, em seguida, recarregue o plugin com oxide.reload <PluginName> no console.

Comandos úteis do console:

oxide.plugins           # listar plugins carregados
oxide.reload PluginName  # aplicar alterações de configuração
oxide.unload PluginName  # desabilitar sem deletar
oxide.grant group admin PluginName.permission  # permissões

Limpando seu servidor

Um wipe redefine o progresso. Existem dois níveis:

• Map wipe — regenera o mapa e limpa construções/saques, mas mantém os "blueprints". Faça isso quando quiser um mapa novo.
• Full wipe (BP wipe) — "map wipe" mais a limpeza dos "blueprints" do jogador. Isso é o que a maioria dos servidores faz na atualização forçada mensal.

Como fazer um wipe

1. Pare o servidor na aba "Console".
2. No File Manager, abra a pasta server/<identity>/ (a identidade é definida na sua aba "Startup").
3. Para fazer um map wipe, exclua os arquivos do mapa: *.map e *.sav (e seus backups .1, .2).
4. Para um full wipe, também exclua os dados dos "blueprints" — remova os arquivos player.blueprints.*.db (ou todos os arquivos de storage/"blueprint" dependendo da sua "build").
5. Opcionalmente, altere a world seed e/ou o map size na aba "Startup" para um mapa totalmente novo.
6. Inicie o servidor. Ele gera um mundo novo na inicialização.

Sempre faça backup primeiro. Faça um backup antes de fazer um "wipe" para que um erro seja reversível — veja Fazendo backup do seu servidor.

Momento do "force wipe"

A Facepunch lança uma atualização obrigatória na primeira quinta-feira de cada mês, o que quebra o Oxide e os plugins até que sejam atualizados. No dia do "force-wipe": atualize o servidor, espere que o Oxide e seus plugins lancem versões atualizadas e, em seguida, faça o "wipe". Executar um Oxide desatualizado após uma atualização forçada falhará ao carregar — isso é esperado até que o uMod seja atualizado.

Problemas comuns

• Plugins não carregam após a atualização mensal: Oxide/plugins ainda não estão atualizados para a nova versão do Rust — atualize o servidor e espere o uMod se atualizar.
• Failed to compile um plugin: versão errada do plugin para sua "build" do Oxide, ou um plugin de dependência ausente — verifique a página do plugin no uMod.
• Wipe "não funcionou": você excluiu arquivos na pasta de identidade errada, ou não parou o servidor primeiro — pare, exclua na pasta server/<identity>/ correta e, em seguida, inicie.
• Servidor não aparece no navegador: ainda está inicializando, ou a descrição/server.hostname não está definida — verifique o console.

Precisa de ajuda com um "wipe" ou um plugin teimoso? Abra um ticket de suporte e nós resolveremos no "node".