Compatibilidad de BetterFood

Objetivos de Ejecución

El repositorio actual apunta a:

• Versión del plugin: 1.5.0
• Bukkit api-version: 1.21.4
• Objetivo de compilación de Spigot API: 26.2-R0.1-SNAPSHOT
• Java: 21

Comandos

El plugin usa:

• /betterfood
• /bf

Los subcomandos orientados al jugador se centran en alternar:

• alimentación automática (toggleEating, o simplemente /betterfood sin argumentos)
• mensajes de retroalimentación de consumo en la barra de acción (toggleMessage)

Los subcomandos de administración (requieren betterfood.admin) exponen las herramientas compartidas de Nightbreak:

• setup — abre el menú de configuración dentro del juego
• recommendedplugins — muestra plugins que combinan bien con BetterFood. BetterFood no tiene actualmente ninguna entrada en el catálogo compartido de recomendaciones, así que esto abre un menú vacío y te avisa de que ahora mismo no hay recomendaciones adicionales (los remitentes de consola reciben la misma nota en forma de chat)
• downloadpluginupdate / downloadall — descarga una actualización del plugin si hay alguna disponible
• downloadallcontent — informa que BetterFood no tiene paquetes de contenido

El autocompletado de tabulación se filtra por permiso y por lo que se haya escrito hasta el momento: toggleEating y toggleMessage solo se sugieren a remitentes con betterfood.user, y downloadpluginupdate, downloadallcontent, setup y recommendedplugins solo a remitentes con betterfood.admin. El alias aceptado downloadall no se sugiere de forma intencionada. Los dos toggles del jugador son solo para jugadores — los subcomandos explícitos toggleEating / toggleMessage rechazan a los remitentes que no son jugadores con "BetterFood settings can only be changed in-game.", mientras que el comando /betterfood a secas dirige a los remitentes de consola al comando de actualización. A un jugador sin betterfood.user se le indica que no tiene permiso para cambiar los ajustes de BetterFood. Un subcomando no reconocido, o más de un argumento, imprime la línea de uso, y esa línea de uso también tiene en cuenta los permisos: los administradores ven la lista completa, y todos los demás solo ven los dos toggles.

Comandos Compartidos de MagmaCore

Como las herramientas compartidas de MagmaCore vienen incluidas, BetterFood también registra estos comandos al cargarse — pero solo si nada más los ha reclamado ya, así que en un servidor que ya ejecuta otro plugin de MagmaGuy el primer plugin en cargarse es el dueño de esos comandos y BetterFood registra en el log que se salta el registro:

• /nightbreak plugins — navega por el catálogo de plugins, como menú dentro del juego y como lista de chat desde la consola (nightbreak.plugins, por defecto op). El comando /nightbreak a secas solo imprime la línea de uso.
• /nightbreaklogin <token> y /nightbreaklogout — conecta y desconecta el token de cuenta compartida de Nightbreak (nightbreak.login, por defecto op)
• /logify — sube el log actual del servidor a mclo.gs (logify.*, por defecto op)
• /betterfoodchangelog [dismiss|disable] — muestra las notas de versión de BetterFood no leídas. Este está separado por espacio de nombres para cada plugin, así que no colisiona; si /betterfoodchangelog estuviera ocupado de algún modo, recurre a una etiqueta del estilo betterfood:betterfoodchangelog.

El comando de changelog es solo para administradores y solo dentro del juego: responde a los remitentes sin permiso de administrador (o a la consola) con "This command is only available to plugin administrators in-game." Cuenta a un jugador como administrador si es op o tiene betterfood.admin o betterfood.*. A los administradores también se les avisa de las notas de versión no leídas poco después de conectarse, salvo que hayan ejecutado /betterfoodchangelog disable. El estado de leído/descartado se guarda por jugador en plugins/BetterFood/nightbreak-changelogs.yml.

Consulta Tokens de Nightbreak, Configuración de Nightbreak y Notificaciones de Changelog para conocer el flujo compartido.

Permisos

• betterfood.user (por defecto true) — controla el listener de auto-comida y los toggles del jugador.
• betterfood.admin (por defecto op) — controla la descarga de actualizaciones del plugin, el menú de configuración y los comandos de plugins recomendados. También cuenta como permiso de administrador para el comando de changelog.
• nightbreak.plugins, nightbreak.login y logify.* (todos por defecto op) — los registran las herramientas incluidas de MagmaCore para los comandos compartidos de arriba, y no están declarados en el plugin.yml de BetterFood.

Otras Integraciones

• Las métricas de bStats están habilitadas (id de plugin 4557) — desactívalas globalmente mediante la configuración de bStats si deseas no participar.
• BetterFood ahora incluye las herramientas compartidas de MagmaCore. Genera un config.yml con el toggle nightbreak.autoDownloadPluginUpdates (por defecto false) — esa es la única clave que BetterFood pone por sí mismo en config.yml — y comprueba nightbreak.io en busca de una versión más reciente unos minutos después del arranque (el retraso se escalona por plugin para que varios plugins de MagmaGuy no llamen todos a la vez), y después aproximadamente una vez por hora. Los resultados solo se registran cuando cambian, así que la consola no se vuelve a llenar de mensajes cada hora. BetterFood no pasa ningún ID de recurso de SpigotMC y su entrada de catálogo tampoco tiene ninguno, por lo que no hay respaldo de versión de SpigotMC.
• Los operadores que se conecten mientras hay una actualización pendiente reciben un aviso en el chat con el enlace a la página de descarga, unos segundos después de iniciar sesión. Se envía en cada conexión mientras la versión instalada siga estando desactualizada.
• El token de cuenta vive fuera de la carpeta del plugin, en el archivo compartido plugins/MagmaCore/nightbreak.yml, así que vincularlo una vez cubre todos los plugins de MagmaGuy del servidor.
• Sin dependencias de plugins externos; la lógica de comida solo escucha el FoodLevelChangeEvent vanilla.