ESX, QBCore ve Qbox: Framework'ünüzü Ayarlayın ve Meslekleri Oluşturun

Çalışan bir framework, FiveM sunucunuzun temelidir. Garajlar, tabletler veya işletmeler eklemeden önce karakter oluşturma, veritabanı ve meslek atamasını çalışır hale getirin. Bu kılavuz, yeni bir kurulumu ve ESX Legacy, QBCore veya Qbox üzerindeki küçük bir örnek mesleği kapsamaktadır. Framework'ünüz için ilgili bölümü takip edin; üçünü birlikte kurmak kurulumun bir parçası değildir.

Temiz bir kurulumla başlayın

Bir Cfx.re hesabı, bir sunucu kayıt anahtarı, uygun bir FXServer artifact'i ve çalışan bir MariaDB servisi hazırlayın. Seçtiğiniz framework tarafından desteklenen veritabanı sürümünü kullanın; Qbox açıkça MariaDB gerektirir, MySQL veya XAMPP desteklemez. Yönetilen hosting kullanıyorsanız, sağlayıcının sunucusunu ve txAdmin kontrollerini kullanın. resmi FiveM sunucu kurulum kılavuzuna ve Qbox gereksinimlerine göz atın.

1. txAdmin'i açın ve yeni bir sunucu veri dizininde yeni bir reçete dağıtımı (recipe deployment) seçin.
2. Framework'ünüzün resmi reçetesini seçin: ESX Legacy, QBCore veya Qbox.
3. Sunucu anahtarını ve doğru MariaDB bağlantı ayrıntılarını girin. Bu sunucunun veritabanına erişimi olan özel bir veritabanı hesabı kullanın.
4. Reçeteyi çalıştırın, oluşturulan yapılandırmayı gözden geçirin ve sunucuyu başlatın. Reçetenin bağımlılıklarını ve kaynak sırasını koruyun.
5. Sunucuya katılın, bir karakter oluşturun, yeniden bağlanın ve diğer kaynakları eklemeden önce karakterin hala yüklendiğini onaylayın.

Reçeteler kaynakları indirir ve kurulum SQL'lerini çalıştırır. Daha sonra ikinci bir tam framework şeması içe aktarmayın veya mevcut bir sunucu üzerine yeni bir reçete kurmayın. Daha sonraki değişikliklerden önce hem dosyaları hem de veritabanını yedekleyin. Framework'e özel kurulum adımları için ESX'in kurulum kılavuzunu, QBCore'un Windows kılavuzunu veya Qbox'ın kurulum kılavuzunu takip edin.

Bir mesleğin gerçekte ne içerdiğini anlayın

Her işin bir dahili anahtarı, bir görüntüleme etiketi ve numaralandırılmış dereceleri vardır. Süreç boyunca sky_example, 0 ve 1 dereceleriyle kullanılır. Framework, iş betiği ve tüm entegrasyonlarda bu anahtarı aynı tutun. “Örnek Şirket” gibi bir etiket yalnızca oyuncuların gördüğü isimdir.

Bir meslek kaydetmek, onun framework kimliğini oluşturur. Oynanış, garajlar, depolama, patron menüleri ve işletme hesapları kendi uyumlu kaynaklarına ve yapılandırmalarına ihtiyaç duyar. Bir framework mesleği bitmiş bir işletme değildir. Yukarıdaki konumlar ESX şemasını, QBCore meslek dosyasını ve Qbox meslek dosyasını takip eder.

ESX Legacy: mesleği MariaDB'de oluşturun

Başka bir sunucunun veritabanını değil, bu sunucu için yapılandırılmış veritabanını açın. Önce örnek anahtarın zaten var olup olmadığını kontrol edin:

SELECT name FROM jobs WHERE name = 'sky_example';
SELECT grade FROM job_grades WHERE job_name = 'sky_example';

Yalnızca her iki kontrol de sıfır satır döndürdüğünde aşağıdaki eklemeleri çalıştırın. Eğer meslek mevcutsa, yinelenen kayıtlar eklemek yerine mevcut kayıtlarını inceleyin ve düzenleyin.

INSERT INTO jobs (name, label)
VALUES ('sky_example', 'Example Company');

INSERT INTO job_grades
    (job_name, grade, name, label, salary, skin_male, skin_female)
VALUES
    ('sky_example', 0, 'employee', 'Employee', 100, '{}', '{}'),
    ('sky_example', 1, 'boss', 'Manager', 200, '{}', '{}');

job_name her rütbeyi mesleğe bağlar. grade sütunu atama için kullanılan rütbedir; satırın otomatik id değeri rütbe değildir. Rütbesi olmayan meslekler göz ardı edilir. Meslek kataloğunu sunucu konsolu üzerinden yeniden yükleyin:

refreshjobs

Mevcut ESX Legacy sırasıyla oxmysql, sonra esx_lib, sonra es_extended ile başlar; eski eğitimler esx_lib kısmını atlamış olabilir. Tarifiniz tarafından sağlanan bağımlılıkları koruyun. güncel tarif yapılandırmasına ve meslek yükleme uygulamasına göz atın.

Bir esx_society entegrasyonu için, dahili rütbe adı boss varsayılan patron yapılandırmasıyla tanınır. Sadece görünür etiket olan “Manager” (Müdür) tek başına bir hak tanımaz. Kurum kaydı, hesaplar ve bağımlılık sırası ayrı kurulum adımları olarak kalır. Meslek kaynağınız kullanıyorsa kurum (society) dokümantasyonunu takip edin.

QBCore: meslekler tablosuna bir girdi ekleyin

qb-core/shared/jobs.lua'ı açın. Bu girdiyi mevcut meslekler tablosunun içine, diğer meslek girdilerinin yanına ve kapanış süslü parantezinden önce ekleyin. Mevcut tablo deklarasyonunu ve tüm mevcut meslekleri koruyun; bu bir tablo girdisidir, dosyanın yerine geçecek bir dosya değildir.

['sky_example'] = {
    label = 'Example Company',
    defaultDuty = false,
    offDutyPay = false,
    grades = {
        ['0'] = { name = 'Employee', payment = 100 },
        ['1'] = { name = 'Manager', payment = 200, isboss = true },
    },
},

Sıfırıncı rütbe dahil olmak üzere rütbe anahtarlarını dize (string) olarak tutun. Komşu girdilerin etrafındaki virgülleri ve parantezleri kontrol edin, kaydedin ve ardından bağımlı kaynakların aynı tanımları yüklemesi için planlı bir tam sunucu yeniden başlatması gerçekleştirin. FiveM'in refresh komutu kaynakları ve manifestleri yeniden tarar; çalışan bir Lua meslek tablosunu yeniden yüklemez. QBCore için ESX stili jobs SQL satırları oluşturmayın. Onun meslek tanımları Lua içinde yaşarken, karakter verileri hala veritabanını kullanır.

isboss yönetici kademesini belirtir; framework-admin komut izinleri sağlamaz. Uyumlu bir yönetim kaynağı, asıl menüyü ve konumunu hala sağlamalı ve yapılandırmalıdır.

Qbox: kendi meslek dosyasını ve sayısal kademelerini kullanın

qbx_core/shared/jobs.lua'ı açın ve bu girdiyi son kapatma süslü parantezinden önce, şu ifadenin döndürdüğü tablonun içine ekleyin: return { ... }. Diğer girdilerini koruyun. Qbox burada sayısal kademe anahtarlarını kullanır; QBCore'un metin anahtarlarını değiştirmeden yapıştırmayın.

['sky_example'] = {
    label = 'Example Company',
    defaultDuty = false,
    offDutyPay = false,
    grades = {
        [0] = { name = 'Employee', payment = 100 },
        [1] = { name = 'Manager', payment = 200, isboss = true, bankAuth = true },
    },
},

Kaydedin ve planlı bir tam sunucu yeniden başlatması gerçekleştirin. bankAuth, isboss'den ayrıdır ve uyumlu bankacılık entegrasyonları tarafından kullanılır; her iki bayrak da bir hesap veya menü oluşturmaz. Kurulumunuzu resmi Qbox meslek tanımlarıyla eşleştirin.

Qbox çoklu meslek desteği içerir. Meslek sınırı ve /setjob'ın üyeliğin yerini mi alacağı yoksa üyeliğe ek mi yapılacağı yapılandırılabilir. Birkaç mesleği yönetirken desteklenen üyelik komutlarını kullanın; harici bir QBCore çoklu meslek kaynağının uyumlu olduğunu varsaymayın. Qbox komutlarına ve çoklu meslek yapılandırmasına bakın.

Atayın, test edin ve yeniden bağlanın

Bir test karakteriyle katılın ve gerekli framework/ACE komut izinlerine sahip bir hesap kullanın. Sadece bir txAdmin girişi bu izinleri sağlamaz. Eğer Qbox'da requireOptIn etkinleştirilmişse, admin komutlarından önce /optin kullanın. Aşağıdaki 1'yi bağlı test karakterinizin mevcut sunucu ID'si ile değiştirin; /job, komutu giren oyuncunun mesleğini raporlar:

/setjob 1 sky_example 0
/job
/setjob 1 sky_example 1
/job

Her iki kademenin de beklenen meslek ve rütbeyi gösterdiğini kontrol edin. Atama sözdizimi ESX, QBCore ve Qbox için belgelenmiştir; Qbox'in koşullu katılım kontrolü, komut uygulamasındadır.

QBCore ve Qbox için bu örnek, mesai dışı olarak başlar ve mesai dışı maaşını devre dışı bırakır. Yüklü olan meslek kaynağınızın mesai eylemini kullanın; varsayılan olarak atanacak evrensel bir /duty komutu yoktur. Giriş ayarları da kaydedilen mesai durumunun mı yoksa defaultDuty durumunun mı geçerli olacağını etkiler. Ardından tekrar bağlanın ve kaydedilen mesleği, rütbeyi ve amaçlanan mesai davranışını doğrulayın.

Mesleği oyunculara açmadan önce, izinlerini her iki rütbe ile de test edin. Bir çalışan, yönetim için ayrılmış özelliklere erişememelidir. Atamadan hemen sonra ödeme beklemek yerine yapılandırılmış maaş aralığınızın dolmasını bekleyin; örnek tutarlar ekonominiz için yer tutuculardır. Eğer bir kontrol başarısız olursa, ilk ilgili konsol hatasını okuyun ve başka bir kaynak eklemeden önce bunu çözün.

Ardından Sky mesleğinizi bağlayın

Framework ataması çalıştığında, Sky kurulum kılavuzunu takip edin ve yüklü meslek kaynağınızı aynı framework anahtarı ve rütbelerle yapılandırın. İlgili ortak ayarlar için Jobs Base ortak özelliklerini kullanın. Yalnızca seçtiğiniz Sky kurulumu bir mesai dışı meslek çifti kullanıyorsa bir mesai dışı meslek çifti yapılandırın ve her iki mesleği de gerekli tüm rütbelerle oluşturun.

Son kontrol: 25 Ekim 2026. Yukarıdaki kaynaklar resmi framework dokümantasyonu, bakımı yapılan tarifler ve GitHub uygulamalarıdır. Örnekleri daha yeni bir sürümden uygulamadan önce yüklü olan sürümünüzü kontrol edin.