Configuração inicial do Extractioncraft

Compatibilidade desta versão de desenvolvimento

Esta secção descreve o código-fonte 1.0-SNAPSHOT do Extractioncraft, e não uma combinação de versões publicada e verificada. O código-fonte atual é compilado com o BetterStructures 2.7.6 e o EliteMobs 10.9.7 e chama diretamente as respetivas API. Use um conjunto de versões compatíveis e testadas antes de abrir o servidor aos jogadores; instalar apenas as versões mais recentes dos plugins complementares não comprova a compatibilidade.

Requisitos

• O plugin gera bytecode para Java 21; use o ambiente Java exigido pela versão de servidor escolhida
• Um servidor Paper/Spigot compatível: o descritor declara 1.21.4, enquanto a compilação atual usa Spigot API 26.3-R0.1-SNAPSHOT. Estes valores não estabelecem um intervalo de versões de servidor testado
• BetterStructures, declarado como dependência opcional, mas necessário para o arranque
• EliteMobs, declarado como dependência opcional, mas necessário para o arranque
• FreeMinecraftModels, declarado como dependência opcional, mas necessário para o arranque
• WorldEdit ou FastAsyncWorldEdit, que o BetterStructures usa para gerar os mapas

Durante o arranque, o Extractioncraft espera que o BetterStructures, o EliteMobs e o FreeMinecraftModels terminem o carregamento e depois dá-lhes até 5 minutos para recarregarem o conteúdo que acabou de importar. Se algum deles estiver em falta, não conseguir carregar ou ainda estiver a recarregar após esse tempo, o Extractioncraft regista ExtractionCraft initialization failed e os seus comandos não são registados.

O que o Extractioncraft cria

No arranque, o Extractioncraft inicializa estes caminhos:

plugins/Extractioncraft/config.yml
plugins/Extractioncraft/messaging.yml
plugins/Extractioncraft/content_packages/
plugins/Extractioncraft/loot_pools/
plugins/Extractioncraft/loot_tables/
plugins/Extractioncraft/imports/

content_packages/ já contém os cinco ficheiros de configuração pré-fabricados Kobold Mines. loot_pools/ e loot_tables/ começam vazias. As tabelas referenciadas pelos pacotes pré-fabricados (kobold_mines_equipment_loot_table.yml e kobold_mines_supplies_loot_table.yml) são fornecidas no pacote de conteúdo transferível, e não no jar do plugin.

O pacote de conteúdo também traz os dados dos mapas, que ficam nos plugins complementares: os geradores de módulos, os módulos, os componentes e os conjuntos de aparecimento vão para o BetterStructures, os bosses e os itens vão para o EliteMobs e os modelos vão para o FreeMinecraftModels. Um pacote conta como transferido em /exc setup quando o BetterStructures tiver carregado o gerador de módulos indicado em betterStructuresModulesContainerName do pacote.

Procedimento inicial recomendado

1. Instale Extractioncraft, BetterStructures, EliteMobs, FreeMinecraftModels e WorldEdit ou FastAsyncWorldEdit. Inicie o servidor uma vez.
2. Execute /exc initialize para abrir o menu inicial. O painel de estado fica vermelho quando nem o WorldEdit nem o FastAsyncWorldEdit estão ativados, amarelo quando nenhum pacote está simultaneamente ativado e suportado por um gerador de módulos carregado, e verde quando um pacote está pronto. Clique no painel para ver os passos seguintes. A cabeça de jogador tem ligações para a página do Extractioncraft em nightbreak.io e para o Discord.
3. Transfira o pacote de conteúdo em nightbreak.io.
4. Coloque o ZIP transferido na pasta plugins/Extractioncraft/imports/.
5. Execute /exc reload ou reinicie o servidor. O importador extrai o ZIP para as pastas do Extractioncraft, do BetterStructures, do EliteMobs e do FreeMinecraftModels. Depois, o Extractioncraft recarrega o BetterStructures, e também o EliteMobs quando o pacote acrescentou conteúdo EliteMobs, e espera que os plugins complementares terminem o carregamento.
6. Execute /exc setup para consultar e gerir os pacotes de conteúdo. Cada pacote apresenta uma cor de estado: verde para instalado, amarelo para transferido mas não instalado e vermelho para não transferido. Clicar num pacote verde desativa-o, clicar num amarelo ativa-o e clicar num vermelho apresenta a sua ligação de transferência, com instruções para colocar o ficheiro na pasta de importação e executar /exc reload. O menu inclui Plugins recomendados e um botão informativo, representado por uma cabeça de jogador, com ligações para a wiki, o Discord, a página do token da conta, /extractioncraft recommendedplugins e /nightbreak plugins.

Os pacotes de conteúdo não são transferidos dentro do jogo; use a ligação de transferência e a pasta de importação.

Ferramentas de configuração partilhadas do MagmaCore

O MagmaCore incluído no Extractioncraft disponibiliza as ferramentas Nightbreak partilhadas:

• Plugins recomendados: /exc recommendedplugins, ou a entrada de /exc setup, lista os plugins complementares adequados e indica quais já estão instalados.
• Token da conta e conteúdo licenciado: /nightbreaklogin regista o token da conta nightbreak.io para transferir conteúdo licenciado dentro do jogo.
• Catálogo de plugins: /nightbreak plugins abre o catálogo dos outros plugins do MagmaGuy.

Conteúdo pré-fabricado

O Extractioncraft inclui configurações para estes pacotes da série Kobold Mines:

Pacote	Ficheiro de configuração	Nível	Máximo de jogadores
Kobold Mines 10	kobold_mines_10.yml	10	8
Kobold Mines 20	kobold_mines_20.yml	20	8
Kobold Mines 30	kobold_mines_30.yml	30	8
Kobold Mines 40	kobold_mines_40.yml	40	8
Kobold Mines 50	kobold_mines_50.yml	50	8

O nível é o contentLevel do pacote, usado no saque dos contentores. Os bosses dos conjuntos de aparecimento do pacote de conteúdo surgem com o mesmo nível. Cada mapa tem zonas Normal, Hard e Mythic, com a zona mais difícil no centro; consulte Saque de mobs mortos.

Todos usam BetterStructures, FreeMinecraftModels e EliteMobs. O PvP está ativado por predefinição. Os dados dos mapas devem ser transferidos separadamente pela ligação de conteúdo apresentada no menu.

Iniciar uma partida

Depois de instalar o conteúdo:

1. Execute /exc createMatch <contentPackage.yml>, por exemplo /exc createMatch kobold_mines_10.yml. A conclusão do argumento sugere todos os pacotes de conteúdo carregados no arranque. O comando recusa um pacote desativado, ou cujo gerador de módulos esteja em falta, desativado, não seja um gerador de mundos ou não tenha módulos iniciais instalados.
2. O plugin gera o mundo de instância através do BetterStructures, usando betterStructuresModulesContainerName do pacote. A geração demora algum tempo e apresenta uma barra de boss com o progresso; quando termina, é teleportado para um ponto de aparecimento aleatório no novo mundo. A geração é cancelada se demorar mais de 15 minutos, se se desligar ou se executar /exc leave.
3. O Extractioncraft não regista um comando de entrada, pelo que a partida contém apenas o jogador que a criou. Ao alcançar minPlayers, predefinido como 1, qualquer jogador da partida pode executar /exc start.
4. Para sair a qualquer momento, execute /exc leave ou /exc quit. Sair depois de a partida ter começado conta como uma extração falhada; consulte o decurso das partidas.