Como instalar plugins EXILED no seu servidor SCP: Secret Laboratory

Quase todo plugin do SCP: Secret Laboratory é feito para o EXILED, o framework de plugins da comunidade. Instale o framework primeiro, e depois os plugins são arquivos DLL que você coloca em uma pasta.

Instale o EXILED

1. Pare o servidor.
2. Baixe a versão do EXILED que combina com a versão do jogo do seu servidor.
3. No painel, abra Files e envie os arquivos do EXILED para ficar com uma pasta EXILED no diretório de usuário do servidor, ao lado da pasta de configuração do SCP Secret Laboratory.
4. Inicie o servidor e leia o console. O EXILED se anuncia com um número de versão ao carregar.

Se nada sobre o EXILED aparecer no console, o framework não está sendo carregado e nenhum plugin vai rodar. Abra um ticket citando as primeiras trinta linhas do console.

Instale um plugin

1. Pare o servidor.
2. Envie o .dll do plugin para:

   .config/EXILED/Plugins/

3. Se o plugin listar dependências, envie essas DLLs para:

   .config/EXILED/Plugins/dependencies/

4. Inicie o servidor. Cada plugin é registrado ao carregar, com a versão dele.

Uma dependência na pasta errada é o erro de instalação mais comum. Os plugins vão em Plugins, e as bibliotecas de que eles precisam vão em dependencies.

Configure um plugin

O EXILED grava a configuração dos plugins em um arquivo de configuração em:

.config/EXILED/Configs/

O arquivo aparece depois da primeira execução. Inicie o servidor uma vez, pare-o e depois edite. O formato é YAML, então a indentação importa, e uma tabulação onde se esperam espaços quebra o arquivo.

Confira o que carregou

Acompanhe o console do painel na inicialização. Ele lista cada plugin com a versão dele e mostra o nome de qualquer um que falhou, com o motivo. Um plugin feito para outra versão do EXILED é a falha mais comum e aparece como um erro de tipo ou de método.

Depois de uma atualização do jogo

Um patch do jogo quebra o EXILED e seus plugins até saírem builds novas. Se o servidor começar a falhar logo depois de uma atualização:

1. Tire o conteúdo de Plugins do lugar.
2. Confirme que o servidor roda limpo sem plugins.
3. Atualize o próprio EXILED e depois coloque os plugins de volta conforme as atualizações chegarem.

Como remover um plugin

Pare o servidor, apague a DLL de Plugins e apague o arquivo dele em Configs se quiser que as configurações dele também sumam. Deixe as dependências quietas, a menos que mais nada as use.