Configuração e Permissões do ResurrectionChest

Permissões

Permissão	Propósito	Padrão
resurrectionchest.*	Dá aos administradores acesso aos comandos de configuração, conteúdo, atualização, recarregamento e limpeza	op
resurrectionchest.setup	Dá aos administradores acesso a /resurrectionchest setup, recommendedplugins, downloadallcontent e updatecontent	op
resurrectionchest.initialize	Permissão de administrador reservada para o fluxo de configuração inicial	op
resurrectionchest.use	Permite que um jogador registre um baú e tenha os itens de morte roteados para ele	true
resurrectionchest.model.free	Permite que um jogador use os visuais gratuitos de baú do FreeMinecraftModels (Wooden Chest)	true
resurrectionchest.model.premium	Permite que um jogador use os visuais premium de baú do FreeMinecraftModels (Angelic Chest)	op

resurrectionchest.use é a permissão importante para o comportamento real do baú. As permissões de administrador e de modelo afetam apenas os comandos e os visuais opcionais, respectivamente.

Comandos

Comando	Permissão	Propósito
/resurrectionchest	resurrectionchest.*	Exibe uma breve nota de informação apontando para o fluxo de configuração
/resurrectionchest setup	resurrectionchest.setup	Abre o menu de configuração (navegar/alternar pacotes de baú, verificar atualizações do plugin, ver plugins recomendados, alternar atualizações automáticas)
/resurrectionchest recommendedplugins	resurrectionchest.setup	Abre (ou, no console, lista) os plugins complementares recomendados para o ResurrectionChest
/resurrectionchest downloadall	resurrectionchest.*	Baixa a atualização do plugin (se houver) e todos os pacotes de conteúdo disponíveis do Nightbreak
/resurrectionchest downloadallcontent	resurrectionchest.setup	Baixa todos os pacotes de conteúdo disponíveis do Nightbreak
/resurrectionchest updatecontent (alias updateallcontent)	resurrectionchest.setup	Re-baixa apenas os pacotes de conteúdo instalados que estão desatualizados
/resurrectionchest downloadpluginupdate	resurrectionchest.*	Baixa uma atualização do plugin ResurrectionChest se houver uma disponível
/resurrectionchest reload	resurrectionchest.*	Recarrega o ResurrectionChest
/resurrectionchest clear	resurrectionchest.*	Limpa todos os blocos rastreados pelo ResurrectionChest; dropa o inventário de cada baú rastreado e remove os blocos de baú e placa

As atualizações de plugin baixadas são colocadas na pasta de atualização do servidor e só têm efeito após a próxima reinicialização do servidor.

Superfície de Configuração

config.yml atualmente expõe estas configurações voltadas ao usuário:

Chave de Config	Tipo	Padrão
setupDone	boolean	false
nightbreak.autoDownloadPluginUpdates	boolean	false
Input name for death chest	string	[DeathChest]
Enable high compatibility / low security mode for plugin conflicts	boolean	false
Lower worn armor's durability on death	boolean	true
Amount of durability to lower on death	int	100
Chest creation message	string	&8[ResurrectionChest] &aYou've created your Death Chest!
Chest destruction message	string	&8[ResurrectionChest] &cYour Death Chest has been destroyed!
Chest missing message	string	&8[ResurrectionChest] &4Your Death Chest is missing!
Death message	string	&8[ResurrectionChest] &aYour items have been moved to your Death Chest!
deathChestRemovedMessage	string	&8[ResurrectionChest] &cYour Death Chest has been removed!
Enable particle effects for death chests	boolean	true
Particle effect 1	string	ENCHANTMENT_TABLE
Particle effect 2	string	ENCHANTMENT_TABLE
Particle effect 3	string	PORTAL
blacklistedWorlds	list	[none]
storeXP	boolean	true
xpPercentageKept	double	0.75
deathChestNameTag	string	$playerName's &fResurrection Chest
freeSingleDeathChestModelName	string	resurrectionchest_free_single
freeDoubleDeathChestModelName	string	resurrectionchest_free_double
premiumSingleDeathChestModelName	string	resurrectionchest_angelic_single
premiumDoubleDeathChestModelName	string	resurrectionchest_angelic_double

Atualizações Automáticas de Plugin e Conteúdo

nightbreak.autoDownloadPluginUpdates é uma configuração compartilhada do Nightbreak/MagmaCore que vem incluída no ResurrectionChest. Seu padrão é false.

• Quando false (o padrão), nada é baixado automaticamente. O ResurrectionChest ainda verifica se há uma atualização do plugin na inicialização (e aproximadamente uma vez por hora) para que o botão de atualização no jogo possa mostrar o resultado, mas você mesmo dispara qualquer download real.
• Quando true, o ResurrectionChest baixa uma atualização de plugin disponível e os pacotes de conteúdo desatualizados na inicialização. As atualizações de plugin e conteúdo baixadas só são usadas após a reinicialização do servidor.
• Os downloads automáticos de plugin exigem um token de conta Nightbreak válido e uma assinatura de apoiador ativa.

Você pode alternar esta configuração no jogo a partir do botão Automatic Updates na barra de ferramentas dentro de /resurrectionchest setup, ou editar o config.yml diretamente.

O menu de configuração também expõe uma entrada Plugin Update (mostra a versão instalada/disponível e baixa uma atualização ao clicar) e uma entrada Recommended Plugins (a mesma lista de /resurrectionchest recommendedplugins).

Tratamento de XP

Quando storeXP está habilitado:

• ResurrectionChest rastreia o XP total atual do jogador durante o jogo
• na morte, armazena XP total rastreado * xpPercentageKept
• define o XP dropado como 0
• devolve o XP armazenado quando o proprietário abrir seu baú registrado na próxima vez

Exceções importantes:

• Se keepInventory estiver ativo, ResurrectionChest não faz nada.
• Se keepLevel estiver ativo, o ramo de armazenamento de XP sai antecipadamente e deixa o tratamento vanilla de nível intacto.

Tratamento de Excedentes

Se o baú não tem espaço livre para um item:

• aquele item permanece na lista normal de itens de morte
• o jogador recebe um aviso de que o baú estava cheio

Integração com FreeMinecraftModels

Se FreeMinecraftModels estiver instalado, ResurrectionChest pode gerar um prop visual de baú em cima do baú real.

Comportamento atual:

• visuais premium (Angelic Chest) são preferidos quando o jogador tem resurrectionchest.model.premium e o modelo premium está de fato carregado
• caso contrário, o visual gratuito (Wooden Chest) é usado quando o jogador tem resurrectionchest.model.free
• se nenhuma das permissões conceder um modelo utilizável, nenhum prop é gerado e o baú vanilla é usado como está
• o modelo visual alterna entre variantes simples e dupla com base no tamanho do baú
• o baú real continua sendo o armazenamento

Quando um prop de modelo personalizado está ativo, os jogadores podem interagir com ele diretamente:

• clicar com o botão direito no prop para abrir o inventário do baú subjacente
• agachar + clicar com o botão esquerdo no prop para destruir o registro (apenas o proprietário pode fazer isso)
• clicar com o botão esquerdo sem agachar mostra um aviso amarelo em vez de destruir o baú

Se o FreeMinecraftModels estiver ausente ou o modelo não puder ser gerado, o baú subjacente ainda funciona normalmente.

Pacotes de Conteúdo

ResurrectionChest vem com dois pacotes de conteúdo que envolvem os modelos de baú do FreeMinecraftModels:

• Wooden Chest (gratuito): fornece resurrectionchest_free_single / resurrectionchest_free_double. Usado por resurrectionchest.model.free.
• Angelic Chest (premium): fornece resurrectionchest_angelic_single / resurrectionchest_angelic_double. Usado por resurrectionchest.model.premium.

Cada pacote fica na pasta models do FreeMinecraftModels quando instalado e em models_disabled quando desinstalado. Alterná-los através de /resurrectionchest setup move os arquivos entre essas pastas e recarrega o FreeMinecraftModels automaticamente.

Ressalvas Baseadas no Código Fonte

O código fonte atual mostra algumas entradas de configuração que estão expostas em config.yml mas não são referenciadas em nenhum lugar fora de DefaultConfig:

• Enable high compatibility / low security mode for plugin conflicts
• Lower worn armor's durability on death e Amount of durability to lower on death
• Particle effect 1
• Particle effect 2
• freeSingleDeathChestModelName
• freeDoubleDeathChestModelName e premiumDoubleDeathChestModelName (o plugin codifica internamente os prefixos de nome de modelo resurrectionchest_free e resurrectionchest_angelic, e então anexa _single ou _double com base no tamanho do baú, então as chaves de config "Double" atualmente não afetam os visuais do baú)

Em contraste, Particle effect 3 é a configuração de partículas com um uso ativo óbvio no código atual (gerada a cada tick enquanto o chunk do baú está carregado). premiumSingleDeathChestModelName é usado para verificar se o arquivo do modelo premium existe antes de atribuir o prefixo premium; a existência do arquivo do modelo gratuito não é verificada separadamente.