Configuração do Extractioncraft
O Extractioncraft usa vários arquivos de configuração. As configurações principais estão em config.yml e messaging.yml. Pacotes de conteúdo, tabelas de saque e pools de saque cada um tem suas próprias pastas de configuração.
config.yml
| Chave | Tipo | Padrão | Descrição |
|---|---|---|---|
deleteItemsOnFailToExtract | Boolean | true | Se os jogadores perdem todos os itens caso não consigam extrair da partida usando um dos pontos de extração. Quando ativado, o conteúdo pré-fabricado é balanceado em torno deste risco. Desativá-lo torna o conteúdo mais fácil de farmar com menos razão para engajar as mecânicas de extração. |
O apagamento só se aplica depois que a partida está realmente ao vivo: um jogador que sai enquanto a instância ainda está no estado de espera ou de contagem regressiva mantém seu inventário. Assim que a partida está em andamento, toda saída que não seja uma extração bem-sucedida (sair, desconectar, morrer ou ser removido pelo plugin) apaga o inventário inteiro.
messaging.yml
Todas as mensagens suportam códigos de cor &. Os placeholders são indicados por linha.
| Chave | Padrão | Descrição |
|---|---|---|
failedToJoinOngoingMatchAsPlayerMessage | Can't join this match - it has already started! | Mostrada quando um jogador tenta entrar em uma partida em andamento |
failedToJoinOngoingMatchAsPlayerInstanceIsFull | Can't join this match - the instance is already full! | Mostrada quando a partida atingiu a contagem máxima de jogadores |
failedToJoinOngoingMatchAsPlayerNoPermission | Can't join this match - you don't have the permission! | Mostrada quando o jogador não tem permissão de entrada |
failedToJoinMatchAsSpectatorNoSpectatorsAllowedMessage | Can't join this match - spectators are not allowed! | Mensagem configurável para quando assistir como espectador está desativado para o pacote de conteúdo. Atualmente não é emitida pelo runtime de partida do MagmaCore: a tentativa de assistir é rejeitada silenciosamente sem enviar nenhuma mensagem. |
failedToJoinMatchAsSpectatorNoPermission | Can't spectate this match - you don't have the permission! | Mensagem configurável para quando o jogador não tem permissão de espectador. Atualmente não é emitida pelo runtime de partida do MagmaCore: um espectador que não tem permissão recebe failedToJoinOngoingMatchAsPlayerNoPermission em vez disso. |
matchJoinAsPlayerMessage | [Extractioncraft] You are now in the match, $player! | Mensagem no chat ao entrar em uma partida como jogador. O runtime do MagmaCore só substitui o placeholder $count (pela contagem mínima de jogadores) nesta string; $player não é substituído, então o texto padrão mostra $player literalmente. |
matchJoinAsPlayerTitle | Extract! | Título mostrado ao entrar em uma partida |
matchJoinAsPlayerSubtitle | Grab the loot and head to an extraction point! | Subtítulo de entrada configurável. Atualmente não é usado pelo runtime de partida do MagmaCore: o subtítulo realmente mostrado ao entrar é matchStartingSubtitle. |
matchJoinAsSpectatorTitle | (vazio) | Título configurável de entrada como espectador. Atualmente não é emitido pelo runtime de partida do MagmaCore. |
matchJoinAsSpectatorSubtitle | Now spectating! | Subtítulo configurável de entrada como espectador. Atualmente não é emitido pelo runtime de partida do MagmaCore. |
matchJoinAsSpectatorMessage | [Extractioncraft] You are now spectating a match! Do &a/extractioncraft quit &fto stop spectating! | Mensagem de chat configurável de entrada como espectador. Atualmente não é emitida pelo runtime de partida do MagmaCore. |
matchLeaveAsPlayerMessage | [Extractioncraft] You have left the match, $player! | Mensagem configurável de saída. Atualmente não é emitida pelo runtime de partida do MagmaCore, e $player não é substituído. |
matchLeaveAsSpectatorMessage | [Extractioncraft] You have left the match, $player! | Mensagem configurável de saída de espectador. Atualmente não é emitida pelo runtime de partida do MagmaCore, e $player não é substituído. |
matchFailedToStartNotEnoughPlayersMessage | This match requires $count players before starting - can't start yet! | Mostrada quando /exc start é usado sem jogadores suficientes. O runtime do MagmaCore substitui o placeholder $amount pela contagem mínima de jogadores, então personalize esta mensagem usando $amount em vez de $count se quiser que o número seja substituído. |
matchStartingMessage | [Extractioncraft] Match starting! | Mensagem de chat configurável de início de partida. Atualmente não é emitida pelo runtime de partida do MagmaCore (a contagem regressiva é mostrada via título/subtítulo). |
matchStartingTitle | Match starting! | Título mostrado durante a contagem regressiva de 3 segundos. $count é substituído pelos segundos restantes. |
matchStartingSubtitle | in $count... | Subtítulo durante a contagem regressiva de 3 segundos. $count é substituído pelos segundos restantes. |
preventTeleportInMessage | [Extractioncraft] You have attempted to teleport into an ongoing match - you can't do that! | Mensagem configurável para teleportes bloqueados para dentro de um mundo de partida. O teleporte em si é cancelado pelo runtime, mas esta mensagem atualmente não é enviada ao jogador. |
preventTeleportOutMessage | [Extractioncraft] You have attempted to teleport from an ongoing match - you can't do that! | Mensagem configurável para teleportes bloqueados para fora de uma partida. O teleporte em si é cancelado pelo runtime, mas esta mensagem atualmente não é enviada ao jogador. |
Configuração de Pacote de Conteúdo
Pacotes de conteúdo são arquivos YAML na pasta content_packages/. Cada um define uma configuração de mapa jogável.
| Chave | Tipo | Padrão | Descrição |
|---|---|---|---|
isEnabled | Boolean | true | Se o pacote conta como instalado. Isso determina a cor da sua entrada no /exc setup (true = instalado/verde, false = baixado mas não instalado/amarelo), e o menu de configuração alterna o valor para você. Isso não remove o pacote do /exc createMatch. |
name | String | (obrigatório) | Nome de exibição do pacote (suporta códigos de cor &) |
description | Lista de String | (obrigatório) | Linhas de descrição mostradas no menu de configuração |
downloadLink | String | (opcional) | URL mostrada no chat quando você clica em um pacote não baixado no menu de configuração |
version | Integer | 0 | Número de versão do conteúdo. A verificação de estado de conteúdo do Extractioncraft só distingue entre não baixado / instalado / não instalado, então este valor atualmente não é comparado com nada. |
folderName | String | (obrigatório) | Nome da subpasta de schematics para este pacote |
usesEliteMobs | Boolean | false | Flag declarativa indicando que o pacote usa conteúdo do EliteMobs. Não aplicada em tempo de execução. |
usesBetterStructures | Boolean | false | Flag declarativa indicando que o pacote usa conteúdo do BetterStructures. Não aplicada em tempo de execução. |
usesFreeMinecraftModules | Boolean | false | Flag declarativa indicando que o pacote usa conteúdo do FreeMinecraftModels. Não aplicada em tempo de execução. Note que a chave YAML é escrita usesFreeMinecraftModules (com "Modules") no código-fonte. |
betterStructuresModulesContainerName | String | (opcional) | O nome do arquivo de configuração do gerador de módulos do BetterStructures passado ao gerador de mundo quando /exc createMatch é executado, ex: kobold_mines_module_generator_10.yml. É esta chave que realmente decide qual mapa é gerado. |
spectatable | Boolean | false | Alternância configurável de espectadores. O Extractioncraft não passa este valor para a instância de partida que constrói, então o runtime sempre trata as partidas como não assistíveis e entradas de espectador são rejeitadas independentemente do que você definir aqui. |
pvpEnabled | Boolean | true | Se o PvP está ativado durante as partidas. Quando false, o fogo amigo é bloqueado em todo o mundo da partida. |
minPlayers | Integer | 1 | Mínimo de jogadores necessário para iniciar uma partida. /exc start se recusa a iniciar abaixo disso, e a contagem regressiva é abortada (encerrando a partida) se a contagem cair abaixo desse valor no meio da contagem. |
maxPlayers | Integer | 100 | Máximo de jogadores permitidos em uma partida. Todos os cinco pacotes pré-fabricados Kobold Mines substituem isso por 8. A build atual não registra nenhum comando de entrada, então apenas o criador entra em uma partida e este limite nunca é alcançado. |
chestLootTables | Lista de String | [] | Tabelas de saque usadas para baús, formatadas como filename.yml:weight |
barrelLootTables | Lista de String | [] | Tabelas de saque usadas para barris, formatadas como filename.yml:weight |
Formato de Peso da Tabela de Saque
As entradas de tabela de saque de baú e barril usam o formato <loot_table_filename.yml>:<weight>. Quando um jogador abre um recipiente, uma tabela de saque é selecionada com base em probabilidade ponderada.
Exemplo:
chestLootTables:
- kobold_mines_chest_high_loot_table_10.yml:.2
- kobold_mines_chest_low_loot_table_10.yml:.2
barrelLootTables:
- kobold_mines_barrel_loot_table_10.yml:1
A metade :weight é obrigatória — uma entrada sem dois-pontos e um número falha na leitura e impede o carregamento do pacote de conteúdo. Os pesos são relativos entre si, então o exemplo acima dá a cada uma das duas tabelas de baú uma fatia igual de 50%. Um nome de arquivo que não corresponda a nenhum arquivo em loot_tables/ registra um aviso na inicialização e quebrará o saque de recipientes desse pacote.