Kurulum

On dakika. İnsanların atladığı tek adım fmLib — onsuz kaynak başlamaz.

Başlamadan önce

İhtiyacınız olan	Neden
ESX, QBCore veya QBox	Callback’ler, bildirimler ve oyuncu verisi framework’ten gelir
fmLib	Zorunlu. Para, eşyalar, meslekler ve araç anahtarları onun üzerinden geçer. Kaynağın kendi rehberi fmLib v2.0.2 sürümüne işaret eder
oxmysql	Her görev, etkinlik ve oyuncunun ilerlemesi veritabanınızda saklanır
ox_target veya qb-target	İsteğe bağlı. `ox_target` varsayılandır; ikisini de kullanmıyorsanız 3D metne geçin
screenshot-basic	İsteğe bağlı, yalnızca webhook node’undaki ekran görüntüleri için

1. Klasörü yerine koyun

mic_questcreator klasörünü Cfx.re granted assets sayfanızdan indirin ve resources içine bırakın, örneğin resources/[mic]/mic_questcreator. fmLib de henüz orada değilse resources içine koyun.

2. Dayandığı şeylerden sonra başlatın

server.cfg içinde ensure mic_questcreator, oxmysql, framework’ünüz (es_extended, qb-core veya qbx_core), fmLib ve target kaynağınızın altına gider. Manifest, fmLib ve oxmysql’i bağımlılık olarak bildirir; bu yüzden biri eksikse ya da daha geç başlıyorsa FiveM quest creator’ı başlatmayı reddeder ve hangisini bulamadığını söyler.

Çalıştığı zaman: kaynak başlarken konsol [QuestCreator] FMLIB Initialized successfully. yazdırır. Kırmızı bir CRITICAL ERROR: FMLIB NOT FOUND!, ESX NOT FOUND! veya QBCore NOT FOUND!, başlatma sırasının yanlış olduğu ya da Config.Framework değerinin yanlış framework’ü adlandırdığı anlamına gelir.

3. Veritabanı

Kaynak klasöründeki install.sql dosyasını HeidiSQL, phpMyAdmin ya da kullandığınız her neyse onunla bir kez içe aktarın. Kaynak tablolarını kendisi oluşturmaz.

Hepsi mic_questcreator_ ile başlayan sekiz tablo oluşturur:

Tablo	Ne tutar
`mic_questcreator_list`	Görevler
`mic_questcreator_locations`	Her görev verenin nerede durduğu ve modeli
`mic_questcreator_dialogs`	Soru-cevap seçenekleri ve bekleme süreleri (cooldown)
`mic_questcreator_personalization`	Her görevin karşılama mesajı, başlığı ve alt başlığı
`mic_questcreator_events`	Node editöründe çizdiğiniz etkinlikler
`mic_questcreator_progress`	Her oyuncunun bir görevde nerede olduğu
`mic_questcreator_cooldowns`	Her oyuncunun bir diyalog seçeneğini ne zaman tekrar kullanabileceği
`mic_questcreator_unlocks`	Her oyuncunun hangi etkinliklerin kilidini açtığı

Çalıştığı zaman: o sekiz tablo veritabanınızdadır. Bir görevi silmek, onun konumlarını, diyaloglarını ve kişiselleştirmesini de siler.

4. Eşyalar

Yok. Kaynak kendine ait hiçbir eşya getirmez. Bir görevin verdiği, aldığı ya da kontrol ettiği eşyalar node’lara yazdığınız her neyse odur; bu yüzden envanterinizde zaten var olmaları gerekir.

5. Framework ve target

config.lua dosyasını açın ve iki satırı kontrol edin:

Seçenek	Şuna ayarlayın
`Config.Framework`	`'esx'` (varsayılan) veya `'qbcore'`. Kendiliğinden algılanmaz. QBox’ta `'qbcore'` kullanın — QBox, QBCore kaynaklarını uyumluluk katmanı üzerinden çalıştırır
`Config.InteractionType`	`'ox_target'` (varsayılan), `'qb-target'` veya `'drawtext'`

İki target kaynağından da kullanmıyorsanız 'drawtext' ayarlayın: oyuncular o zaman NPC’ye yürür ve E tuşuna basar.

6. Editörü kendinize verin

Editör, mic_questcreator.open ACE yetkisinin arkasında kilitlidir. Onu server.cfg (ya da yetki dosyanız) içinde bir add_ace satırıyla verin: tek bir kişiye identifier ile, örneğin add_ace identifier.discord:YOUR_DISCORD_ID mic_questcreator.open allow, ya da bütün bir gruba, örneğin add_ace group.admin mic_questcreator.open allow.

Çalıştığı zaman: /questcreator Quest & Event Creator’ı açar. Yetki olmadan sunucu “You do not have permission to access the Quest Creator.” cevabını verir.

7. İlk test

Events sekmesinde bir etkinlik oluşturun, node editöründe açın ve Start → Notification → Give Money → End bağlantılarını yapın. Kaydedin.
Quests sekmesinde bir görev oluşturun. Bir konum ekleyin: bir ped modeli seçin, Set Position tuşuna basın, bir noktaya yürüyün ve E ile onaylayın.
Bir soru ve bir cevap içeren bir diyalog ekleyin ve Trigger Event altında etkinliğinizi seçin. Görevi kaydedin.

Çalıştığı zaman: NPC yerleştirdiğiniz yerde durur, onunla konuşmak diyalog penceresini açar ve seçeneğinizi seçmek bildirimi gösterir ve size ödeme yapar.

Şehrinizi açmadan önce

mic_questcreator.open yetkisi yalnızca doğru kişilerde. Ona sahip olan herkes sunucudaki her görevi oluşturabilir ve silebilir.
Config.Framework ve Config.InteractionType değerlerinin sunucunuzun gerçekte çalıştırdığıyla eşleştiğini kontrol edin.
/cancelquest hakkında karar verin. Varsayılan olarak açıktır; Config.EnableCancelQuest onu kapatır.
Ödüllü bir görevi normal bir karakterde test edin, yalnızca yönetici karakterinizde değil; böylece oyuncularınızın göreceği yetkileri ve envanteri siz de görürsünüz.