# ⚡| Instalación Esta guía explica cómo instalar NPC-RealTalking en tu servidor Minecraft y conectarlo con el panel web. Antes de empezar, asegurate de tener acceso al panel web, al archivo `.jar` del plugin y a la configuración de tu servidor. *** ### Requisitos Para usar NPC-RealTalking necesitás: * Un servidor Minecraft compatible con plugins Bukkit, Spigot o Paper. * Java compatible con la versión de tu servidor. * Citizens instalado y funcionando. * El archivo `.jar` de NPC-RealTalking. * Acceso al panel web. * Una `PLUGIN_API_KEY` válida. * Conexión a internet desde el servidor Minecraft hacia el backend. Panel web: {% embed url="" %} Backend: {% embed url="" %} *** ### Instalar el plugin 1. Apagá tu servidor Minecraft. 2. Copiá el archivo del plugin dentro de la carpeta plugins de tu servidor: `plugins/NPC-RealTalking.jar` 3. Verificá que Citizens también esté instalado: `plugins/Citizens.jar` 4. Encendé el servidor. 5. Al iniciar por primera vez, el plugin debería crear su carpeta de configuración: `plugins/NPC-RealTalking/` Dentro vas a encontrar el archivo: `plugins/NPC-RealTalking/config.yml` *** ### Configurar config.yml Abrí el archivo: `plugins/NPC-RealTalking/config.yml` Buscá la sección backend y configúrala con la URL de producción y tu API key del plugin. Ejemplo de configuración del plugin: 
flowchart LR
backend:
  base-url: "https://nrt.mstudiosmc.online"
  api-key: "TU_PLUGIN_API_KEY" <<<=============
  allow-insecure-http: false

  sync:
    auto-refresh-enabled: true
    auto-refresh-minutes: 5
    cache-file: "cache/dialogues.json"
La api-key debe ser la clave del plugin, normalmente con este formato: `nrt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` No uses la clave de login del panel web. La clave de login suele empezar con: `nrt_login_` **\*\*Esa clave es solo para administradores.\*\*** *** ### Aplicar la configuración Después de editar config.yml, podés reiniciar el servidor o recargar la configuración con: `/nrt reload` Luego sincronizá los diálogos publicados desde el panel web: `/nrt sync` Si todo está bien configurado, el plugin descargará los diálogos publicados y guardará una copia local en cache. *** ### Crear o vincular NPCs NPC-RealTalking trabaja con NPCs de Citizens. Para crear un NPC básico con Citizens: `/npc create NombreDelNPC` Cada NPC tiene un ID interno. Ese ID es el que se usa para asociar el diálogo desde el panel web. Para ver información del NPC seleccionado: `/npc info` En el panel web, al crear o editar un diálogo, usá el ID del NPC correspondiente para que el plugin sepa qué conversación iniciar cuando un jugador interactúe con ese NPC. *** ### Crear el primer diálogo 1. Entrá al panel web: {% embed url="" %} 2. Iniciá sesión con tu usuario administrador. 3. Creá un nuevo diálogo. 4. Asigná el ID del NPC de Citizens. 5. Agregá al menos un nodo inicial. 6. Escribí el primer mensaje del NPC. 7. Agregá opciones de respuesta si corresponde. 8. Guardá y publicá el diálogo. 9. En el servidor Minecraft ejecutá: `/nrt sync` 10. Interactuá con el NPC dentro del juego. *** ### Verificar que funciona Para confirmar que la instalación está funcionando: * El comando /nrt reload no debería mostrar errores. * El comando /nrt sync debería sincronizar diálogos correctamente. * El archivo de cache debería generarse en: `plugins/NPC-RealTalking/cache/dialogues.json` * Al interactuar con un NPC que tiene diálogo publicado, debería iniciar la conversación. * Al interactuar con un NPC sin diálogo, el comportamiento dependerá de esta opción: `conversation:` \ `notify-missing-dialogue: true` Si está en true, el jugador verá un mensaje en el chat. Si está en false, el plugin ignorará la interacción silenciosamente. *** ### Problemas comunes #### El plugin no sincroniza Revisá que base-url esté bien escrito: `base-url: "https://nrt.mstudiosmc.online"` Revisá también que la api-key sea la clave del plugin y no la clave de login del panel. #### Error 401 Unauthorized Significa que la API key no coincide con la configurada en el backend. Verificá que estés usando la clave correcta: `nrt_live_...` #### El NPC no inicia conversación Revisá que: * El diálogo esté publicado. * El ID del NPC sea correcto. * El plugin haya sincronizado después de publicar. * El NPC exista y esté spawneado. * El archivo de cache tenga diálogos guardados. #### El NPC muestra que no tiene diálogo Significa que el plugin no encontró un diálogo publicado para ese NPC. Podés ocultar ese mensaje con: `conversation: notify-missing-dialogue: false` #### No se creó config.yml Apagá el servidor, verificá que el .jar esté dentro de plugins, y encendelo otra vez. También revisá la consola por errores relacionados con dependencias o versión de Java. *** ### Siguiente paso Después de instalar y conectar el plugin, continuá con la sección **Panel Web** para aprender a crear servidores, administrar API keys y publicar diálogos. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wikinrt.mstudiosmc.online/inicio/or-instalacion.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.