vMenu Docs
Kurulum

FiveM Legacy'ye Kurulum

vMenu Enhanced'ın orijinal GTA V üzerine kurulu normal bir FiveM sunucusuna txAdmin tarifiyle (recipe) veya elle nasıl kurulacağı.

Bu sayfa, orijinal GTA V üzerine kurulu ve bizim FiveM Legacy dediğimiz normal FiveM içindir. Bunun yerine FiveM Enhanced mi kullanıyorsunuz? O zaman aradığınız sayfa FiveM Enhanced'a Kurulum. vMenu Enhanced'ın menüleri ve özellikleri her ikisinde de birebir aynıdır.

Başlamadan önce

  • Bu, orijinal vMenu değildir. Kendi izin adları vardır ve orijinal vMenu'nün kaydettiği hiçbir şeyi okumaz. İkisini asla aynı anda çalıştırmayın. Orijinal vMenu, yani v3.9.2 ve öncesi, artık güncellenmiyor, ancak belgelerine hâlâ buradan ulaşabilirsiniz.
  • Sunucu artifact'larınızı güncel tutun. vMenu, güncelleme denetimleri ve webhook'lar gibi şeyleri küçük bir Node.js yardımcısı üzerinden gönderir; bunun için güncel artifact'larla gelen Node.js 22 sürümü gerekir. Konsolunuz net bridge'in hiç yanıt vermediğini yazıyorsa artifact'larınızı güncelleyin.

Hızlı yol: txAdmin ile

txAdmin, her FiveM sunucusuyla birlikte gelen kontrol panelidir. Onun "tarifleri" (recipe) sizin için tamamen yeni bir sunucu kurar. vMenu tarifi size vMenu Enhanced'ı, hazır izinleri ve ayarları, ayrıca routing buckets, theme picker ve custom themes eklentilerini verir. txAdmin'de oluşturduğunuz yönetici, menünün tamamını hemen kullanabilir.

txAdmin'in kurulum ekranında vMenu tarifini seçin. Listede yoksa "Remote URL Template" seçeneğini seçip şu bağlantıyı yapıştırın; bu bağlantı her zaman en yeni sürümü gösterir:

https://github.com/TomGrobbe/vMenu/releases/latest/download/txadmin-vmenu-legacy-recipe.yaml

Hepsi bu kadar, sayfanın geri kalanını atlayabilirsiniz. txAdmin'in sizin için oluşturduğu server.cfg, eklentilerin izinlerinin nasıl ayarlanacağını açıklar.

Elle kurulum

1. İndirin ve açın

vMenu-Enhanced-Legacy-v<version>.zip dosyasını son sürümden indirin ve resources klasörünüze açın. Burada yalnızca adında "Legacy" geçen zip çalışır. Diğeri başlamayı reddeder ve bunu konsolda size söyler.

Klasör adı önemlidir

Sunucunuz FiveM Enhanced olmasa bile klasörü, büyük harfler dahil, tam olarak vMenu.Enhanced diye adlandırın. Her izin ve ayar adı bu addan türetilir ve vMenu başka bir adla başlamayı reddeder.

2. İlk satırları server.cfg dosyanıza ekleyin

exec @vMenu.Enhanced/config/permissions.cfg
exec @vMenu.Enhanced/config/configuration.cfg
add_filesystem_permission vMenu.Enhanced write vMenu.Enhanced
ensure vMenu.Enhanced

İki exec satırı, bir sonraki adımda oluşturacağınız izinleri ve ayarları yükler. add_filesystem_permission satırı vMenu'nün kendi klasörüne yazmasına izin verir. Üçünün de ensure satırından önce gelmesi gerekir; aksi hâlde kimse menüyü açamaz ve vMenu hiçbir şey kaydedemez.

Rol senkronizasyonlu bir entegrasyon mi kullanıyorsunuz, yani hangi oyuncunun hangi izin grubunda olduğuna entegrasyonunuz mu karar veriyor? O zaman vMenu'nün şu iki satıra da ihtiyacı vardır; örnek permissions.cfg dosyasında bunlar zaten en üsttedir:

add_ace resource.vMenu.Enhanced command.add_principal allow
add_ace resource.vMenu.Enhanced command.remove_principal allow

3. İzin ve ayar dosyalarınızı oluşturun

resources/vMenu.Enhanced/config/ klasörünü açın. permissions.cfg.example ve configuration.cfg.example dosyalarını kopyalayın, kopyaların adlarından .example uzantısını silin. Ardından kopyaları düzenleyin:

  • permissions.cfg, menünün hangi bölümünü kimin kullanabileceğine karar verir. FiveM'in "bu oyuncunun veya grubun bunu yapmasına izin var" deme biçimi olan "ace" izinlerini kullanır.
  • configuration.cfg, vMenu'nün nasıl davranacağına ve nelerin açık olacağına karar verir.

vMenu kopyalarınızı asla değiştirmez. .example dosyaları vMenu her başladığında yeniden yazılır; böylece mevcut tüm izinleri ve ayarları her zaman listelerler. Kopyalarınızı güncel tutmak size kalmıştır: her vMenu güncellemesinden sonra değişiklik günlüğüne (changelog) bakın veya kopyalarınızı .example dosyalarıyla karşılaştırın, istediğiniz yeni izinleri ve ayarları kendiniz ekleyin.

Sadece arkadaşlarınızla mı oynuyorsunuz? permissions.cfg dosyasındaki şu tek satır sizi başlatmaya yeter:

add_ace builtin.everyone "vMenu.Enhanced.Everything" allow

Bu, herkese her şeyi verir

Bu satırı yalnızca rastgele kişilerin katılamayacağı, beyaz listeli (whitelist) bir sunucuda kullanın.

Hazırsınız

Sunucunuzu yeniden başlatın, sunucuya girin ve menüyü açmak için M tuşuna basın. vMenu'nün bir tuşa bağladığı diğer her şey için Tuş Atamaları sayfasına bakın.

FiveM Legacy'de Eklentiler

Lua, JavaScript veya TypeScript ile yazılmış eklentiler, tüm resmî eklentiler dahil, her iki sürümde de çalışır. C# eklentisi için FiveM Legacy'ye göre derlenmiş bir yapı gerekir, bkz. C# kurulumu.

Bu sayfada