NPC Quests

IMPORTANTE: Este es un complemento adicional para el complemento NPC Dialog. NPC Dialog debe estar instalado y funcionando antes de instalar NPC Quests.

Servidor de Soporte – https://discord.gg/DRxwt8Qg2W

NPC Quests es un complemento para el complemento NPC Dialog. Este complemento amplía NPC Dialog con una funcionalidad integral de misiones y requisitos. NPC Dialog debe estar instalado primero, ya que NPC Quests depende de él para funcionar. Este complemento permite a los administradores del servidor crear sistemas de misiones complejas e interactivas con NPCs sin necesidad de conocimientos de programación.

El complemento funciona sin problemas con el complemento principal NPC Dialog, detectando automáticamente cuando está instalado y habilitando las funciones de misión en todo el sistema de diálogo. Cuando se instala el complemento, cada botón en cada página de diálogo obtiene la capacidad de tener requisitos y recompensas configuradas.

Las características clave incluyen múltiples tipos de requisitos, como requisitos de objetos donde los jugadores deben tener objetos específicos en su inventario, requisitos de NPC donde los jugadores deben interactuar primero con otros NPCs, y requisitos personalizados que se integran con otros complementos a través de una API. El sistema de recompensas es igualmente flexible, admitiendo recompensas de objetos, recompensas de complementos personalizados y ejecución de comandos de consola.

El complemento rastrea todas las interacciones de los jugadores con los NPCs, permitiendo un progreso secuencial de las misiones. Los jugadores no pueden acceder a los NPCs o botones si no han completado los requisitos previos necesarios. Esto permite la creación de tramas ramificadas y cadenas de misiones complejas donde el orden de las interacciones con los NPCs es importante.

Una característica poderosa es el sistema Last Button, que permite marcar cualquier botón como la última interacción. Cuando un jugador hace clic en un Last Button, el diálogo se cierra y ya no puede interactuar con ese NPC. Esto es perfecto para completar tramas o bloquear contenido tras su finalización. Cuando un jugador intenta interactuar con un NPC después de que se ha hecho clic en un Last Button, ve una Finished Page con mensajes personalizables.

El complemento incluye una interfaz de administración integral accesible a través del comando /npcquest. Esta interfaz proporciona una fácil configuración de todos los ajustes relacionados con las misiones sin necesidad de editar archivos JSON manualmente. Los administradores pueden seleccionar NPCs, páginas de diálogo y botones individuales para configurar sus requisitos y recompensas.

GUÍA DE CONFIGURACIÓN:

INSTALACIÓN:

REQUISITO PREVIO: El complemento NPC Dialog debe estar instalado y funcionando antes de instalar NPC Quests.

1. Instala y configura primero el complemento NPC Dialog
2. Coloca el archivo JAR de NPC Quests en la carpeta mods de tu servidor
3. Reinicia el servidor
4. El complemento detectará e integrará automáticamente con NPC Dialog

ACCESO A LA INTERFAZ DE ADMINISTRACIÓN:

Utiliza el comando /npcquest o /npcquests para abrir la interfaz de configuración de misiones. Debes tener el permiso npcquests.admin para usar este comando.

CONFIGURACIÓN BÁSICA:

1. Selecciona un NPC del menú desplegable en la parte superior
2. Selecciona una página de diálogo para ese NPC
3. Selecciona qué botón deseas configurar (Siguiente, Anterior, Cerrar, Botón Personalizado 1 o Botón Personalizado 2)
4. Configura los requisitos y recompensas según sea necesario
5. Haz clic en Guardar para guardar tus cambios

TIPOS DE REQUISITOS:

Requisitos de Objetos:
Los requisitos de objetos verifican si el jugador tiene objetos específicos en su inventario antes de permitirle hacer clic en un botón. Puedes añadir múltiples requisitos de objetos a un solo botón.

Para añadir un requisito de objeto:
– Introduce el ID del objeto en el campo ID del objeto (por ejemplo: Plant_Fruit_Apple)
– Introduce la cantidad requerida en el campo Cantidad
– Marca la casilla Consumir si deseas que los objetos sean eliminados cuando se cumpla el requisito
– Haz clic en Añadir Requisito de Objeto

Para eliminar un requisito de objeto:
– Encuentra el requisito en la lista
– Haz clic en el botón Eliminar junto a él

Los IDs de los objetos deben coincidir exactamente con el sistema de objetos de Hytale. Los IDs de objetos comunes incluyen Plant_Fruit_Apple, Ore_Iron, Weapon_Sword_Wooden, etc.

Requisitos de NPC:
Los requisitos de NPC requieren que los jugadores interactúen con otros NPCs antes de que puedan acceder a ciertos botones o NPCs. Esto crea cadenas de misiones donde los jugadores deben hablar con los NPCs en un orden específico.

Para añadir un requisito de NPC:
– Selecciona el NPC requisito del menú desplegable
– Haz clic en Añadir Requisito de NPC

Para eliminar un requisito de NPC:
– Encuentra el requisito en la lista
– Haz clic en el botón Eliminar junto a él

Los requisitos de NPC se verifican cuando:
– Un jugador intenta interactuar con un NPC (verifica los requisitos de la página de requisitos del botón)
– Un jugador hace clic en un botón que tiene requisitos de NPC configurados

Si no se cumplen los requisitos, el jugador verá un mensaje de fallo personalizable y no podrá continuar.

Requisitos Personalizados:
Los requisitos personalizados se integran con otros complementos a través de la API RequirementChecker. Esto permite que NPC Dialog verifique condiciones de otros complementos como sistemas de economía, sistemas de niveles o rastreadores de misiones personalizados.

Para añadir un requisito personalizado:
– Introduce el ID del requisito (este es registrado por otro complemento a través de la API)
– Introduce la Cantidad requerida (usa 0 para verificaciones booleanas)
– Haz clic en Añadir Requisito Personalizado

Para eliminar un requisito personalizado:
– Encuentra el requisito en la lista
– Haz clic en el botón Eliminar junto a él

El ID del requisito debe estar registrado por otro complemento utilizando la API de NPC Dialog. Contacta al desarrollador del otro complemento para averiguar qué IDs de requisitos están disponibles.

TIPOS DE RECOMPENSAS:

Recompensas de Objetos:
Las recompensas de objetos dan a los jugadores objetos cuando hacen clic en un botón que tiene recompensas configuradas. Puedes añadir múltiples recompensas de objetos a un solo botón.

Para añadir una recompensa de objeto:
– Introduce el ID del objeto en el campo ID del objeto
– Introduce la cantidad a dar en el campo Cantidad
– Haz clic en Añadir Recompensa de Objeto

Para eliminar una recompensa de objeto:
– Encuentra la recompensa en la lista
– Haz clic en el botón Eliminar junto a ella

Los objetos se entregan al inventario del jugador. Si el inventario está lleno, los objetos pueden ser descartados o perdidos dependiendo de la configuración del servidor.

Recompensas Personalizadas:
Las recompensas personalizadas se integran con otros complementos a través de la API RewardProvider. Esto permite que NPC Dialog otorgue recompensas de otros complementos como sistemas de economía, sistemas de experiencia o rastreadores de recompensas personalizados.

Para añadir una recompensa personalizada:
– Introduce el ID de la recompensa (este es registrado por otro complemento a través de la API)
– Introduce la Cantidad a dar
– Haz clic en Añadir Recompensa Personalizada

Para eliminar una recompensa personalizada:
– Encuentra la recompensa en la lista
– Haz clic en el botón Eliminar junto a ella

El ID de la recompensa debe estar registrado por otro complemento utilizando la API de NPC Dialog. Contacta al desarrollador del otro complemento para averiguar qué IDs de recompensas están disponibles.

Comandos de Consola:
Los comandos de consola ejecutan comandos del servidor cuando se hace clic en un botón con recompensas. Los comandos se ejecutan como consola, lo que significa que tienen todos los permisos y pueden usar comandos de administrador.

Para añadir un comando de consola:
– Introduce el comando completo en el campo Comando (por ejemplo: give @p Plant_Fruit_Apple –quantity=5)
– Haz clic en Añadir Comando de Consola

Para eliminar un comando de consola:
– Encuentra el comando en la lista
– Haz clic en el botón Eliminar junto a él

Los comandos admiten marcadores de posición como @p para el jugador que activó el botón. Todos los comandos se ejecutan con permisos de consola.

CONFIGURACIÓN DE LA PÁGINA DE REQUISITOS:

La Página de Requisitos es una página de diálogo especial que se muestra cuando un jugador interactúa por primera vez con un NPC pero no ha cumplido con los requisitos para acceder al diálogo principal. Puedes configurar esta página seleccionando “Página de Requisitos” en el menú desplegable Página.

Mensaje de Fallo de Requisito de NPC:
Este mensaje se muestra a los jugadores cuando no han hablado con los NPCs de requisito necesarios. Puedes usar el marcador de posición {PREREQNPC} para el nombre del NPC de requisito y {NPC} para el nombre del NPC actual.

Título de Requisitos No Cumplidos:
Este título se muestra en la barra de título del diálogo cuando no se cumplen los requisitos. Déjalo vacío para usar el título de la página.

Texto del Botón de Cerrar:
El texto que se muestra en el botón de cerrar cuando no se cumplen los requisitos. Déjalo vacío para usar el texto predeterminado.

CARACTERÍSTICA DEL ÚLTIMO BOTÓN:

La característica del Último Botón permite marcar cualquier botón como la última interacción con un NPC. Cuando un jugador hace clic en un Último Botón:

1. El diálogo se cierra inmediatamente
2. La interacción se marca como finalizada
3. El jugador ya no puede interactuar con ese NPC

Si un jugador intenta interactuar con un NPC después de hacer clic en un Último Botón, verá la Página Finalizada en lugar del diálogo normal.

Para habilitar el Último Botón:
1. Selecciona el NPC, la página y el botón que deseas marcar como el último botón
2. Marca la casilla “Marcar como Último Botón”
3. Configura los ajustes de la Página Finalizada (ver más abajo)
4. Haz clic en Guardar

CONFIGURACIÓN DE LA PÁGINA FINALIZADA:

La Página Finalizada se muestra cuando un jugador intenta interactuar con un NPC después de que se ha hecho clic en un Último Botón. Configura esta página en la interfaz de administración cuando la casilla del Último Botón esté habilitada.

Título de la Página Finalizada:
El título que se muestra en la barra de título del diálogo cuando se muestra la página finalizada.

Mensaje de la Página Finalizada:
El mensaje principal que se muestra al jugador explicando que ya ha completado esta interacción.

Texto del Botón de Cerrar de la Página Finalizada:
El texto que se muestra en el botón de cerrar para la página finalizada.

ALMACENAMIENTO DE DATOS:

Todos los datos de configuración de misiones se almacenan en archivos JSON en la carpeta Hyronix_NPC Quests dentro del directorio de datos de tu servidor. El archivo interactionHistory.json rastrea qué jugadores han interactuado con qué NPCs, incluyendo qué interacciones están marcadas como finalizadas.

La estructura de la carpeta de datos:
– Hyronix_NPC Quests/
– npcs/ (archivos JSON individuales de NPC)
– interactionHistory.json (rastreo de interacciones de jugadores)

SEGUIMIENTO DE INTERACCIONES:

El complemento rastrea automáticamente todas las interacciones de los jugadores con los NPCs. Este seguimiento se utiliza para:
– Verificar los requisitos de NPC
– Prevenir interacciones repetidas cuando el Último Botón está habilitado
– Mantener el estado de progreso de la misión

El historial de interacciones se almacena por jugador y persiste a través de los reinicios del servidor. Para restablecer el historial de interacciones de un jugador, puedes editar o eliminar manualmente su entrada en interactionHistory.json.

CONFIGURACIÓN DE BOTONES:

Puedes configurar requisitos y recompensas para los siguientes botones:
– Botón Siguiente: El botón que avanza a la siguiente página de diálogo
– Botón Anterior: El botón que regresa a la página de diálogo anterior
– Botón Cerrar: El botón que cierra el diálogo
– Botón Personalizado 1: Primer botón personalizable (si está habilitado en la página de diálogo)
– Botón Personalizado 2: Segundo botón personalizable (si está habilitado en la página de diálogo)

Cada botón puede tener:
– Múltiples requisitos de objetos
– Múltiples requisitos de NPC
– Múltiples requisitos personalizados
– Múltiples recompensas de objetos
– Múltiples recompensas personalizadas
– Múltiples comandos de consola
– Estado de Último Botón

FLUJO DE TRABAJO DEL BOTÓN:

Cuando un jugador hace clic en un botón, sucede lo siguiente en orden:

1. Se verifican los requisitos:
– Requisitos de objetos: Verifica si el jugador tiene los objetos requeridos
– Requisitos de NPC: Verifica si el jugador ha hablado con los NPCs requeridos
– Requisitos personalizados: Verifica con los verificadores de requisitos registrados

2. Si algún requisito falla:
– Se muestra un mensaje de fallo al jugador
– No se otorgan recompensas
– La acción del botón no procede

3. Si todos los requisitos se cumplen:
– Se consumen los objetos requeridos (si se habilita el consumo)
– Se otorgan recompensas:
– Las recompensas de objetos se añaden al inventario
– Las recompensas personalizadas son procesadas por los proveedores de recompensas registrados
– Se ejecutan los comandos de consola

4… [Truncado]