Configuración inicial de Extractioncraft

Compatibilidad de la versión de desarrollo

Esta sección describe el código fuente 1.0-SNAPSHOT de Extractioncraft, no una combinación de versiones publicada y verificada. El código actual se compila contra BetterStructures 2.7.6 y EliteMobs 10.9.7 y llama directamente a sus API. Usa un conjunto de compilaciones compatibles y probado antes de abrir el servidor a los jugadores; instalar las últimas versiones de los plugins complementarios no basta para establecer su compatibilidad.

Requisitos

• El plugin genera bytecode para Java 21; usa el entorno Java requerido por la versión de servidor elegida
• Un servidor Paper/Spigot compatible: el descriptor declara 1.21.4, mientras que la compilación actual usa Spigot API 26.3-R0.1-SNAPSHOT. Estos valores no establecen un rango de versiones de servidor probado
• BetterStructures (declarada como dependencia opcional, necesaria para arrancar)
• EliteMobs (declarada como dependencia opcional, necesaria para arrancar)
• FreeMinecraftModels (declarada como dependencia opcional, necesaria para arrancar)
• WorldEdit o FastAsyncWorldEdit, que BetterStructures usa para generar los mapas

Durante el arranque, Extractioncraft espera a que BetterStructures, EliteMobs y FreeMinecraftModels terminen de cargarse y después les da hasta 5 minutos para recargar cualquier contenido que acabe de importar. Si alguno falta, no se carga o sigue recargándose pasado ese tiempo, Extractioncraft registra ExtractionCraft initialization failed y sus comandos no se registran.

Qué crea Extractioncraft

Al arrancar, 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 con los cinco archivos de configuración prediseñados de Kobold Mines. loot_pools/ y loot_tables/ empiezan vacíos. Las tablas de botín a las que hacen referencia los paquetes prediseñados (kobold_mines_equipment_loot_table.yml y kobold_mines_supplies_loot_table.yml) llegan con el paquete de contenido descargable, no con el JAR del plugin.

El paquete de contenido también incluye los datos del mapa, que se guardan en los plugins complementarios: los generadores de módulos, los módulos, los componentes y los grupos de aparición van a BetterStructures, los jefes y los objetos a EliteMobs, y los modelos a FreeMinecraftModels. Un paquete figura como descargado en /exc setup cuando BetterStructures ha cargado el generador de módulos indicado en el betterStructuresModulesContainerName del paquete.

Proceso recomendado para la primera instalación

1. Instala Extractioncraft junto con BetterStructures, EliteMobs, FreeMinecraftModels y WorldEdit (o FastAsyncWorldEdit). Arranca el servidor una vez.
2. Ejecuta /exc initialize para abrir el menú de configuración inicial. Su panel de estado aparece en rojo cuando no está habilitado ni WorldEdit ni FastAsyncWorldEdit, en amarillo cuando ningún paquete está a la vez habilitado y respaldado por un generador de módulos cargado, y en verde en cuanto un paquete está listo. Haz clic en el panel para ver los siguientes pasos. La cabeza de jugador enlaza con la página de Extractioncraft en nightbreak.io y con Discord.
3. Descarga el paquete de contenido de nightbreak.io.
4. Coloca el ZIP descargado en la carpeta plugins/Extractioncraft/imports/.
5. Ejecuta /exc reload o reinicia el servidor. El importador descomprime el ZIP en las carpetas de Extractioncraft, BetterStructures, EliteMobs y FreeMinecraftModels. Después, Extractioncraft recarga BetterStructures, y también EliteMobs si el paquete añadió contenido de EliteMobs, y espera a que los plugins complementarios terminen de cargarse.
6. Ejecuta /exc setup para explorar y gestionar los paquetes de contenido. Cada paquete muestra un estado por colores (verde = instalado, amarillo = descargado pero sin instalar, rojo = sin descargar). Al hacer clic en un paquete verde se deshabilita, en uno amarillo se habilita, y en uno rojo se muestra su enlace de descarga con instrucciones para colocar el archivo en la carpeta de importación y ejecutar /exc reload. El menú también incluye una entrada de plugins recomendados y un botón de información (la cabeza de jugador) con enlaces a la wiki, Discord, la página del token de tu cuenta, /extractioncraft recommendedplugins y /nightbreak plugins.

Los paquetes de contenido no se descargan desde el juego; usa el enlace de descarga y la carpeta de importación.

Funciones compartidas de configuración de MagmaCore

Como MagmaCore está incluido en Extractioncraft, el plugin incorpora las herramientas compartidas de configuración de Nightbreak:

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

Contenido prediseñado

Extractioncraft incluye la configuración de los siguientes paquetes de contenido prediseñado de la serie Kobold Mines:

Paquete	Archivo de configuración	Nivel	Máximo de jugadores
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

El nivel es el contentLevel del paquete, que se usa para el botín de los contenedores. Los jefes de los grupos de aparición del paquete de contenido aparecen con ese mismo nivel. Cada mapa tiene zonas Normal, Hard y Mythic, con la zona más difícil en el centro; consulta botín al matar mobs.

Todos los paquetes prediseñados usan BetterStructures, FreeMinecraftModels y EliteMobs. El PvP está habilitado por defecto. Los datos del mapa deben descargarse por separado mediante el enlace de contenido del menú de configuración.

Iniciar una partida

Una vez instalado el contenido:

1. Ejecuta /exc createMatch <contentPackage.yml> (por ejemplo, /exc createMatch kobold_mines_10.yml). El argumento se autocompleta con todos los paquetes de contenido cargados al arrancar. El comando rechaza un paquete deshabilitado, o cuyo generador de módulos falte, esté deshabilitado, no sea un generador de mundos o no tenga módulos iniciales instalados.
2. El plugin genera el mundo instanciado mediante BetterStructures, usando el betterStructuresModulesContainerName del paquete. La generación no es instantánea y muestra una barra de jefe de progreso; te teletransportas a un punto de aparición aleatorio del nuevo mundo cuando está listo. La generación se cancela si tarda más de 15 minutos, si te desconectas o si ejecutas /exc leave.
3. Extractioncraft no registra ningún comando para unirse, así que la partida solo contiene a su creador. Una vez alcanzado minPlayers (1 por defecto), cualquier jugador de la partida puede ejecutar /exc start.
4. Para salir de una partida en cualquier momento, ejecuta /exc leave (o /exc quit). Salir después de que la partida haya empezado cuenta como una extracción fallida; consulta el desarrollo de la partida.