Kurulum
Bu rehber, XDEV Appearance için tam kurulum sürecini açıklar.
Resource hem:
- sıfırdan kurulumları
- hali hazırda başka appearance sistemleri kullanan sunucuları
destekleyecek şekilde tasarlanmıştır.
Gereksinimler
Gerekli bağımlılıklar:
- QBCore
- oxmysql
- ox_lib
Gerekli resource sıralaması:
ensure oxmysql
ensure ox_lib
ensure qb-core
ensure xdev_appearance
Resource Kurulumu
Resource'u sunucunuzun resources klasörüne yerleştirin:
resources/[standalone]/xdev_appearance
Sunucu yapılandırmanıza resource'u ekleyin:
ensure xdev_appearance
SQL Kurulumu
Resource ile birlikte gelen SQL dosyasını içe aktarın.
SQL yapısı şunları destekler:
- sıfırdan kurulumlar
- mevcut Illenium veritabanları
- otomatik veritabanı genişletme sistemi
Kurulum sistemi gerekli olduğunda eksik sütunları otomatik olarak ekler.
Desteklenen genişletmeler:
- tattoo
- peddata
- active
- props
- components
- outfitId
Önerilen Veritabanı Yapısı
Önerilen veritabanı karakter seti:
utf8mb4
Önerilen depolama motoru:
InnoDB
Framework Yapılandırması
Resource varsayılan olarak QBCore için yapılandırılmıştır.
Uyumluluk event sistemleri şunlar için dahildir:
- qb-clothing
- illenium-appearance
Bu uyumluluk eventleri şu dosyada bulunur:
escrow/client/compatibility.lua
Ox Lib
Sistem dahili olarak ox_lib kullanır.
Resource başlamadan önce aşağıdaki satırın mevcut olduğundan emin olun:
@ox_lib/init.lua
Bu satır zaten fxmanifest içerisinde dahil edilmiştir.
Escrow Yapısı
Resource kısmi escrow koruması kullanır.
Düzenlenebilir dosyalar:
shared/*.lua
shared/language/*.lua
shared/data/*.lua
Korunan dosyalar:
escrow/client/*
escrow/server/*
Bu yapı geliştiricilerin:
- config sistemlerini özelleştirmesine
- entegrasyon oluşturmasına
- sistemleri override etmesine
- dil dosyalarını düzenlemesine
izin verirken korunan dahili mantığın açığa çıkmasını engeller.
İlk Başlatma
Resource başlatıldıktan sonra:
- veritabanı tablolarının düzgün oluşturulduğunu doğrulayın
- oxmysql hatası oluşmadığını doğrulayın
- appearance menüsünün düzgün açıldığını doğrulayın
- oyuncu skin verilerinin düzgün kaydedildiğini doğrulayın
- dövme ve kombin sistemlerinin düzgün kaydedildiğini doğrulayın
Önerilen Kontroller
Canlı kullanıma geçmeden önce şunları test edin:
- karakter oluşturma
- kıyafet kayıt/yükleme
- dövme kayıt/yükleme
- kombin kayıt/yükleme
- kombin paylaşım kodları
- reconnect sonrası veri kalıcılığı
- uyumluluk modu
- Illenium format modu