Configuração do ResurrectionChest

Primeira Inicialização

Na primeira vez que um administrador com resurrectionchest.* entrar, o ResurrectionChest posta uma mensagem única de primeira inicialização dez segundos após o login. A mensagem confirma que o plugin está pronto para uso, aponta para /resurrectionchest setup e lembra como registrar um baú (coloque um baú e ponha nele uma placa que diga [DeathChest] — ou o que quer que você tenha definido em Input name for death chest).

ResurrectionChest funciona de imediato com baús vanilla, então não há nada que você precise fazer aqui. O lembrete para de aparecer assim que setupDone for true no config.yml. Abrir /resurrectionchest setup alterna setupDone para true automaticamente, o que dispensa permanentemente a mensagem.

Menu de Configuração

/resurrectionchest setup

Abre o menu de configuração Nightbreak. A partir daí, os administradores podem:

• visualizar todos os pacotes de conteúdo do ResurrectionChest (Wooden Chest, Angelic Chest)
• instalar ou desinstalar pacotes (o que move os arquivos de modelo entre as pastas models e models_disabled do FreeMinecraftModels)
• filtrar pacotes por Free ou Premium
• verificar e baixar uma atualização do plugin através da entrada Plugin Update
• abrir a lista Recommended Plugins (a mesma visualização de /resurrectionchest recommendedplugins)
• ligar ou desligar as Automatic Updates (a configuração nightbreak.autoDownloadPluginUpdates — veja Config e Permissões)
• ler instruções de instalação e abrir links relevantes do Nightbreak através do botão de informações

Quando um pacote é instalado ou desinstalado, o ResurrectionChest recarrega o FreeMinecraftModels automaticamente para que os props de baú sejam atualizados.

/resurrectionchest downloadall baixa a atualização do plugin (se houver) e todos os pacotes de conteúdo do ResurrectionChest disponíveis do Nightbreak de uma só vez (requer uma conta Nightbreak vinculada). /resurrectionchest downloadallcontent baixa apenas os pacotes de conteúdo, e /resurrectionchest updatecontent (alias updateallcontent) re-baixa apenas os pacotes de conteúdo que estão desatualizados.

Se os arquivos de um pacote foram danificados ou apagados enquanto o número da versão ainda consta como atual, /resurrectionchest forcereinstallcontent <package|all> o re-baixa mesmo assim. O argumento do pacote tem autocompletar para all, wooden-chest e angelic-chest; use all para refazer todos os pacotes já baixados, ou informe o slug diretamente se os arquivos de um pacote sumiram por completo.

Importações Manuais

Os downloads chegam em — e pacotes colocados à mão podem ser depositados em:

plugins/ResurrectionChest/imports

Deixe os arquivos dos pacotes intactos. O ResurrectionChest descompacta a pasta na inicialização, encaminha os arquivos de modelo para o FreeMinecraftModels e atualiza o FreeMinecraftModels automaticamente quando modelos foram instalados. Veja o guia compartilhado: Importações manuais vs gerenciamento no jogo.

Registrando um Baú

1. Coloque um baú.
2. Coloque uma placa de parede fixada naquele baú.
3. Escreva o texto de ativação configurado na linha 1 ou linha 2 da placa.

O texto de ativação padrão é:

[DeathChest]

Quando a placa é aceita, ResurrectionChest:

• reescreve a placa (linha 1 é apagada, linha 2 mostra o texto de ativação em roxo, linha 3 mostra o nome de exibição do jogador, linha 4 é apagada)
• armazena aquele baú para o jogador
• remove a entrada de baú registrada anterior do jogador se ele já tinha uma, incluindo a exclusão da placa de configuração daquele baú antigo (o bloco do baú antigo e seu conteúdo são deixados intactos)
• marca os blocos do baú e da placa com um marcador de propriedade no tick seguinte, para que o plugin consiga distinguir depois os seus próprios blocos de imitações

Não há um fluxo de registro de baú baseado em comandos.

Regras de Configuração

• O jogador precisa de resurrectionchest.use.
• A configuração é bloqueada em mundos na lista negra.
• A placa aceita deve ser uma placa de parede fixada em um baú.
• Qualquer material de placa de parede funciona porque o código verifica os tipos de bloco de placa de parede, não um material de placa específico.
• O bloco atrás da placa deve ser um baú comum. Baús armadilhados, barris e outros contêineres são rejeitados.
• O baú não pode já estar registrado para outro jogador. Se estiver (qualquer uma das metades de um baú duplo conta), a placa é deixada como texto comum e o jogador é informado de que o baú pertence a outra pessoa.
• O jogador precisa ter permissão para construir no bloco do baú. O ResurrectionChest roteia isso pela consulta compartilhada de WorldGuard / GriefPrevention do MagmaCore, então registrar um baú dentro de uma região onde o jogador não pode construir é recusado com o texto de Chest protected region message. Sem nenhum plugin de proteção instalado, não há restrição extra — veja Config e Permissões.

Baús Simples e Duplos

• Um baú simples normal funciona imediatamente.
• Se um baú registrado depois se tornar parte de um baú duplo, o ResurrectionChest detecta a mudança um tick após o bloco ser colocado, marca a metade recém-unida (e quaisquer placas nela) e troca o prop pelo modelo de baú duplo.
• Se essa metade recém-unida já pertencer ao registro de outro jogador, o registro inteiro é descartado em vez de absorver o baú do outro jogador.
• Os itens de morte podem preencher ambos os lados de um inventário de baú duplo.
• Na morte, todas as metades do baú ainda precisam carregar a marca de propriedade deste jogador. Se uma das metades foi substituída sem o plugin saber, o baú conta como ausente.

Comportamento de Remoção

Quebrar qualquer um destes remove o registro:

• o baú registrado
• uma placa fixada pertencente àquele baú registrado

Quando um registro é removido (por qualquer gatilho — quebrando o baú, quebrando a placa, ou destruindo-o através do prop do FreeMinecraftModels), o plugin também remove quaisquer placas de parede ainda fixadas a esse bloco de baú. Essas placas são apagadas, não dropadas como itens.

Um registro também é descartado automaticamente quando o plugin não consegue mais provar que os blocos são seus: se qualquer metade de baú em uma localização armazenada perdeu sua marca de propriedade, ou agora carrega a de outra pessoa, o registro é descartado na próxima inicialização, carregamento de chunk ou atualização de modelos, e um aviso nomeando o UUID do proprietário e as coordenadas do baú é escrito no console. O bloco do baú em si é deixado no lugar. As marcas das placas só são reverificadas quando o plugin remarca seus blocos — quando uma metade de baú duplo é unida, e quando um registro mais antigo é migrado para as marcas de propriedade atuais. Defina Enable high compatibility / low security mode for plugin conflicts como true se outro plugin no seu servidor remover esses dados de bloco — veja Config e Permissões.

O plugin também cancela tentativas de editar a placa de configuração registrada no local.

Se um prop de baú personalizado estiver ativo, clicar com o botão esquerdo no prop também remove o registro (apenas o proprietário do baú pode fazer isso — veja Config e Permissões).

Os administradores podem apagar todos os baús registrados de uma só vez com /resurrectionchest clear. Para cada baú rastreado, ele dropa o inventário do baú no chão, então remove o baú e quaisquer placas de configuração fixadas e limpa o registro armazenado.

Aviso de Proteção

ResurrectionChest não é um plugin de proteção.

• Não impede outros jogadores de abrir o baú físico.
• Não impede outros jogadores de quebrar o baú físico ou a placa se a configuração de proteção do seu servidor permitir.

Use proteção de região ou outra solução de proteção de baú se precisar de controle de acesso.