Kurulum

FiveM scripti kurmak karmaşık değil. Ama daha önce hiç yapmadıysan, işe girişmeden önce sunucunun scriptleri nasıl yüklediğini anlamak işini kolaylaştırır.

FiveM Scripti Nedir?

FiveM scriptlerine kaynak (resource) denir. Kaynak, bir scriptin çalışması için gereken her şeyi içeren bir klasördür: client dosyaları, server dosyaları, config dosyaları ve varsa UI dosyaları.

Her kaynak klasöründe fxmanifest.lua adında bir dosya olmalı. Bu dosya sunucuya neyi yükleyeceğini söyler. Dosya yoksa sunucu klasörü tamamen görmezden gelir.

1. Adım: Script Dosyalarını Al ve Arşivden Çıkar

Scriptler genelde .zip veya .rar dosyası olarak gelir. İndirdiğin arşivi 7-Zip ya da WinRAR ile çıkar.

İçinde kaynak klasörünü bulacaksın. Klasörde en azından şunlar olmalı:

• fxmanifest.lua
• Bir veya daha fazla script dosyası (client.lua, server.lua, config.lua vb.)

Dokümantasyon güvenli olduğunu söylemiyorsa klasörün içindeki dosyaların adını değiştirme. fxmanifest.lua içindeki dosya yolları büyük/küçük harfe duyarlıdır ve gerçek dosya adlarıyla birebir aynı olmalıdır.

2. Adım: Kaynağı Sunucuna Yükle

Kaynaklar, sunucu veri dizinindeki resources/ klasörüne konur. Tipik bir yapı şöyle görünür:

server-data/
└── resources/
    └── [scripts]/
        └── your-script/
            ├── fxmanifest.lua
            ├── client.lua
            └── server.lua

[scripts] gibi köşeli parantezli klasörler sadece düzen için kullanılan kategorilerdir, kendileri birer kaynak değildir. İçlerindeki scriptler sorunsuz çalışır.

Kaynak klasörünü FTP, SFTP ya da hosting panelinin dosya yöneticisiyle yükle.

3. Adım: Scripti Yapılandır

Çoğu scriptte bir config.lua dosyası bulunur. Dosyayı aç ve değerleri sunucuna göre ayarla. Burada genelde altyapı türü, meslek adları ve item adları gibi ayarlar olur.

Scripti başlatmadan önce dokümantasyonu oku. Kurulumdan sonra bir scriptin çalışmamasının en yaygın sebebi bu adımı atlamaktır.

4. Adım: Scripti server.cfg'ye Ekle

server.cfg dosyasını aç ve şu satırı ekle:

ensure your-script

your-script kısmını kaynak klasörünün tam adıyla değiştir. Büyük/küçük harf önemlidir.

Script ESX, QBCore veya ox_lib gibi başka kaynaklara bağlıysa, önce onlar yüklensin diye bunların server.cfg içinde daha yukarıda yer aldığından emin ol.

Günümüzde standart olan ensure. Kaynağı başlatır ve çökerse otomatik olarak yeniden başlatır. Eski start komutu hâlâ çalışır ama ensure tercih edilir.

5. Adım: Kaynağı Başlat

Tüm sunucuyu yeniden başlatmana gerek yok. Bir kaynağı başlatmanın iki yolu var:

• txAdmin: Resources paneline git, scripti bul ve Start'a tıkla.
• Sunucu konsolu: Konsola doğrudan start your-script yaz.

Konsol çıktısında hata olup olmadığına bak. Script doğru yüklendiyse şunu göreceksin:

Started resource your-script

Sık Karşılaşılan Sorunlar

Özet

1. Arşivi çıkar ve kaynak klasörünü bul.
2. Klasörü server-data/resources/ içine yükle.
3. config.lua dosyasını sunucu kurulumuna göre düzenle.
4. server.cfg dosyasına ensure your-script satırını ekle.
5. Kaynağı başlat ve konsolda hata olup olmadığını kontrol et.

Süreç her script için aynı. Değişen tek kısım yapılandırma.