Configuração inicial do ResurrectionChest

Primeiro arranque

Até a configuração estar concluída, o ResurrectionChest apresenta um lembrete inicial dez segundos após cada entrada de um administrador com resurrectionchest.*. A mensagem confirma que o plugin está pronto, indica /resurrectionchest setup e explica como registar um baú: colocar um baú e fixar-lhe uma placa com [DeathChest], ou com o texto definido em Input name for death chest.

O ResurrectionChest funciona de imediato com baús vanilla. Não há nenhum passo obrigatório nesta fase. O lembrete deixa de aparecer quando setupDone fica definido como true em config.yml. Abrir /resurrectionchest setup faz isso automaticamente e dispensa a mensagem de forma permanente.

/resurrectionchest initialize abre a configuração guiada. As opções de configuração recomendada, configuração manual e utilização do conteúdo atual marcam a configuração como concluída. Os baús de morte vanilla funcionam sem descarregar qualquer pacote.

Menu de configuração

/resurrectionchest setup

Abre o menu de configuração Nightbreak. Aqui, os administradores podem:

• consultar todos os pacotes de conteúdo ResurrectionChest, Wooden Chest e Angelic Chest
• instalar ou desinstalar pacotes, movendo os ficheiros de modelos entre as pastas models e models_disabled do FreeMinecraftModels
• filtrar pacotes gratuitos ou premium
• verificar e descarregar uma atualização através da opção Atualização do plugin
• descarregar ou atualizar todos os pacotes de uma só vez com a opção de descarregar tudo, que executa /resurrectionchest downloadall por si
• abrir a lista de Plugins recomendados, também disponível através de /resurrectionchest recommendedplugins
• ativar ou desativar as Atualizações automáticas, que correspondem à definição nightbreak.autoDownloadPluginUpdates. Consulte Configuração e permissões.
• ler as instruções de instalação e abrir as ligações relevantes do Nightbreak através do botão de informação

Quando um pacote é instalado ou desinstalado, o ResurrectionChest recarrega automaticamente o FreeMinecraftModels para atualizar os modelos dos baús.

/resurrectionchest downloadall descarrega de uma só vez a atualização do plugin, se existir, e todos os pacotes de conteúdo ResurrectionChest disponíveis no Nightbreak. Exige uma conta Nightbreak ligada. /resurrectionchest downloadallcontent descarrega apenas os pacotes de conteúdo. /resurrectionchest updatecontent, também disponível como updateallcontent, volta a descarregar apenas os pacotes desatualizados.

Se os ficheiros de um pacote estiverem danificados ou tiverem sido eliminados, mas a versão ainda constar como atual, /resurrectionchest forcereinstallcontent <package|all> volta a descarregá-lo. O argumento do pacote sugere all, wooden-chest e angelic-chest ao premir Tab. Use all para reinstalar todos os pacotes já descarregados, ou indique diretamente o identificador se os ficheiros de um pacote tiverem desaparecido por completo.

Importações manuais

As descargas são guardadas nesta pasta, onde também pode colocar pacotes manualmente:

plugins/ResurrectionChest/imports

Mantenha os arquivos dos pacotes intactos. No arranque, o ResurrectionChest extrai o conteúdo da pasta, encaminha os modelos para o FreeMinecraftModels e atualiza-o automaticamente se tiver instalado modelos. Consulte o guia partilhado Importações manuais e gestão no jogo.

Registar um baú

1. Coloque um baú.
2. Fixe uma placa de parede nesse baú.
3. Escreva o texto de ativação configurado na primeira ou segunda linha da placa. As maiúsculas e minúsculas não importam.

O texto predefinido é:

[DeathChest]

Quando aceita a placa, o ResurrectionChest:

• reescreve-a, limpando as linhas 1 e 4, mostrando o texto de ativação a roxo na linha 2 e o nome de apresentação do jogador na linha 3
• regista esse baú para o jogador
• remove o registo anterior, se existir, incluindo a placa de configuração do baú antigo; o baú antigo e o seu conteúdo permanecem intactos
• acrescenta uma marca de proprietário aos blocos do baú e da placa no tick seguinte, para os distinguir posteriormente de blocos semelhantes

Se outro plugin cancelar a colocação da placa, o novo registo não é guardado e o baú anterior continua registado. Destruir um baú ou uma placa só remove o registo quando a destruição se concretiza. Uma destruição cancelada não remove o registo.

Não existe um comando para registar baús.

Regras de configuração

• O jogador precisa de resurrectionchest.use.
• O registo está bloqueado nos mundos excluídos.
• A placa tem de ser uma placa de parede fixada num baú.
• Qualquer material de placa de parede funciona, pois o código verifica o tipo de bloco e não um material específico.
• O bloco atrás da placa tem de ser um baú normal. Baús armadilhados, barris e outros recipientes são rejeitados.
• O baú não pode estar registado para outro jogador. Basta que uma metade de um baú duplo esteja registada para o registo ser recusado. A placa fica com o texto normal e o jogador é informado de que o baú pertence a outra pessoa.
• O jogador tem de poder construir no bloco do baú. O ResurrectionChest consulta a integração partilhada do MagmaCore com WorldGuard e GriefPrevention e os relatórios de proteção dos fornecedores de propriedade de locais. Uma recusa impede o registo e apresenta Chest protected region message. Sem fornecedores de proteção ou propriedade, não há esta restrição adicional. Consulte Configuração e permissões.

Baús simples e duplos

• Um baú simples normal funciona imediatamente.
• Se um baú registado passar a fazer parte de um baú duplo, o ResurrectionChest deteta a alteração um tick após a colocação do bloco, marca a nova metade e as respetivas placas, e troca o modelo pela variante dupla.
• Se a nova metade já pertencer ao registo de outro jogador, todo o registo é descartado em vez de incorporar o baú desse jogador.
• Os itens da morte podem preencher as duas metades do inventário de um baú duplo, num total de 54 espaços.
• Um baú duplo pode atravessar o limite de um chunk. O servidor só emparelha as duas metades enquanto ambos os chunks estão carregados, por isso, quando o dono morre longe, o ResurrectionChest carrega o chunk que contém a outra metade antes de verificar a propriedade e mover os itens. Carrega-o normalmente e não o mantém carregado à força. Se as metades continuarem sem emparelhar, a consola regista um aviso com o nome do jogador e a localização do baú, e só a metade registada recebe itens.
• Com as definições de segurança predefinidas, todas as metades têm de manter a marca de proprietário do jogador no momento da morte. Se uma metade tiver sido substituída sem o conhecimento do plugin, o baú é considerado desaparecido.

Comportamento de remoção

Destruir qualquer um destes elementos remove o registo:

• o baú registado
• uma placa fixada pertencente a esse baú

Quando um registo é removido, quer por destruir o baú, a placa ou o modelo FreeMinecraftModels, o plugin também remove as placas de parede fixadas que passem na verificação de proprietário. Essas placas são eliminadas e não caem como itens.

O registo também é descartado automaticamente quando o plugin já não consegue confirmar que os blocos lhe pertencem. Se uma metade do baú numa localização guardada perder a marca de proprietário ou passar a ter a de outra pessoa, o registo é descartado no próximo arranque, carregamento do chunk ou atualização de modelos. A consola recebe um aviso com o UUID do proprietário e as coordenadas. O bloco do baú permanece no local. As marcas das placas só voltam a ser verificadas quando o plugin marca novamente os blocos: ao juntar uma metade de baú duplo ou ao migrar um registo antigo para as marcas atuais. Ative Enable high compatibility / low security mode for plugin conflicts se outro plugin remover estes dados dos blocos. Consulte Configuração e permissões.

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

Se estiver ativo um modelo de baú personalizado, clicar nele com o botão esquerdo também remove o registo. Só o proprietário pode fazê-lo. Consulte Configuração e permissões.

Os administradores podem eliminar todos os baús registados com /resurrectionchest clear. Para cada baú acompanhado, o comando larga o conteúdo no chão, remove o baú e as placas de configuração fixadas, e elimina o registo guardado.

Esta limpeza respeita as verificações de proprietário configuradas. Os blocos que não passam nessas verificações permanecem intactos. Se o mundo de um baú estiver descarregado, só o registo é eliminado; os blocos desse mundo permanecem.

Aviso sobre proteção

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 destruir o baú físico ou a placa se as proteções do servidor o permitirem.

Use proteção de regiões ou outra solução de proteção de baús se precisar de controlar o acesso.

Resolução de problemas

• Os itens não vão para o baú. Verifique se o jogador tem resurrectionchest.use, se a placa usou o texto de ativação configurado e se o baú ainda existe e está registado nesse jogador (partir o baú remove o registo). As mortes num mundo listado em blacklistedWorlds, ou com keepInventory ativo, são ignoradas pelo plugin.
• O modelo personalizado do baú não aparece. O modelo é escolhido quando o baú é registado. Se o FreeMinecraftModels ou o pacote de modelos foram instalados mais tarde, ou se a permissão de modelo do jogador mudou, parta o baú e registe-o de novo. Consulte Integração com o FreeMinecraftModels.
• Antes de executar /resurrectionchest clear, faça uma cópia de segurança de playerData.yml e de qualquer conteúdo de baús que queira manter. O comando esvazia todos os baús registados para o chão e remove os baús e as suas placas.

Ao pedir ajuda, indique as versões do ResurrectionChest e do servidor, o seu config.yml, os passos que reproduzem o problema e o registo completo do servidor. O /logify envia o registo e devolve uma ligação.