Paquetes de contenido de CannonRTP

CannonRTP gestiona los modelos oficiales de cañones como paquetes de contenido de Nightbreak. Las descargas actuales de Free Cannon y Premium Cannon contienen el modelo de FreeMinecraftModels y un marcador de versión del paquete en content_packages/. El propio CannonRTP genera las configuraciones de cañón correspondientes en cannons/; las descargas no incluyen configuraciones de ubicaciones.

Comandos principales

Comando	Propósito
/wc setup	Abre el explorador de contenido de Nightbreak con los paquetes de cañones instalados y disponibles para descargar
/wc downloadall	Descarga la actualización de CannonRTP y todos los paquetes de contenido disponibles en Nightbreak
/wc updatecontent	Actualiza en bloque los paquetes de CannonRTP desactualizados; alias: /wc updateallcontent
/wc reload	Recarga CannonRTP tras una importación manual
/nightbreaklogin <token>	Registro compartido del token de Nightbreak, necesario para los paquetes prémium

Los comandos de gestión de /wc exigen cannonrtp.admin. El comando independiente de cuenta /nightbreaklogin <token> exige nightbreak.login.

Además de los paquetes de cañones, el menú /wc setup muestra una entrada de actualización del plugin (haz clic en ella para descargar una actualización disponible), una entrada de plugins recomendados, una entrada para descargarlo todo que ejecuta /wc downloadall y un interruptor de actualizaciones automáticas que escribe nightbreak.autoDownloadPluginUpdates en config.yml (consulta Configuración).

Paquetes incluidos

CannonRTP incluye por defecto las definiciones de dos paquetes de Nightbreak:

ID del paquete	Nombre visible	Origen
cannonrtp	CannonRTP gratuito	Descarga gratuita de Nightbreak
cannonrtp_premium	CannonRTP prémium	Requiere acceso de colaborador prémium de Nightbreak

Cada definición está en plugins/CannonRTP/content_packages/<id>.yml y guarda:

• isEnabled: si el paquete está activado; el menú /wc setup lo escribe al habilitar o deshabilitar el paquete.
• version: versión instalada localmente, que /wc updatecontent usa para detectar qué está desactualizado.
• name y description: textos mostrados en /wc setup.
• downloadLink: página de Nightbreak a la que CannonRTP te remite cuando un paquete no tiene nightbreakSlug y hay que descargarlo a mano, y enlace del aviso de la consola sobre un paquete desactualizado.
• folderName y contentFilePrefixes: archivos que CannonRTP considera parte del paquete.
• nightbreakSlug: slug del proyecto de Nightbreak usado por el servicio de descarga y actualización.

Normalmente no debes editar estos archivos a mano: el plugin los regenera y reescribe.

Estados de los paquetes

En /wc setup, cada paquete muestra uno de estos estados:

• Instalado: cumple las comprobaciones de descarga indicadas abajo, sus metadatos tienen isEnabled: true y existen entradas de cañones correspondientes en plugins/CannonRTP/cannons/.
• Descargado pero deshabilitado: se reconoce la descarga del modelo, pero el paquete no está activo; deshabilitarlo desde el menú mueve sus archivos a plugins/CannonRTP/cannons_disabled/.
• Desactualizado: el paquete está instalado y hay una versión más reciente en Nightbreak; si tu cuenta vinculada ya no tiene acceso, el menú lo indica en lugar de ofrecer la actualización.
• Requiere acceso: el paquete no está descargado, has iniciado sesión y tu cuenta de Nightbreak no tiene acceso a él.
• Sin descargar: falta un marcador de versión local positivo o no se encuentran los archivos del modelo.

Los YAML de cañones generados no demuestran por sí solos que se haya descargado el paquete. CannonRTP exige una version local mayor que cero y al menos un archivo .bbmodel dentro de la carpeta folderName del paquete, bajo plugins/FreeMinecraftModels/models/ o plugins/FreeMinecraftModels/Models/. Si falta la carpeta del modelo, el paquete vuelve a estar disponible para descargar aunque siga existiendo su configuración de cañón generada.

Al pulsar un paquete, el menú lo descarga, instala, habilita o deshabilita. Deshabilitarlo mueve sus configuraciones de cannons/ a cannons_disabled/ sin borrarlas, por lo que volver a habilitarlo restaura los mismos archivos. CannonRTP vuelve a crear sus archivos integrados cannonrtp_free_cannon.yml y cannonrtp_premium_cannon.yml siempre que falten en cannons/, así que tras deshabilitar el paquete la recarga deja allí copias predeterminadas sin colocaciones; al volver a habilitarlo, los archivos guardados se mueven de nuevo sobre ellas.

Carpetas de cañones

Carpeta	Propósito
plugins/CannonRTP/cannons/	Configuraciones activas. Se cargan al arrancar o ejecutar /wc reload.
plugins/CannonRTP/cannons_disabled/	Configuraciones de paquetes actualmente deshabilitadas. El cargador las ignora, pero se conservan para habilitarlas más adelante.
plugins/CannonRTP/imports/	Carpeta de entrada para importaciones manuales. CannonRTP la examina al arrancar y combina su contenido con las carpetas de paquetes.

Alternativa de importación manual

También puedes instalar un paquete manualmente:

1. Descarga el ZIP del paquete desde Nightbreak.
2. Colócalo intacto en plugins/CannonRTP/imports/.
3. Ejecuta /wc reload.

CannonRTP detectará el paquete, moverá los archivos a las carpetas correspondientes y recargará las configuraciones de cañones. La importación manual sigue admitida, pero el proceso recomendado usa /wc setup y /wc downloadall para gestionarlo automáticamente.

Acceso prémium

Los paquetes prémium, como cannonrtp_premium, requieren una cuenta de Nightbreak vinculada. Usa /nightbreaklogin <token> una vez con un token de la página de tu cuenta; después, /wc downloadall y el menú /wc setup podrán obtener el contenido prémium.

Sin iniciar sesión, los paquetes prémium siguen apareciendo en el menú, pero no se pueden descargar.