Instalação do Extractioncraft

Requisitos

• Java 21
• Um servidor compatível com Paper/Spigot na linha de API 1.21.4
• BetterStructures (dependência opcional, necessário para conteúdo pré-fabricado)
• EliteMobs (dependência opcional, necessário para conteúdo pré-fabricado)
• FreeMinecraftModels (dependência opcional, necessário para conteúdo pré-fabricado)

O Que o Extractioncraft Cria

Na inicialização, 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/

A pasta content_packages/ já vem preenchida com os cinco arquivos de configuração pré-fabricados do Kobold Mines. As pastas loot_pools/ e loot_tables/ começam vazias — as tabelas de saque que os pacotes pré-fabricados referenciam (kobold_mines_chest_high_loot_table_10.yml e companhia) chegam com o pacote de conteúdo para download, não com o jar do plugin.

A pasta schematics/ não é criada na inicialização. Ela aparece assim que o conteúdo é instalado, e guarda os dados do mapa de cada pacote de conteúdo dentro de uma subpasta nomeada conforme o folderName do pacote (ex: schematics/kobold_mines_10/). O Extractioncraft usa a presença dessa subpasta para decidir se um pacote conta como baixado no /exc setup.

Fluxo Recomendado Para a Primeira Vez

1. Instale o Extractioncraft junto com o BetterStructures, EliteMobs, FreeMinecraftModels e WorldEdit (ou FastAsyncWorldEdit). Inicie o servidor uma vez.
2. Execute /exc initialize para abrir o menu de configuração inicial. Ele verifica se o WorldEdit (ou FastAsyncWorldEdit) está instalado e se pelo menos uma configuração de schematic do BetterStructures está disponível, e então oferece um botão "Concluir configuração inicial". Como os mapas são conteúdo do BetterStructures, os links de ajuda desse menu apontam para a página de instalação do BetterStructures e para o Discord compartilhado.
3. Baixe pacotes de conteúdo em nightbreak.io.
4. Coloque o conteúdo baixado na pasta plugins/Extractioncraft/imports/. O plugin extrairá os arquivos compactados suportados na próxima inicialização.
5. Execute /exc reload ou reinicie o servidor.
6. Execute /exc setup para navegar e gerenciar os pacotes de conteúdo instalados. Cada pacote mostra um status colorido (verde = instalado, amarelo = baixado mas não instalado, vermelho = não baixado) e uma ação de clique. O menu de configuração também inclui uma entrada Plugins Recomendados e um botão de informação (a cabeça de jogador) com links para a wiki, o Discord, a página do token da sua conta e os comandos de atualização.

Recursos de Configuração Compartilhados do MagmaCore

Como o MagmaCore vem incluído no Extractioncraft, o plugin vem com as ferramentas de configuração compartilhadas do Nightbreak:

• Plugins recomendados — /exc recommendedplugins (ou a entrada dentro de /exc setup) lista os plugins complementares que combinam bem com o Extractioncraft e mostra quais já estão instalados.
• Token de conta / conteúdo licenciado — /nightbreaklogin registra o token da sua conta nightbreak.io para que o servidor possa baixar conteúdo licenciado no jogo.
• Catálogo de plugins — /nightbreak plugins abre um catálogo navegável dos outros plugins do MagmaGuy.

Conteúdo Pré-fabricado

O Extractioncraft vem com configuração para os seguintes pacotes de conteúdo pré-fabricados (série Kobold Mines):

Pacote	Nome do arquivo de config	Faixa de nível EliteMobs	Máx jogadores
Kobold Mines 10	kobold_mines_10.yml	0-10	8
Kobold Mines 20	kobold_mines_20.yml	11-20	8
Kobold Mines 30	kobold_mines_30.yml	21-30	8
Kobold Mines 40	kobold_mines_40.yml	31-40	8
Kobold Mines 50	kobold_mines_50.yml	41-50	8

Todos os pacotes pré-fabricados usam BetterStructures, FreeMinecraftModels e EliteMobs. O PvP está ativado por padrão. Os dados do mapa devem ser baixados separadamente dos links de conteúdo mostrados no menu de configuração.

Iniciando uma Partida

Uma vez que o conteúdo estiver instalado:

1. Execute /exc createMatch <contentPackage.yml> (ex: /exc createMatch kobold_mines_10.yml). O argumento auto-completa os nomes de arquivos de pacotes de conteúdo disponíveis — incluindo pacotes atualmente marcados como não instalados, então uma escolha errada falhará na geração do mundo em vez de falhar no comando.
2. O plugin gera o mundo instanciado de forma assíncrona via BetterStructures, usando o betterStructuresModulesContainerName do pacote. A geração não é instantânea; você é teleportado para um ponto de spawn aleatório no novo mundo assim que ele estiver pronto.
3. A build atual não registra nenhum comando de entrada, então a partida contém apenas o jogador que a criou — o maxPlayers do pacote (8 em todos os pacotes pré-fabricados) é lido pelo runtime de partidas compartilhado, mas nada consegue alcançá-lo. Assim que minPlayers é atingido (1 por padrão), qualquer jogador na partida pode executar /exc start.
4. Para sair de uma partida a qualquer momento, execute /exc leave (ou /exc quit). Sair de uma partida ao vivo sem extrair destrói seu inventário por padrão — veja o fluxo da partida.