Importaciones manuales vs gestión dentro del juego

Los plugins gestionados por Nightbreak ahora prefieren la configuración y gestión de contenido dentro del juego, pero las importaciones manuales siguen existiendo como alternativa.

Recomendado: Gestión dentro del juego

Usa el menú de configuración junto con un token Nightbreak vinculado cuando quieras:

• exploración de contenido con reconocimiento de acceso
• instalación con un clic o guiada por menú
• comandos de descarga y actualización masiva
• verificaciones automáticas de paquetes desactualizados
• un flujo de trabajo que coincida con la base de código actual

Esta es la ruta preferida para:

• EliteMobs
• BetterStructures
• FreeMinecraftModels
• EternalTD
• ResurrectionChest
• WorldCannon

Los seis ejecutan el importador compartido, así que los seis también aceptan la alternativa manual descrita más abajo.

Alternativa: Importaciones manuales

Las importaciones manuales siguen siendo útiles cuando:

• ya tienes los zips de paquetes descargados
• estás moviendo archivos entre servidores
• quieres trabajar sin conexión a Nightbreak durante las pruebas
• un paquete se distribuye intencionalmente fuera de la ruta de descarga dentro del juego

Las descargas masivas de Nightbreak también terminan en la carpeta imports del plugin. La diferencia es que la ruta dentro del juego maneja las verificaciones de acceso y el paso de descarga por ti.

Mapa de carpetas de importación

Plugin	Carpeta de importación
EliteMobs	plugins/EliteMobs/imports
BetterStructures	plugins/BetterStructures/imports
FreeMinecraftModels	plugins/FreeMinecraftModels/imports
EternalTD	plugins/EternalTD/imports
ResurrectionChest	plugins/ResurrectionChest/imports
WorldCannon	plugins/CannonRTP/imports

La carpeta de plugin de WorldCannon se llama CannonRTP — ese es el nombre interno del plugin, y es donde están tanto su carpeta imports como su contenido instalado.

Reglas de importación manual

• Mantén el paquete descargado comprimido a menos que la documentación específica del plugin diga lo contrario.
• Coloca el paquete en la carpeta imports correcta.
• Recarga o reinicia el plugin si la documentación específica del plugin lo requiere.
• Vuelve a abrir el menú de configuración después para confirmar el estado de instalación.

El importador compartido puede procesar:

• paquetes .zip colocados en imports
• ciertas carpetas ya descomprimidas si incluyen pack.meta
• archivos .bbmodel para FreeMinecraftModels

Los archivos comprimidos se extraen en una carpeta de preparación oculta dentro de imports y solo se instalan desde ahí. FMM limpia esa carpeta de preparación tanto si la operación tiene éxito como si falla, así que una importación fallida normal deja el zip original listo para reintentar en lugar de un paquete a medio extraer visible junto a él.

Qué acepta el importador

pack.meta decide adónde va el contenido

Un paquete puede incluir un archivo pack.meta en el nivel superior que indique la plataforma de plugin a la que va dirigido — elitemobs, betterstructures, freeminecraftmodels, eternaltd, extractioncraft, resurrectionchest, megablocksurvivors o worldcannon (también se acepta como cannonrtp o world_cannon). Ese nombre se compara sin distinguir mayúsculas de minúsculas y se ignoran los espacios circundantes, los finales de línea y una marca de orden de bytes inicial, así que un archivo guardado por un editor de Windows funciona sin problemas.

Si el archivo comprimido no tiene pack.meta, se trata como un paquete para el plugin en cuya carpeta imports se dejó caer.

Si pack.meta indica algo que el importador no conoce, el paquete es rechazado y el zip se deja en imports para que puedas corregirlo e intentarlo de nuevo.

Los nombres de las carpetas de nivel superior deben ser reconocidos

El importador dirige cada carpeta de nivel superior del paquete a un destino según su nombre. Algunos nombres funcionan para todas las plataformas:

Carpeta	Va a
worldcontainer	El contenedor de mundos del servidor (cada subcarpeta se convierte en un mundo)
models o modelengine	La carpeta de modelos de FreeMinecraftModels, o la carpeta de blueprints de ModelEngine si solo está instalado ModelEngine
scripts	plugins/FreeMinecraftModels/scripts
pack.meta	Se ignora — son metadatos, no contenido

Todo lo demás se resuelve por plataforma (por ejemplo custombosses, customitems y content_packages para EliteMobs; schematics, spawn_pools y components para BetterStructures).

Una carpeta de nivel superior que el importador no reconozca para esa plataforma provoca que se rechace el paquete completo en lugar de instalarse parcialmente, y el archivo comprimido se conserva. Si tu paquete no se importa, la consola indica cuál es la carpeta problemática.

Las importaciones fallidas se revierten

Una importación se aplica como una única transacción. Los archivos existentes se respaldan antes de ser reemplazados, las carpetas de mundo reemplazadas se apartan en lugar de borrarse, y cualquier fallo a mitad de proceso revierte todos los destinos que el paquete hubiera tocado. El zip se queda en imports, así que reintentar es seguro. Si la propia reversión encuentra un error del sistema de archivos, la consola informa explícitamente de que la reversión quedó incompleta y te indica que revises los destinos registrados antes de reintentar.

El archivo comprimido solo se elimina cuando la importación se ha confirmado por completo. Si ves un paquete todavía en imports después de una recarga, es el importador diciéndote que no se instaló — revisa la consola para ver el motivo.

Diferencias importantes

Ruta dentro del juego

• con reconocimiento de token
• puede mostrar contenido bloqueado y desactualizado
• generalmente se recarga automáticamente después de operaciones masivas
• refleja el flujo de trabajo administrativo actualmente previsto

Ruta manual

• funciona sin acceso a descargas dentro del juego
• requiere que gestiones los archivos zip tú mismo
• puede requerir una recarga del plugin
• puede dejar contenido en un estado de descargado-pero-no-habilitado dependiendo del plugin
• puede exponer problemas de estructura del paquete que la ruta de acceso dentro del juego normalmente ocultaría hasta el momento de la instalación