A resposta rápida
Envie os arquivos de plugin .cs para oxide/plugins. As
configurações deles aparecem em oxide/config depois da primeira execução. Use
oxide.reload PluginName para aplicar alterações sem reiniciar, e conceda
permissões a grupos com oxide.grant group (GROUP) (PERMISSION) em vez de a
indivíduos.
Pontos principais
- Três pastas: plugins, config, data. Cada uma tem uma função.
- Os arquivos de configuração só aparecem depois que o plugin roda uma vez. Não os crie manualmente.
oxide.reloadvence o restart para quase toda alteração de plugin.- Conceda a grupos, não a pessoas. Isso escala e é auditável.
- A documentação de cada plugin lista suas permissões. Leia antes de ficar chutando.
As três pastas
O uMod cria três pastas no seu servidor, e saber o que cada uma faz evita muita confusão depois.
oxide/plugins- Os próprios arquivos de plugin, como
.cs. Colocar um arquivo aqui o carrega automaticamente. oxide/config- Arquivos de configuração da maioria dos plugins. Eles são gerados pelo plugin na primeira execução, não fornecidos por você.
oxide/data- Dados armazenados que alguns plugins mantêm entre restarts, como registros de jogadores ou saldos de economia. Trate isso como a memória do plugin, e não como algo para editar casualmente.
Um arquivo de configuração ausente não é um problema para corrigir. Se você acabou de enviar
um plugin e oxide/config não tem nada para ele, é porque o plugin ainda não
rodou. Inicie o servidor, deixe-o carregar, e o arquivo vai estar lá.
Enviando plugins
-
Consiga o arquivo do plugin
Baixe o arquivo
.csna biblioteca de plugins do uMod ou onde quer que o autor o distribua. -
Envie-o para oxide/plugins
Pelo gerenciador de arquivos ou via FTP. Envie o próprio arquivo
.cs, não um zip dele. -
Deixe carregar
O uMod detecta novos arquivos automaticamente. Observe o console para ver uma confirmação de carregamento ou um erro.
-
Configure-o
O arquivo de configuração dele agora vai existir em
oxide/config. Edite-o, depois executeoxide.reload PluginNamepara aplicar.
Todo plugin no site do uMod vem com uma descrição cobrindo a configuração inicial, as opções de configuração e as permissões que ele define. Leia essa página antes de começar a chutar configurações, porque a maioria das dúvidas que você vai ter já está respondida nela.
Os comandos que você precisa
| Comando | O que faz |
|---|---|
oxide.reload (PLUGIN NAME) | Recarrega o plugin especificado. |
oxide.unload (PLUGIN NAME) | Descarrega o plugin especificado. |
oxide.reload * | Recarrega todos os plugins de uma vez. |
oxide.usergroup add (GROUP NAME) | Cria um novo grupo de usuário do Oxide. |
oxide.grant group (GROUP NAME) (PERMISSION) | Concede uma permissão a um grupo. |
oxide.grant user (USERNAME/STEAM64 ID) (PERMISSION) | Concede uma permissão a um único usuário. |
oxide.reload é o que muda a forma como você trabalha. Editar uma configuração e
recarregar um único plugin leva segundos e não desconecta ninguém. Reiniciar o servidor para
alcançar o mesmo resultado custa aos seus jogadores um carregamento de mapa e, se a seed mudou,
até dez minutos.
Grupos de permissão na prática
As permissões do Oxide podem ser concedidas a um usuário individual ou a um grupo. As duas formas funcionam. Use grupos.
O motivo é a manutenção. Conceda dez permissões diretamente a cinco VIPs e você tem cinquenta
concessões para acompanhar, e quando alguém deixa de ser VIP você precisa lembrar de todas as
dez. Conceda as dez permissões a um grupo VIPs e adicionar ou remover uma pessoa é
um único comando.
-
Crie o grupo
oxide.usergroup add VIPs -
Conceda as permissões ao grupo
oxide.grant group VIPs kits.vip -
Adicione pessoas ao grupo
Em vez de conceder permissões a elas individualmente. O acesso delas então segue a definição do grupo.
Exemplos práticos
- Recarregue um plugin que você acabou de atualizar
- Você substituiu o arquivo do BetterChat, então execute
oxide.reload BetterChat. Não precisa reiniciar. - Dê noclip aos admins
oxide.grant group Admins noclip.usedá essa permissão a todos no grupo Admins.- Crie um nível VIP
oxide.usergroup add VIPs, depois conceda a ele o que quer que o nível pago deva incluir.- Conceda algo a uma pessoa temporariamente
oxide.grant user 76561198000000000 kits.event. Use isso com moderação, e lembre-se de que você concedeu.- Desligue agora um plugin que está se comportando mal
oxide.unload PluginName. Mais rápido e menos disruptivo do que um restart, e informa imediatamente se aquele plugin era o problema.
Hábitos que valem a pena ter
- Faça backup antes de alterar plugins
- Faça uma cópia de
oxide/antes de adicionar ou remover qualquer coisa. Restaurar uma pasta é mais rápido do que reconstruir uma configuração de memória. - Adicione um plugin de cada vez
- Adicione, recarregue, observe o console e o FPS do servidor, depois siga em frente. Adicionar seis de uma vez e descobrir que o servidor não está bem deixa você com seis suspeitos.
- Fique de olho no desempenho ao longo do caminho
- Os plugins são a principal influência no desempenho do servidor Rust, e um plugin que parece trivial ainda pode custar cada tick.
- Mantenha os plugins atualizados
- Confira o uMod depois de cada atualização do Rust. Um plugin desatualizado falha na compilação e o erro o nomeia, o que pelo menos é fácil de diagnosticar.
- Leia o console
- O uMod é excepcionalmente bom em dizer o que deu errado. A maioria dos problemas de plugin já está explicada na saída que você ainda não rolou para trás para ler.
Para mais profundidade sobre o framework em si, a documentação oficial do uMod é a fonte definitiva. Se você ainda não o instalou, comece com nosso guia sobre como instalar o uMod em um servidor Rust.