Kaynağı başlatamazsınız: FiveM neden betiğinizi başlatmıyor

Couldn't start resource X veya FiveM konsolunuzda Failed to start resource? Sıradan nedenler (manifest, klasör adı, Lua hatası, bağımlılık, escrow) ve sizinkini nasıl bulabilirsiniz.

ensure my_script çalıştırırsınız veya sunucuyu başlatırsınız ve konsol yazdırır:

text
Couldn't start resource my_script.

Bu satır yalnızca sonucu söyler. Neden yukarıdaki satırlardadır. Bu rehber sırası kontrol etmeye değer sıradan nedenleri listeler ve nedeni bilmek için konsolu okumanın nasıl yapıldığını gösterir.

Önce yukarıdaki satırları okuyun

Sunucu konsolunda veya txAdmin canlı konsolunda Couldn't start resource kaydırın. Doğrudan yukarıdaki satır neredeyse her zaman nedenidir: eksik bağımlılık, dosya ve satır numarası ile ayrıştırma hatası veya manifest sorunu.

Konsol çok gürültülüyse, sunucuyu durdurun, başlatın ve yalnızca başarısız kaynağı çalıştırın:

text
ensure my_script

Şimdi bu komuttan hemen sonra yazdırılan her şey kaynağa aittir.

1. Kaynak bulunamadı

text
Couldn't find resource my_script.

FiveM resources altında herhangi bir yerde tam olarak my_script adlı bir klasör arar ve bu klasör fxmanifest.lua (veya eski __resource.lua) adlı bir dosya içermelidir. Üç şeyi kontrol edin:

  • server.cfg içindeki ad klasör adıyla harf harf eşleşir. Linux sunucusunda, My_Script ve my_script farklıdır.
  • Manifest dosyası fxmanifest.lua olarak adlandırılır, fxmanifest.lua.txt değil (Windows bilinen uzantıları gizler) ve fxmanifest (1).lua değil.
  • Yeni klasör ekledikten sonra sunucu konsolunda refresh çalıştırın, sonra ensure tekrar. Çalışan sunucu siz yapana kadar yeni klasörleri taramaz.

2. Açıldıktan sonra iç içe geçmiş klasör

Bu, indirilen betiklerle en yaygın hatadır. my_script.zip dosyasını açıp sonunda:

text
resources/
  my_script/
    my_script/
      fxmanifest.lua
      client/
      server/

Manifest bir seviye çok derin, bu nedenle FiveM my_script'ı manifest olmayan düz bir klasör olarak görür. İç klasörü yukarı taşıyın, böylece fxmanifest.lua ensure ettiğiniz klasörün içine doğrudan oturur.

[mic] gibi köşeli ayraç yazılı kategori klasörleri iyidir: FiveM onlara bakar. Başka bir kaynağın içindeki kaynak değil.

3. Yükte Lua söz dizimi hatası

text
Error parsing script @my_script/server/main.lua in resource my_script: @my_script/server/main.lua:42: unexpected symbol near 'end'
Couldn't start resource my_script.

İleti dosya ve satırı adlandırır (main.lua:42). Bu satırı açın ve öncesini de arayın: eksik end, tabloda eksik virgül veya kötü kopyala ve yapıştırdan sapma karakteri. Düzeltin, sonra ensure tekrar.

Söz dizimi hatası gibi görünen ama olmayan iki neden:

  • Betik Lua 5.4 söz dizimini (<const>, <close>, tamsayı bölümü) kullanır ve manifest lua54 'yes' eksik.
  • Dosya farklı kodlama veya BOM ile kaydedildi. BOM olmadan UTF-8 olarak kaydedin.

4. Eksik bağımlılık

text
Could not find dependency ox_lib for resource my_script.
Couldn't start resource my_script.

Manifest sunucunuzda olmayan başka bir kaynağı ister. Kurun ve klasör adını tam tutun. Tam açıklama X kaynağı Y kaynağı için bağımlılık bulamadı içindedir.

5. Manifest hataları

Kötü fxmanifest.lua kaynağı herhangi bir betik çalıştırmadan önce durdurur. Kontrol edin:

lua
fx_version 'cerulean'
game 'gta5'

client_scripts { 'client/*.lua' }
server_scripts { 'server/*.lua' }

Yaygın hatalar: eksik fx_version veya game, { } listesinde girişleri arasında eksik virgül, manifestte olmayan bir dosya yolu ve yanlış eğik çizgi yönü veya yazı tipi olan bir yol. İleri eğik çizgi kullanın. Kaynak yine de __resource.lua gönderirse, bkz. __resource.lua'yı fxmanifest.lua'ya dönüştürme.

6. Escrow, hak ve lisans

Korumalı (escrowed) betikler sunucunuzun lisans anahtarının kıymeti sahip olan Cfx.re hesabına ait olup olmadığını kontrol eder. Yoksa, kaynak başlamayı reddeder ve yukarıdaki satır istenen hakkı eksik olduğunuzu söyler. Bu ayrı bir onarımdır: escrow: Gerekli hakka sahip değilsiniz.

7. Kaynak başlar, sonra başka şekilde başarısız olur

Bazen başlangıç başarılı olur ve başarısızlık bir saniye sonra, betik dosyasında SCRIPT ERROR gibi, çerçeveden nil değeri gibi gelir. Bu artık başlama sorunu değildir. Hata satırını okuyun, dosya ve satır numarasını bulun ve bunu düzeltin. Çerçeve nesnesi nil ise, ESX veya QBCore kılavuzuyla başlayın.

Manifestin test etmesinin hızlı yolu

Temiz bir test kaynağıyla başlayın. resources/test_ok/fxmanifest.lua oluşturun:

lua
fx_version 'cerulean'
game 'gta5'

server_script 'server.lua'

ve resources/test_ok/server.lua:

lua
print('test_ok started')

refresh çalıştırın sonra ensure test_ok. Eğer çalışırsa, sunucunuz ve yollar iyidir ve hata takip ettiğiniz kaynak içindedir.

Kontrol Listesi

Semptom Çözüm
Couldn't find resource my_script. Klasör adı ensure ile farklı veya fxmanifest.lua yok; refresh çalıştırın
Klasör my_script/my_script/ Açılmış bir seviye çok derin; iç klasörü yukarı taşıyın
Error parsing script ... unexpected symbol Gösterilen dosya ve satırda söz dizimi hatası
Could not find dependency Bağımlılığı kurun, tam klasör adı
Başarısız satırın üstünde hiçbir şey ensure tek başına çalıştırın ve sonrasında yazdırılanlı okuyun
Hak veya lisans metni Escrow: lisans anahtarı ve Cfx.re hesabı eşleşmelidir

Kısa yanıtlar

Kaynağı başlatamazsınız ne demek?

FiveM kaynağı buldu ancak başlatırken durdu. Neden asla bu satırda değildir: konsolda tam üstünde yazdırılan bir veya daha fazla satırlarıdır.

Neden Kaynağı bulamadı dedi?

ensure içindeki ad, resources altındaki herhangi bir klasöre uyuşmuyor veya klasörün üst seviyesinde fxmanifest.lua yok. Yazımı ve açılan klasörü kontrol edin.

Lua hatası bir kaynağın başlamaktan durabilir mi?

Evet. Betik dosyasında söz dizimi hatası tüm kaynağın yüklemesini başarısız kılar. Konsol dosya ve hatanın satır numarasını gösterir.

Bu sorunu yaşatmayan scriptler

Item Creator V2Animasyonlar, proplar, efektler ve daha fazlasıyla kullanılabilir eşyalar oluşturun — kod yazmadan.Scripti gör →Shop CreatorBir dakikadan kısa sürede dükkân kurun — sahipler, çalışanlar, kasalar ve soygunlar dahil.Scripti gör →Quest CreatorGörevler ve NPC diyalogları için oyun içinde düğüm düğüm kurulan görsel editör.Scripti gör →

Okumaya devam edin