Instalação

Dez minutos. O único passo que as pessoas costumam pular é o fmLib — o recurso não inicia sem ele.

Antes de começar

Você precisa	Por quê
ESX, QBCore ou QBox	Callbacks, notificações e dados do jogador vêm do framework
fmLib	Obrigatório. Dinheiro, itens, empregos e chaves de veículos passam por ele. O próprio guia do recurso aponta para o fmLib v2.0.2
oxmysql	Cada missão, evento e progresso do jogador é armazenado no seu banco de dados
ox_target ou qb-target	Opcional. `ox_target` é o padrão; mude para texto 3D se não usar nenhum dos dois
screenshot-basic	Opcional, apenas para capturas de tela no nó de webhook

1. Coloque a pasta no lugar

Baixe o mic_questcreator dos seus ativos concedidos na Cfx.re e coloque a pasta nos seus recursos, por exemplo resources/[mic]/mic_questcreator. Coloque o fmLib nos seus recursos também, caso ainda não esteja lá.

2. Inicie-o depois das dependências

No server.cfg, o ensure mic_questcreator deve ficar abaixo do oxmysql, do seu framework (es_extended, qb-core ou qbx_core), do fmLib e do seu recurso de target. O manifesto declara o fmLib e o oxmysql como dependências, portanto, se algum deles estiver faltando ou iniciar depois, o FiveM se recusará a iniciar o Quest Creator e informará qual deles não encontrou.

Funcionou quando o console imprime [QuestCreator] FMLIB Initialized successfully. ao iniciar o recurso. Um erro em vermelho como CRITICAL ERROR: FMLIB NOT FOUND!, ESX NOT FOUND! ou QBCore NOT FOUND! significa que a ordem de inicialização está incorreta ou que o Config.Framework indica o framework errado.

3. O banco de dados

Importe o install.sql da pasta do recurso uma única vez, usando HeidiSQL, phpMyAdmin ou a ferramenta de sua preferência. O recurso não cria as tabelas sozinho.

Ele cria oito tabelas, todas começando com mic_questcreator_:

Tabela	O que ela armazena
`mic_questcreator_list`	As missões
`mic_questcreator_locations`	Onde cada NPC de missão fica posicionado e o seu modelo
`mic_questcreator_dialogs`	As opções de perguntas e respostas e seus tempos de recarga
`mic_questcreator_personalization`	Mensagem de boas-vindas, título e subtítulo de cada missão
`mic_questcreator_events`	Os eventos que você desenha no editor de nós
`mic_questcreator_progress`	Onde cada jogador está em uma missão
`mic_questcreator_cooldowns`	Quando cada jogador poderá usar uma opção de diálogo novamente
`mic_questcreator_unlocks`	Quais eventos cada jogador desbloqueou

Funcionou quando essas oito tabelas estiverem no seu banco de dados. Excluir uma missão remove seus locais, diálogos e personalizações junto com ela.

4. Itens

Nenhum. O recurso não traz itens próprios. Os itens que uma missão entrega, remove ou verifica são aqueles que você digita nos nós, portanto eles já devem existir no seu inventário.

5. Framework e target

Abra o config.lua e verifique duas linhas:

Opção	Defina como
`Config.Framework`	`'esx'` (o padrão) ou `'qbcore'`. Não é detectado automaticamente. No QBox, use `'qbcore'` — o QBox executa recursos QBCore através da sua camada de compatibilidade
`Config.InteractionType`	`'ox_target'` (o padrão), `'qb-target'` ou `'drawtext'`

Se você não usar nenhum recurso de target, defina 'drawtext': os jogadores então caminham até o NPC e pressionam E.

6. Dê permissão ao editor para você mesmo

O editor é protegido pela permissão ACE mic_questcreator.open. Conceda-a no server.cfg (ou no seu arquivo de permissões) com uma linha add_ace: para uma única pessoa por identificador, por exemplo add_ace identifier.discord:YOUR_DISCORD_ID mic_questcreator.open allow, ou para um grupo inteiro, por exemplo add_ace group.admin mic_questcreator.open allow.

Funcionou quando /questcreator abre o Quest & Event Creator. Sem a permissão, o servidor responde “You do not have permission to access the Quest Creator.”

7. Primeiro teste

Na aba Events, crie um evento, abra-o no editor de nós e conecte Start → Notification → Give Money → End. Salve.
Na aba Quests, crie uma missão. Adicione um local: escolha um modelo de ped, pressione Set Position, caminhe até um ponto e confirme com E.
Adicione um diálogo com uma pergunta e uma resposta, e escolha o seu evento em Trigger Event. Salve a missão.

Funcionou quando o NPC estiver parado onde você o colocou, conversar com ele abrir a janela de diálogo e escolher a sua opção mostrar a notificação e pagar o valor configurado.

Antes de abrir sua cidade

Apenas as pessoas certas têm mic_questcreator.open. Qualquer pessoa com essa permissão pode criar e excluir todas as missões do servidor.
Verifique se Config.Framework e Config.InteractionType correspondem ao que o seu servidor realmente usa.
Decida sobre o /cancelquest. Ele vem ativado por padrão; Config.EnableCancelQuest o desativa.
Teste uma missão com recompensa em um personagem normal, não apenas no seu personagem de administrador, para ver as mesmas permissões e inventário que os seus jogadores terão.