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/
plugins/Extractioncraft/schematics/

A pasta schematics/ contém os dados reais do mapa do BetterStructures para cada pacote de conteúdo instalado, dentro de uma subpasta nomeada conforme o folderName do pacote (ex: schematics/kobold_mines_10/).

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 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".
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.
2. O plugin gera o mundo instanciado de forma assíncrona via BetterStructures. Você é teleportado quando estiver pronto.
3. Outros jogadores podem entrar. Quando a contagem mínima de jogadores é atingida, qualquer jogador na partida pode executar /exc start.
4. Para sair de uma partida a qualquer momento, execute /exc leave (ou /exc quit).