Chatbot de Minecraft por servidor
← Volver al índice de documentación
El panel ofrece un chatbot configurado por el administrador para cada servidor de Minecraft gestionado, configurado en la pestaña Ajustes → Chatbot del servidor. Se conecta a un punto final de finalización de chat compatible con OpenAI, incluido Ollama en otro host de la LAN. Cada servidor tiene su propio punto final, modelo, nombre de invocación, persona, política de transcripción, mensajes de alcance y política de poder. La invocación predeterminada es @wizard, y la persona predeterminada demuestra un mago antiguo y juguetón dentro del juego; ambos son editables.

Experiencia del jugador
Sección titulada «Experiencia del jugador»- Cualquier jugador puede usar
@wizard <mensaje>(o la invocación configurada) para conversar y obtener ayuda con recetas vanilla deterministas y conscientes de la versión de Minecraft. - Los saludos de bienvenida y una notificación configurable de registro de sesión de juego de una sola vez recuerdan a los jugadores que el chatbot está disponible.
@wizard chatabre una ventana de conversación corta de opción;@wizard byela cierra. - Los usuarios básicos pueden invocar poderes de auto/mundo habilitados. Los controladores de poder pueden invocar acciones validadas por separado que afectan a otro jugador en línea. Los jugadores que no pertenecen a ninguno de estos grupos permanecen solo en modo de conversación.
- Los autogalos de usuario básico utilizan una lista de elementos permitidos. Los controladores pueden dar a otro jugador cualquier elemento válido con nombre de espacio de nombres, vanilla o modificado, sujeto al límite de cantidad y otras salvaguardas de poder.

Diseño y seguridad
Sección titulada «Diseño y seguridad»La configuración y las transcripciones son solo para administradores. El modelo nunca recibe RCON sin procesar ni ejecución de comandos arbitraria. Un mensaje expone solo la única herramienta fija que coincide con su intención explícita; el código del servidor valida la autorización, los argumentos, las banderas, las cantidades, los tiempos de espera y los nombres exactos de los jugadores en línea antes de ejecutar una operación de servicio existente. Se rechazan los selectores de Minecraft, las acciones entre jugadores no pueden dirigirse al llamador, los poderes comienzan en modo de simulación y cada poder intentado se audita. Los modelos de llamada de herramientas no compatibles vuelven a la conversación solamente.
Las respuestas están limitadas para el chat de Minecraft. Las recetas vanilla conocidas provienen de datos de recetas versionados incluidos y se renderizan como filas estables de 2x2/3x3; no se confía en que el LLM invente diseños de recetas. Las recetas desconocidas o modificadas dirigen al jugador a JEI/REI en lugar de fabricar una respuesta.
Archivos de implementación principales
Sección titulada «Archivos de implementación principales»src/services/wizard.js: configuración por servidor, solicitudes compatibles con OpenAI, manejo de chat, alcance, retención de transcripciones y límites de respuesta.src/services/wizardPowers.js: comprobaciones de roles, esquemas de herramientas específicos de intención, validación, ejecución, tiempos de espera y auditoría de poderes.src/services/wizardRecipes.js: búsqueda determinista de recetas versionadas y formato de cuadrícula. Los datos de recetas y elementos provienen del paquete incluidominecraft-data. (Un borrador anterior de este documento apuntaba a una carpetasrc/data/recipes/que nunca se confirmó; no existe tal carpeta y los datos residen en el paquete. Consulte “Huella de dependencia”.)src/analytics/ingest.js: reenvía las uniones, salidas y chats de jugadores analizados al chatbot.src/web/routes/wizard.js,public/js/pages/integrations.jsyviews/partials/server/integrations.hbs(a través dechatbot.hbs): API de administrador y la pestaña Ajustes → Chatbot por servidor.src/db/migrations/011_wizard_chat.js,013_wizard_invocation_name.js,015_wizard_powers.js,017_wizard_outreach.jsy019_wizard_power_controllers.js: esquema persistente.test/wizard.test.js: pruebas de autorización, límites de herramientas, retención, alcance y comportamiento del chat.
Los nombres internos de ruta/módulo/tabla wizard se conservan para compatibilidad de actualización y API; “chatbot” es el término del producto visible para el usuario. Del mismo modo, el campo almacenado power_testers_json se mapea al grupo Usuarios básicos de la interfaz de usuario.
Huella de dependencia (minecraft-data)
Sección titulada «Huella de dependencia (minecraft-data)»La ayuda de recetas utiliza el paquete minecraft-data. Es grande en disco (aproximadamente 429 MB instalado) y se incluye dentro de la imagen de producción porque es una dependencia en tiempo de ejecución, no de desarrollo. Lo mantenemos a propósito para que la ayuda de recetas funcione sin conexión para cada versión de Minecraft sin llamadas de red.
Notas para quien revise esto a continuación (humano o IA), para que el tamaño no sea una sorpresa:
- Solo se utilizan los datos de Java (
pc) en este momento.wizardRecipes.jsleeminecraftData.versions.pcy las tablasrecipes,itemsyblockspor versión. Los archivos que realmente toca suman aproximadamente 15 MB en todas las versiones de pc. - Alrededor de 330 MB del paquete son
data/bedrock, y nada aquí lo lee todavía. Lo dejamos en su lugar a propósito. Si el panel alguna vez agrega soporte para Bedrock Minecraft, los datos de recetas y elementos de Bedrock ya están aquí, por lo que la función de recetas puede crecer para cubrir servidores Bedrock sin agregar una nueva dependencia. Comience desdeminecraftData.versions.bedrocky siga la misma forma que la ruta de pc. - Si el tamaño tiene que reducirse antes de que llegue el soporte de Bedrock, ya existe un patrón para ello en este repositorio.
src/services/itemRegistry.jsrecupera archivos deminecraft-datade la CDN de jsDelivr cuando los necesita y los almacena en caché enapi_cache. Cualquiera de esos enfoques, o un pequeño subconjunto seleccionado a mano desrc/data/recipes/que cubra algunas versiones comunes, reduciría mucho la imagen.
Almacenamiento local e inspección manual
Sección titulada «Almacenamiento local e inspección manual»Toda la configuración y las transcripciones conservadas residen en la base de datos SQLite del panel en /data/panel.db dentro del contenedor del panel. Con el montaje Compose estándar, la ruta del host es ${DATA_DIR_HOST}/panel.db (por ejemplo, /opt/msm/data/panel.db). Las tablas relevantes son wizard_configs, wizard_transcripts y wizard_outreach; las auditorías de poderes son filas en la tabla events con el tipo wizard-power. La clave API LLM opcional está cifrada con AES-256-GCM con la clave en reposo del panel, .secret-key en la carpeta de datos (separada de SESSION_SECRET).
Haga una copia de seguridad de la base de datos y detenga el panel antes de editar SQLite directamente para que su WAL se maneje de forma segura. Se prefiere usar la UI/API de administrador porque aplica validación y cifrado. Mantenga juntos los archivos panel.db, panel.db-wal y panel.db-shm al copiar una base de datos en vivo.