# FiveM Legacy'ye Kurulum (/tr/docs/enhanced/installing/fivem-legacy)

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](./fivem-enhanced.md). vMenu Enhanced'ın menüleri ve özellikleri her ikisinde de birebir aynıdır.

## Başlamadan önce [#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](../../legacy/index.md) 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 [#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](https://github.com/TomGrobbe/vMenu.RoutingBucketsPlugin), [theme picker](https://github.com/TomGrobbe/vMenu.ThemePicker) ve [custom themes](https://github.com/TomGrobbe/vMenu.CustomThemesPlugin) 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 [#elle-kurulum]

### 1. İndirin ve açın [#1-i̇ndirin-ve-açın]

`vMenu-Enhanced-Legacy-v<version>.zip` dosyasını [son sürümden](https://github.com/TomGrobbe/vMenu/releases/latest) 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.

:::danger[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 [#2-i̇lk-satırları-servercfg-dosyanıza-ekleyin]

```ini
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](https://github.com/TomGrobbe/vMenu/blob/main/docs/src/content/docs../integrations.md) 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:

```ini
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 [#3-i̇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:

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

:::danger[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 [#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ı](../key-bindings.md) sayfasına bakın.

## FiveM Legacy'de Eklentiler [#fivem-legacyde-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](../plugins/csharp.md).
