Comandos y permisos de CannonRTP

CannonRTP registra sus comandos en el espacio de nombres cannonrtp.

• Comando principal: /cannonrtp
• Alias: /crtp, /wc

La mayoría de los administradores usarán el alias corto /wc, pero todos los subcomandos exigen el nodo cannonrtp.admin.

Comandos de administración

create, place, remove, target y center guardan la configuración antes de aplicar el cambio. Si falla el guardado, el comando informa del error y no recarga ni aplica ese cambio. Corrige el problema del archivo antes de volver a intentarlo.

Tras un cambio correcto, estos comandos y delete reconstruyen todos los cañones, no solo el que has editado. Se cancelan los lanzamientos activos y esos jugadores vuelven al asiento de su cañón, todos los cañones descartan sus destinos en cola y vuelven a buscar, y se restablecen todos los tiempos de reutilización de los lanzamientos.

Comando	Emisor	Descripción
/cannonrtp	Cualquiera	Muestra la cabecera de ayuda seguida de todos los subcomandos registrados que puede usar el emisor
/wc help	Cualquiera	Equivale a /cannonrtp: muestra la lista de ayuda
/wc create <id>	Jugador	Crea una configuración de cañón nueva y coloca su primera instancia en tu ubicación. Rechaza un ID que ya exista; usa /wc place para añadirle una colocación.
/wc create <id> <display_name>	Jugador	Hace lo anterior con un nombre visible personalizado; los guiones bajos se convierten en espacios
/wc place <id>	Jugador	Añade otra colocación de un cañón existente en tu ubicación
/wc remove <id>	Jugador	Elimina la colocación de <id> más cercana en tu mundo actual y conserva el archivo de configuración
/wc delete <id>	Cualquiera	Elimina el archivo de configuración del cañón por completo
/wc target <id> <world>	Jugador	Cambia el mundo de destino del aterrizaje
/wc center <id>	Jugador	Establece el centro de búsqueda del cañón en tu ubicación
/wc list	Cualquiera	Enumera todas las colocaciones con nombre visible, estado, tamaño de cola y último detalle del estado
/wc status	Cualquiera	Muestra lo mismo que /wc list
/wc probe	Jugador	Comprueba si tu ubicación supera todas las protecciones habilitadas
/wc reload	Cualquiera	Recarga CannonRTP por completo: todos los archivos de configuración, los cañones y los adaptadores de protección, además de lo que haya pendiente en la carpeta imports/
/wc setup	Jugador	Abre el explorador de contenido de Nightbreak con los paquetes de cañones instalados y disponibles para descargar
/wc recommendedplugins	Cualquiera	Abre el catálogo de plugins complementarios recomendados para CannonRTP
/wc downloadpluginupdate	Cualquiera	Descarga de Nightbreak un JAR más reciente de CannonRTP. Se usa tras el siguiente reinicio del servidor, o antes si nightbreak.applyPluginUpdatesWithoutRestart en config.yml vale when-empty o immediately
/wc applypluginupdate	Cualquiera	Aplica sin reiniciar una actualización de CannonRTP ya descargada, recargando el plugin desde el nuevo JAR. Se rechaza cuando no hay ninguna actualización válida y más reciente en espera, cuando un plugin de otro autor depende de CannonRTP (como dependencia obligatoria u opcional) o mientras hay otro cambio de plugin en curso. Si el nuevo JAR no consigue habilitarse, se vuelve a cargar el JAR anterior y la actualización se queda en la carpeta de actualizaciones para el siguiente reinicio. Consulta Aplicar actualizaciones sin reiniciar.
/wc downloadall	Cualquiera	Descarga la actualización de CannonRTP y todos los paquetes de contenido disponibles en Nightbreak
/wc downloadallcontent	Cualquiera	Descarga todos los paquetes de CannonRTP disponibles en Nightbreak; solo contenido, sin el JAR del plugin
/wc updatecontent	Cualquiera	Descarga actualizaciones de los paquetes de CannonRTP desactualizados; alias: /wc updateallcontent
/wc forcereinstallcontent <package|all>	Cualquiera	Vuelve a descargar contenido aunque la copia local ya esté actualizada, para reparar archivos dañados o editados manualmente. Usa all para todos los paquetes ya descargados o autocompleta un slug de paquete de Nightbreak: free-cannon-model o cannonrtp-premium-cannon-model.

/wc initialize abre el menú de configuración inicial para jugadores con cannonrtp.admin. /wc setup abre el explorador de contenido. La inicialización compartida registra ambos comandos; los modos predefinidos no determinan si existe initialize.

Hasta que la configuración se marque como terminada (setupDone en config.yml), los jugadores con cannonrtp.admin reciben un recordatorio en el chat unos 10 segundos después de conectarse, con enlaces en los que se puede hacer clic a /wc initialize y /wc setup. Cada opción del menú de configuración inicial (Recommended Setup, Manual Setup, Use Current Content) establece setupDone en true y detiene el recordatorio.

Todos los subcomandos de administración anteriores exigen cannonrtp.admin.

Estos comandos de Nightbreak están incluidos en CannonRTP

/wc setup, /wc initialize, /wc recommendedplugins, /wc downloadpluginupdate, /wc applypluginupdate, /wc downloadall, /wc downloadallcontent, /wc updatecontent y /wc forcereinstallcontent los proporciona la biblioteca compartida MagmaCore incluida en el JAR de CannonRTP. Se registran automáticamente y no aparecen en plugin.yml. El comando independiente /nightbreaklogin, también de MagmaCore, vincula el servidor a tu cuenta de Nightbreak para las descargas prémium, y /nightbreaklogout lo desvincula (consulta Desconectar un servidor).

MagmaCore también registra /wcchangelog, que muestra a los administradores las notas de versión sin leer de CannonRTP y de los paquetes de cañones. Consulta Notificaciones de notas de versión.

Consulta Paquetes de contenido para saber qué gestionan /wc setup, /wc downloadall y /wc updatecontent.

Diferencias entre create, place, remove y delete

Una configuración, plugins/CannonRTP/cannons/<id>.yml, puede controlar varias colocaciones en el mundo. create crea la configuración y la primera colocación. place añade una colocación a una configuración existente. remove elimina la colocación más cercana en tu mundo, pero conserva la configuración. delete elimina el archivo de configuración y todas sus colocaciones. Los tres archivos integrados (example_cannonrtp, cannonrtp_free_cannon, cannonrtp_premium_cannon) vuelven con sus valores predeterminados y sin colocaciones en la recarga siguiente.

Interacción de jugadores

No hay un comando de jugador para activar un cañón. Se usa entrando en su radio de activación, triggerRadius, de 1.75 bloques por defecto.

Permisos

plugin.yml registra dos nodos de permiso:

Permiso	Predeterminado	Descripción
cannonrtp.admin	op	Necesario para todos los subcomandos de administración, incluidos los de Nightbreak setup / downloadall / updatecontent
cannonrtp.use	true	Necesario para que un jugador pueda activar cualquier cañón

Los comandos compartidos /nightbreaklogin y /nightbreaklogout, proporcionados por MagmaCore y no declarados en el plugin.yml de CannonRTP, usan su propio nodo nightbreak.login, que por defecto es op.

Cómo funciona cannonrtp.use

Si un jugador no tiene cannonrtp.use, el cañón lo ignora silenciosamente. Esta comprobación básica no envía un mensaje de denegación: el jugador atraviesa la zona sin ser lanzado.

Permiso adicional por cañón

Cada configuración puede definir un campo requiredPermission.

• Si está vacío, como por defecto, solo se comprueba cannonrtp.use.
• Si está definido y el jugador tiene cannonrtp.use pero carece del permiso específico, CannonRTP envía noPermission con el nombre visible del cañón. El mensaje se limita a una vez cada tres segundos por jugador y cañón.

Autocompletado

Los comandos que actúan sobre cañones existentes, place, remove, delete, target y center, autocompletan <id> con los ID de configuración conocidos y solo aceptan uno existente. La excepción es /wc create: <id> y <display_name> son texto libre, por lo que solo se muestran esas indicaciones. Los argumentos <world> se autocompletan con los nombres de mundos cargados, y /wc forcereinstallcontent ofrece all y los slugs de los paquetes de Nightbreak.