Instalacja

Dziesięć minut. Jedyny krok, który ludzie pomijają, to fmLib — zasób nie uruchomi się bez niego.

Zanim zaczniesz

Potrzebujesz	Dlaczego
ESX, QBCore lub QBox	Callbacki, powiadomienia i dane gracza pochodzą z frameworka
fmLib	Wymagany. Przechodzą przez niego pieniądze, przedmioty, prace i kluczyki do pojazdów. Instrukcja samego zasobu wskazuje fmLib v2.0.2
oxmysql	Każdy quest, event i postęp gracza są przechowywane w twojej bazie danych
ox_target lub qb-target	Opcjonalnie. Domyślny jest `ox_target`; jeśli nie używasz żadnego, przełącz się na tekst 3D
screenshot-basic	Opcjonalnie, tylko do zrzutów ekranu w węźle webhooka

1. Wgraj folder

Pobierz mic_questcreator ze swoich przyznanych zasobów Cfx.re i wrzuć folder do swoich zasobów, na przykład resources/[mic]/mic_questcreator. Wgraj tam też fmLib, jeśli jeszcze go nie ma.

2. Uruchom go po zasobach, na których się opiera

W server.cfg linia ensure mic_questcreator musi znaleźć się poniżej oxmysql, twojego frameworka (es_extended, qb-core lub qbx_core), fmLib oraz zasobu targetu. Manifest deklaruje fmLib i oxmysql jako zależności, więc jeśli któregoś brakuje albo startuje później, FiveM odmówi uruchomienia Quest Creatora i poda, którego nie znalazł.

Działa, gdy konsola wypisze [QuestCreator] FMLIB Initialized successfully. przy starcie zasobu. Czerwony komunikat CRITICAL ERROR: FMLIB NOT FOUND!, ESX NOT FOUND! lub QBCore NOT FOUND! oznacza, że kolejność uruchamiania jest zła albo Config.Framework wskazuje niewłaściwy framework.

3. Baza danych

Zaimportuj install.sql z folderu zasobu jeden raz, za pomocą HeidiSQL, phpMyAdmin lub czegokolwiek, czego używasz. Zasób nie tworzy swoich tabel samodzielnie.

Powstaje osiem tabel, wszystkie zaczynają się od mic_questcreator_:

Tabela	Co przechowuje
`mic_questcreator_list`	Questy
`mic_questcreator_locations`	Gdzie stoi każdy zleceniodawca i jaki ma model
`mic_questcreator_dialogs`	Opcje pytanie–odpowiedź i ich cooldowny
`mic_questcreator_personalization`	Wiadomość powitalna, tytuł i podtytuł każdego questa
`mic_questcreator_events`	Eventy rysowane w edytorze węzłów
`mic_questcreator_progress`	Etap questa, na którym jest każdy gracz
`mic_questcreator_cooldowns`	Kiedy każdy gracz może ponownie użyć opcji dialogu
`mic_questcreator_unlocks`	Które eventy odblokował każdy gracz

Działa, gdy te osiem tabel znajduje się w twojej bazie danych. Usunięcie questa usuwa razem z nim jego lokalizacje, dialogi i personalizację.

4. Przedmioty

Brak. Zasób nie dostarcza żadnych własnych przedmiotów. Przedmioty, które quest daje, zabiera lub sprawdza, to te, które wpiszesz w węzłach, więc muszą już istnieć w twoim ekwipunku.

5. Framework i target

Otwórz config.lua i sprawdź dwie linijki:

Opcja	Ustaw na
`Config.Framework`	`'esx'` (domyślnie) lub `'qbcore'`. Nie jest wykrywany automatycznie. Na QBox użyj `'qbcore'` — QBox uruchamia zasoby QBCore przez swoją warstwę zgodności
`Config.InteractionType`	`'ox_target'` (domyślnie), `'qb-target'` lub `'drawtext'`

Jeśli nie używasz żadnego z zasobów targetu, ustaw 'drawtext': gracze podchodzą wtedy do NPC i naciskają E.

6. Daj sobie dostęp do edytora

Edytor jest zablokowany za uprawnieniem ACE mic_questcreator.open. Nadaj je w server.cfg (lub w pliku z uprawnieniami) linią add_ace: pojedynczej osobie po identyfikatorze, na przykład add_ace identifier.discord:YOUR_DISCORD_ID mic_questcreator.open allow, albo całej grupie, na przykład add_ace group.admin mic_questcreator.open allow.

Działa, gdy /questcreator otwiera Quest & Event Creator. Bez uprawnienia serwer odpowiada “You do not have permission to access the Quest Creator.”

7. Pierwszy test

W zakładce Events utwórz event, otwórz go w edytorze węzłów i połącz Start → Notification → Give Money → End. Zapisz.
W zakładce Quests utwórz questa. Dodaj lokalizację: wybierz model peda, naciśnij Set Position, podejdź w wybrane miejsce i potwierdź klawiszem E.
Dodaj dialog z pytaniem i odpowiedzią, a w Trigger Event wybierz swój event. Zapisz questa.

Działa, gdy NPC stoi tam, gdzie go ustawiłeś, rozmowa z nim otwiera okno dialogowe, a wybranie twojej opcji pokazuje powiadomienie i wypłaca ci pieniądze.

Zanim otworzysz miasto

Tylko właściwe osoby mają mic_questcreator.open. Każdy, kto je ma, może tworzyć i usuwać wszystkie questy na serwerze.
Sprawdź, czy Config.Framework i Config.InteractionType odpowiadają temu, co faktycznie działa na twoim serwerze.
Zdecyduj o /cancelquest. Jest domyślnie włączona; Config.EnableCancelQuest ją wyłącza.
Przetestuj quest z nagrodą na zwykłej postaci, a nie tylko na adminie, żeby zobaczyć te same uprawnienia i ten sam ekwipunek, które będą mieli twoi gracze.