Saltearse al contenido
DarkBladeDev Docs

Instalación y Primeros Pasos

Esta guía detalla los pasos para instalar CraftingEngine en servidores de Minecraft que utilicen Paper, Purpur o implementaciones compatibles de la versión 1.20+.

1. Requisitos del Entorno

Antes de instalar CraftingEngine, asegúrate de que tu servidor cumpla con lo siguiente:

  • Entorno Java: Java 21 o superior (versión LTS recomendada).
  • Plataforma del Servidor: Paper, Purpur o forks modernos que soporten Minecraft 1.20.4 hasta 1.21.x (probado en 1.21.4).
  • Motor de Paquetes de Red: PacketEvents v2.14.0+ (obligatorio para las previsualizaciones de bloques fantasma y animaciones cliente).
  • Integraciones Opcionales:
    • Plugins de Ítems Personalizados: ItemsAdder, Oraxen, MMOItems, ExecutableItems, MythicMobs.
    • Variables y Placeholders: PlaceholderAPI.
    • Economía: Vault.

2. Pasos de Instalación

  1. Descarga el Archivo: Obtén el archivo CraftingEngine-2.7.0.jar más reciente.
  2. Copia al Servidor: Coloca el archivo JAR dentro de la carpeta plugins/ de tu servidor.
  3. Instala PacketEvents: Si aún no lo tienes, añade PacketEvents a la carpeta plugins/.
  4. Inicia el Servidor: Arranca el servidor para que CraftingEngine genere automáticamente su estructura de carpetas:
plugins/CraftingEngine/
├── config.yml              # Opciones globales, frecuencia del ticker e idioma
├── capabilities/           # Definiciones modulares de capacidades de estación
├── lang/                   # Paquetes de idioma (en_US.yml, es_ES.yml)
├── menus/                  # Plantillas de menús GUI de 9xN ranuras
├── presets/
│   ├── holograms/          # Diseños de TextDisplay flotantes
│   └── placements/         # Presets de colocación espacial 3D para Display Entities
├── processes/              # Recetas y blueprints de crafteo
└── stations/               # Definiciones de estaciones de trabajo y multibloques
  1. Verifica los Mensajes de Inicio: Confirma en la consola del servidor la carga correcta:
[CraftingEngine] Initializing CraftingEngine...
[CraftingEngine] Loaded 10 capability definition(s).
[CraftingEngine] Loaded 3 workstation definition(s).
[CraftingEngine] Loaded 2 GUI menu template(s).
[CraftingEngine] Loaded 5 process definition(s).
[CraftingEngine] CraftingEngine successfully enabled & ticking (interval: 1 tick(s)).

3. Primeros Comandos de Verificación

Dentro del juego o desde la consola, ejecuta los siguientes comandos:

Ventana de terminal
/cfe version
/cfe status

La respuesta confirmará:

  • Versión del plugin y de la API (v2.7.0).
  • Cantidad de capacidades, estaciones, blueprints, menús y presets cargados.
  • Estado del ticker del programador (RUNNING a 20 TPS).

4. Estaciones y Recetas de Demostración

CraftingEngine genera archivos de ejemplo para que puedas probar sus funciones de inmediato:

  1. Estación de Bloque Único (stations/blacksmith_anvil.yml):
    • Yunque estándar que ofrece las capacidades de forging y heating.
    • Al hacer clic derecho, abre el menú de navegación de recetas (menus/process_browser.yml).
  2. Estructura Multibloque 3D (stations/example_runic_forge.yml):
    • Estructura 3D compuesta por un yunque central rodeado de ladrillos de piedra, bloques de magma, lava, barras de hierro y linternas de almas.
    • Soporta rotación en los 4 puntos cardinales y bloques fantasma virtuales con PacketEvents.
  3. Crafteo Manual Interactivo (processes/manual_iron_blade.yml):
    • Coloca 2 lingotes de hierro calientes en un yunque y golpéalo 5 veces con un pico o martillo.
    • Observa la transformación del modelo 3D y la barra de progreso en tiempo real.

5. Recarga en Caliente (Hot-Reload)

Puedes modificar archivos en plugins/CraftingEngine/ y aplicar los cambios sin reiniciar el servidor:

Ventana de terminal
/cfe reload all

También puedes recargar subsistemas individuales:

  • /cfe reload config - Configuración global e idiomas.
  • /cfe reload processes - Blueprints y lógica de recetas.
  • /cfe reload stations - Estaciones y estructuras multibloque.
  • /cfe reload menus - Plantillas de menús de inventario.

Siguientes Pasos