Configuração do Extractioncraft

O Extractioncraft usa vários ficheiros de configuração. As definições principais estão em config.yml e messaging.yml. Os pacotes de conteúdo, as tabelas de saque e os conjuntos de saque têm pastas próprias.

config.yml

Chave	Tipo	Predefinição	Descrição
deleteItemsOnFailToExtract	Booleano	true	Determina se os jogadores perdem todos os itens quando não saem da partida por um ponto de extração. O conteúdo pré-fabricado foi equilibrado tendo em conta este risco. Desativá-lo facilita a recolha repetida de recompensas e reduz a necessidade de usar a extração.
nightbreak.autoDownloadPluginUpdates	Booleano	false	Opção partilhada do MagmaCore, acrescentada ao ficheiro depois de o Extractioncraft arrancar. Com true, as atualizações disponíveis do plugin Extractioncraft são descarregadas alguns minutos após o arranque e usadas após o próximo reinício, a menos que nightbreak.applyPluginUpdatesWithoutRestart as aplique antes. Consulte atualizações automáticas.
nightbreak.applyPluginUpdatesWithoutRestart	Texto	never	Opção partilhada do MagmaCore. never aguarda o próximo reinício, when-empty aplica uma atualização do plugin descarregada na próxima vez que não houver jogadores online e immediately aplica-a assim que termina a descarga. Aplicar uma atualização recarrega o Extractioncraft, o que termina as partidas em curso. Consulte aplicar atualizações sem reiniciar.

A eliminação só se aplica depois de a partida ter começado. Sair enquanto a partida espera ou está em contagem decrescente deixa o inventário intacto. Extrair, desligar o servidor ou recarregar o plugin conserva os itens e vincula ao jogador os que ainda não estejam vinculados, se o encantamento Soulbind do EliteMobs estiver ativo. Com esta opção definida como false, todas as outras saídas de uma partida em curso vinculam os itens em vez de os eliminar. Consulte o decurso das partidas para cada forma de sair.

messaging.yml

Todas as mensagens aceitam códigos de cor &. Os marcadores disponíveis são indicados em cada linha.

Chave	Predefinição	Descrição
failedToJoinOngoingMatchAsPlayerMessage	Can't join this match - it has already started!	Apresentada quando um jogador tenta entrar numa partida já iniciada
failedToJoinOngoingMatchAsPlayerInstanceIsFull	Can't join this match - the instance is already full!	Apresentada quando a partida atingiu o limite de jogadores
failedToJoinOngoingMatchAsPlayerNoPermission	Can't join this match - you don't have the permission!	Mensagem configurável para a falta de permissão. Atualmente não é enviada: as partidas do Extractioncraft não definem nenhuma permissão de entrada.
failedToJoinMatchAsSpectatorNoSpectatorsAllowedMessage	Can't join this match - spectators are not allowed!	Mensagem configurável para pacotes que não permitem espectadores. A implementação atual de partidas do MagmaCore não a envia: rejeita a tentativa sem mensagem.
failedToJoinMatchAsSpectatorNoPermission	Can't spectate this match - you don't have the permission!	Mensagem configurável para a falta de permissão de espectador. Atualmente não é enviada: assistir como espectador não exige permissão.
matchJoinAsPlayerMessage	[Extractioncraft] You are now in the match, $player!	Mensagem de chat ao entrar como jogador. $player é substituído pelo nome do jogador e $count pelo número mínimo de jogadores.
matchJoinAsPlayerTitle	Extract!	Título apresentado ao entrar numa partida
matchJoinAsPlayerSubtitle	Grab the loot and head to an extraction point!	Subtítulo apresentado ao entrar numa partida
matchJoinAsSpectatorTitle	(vazio)	Título apresentado ao entrar como espectador. O Extractioncraft não tem comando para assistir, pelo que só o veem os espectadores admitidos por outro plugin através da API.
matchJoinAsSpectatorSubtitle	Now spectating!	Subtítulo apresentado ao entrar como espectador. Só é enviado a espectadores admitidos através da API.
matchJoinAsSpectatorMessage	[Extractioncraft] You are now spectating a match! Do &a/extractioncraft quit &fto stop spectating!	Mensagem de chat ao entrar como espectador. Só é enviada a espectadores admitidos através da API. $player é substituído pelo nome do jogador.
matchLeaveAsPlayerMessage	[Extractioncraft] You have left the match, $player!	Mensagem de saída configurável. A implementação atual do MagmaCore não a envia nem substitui $player.
matchLeaveAsSpectatorMessage	[Extractioncraft] You have left the match, $player!	Mensagem de saída de espectador configurável. A implementação atual do MagmaCore não a envia nem substitui $player.
matchFailedToStartNotEnoughPlayersMessage	This match requires $count players before starting - can't start yet!	Apresentada a todos na partida quando /exc start é usado sem jogadores suficientes. Só o marcador $amount é substituído pelo número mínimo de jogadores, pelo que o texto predefinido mostra $count literalmente. Use $amount se quiser que o número seja substituído.
matchStartingMessage	[Extractioncraft] Match starting!	Mensagem de chat de início configurável. A implementação atual do MagmaCore não a envia; apresenta a contagem decrescente através do título e subtítulo.
matchStartingTitle	Match starting!	Título da contagem decrescente. $count mostra 2, 1 e depois 0, a intervalos de um segundo.
matchStartingSubtitle	in $count...	Subtítulo da contagem decrescente. $count mostra 2, 1 e depois 0, a intervalos de um segundo.
preventTeleportInMessage	[Extractioncraft] You have attempted to teleport into an ongoing match - you can't do that!	Mensagem configurável para teletransportes bloqueados para dentro do mundo de uma partida. O teletransporte é cancelado, mas a mensagem não é enviada atualmente.
preventTeleportOutMessage	[Extractioncraft] You have attempted to teleport from an ongoing match - you can't do that!	Mensagem configurável para teletransportes bloqueados para fora de uma partida. O teletransporte é cancelado, mas a mensagem não é enviada atualmente.

Configuração dos pacotes de conteúdo

Os pacotes de conteúdo são ficheiros YAML na pasta content_packages/. Cada um define a configuração de um mapa jogável.

Chave	Tipo	Predefinição	Descrição
isEnabled	Booleano	true	Indica se o pacote conta como instalado e determina a sua cor em /exc setup: true corresponde a instalado/verde e false a transferido mas não instalado/amarelo. O menu altera este valor. /exc createMatch continua a sugerir um pacote desativado por Tab, mas recusa gerá-lo.
name	Texto	(obrigatório)	Nome apresentado do pacote, com suporte para códigos de cor &
description	Lista de textos	(obrigatório)	Linhas de descrição apresentadas no menu de configuração
downloadLink	Texto	(opcional)	URL apresentada no chat ao clicar num pacote ainda não transferido no menu. Os pacotes pré-fabricados usam https://nightbreak.io/plugin/extractioncraft/.
version	Inteiro	0	Número de versão do conteúdo. A verificação de estado só distingue não transferido, instalado e não instalado; atualmente este valor não é comparado com nenhum outro.
folderName	Texto	(opcional)	Escrito nos ficheiros pré-fabricados, mas não lido pelo código atual. O facto de um pacote contar como transferido depende de betterStructuresModulesContainerName.
usesEliteMobs	Booleano	false	Indicação declarativa de que o pacote usa conteúdo EliteMobs. Não é verificada durante o funcionamento.
usesBetterStructures	Booleano	false	Indicação declarativa de que o pacote usa conteúdo BetterStructures. Não é verificada durante o funcionamento.
usesFreeMinecraftModules	Booleano	false	Indicação declarativa de que o pacote usa conteúdo FreeMinecraftModels. Não é verificada durante o funcionamento. A chave YAML no código-fonte é mesmo usesFreeMinecraftModules, com "Modules".
betterStructuresModulesContainerName	Texto	(opcional)	Nome do ficheiro de configuração do gerador modular BetterStructures passado ao gerador de mundos por /exc createMatch, por exemplo kobold_mines_module_generator_10.yml. Esta é a chave que determina o mapa gerado. O gerador tem de estar ativado, ter isWorldGeneration: true e indicar pelo menos um módulo inicial instalado. O menu de configuração trata o pacote como transferido assim que o BetterStructures carregar este gerador.
spectatable	Booleano	false	Indica se a partida aceita espectadores. O Extractioncraft não tem comando para assistir, pelo que isto só afeta os espectadores que outro plugin admita através da API.
pvpEnabled	Booleano	true	Ativa o PvP nas partidas. Com false, os jogadores e os seus projéteis não podem causar dano a outros jogadores em nenhum ponto do mundo da partida.
minPlayers	Inteiro	1	Número mínimo para iniciar. /exc start recusa começar abaixo deste número. Se o número cair abaixo dele durante a contagem decrescente, esta é interrompida e a partida termina. Valores acima de maxPlayers são reduzidos para maxPlayers.
maxPlayers	Inteiro	100	Limite de jogadores por partida (pelo menos 1). Os cinco pacotes pré-fabricados Kobold Mines usam 8. O Extractioncraft não regista um comando de entrada, pelo que só o criador entra numa partida, a menos que outro plugin admita jogadores através da API.
contentLevel	Inteiro	10	Nível transmitido ao EliteMobs ao gerar o saque de baús e barris. Valores abaixo de 1 passam a 1. Os pacotes pré-fabricados usam 10, 20, 30, 40 e 50.
chestLootTables	Lista de textos	[]	Tabelas de saque dos baús, no formato filename.yml:weight
barrelLootTables	Lista de textos	[]	Tabelas de saque dos barris, no formato filename.yml:weight

Formato dos pesos das tabelas de saque

As entradas de tabelas para baús e barris usam <loot_table_filename.yml>:<weight>. Quando um jogador abre um contentor, uma tabela é escolhida segundo as probabilidades relativas dos pesos.

Exemplo:

chestLootTables:
  - my_chest_high_loot_table.yml:.2
  - my_chest_low_loot_table.yml:.2
barrelLootTables:
  - kobold_mines_supplies_loot_table.yml:1

A parte :weight é obrigatória e tem de ser um número positivo. Uma entrada sem exatamente um sinal de dois pontos, com o nome do ficheiro em branco ou com um peso que não seja um número positivo é ignorada com um aviso. Os pesos são relativos entre si: neste exemplo, cada tabela de baú tem 50% de probabilidade. Um nome que não corresponda a um ficheiro em loot_tables/ gera um aviso no arranque e é ignorado, tal como uma tabela definida com isEnabled: false. Se não restar nenhuma tabela utilizável, clicar com o botão direito nesse tipo de contentor não faz nada.