Instalación

Diez minutos. El paso que la gente se salta es fmLib: el recurso no arranca sin él.

Antes de empezar

Necesitas	Por qué
ESX, QBCore o QBox	Los callbacks, las notificaciones y los datos del jugador vienen del framework
fmLib	Obligatorio. El dinero, los ítems, los trabajos y las llaves de vehículos pasan por él. La guía del propio recurso apunta a fmLib v2.0.2
oxmysql	Todas las misiones, los eventos y el progreso de cada jugador se guardan en tu base de datos
ox_target o qb-target	Opcional. `ox_target` es el valor por defecto; cambia a texto 3D si no usas ninguno de los dos
screenshot-basic	Opcional, solo para las capturas de pantalla del nodo de webhook

1. Coloca la carpeta

Descarga mic_questcreator desde tus Cfx.re granted assets y suelta la carpeta en tus recursos, por ejemplo resources/[mic]/mic_questcreator. Pon también fmLib en tus recursos si todavía no está.

2. Arráncalo después de aquello de lo que depende

En server.cfg, ensure mic_questcreator va debajo de oxmysql, tu framework (es_extended, qb-core o qbx_core), fmLib y tu recurso de target. El manifest declara fmLib y oxmysql como dependencias, así que si falta alguno de los dos o arranca más tarde, FiveM se niega a arrancar el quest creator y te dice cuál no ha encontrado.

Ha funcionado si la consola muestra [QuestCreator] FMLIB Initialized successfully. al arrancar el recurso. Un CRITICAL ERROR: FMLIB NOT FOUND!, ESX NOT FOUND! o QBCore NOT FOUND! en rojo significa que el orden de arranque está mal o que Config.Framework indica el framework equivocado.

3. La base de datos

Importa install.sql desde la carpeta del recurso una sola vez, con HeidiSQL, phpMyAdmin o lo que uses. El recurso no crea sus tablas por sí mismo.

Crea ocho tablas, todas empezando por mic_questcreator_:

Tabla	Qué guarda
`mic_questcreator_list`	Las misiones
`mic_questcreator_locations`	Dónde está cada NPC de misión y su modelo
`mic_questcreator_dialogs`	Las opciones de pregunta y respuesta, y sus cooldowns
`mic_questcreator_personalization`	Mensaje de bienvenida, título y subtítulo de cada misión
`mic_questcreator_events`	Los eventos que dibujas en el editor de nodos
`mic_questcreator_progress`	En qué punto de una misión está cada jugador
`mic_questcreator_cooldowns`	Cuándo puede volver a usar cada jugador una opción de diálogo
`mic_questcreator_unlocks`	Qué eventos ha desbloqueado cada jugador

Ha funcionado si esas ocho tablas están en tu base de datos. Al borrar una misión se borran con ella sus ubicaciones, diálogos y personalización.

4. Ítems

Ninguno. El recurso no trae ítems propios. Los ítems que una misión da, quita o comprueba son los que escribes en los nodos, así que deben existir ya en tu inventario.

5. Framework y target

Abre config.lua y revisa dos líneas:

Opción	Ponla en
`Config.Framework`	`'esx'` (por defecto) o `'qbcore'`. No se detecta solo. En QBox, usa `'qbcore'`: QBox ejecuta los recursos de QBCore a través de su capa de compatibilidad
`Config.InteractionType`	`'ox_target'` (por defecto), `'qb-target'` o `'drawtext'`

Si no usas ninguno de los dos recursos de target, pon 'drawtext': los jugadores se acercan al NPC y pulsan E.

6. Date acceso al editor

El editor está protegido por el permiso ACE mic_questcreator.open. Concédelo en server.cfg (o en tu archivo de permisos) con una línea add_ace: a una sola persona por su identificador, por ejemplo add_ace identifier.discord:YOUR_DISCORD_ID mic_questcreator.open allow, o a todo un grupo, por ejemplo add_ace group.admin mic_questcreator.open allow.

Ha funcionado si /questcreator abre el Quest & Event Creator. Sin el permiso, el servidor responde “You do not have permission to access the Quest Creator.”

7. Primera prueba

En la pestaña Events, crea un evento, ábrelo en el editor de nodos y conecta Start → Notification → Give Money → End. Guarda.
En la pestaña Quests, crea una misión. Añade una ubicación: elige un modelo de ped, pulsa Set Position, camina hasta un sitio y confirma con E.
Añade un diálogo con una pregunta y una respuesta, y elige tu evento en Trigger Event. Guarda la misión.

Ha funcionado si el NPC está donde lo colocaste, al hablar con él se abre la ventana de diálogo y, al elegir tu opción, aparece la notificación y te paga.

Antes de abrir tu ciudad

Solo las personas adecuadas tienen mic_questcreator.open. Cualquiera con ese permiso puede crear y borrar todas las misiones del servidor.
Comprueba que Config.Framework y Config.InteractionType coinciden con lo que realmente usa tu servidor.
Decide qué hacer con /cancelquest. Está activado por defecto; Config.EnableCancelQuest lo desactiva.
Prueba una misión con recompensa en un personaje normal, no solo en el de admin, para ver los mismos permisos e inventario que verán tus jugadores.