Configuración Inicial de Extractioncraft

Requisitos

• Java 21
• Un servidor compatible con Paper/Spigot en la línea de API 1.21.4
• BetterStructures (soft-depend, requerido para contenido premade)
• EliteMobs (soft-depend, requerido para contenido premade)
• FreeMinecraftModels (soft-depend, requerido para contenido premade)

Lo que Extractioncraft Crea

Al iniciar, Extractioncraft inicializa estas rutas:

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/ viene rellenada de antemano con los cinco archivos de configuración premade de Kobold Mines. loot_pools/ y loot_tables/ empiezan vacías: las tablas de botín que referencian los paquetes premade (kobold_mines_chest_high_loot_table_10.yml y compañía) llegan con el pack de contenido descargable, no con el jar del plugin.

La carpeta schematics/ no se crea al iniciar. Aparece una vez que se instala contenido, y contiene los datos del mapa de cada paquete de contenido en una subcarpeta nombrada según el folderName del paquete (por ejemplo, schematics/kobold_mines_10/). Extractioncraft usa la presencia de esa subcarpeta para decidir si un paquete cuenta como descargado en /exc setup.

Flujo Recomendado para Primera Vez

1. Instala Extractioncraft junto con BetterStructures, EliteMobs, FreeMinecraftModels y WorldEdit (o FastAsyncWorldEdit). Inicia el servidor una vez.
2. Ejecuta /exc initialize para abrir el menú de configuración inicial. Comprueba que WorldEdit (o FastAsyncWorldEdit) está instalado y que al menos una configuración de esquemático de BetterStructures está disponible, y luego ofrece un botón "Complete first-time setup". Como los mapas son contenido de BetterStructures, los enlaces de ayuda de este menú apuntan a la página de configuración de BetterStructures y al Discord compartido.
3. Descarga paquetes de contenido desde nightbreak.io.
4. Coloca el contenido descargado en la carpeta plugins/Extractioncraft/imports/. El plugin extraerá los archivos comprimidos compatibles en el siguiente arranque.
5. Ejecuta /exc reload o reinicia el servidor.
6. Ejecuta /exc setup para explorar y gestionar los paquetes de contenido instalados. Cada paquete muestra un estado en color (verde = instalado, amarillo = descargado pero no instalado, rojo = no descargado) y una acción al hacer clic. El menú de configuración también incluye una entrada de Plugins Recomendados y un botón de información (la cabeza de jugador) con enlaces a la wiki, el Discord, la página del token de tu cuenta y los comandos de actualización.

Funciones de Configuración Compartidas de MagmaCore

Como MagmaCore viene incluido en Extractioncraft, el plugin se distribuye con las herramientas de configuración compartidas de Nightbreak:

• Plugins recomendados — /exc recommendedplugins (o la entrada dentro de /exc setup) lista los plugins complementarios que combinan bien con Extractioncraft y muestra cuáles ya están instalados.
• Token de cuenta / contenido con licencia — /nightbreaklogin registra el token de tu cuenta de nightbreak.io para que el servidor pueda descargar contenido con licencia dentro del juego.
• Catálogo de plugins — /nightbreak plugins abre un catálogo navegable de los demás plugins de MagmaGuy.

Contenido Premade

Extractioncraft viene con configuración para los siguientes paquetes de contenido premade (serie Kobold Mines):

Paquete	Nombre de archivo de configuración	Rango de nivel de EliteMobs	Jugadores máximos
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 los paquetes premade usan BetterStructures, FreeMinecraftModels y EliteMobs. El PvP está habilitado por defecto. Los datos del mapa deben descargarse por separado desde los enlaces de contenido mostrados en el menú de configuración.

Iniciar una Partida

Una vez que el contenido está instalado:

1. Ejecuta /exc createMatch <contentPackage.yml> (por ejemplo, /exc createMatch kobold_mines_10.yml). El argumento se autocompleta con tab a partir de los nombres de archivo de paquetes de contenido disponibles, incluidos los paquetes marcados actualmente como no instalados, así que una elección equivocada fallará en la generación del mundo y no en el comando.
2. El plugin genera el mundo instanciado de forma asíncrona a través de BetterStructures usando el betterStructuresModulesContainerName del paquete. La generación no es instantánea; serás teletransportado a un punto de aparición aleatorio del nuevo mundo una vez que esté listo.
3. La build actual no registra ningún comando para unirse, así que la partida contiene únicamente al jugador que la creó: el maxPlayers del paquete (8 en todos los paquetes premade) lo lee el runtime de partidas compartido, pero nada puede alcanzarlo. Una vez que se cumple minPlayers (1 por defecto), cualquier jugador en la partida puede ejecutar /exc start.
4. Para salir de una partida en cualquier momento, ejecuta /exc leave (o /exc quit). Salir de una partida en curso sin extraerte destruye tu inventario por defecto — consulta desarrollo de la partida.