Instalación

Esta página cubre lo que Verité necesita para funcionar, los plugins opcionales con los que puede trabajar y lo que ocurre la primera vez que arranca. Para los pasos de descarga y una breve descripción general, consulta la página de inicio. El material aquí profundiza en los requisitos, las dependencias y el comportamiento del primer arranque.

Requisitos

Verité está pensado para los servidores de Minecraft modernos y sus forks habituales.

Verité no incluye una compilación separada por plataforma más allá de la versión apropiada para tu servidor. Instala el archivo correcto para tu versión de Minecraft y tu software de servidor, colócalo en el directorio plugins/ y reinicia.

En cualquier versión de Minecraft fuera del rango compatible, Verité se desactiva al iniciar y registra la versión en ejecución junto con el rango compatible. Verité 1.2.8 es la última versión para Minecraft 1.19 a 1.21.5.

Biblioteca en tiempo de ejecución

Verité almacena sus datos en una base de datos H2 embebida. H2 se declara como una biblioteca de plugin en plugin.yml:

libraries:
  - com.h2database:h2:2.4.240

Tu servidor resuelve y descarga esta biblioteca automáticamente al cargar, sobre un cargador de clases de biblioteca aislado. No se requiere ninguna descarga manual. Si la biblioteca no se puede resolver, Verité se desactiva a sí mismo en lugar de funcionar sin almacenamiento, así que vigila la consola en el primer arranque.

La base de datos se ejecuta en modo de archivo embebido sin socket de red. Se describe con más detalle en la página de Privacidad y datos.

Dependencias opcionales

Verité declara cuatro dependencias opcionales:

softdepend: [floodgate, PlaceholderAPI, LuckPerms, Skript]

Una dependencia opcional nunca es obligatoria. Cuando uno de estos plugins está presente, el servidor lo carga antes que a Verité para que la característica correspondiente pueda activarse. Cuando está ausente, Verité funciona con normalidad y la característica simplemente no existe.

Primer arranque

La primera vez que Verité se carga, prepara su propia carpeta de datos en plugins/Verite/. Durante este primer arranque:

• Crea la carpeta de datos del plugin.
• Abre la base de datos H2 embebida (verite.mv.db) en esa carpeta, creándola si no existe.
• Escribe el config.yml por defecto.
• Despliega los recursos del filtro de chat en una subcarpeta filter/.
• Registra comandos, listeners e integraciones para cualquier dependencia opcional que esté instalada.

Vigila la consola durante este primer arranque. Confirma que Verité se carga y que no aparecen advertencias ni errores que apunten a un problema de configuración o compatibilidad.

Salida de consola

Verité colorea sus mensajes de consola para que los fallos destaquen frente a las líneas de arranque habituales. Los errores se muestran en rojo, los aciertos en verde y los recuentos en el color de marca de Verité. Todos los mensajes llevan el prefijo [Verité].

El color sólo se añade cuando la consola puede mostrarlo. Verité comprueba, en este orden:

Cuando el color está desactivado, los mensajes se escriben como texto plano, sin dejar códigos de escape, de modo que los archivos de registro siguen siendo legibles.

Dos propiedades del sistema anulan la detección si necesita forzar un resultado:

-Dverite.console.colour=false
-Dverite.console.truecolour=false

La primera desactiva (o activa) el color por completo. La segunda mantiene el color pero baja de 24 bits a la paleta básica de 16 colores, lo que conviene probar si su consola muestra caracteres extraños en lugar de color.

Módulos

Verité está construido a partir de tres módulos, cada uno alternado de forma independiente en config.yml. Los tres están activados por defecto. Desactiva un módulo estableciendo su flag enabled en false; el resto del plugin sigue funcionando.

chat.filter:
  enabled: true

moderation:
  enabled: true

vanish:
  enabled: true

Actualización automática de la configuración

Cuando Verité se actualiza, puede añadir nuevas claves a tu config.yml existente para que no pierdas tus ajustes. Esto se controla en la sección general:

general:
  auto.update.config: true

Con esto activado, las nuevas claves de configuración añadidas en una versión posterior se fusionan en tu archivo automáticamente. Esto no omite las actualizaciones del tokenizador, que se gestionan por separado.

Los archivos de recursos del filtro de chat (los archivos .eve) tienen su propio interruptor, que está desactivado por defecto:

chat.filter:
  auto.update.eve: false