# Kurulum

Bu kılavuz, arayüzü önceden derlenmiş dağıtım paketini kullanır. Kurulum için Node.js gerekmez ve UI'ı yeniden derlemeniz gerekmez.

## Gereksinimler

| Bileşen | Gerektiği durum |
| --- | --- |
| `oxmysql` ve çalışan bir veritabanı bağlantısı | Kaynak verilerini kaydetmek için zorunludur. |
| Qbox, QBCore veya ESX | Ekonomisini ve izinlerini kullanıyorsanız gerekir. Başka bir ekonomiyi standalone callback'lerle bağlayabilirsiniz. |
| Dövme paketleri | İsteğe bağlıdır. Hiçbir paket kurmayabilir, bazılarını veya hepsini kurabilirsiniz. |
| `ox_lib` | TextUI bildirimi için isteğe bağlıdır; yerel bir alternatif vardır. |
| Görünüm sistemi | Sunucunuz kullanıyorsa [görünüm bridge'ini](https://docs.cxgstudios.com/docs/tr/01-cxg-tattoos/05-integraciones.md#görünüm-ve-karakterin-yüklenmesi) inceleyin. |

Blueprint'ler kodlarla paylaşılır. Dahil edilen yapılandırmayı kullanmak için envantere bir eşya eklemeniz gerekmez.

## Kaynağı yerleştirin

1. Paketi sunucunuzdaki bir kaynak klasörüne çıkarın.
2. Bu kılavuzlarda klasör adı olarak `cxg-tattoos` kullanılır. Klasörünüz farklı adlandırılmışsa `ensure` ve `restart` komutlarında gerçek adını kullanın.
3. Sağlanan dizin yapısını koruyun. Paket dosyalarıyla birlikte `config.lua`, `shared/tattoos.json`, `bridge/` ve `ui/dist/index.html` dosyalarının bulunduğunu doğrulayın.
4. Veritabanı bağlantınızı yapılandırın ve `oxmysql` kaynağının düzgün başlatıldığından emin olun.

## Başlatma sırası

Qbox ve harici paket olmadan kullanım örneği:

```cfg
ensure oxmysql
ensure qbx_core
ensure cxg-tattoos
```

QBCore veya ESX kullanıyorsanız `qbx_core` yerine `qb-core` ya da `es_extended` yazın. Görünüm sistemi kullanıyorsanız, kaynaktan önce başlatın. Standalone kullanımda önce [ödeme ve izin callback'lerini](https://docs.cxgstudios.com/docs/tr/01-cxg-tattoos/05-integraciones.md) yapılandırın.

Paketleriniz varsa yalnızca kurulu olanları kaynaktan önce başlatın. Örneğin:

```cfg
ensure oxmysql
ensure qbx_core
ensure xgc_TattooClasic
ensure xgc_TattooGangs
ensure cxg-tattoos
```

Sahip olmadığınız paketler için `ensure` satırı eklemeyin. Başlatılmamış paketler atlanacağından varsayılan kaynaklar `Config.TattooCatalog.sources` içinde kalabilir.

## İlk başlatma

Kaynak, depolama alanını otomatik olarak hazırlar. Yeni kurulumda şemayı elle içe aktarmanız gerekmez.

Denemeden önce `config.lua` dosyasında şunları inceleyin:

- `Config.Locale`: genel dil.
- `Config.Purchases`: ekonomi ve tahsilat hesapları.
- `Config.Permissions`: yönetici erişimi.
- `Config.Identity`: sunucunun kimlik sistemi ve oyuncu verilerini kaydetmek ve geri almak için kullanılan tanımlayıcı. [Kimlik sistemi](https://docs.cxgstudios.com/docs/tr/01-cxg-tattoos/03-configuracion.md#kimlik-sistemi) bölümüne bakın.
- `Config.Shops`: mağazaların başlangıç konumları.

Yapılandırılmış bir mağazaya gidip etkileşimi kullanın. Kataloğu, bir önizlemeyi ve test karakteriyle yapılan bir satın almayı kontrol edin. Dövmenin korunduğunu doğrulamak için karakteri yeniden yükleyin.

Dahil edilen yönetici komutu `Config.AdminCommand` içinde yapılandırılır; başlangıç adı `/tattooadmin` şeklindedir. Kullanmadan önce [izinler ve ödemeler](https://docs.cxgstudios.com/docs/tr/01-cxg-tattoos/05-integraciones.md) bölümünü inceleyin.

## Değişiklikleri uygulama

`config.lua` veya bir bridge'i değiştirdikten sonra dosyayı kaydedin ve kaynağı yeniden başlatın:

```cfg
restart cxg-tattoos
```

Katalog kaynakları başlangıçta yeniden okunur ve yönetici panelinden eşitlenebilir. Panelden kaydedilen ayarlar korunur; bir dosya değerinin bunların yerini almasını beklemeden önce [yapılandırma](https://docs.cxgstudios.com/docs/tr/01-cxg-tattoos/03-configuracion.md) ve [katalog](https://docs.cxgstudios.com/docs/tr/01-cxg-tattoos/04-catalogo.md) kılavuzlarını inceleyin.

## Sık karşılaşılan sorunlar

| Belirti | Kontrol edilecekler |
| --- | --- |
| Kaynak başlamıyor | `oxmysql` başlatılmış mı, bağlantı çalışıyor mu ve paket eksiksiz mi? |
| Mağazada bir paket eksik | Kaynağı başlatılmış mı, `enabled` değeri `false` değil mi ve JSON yolu pakettekiyle eşleşiyor mu? |
| Arayüz boş görünüyor | `ui/dist/index.html` ile `ui/dist/assets/` içindeki başvurulan dosyalar birlikte kopyalanmış mı? |
| Panel erişimi reddediyor | `Config.AdminCommand.permission`, izin binding'leri ve yapılandırılmış roller veya ACE. |
| Ödeme reddediliyor | Seçilen framework, kaynak adları, bakiye ve varsa standalone callback'ler. |
| Aynı yerde iki dövme etkileşimi var | Başka bir görünüm veya mağaza kaynağında aynı konum etkin mi? Kullanmak istediğiniz mağaza için tek bir erişim noktası bırakın. |
| Mağaza veya seviye değişikliği uygulanmıyor | Panelden kaydedilmiş bir ayar var mı? Etkin değeri panelde düzenleyin. |

Sorunları teşhis etmek için geçici olarak `Config.Debug` ve `Config.Permissions.debug` seçeneklerini etkinleştirebilirsiniz. İşiniz bitince devre dışı bırakın.

[Yapılandırmaya devam edin](https://docs.cxgstudios.com/docs/tr/01-cxg-tattoos/03-configuracion.md).