TERA API Update Version 1.2.0

TERA API Güncellemesi
Sürüm 1.2.0

Bu güncelleme ve kurulumu hakkında Rusça bilgi:

İndir:


Genel Değişiklikler

• Oyun istemcisi DataCenters dosyalarından veri doğrudan içe aktarma yeteneği eklendi.
• USA gibi yerelleştirme istemcilerini desteklemek için dil kodlarına genişletilmiş destek eklendi.
• İstemcinin sunucuya otomatik girişini devre dışı bırakma yeteneği eklendi.
• Sunucu erişilebilirliğini belirlemek için port kontrolünü devre dışı bırakma yeteneği eklendi.
• Sunucu listesinde dinamik veri yeniden tanımlama işlevi eklendi (aşağıda bakınız).
• Veritabanı migrasyonu ve otomatik tablo oluşturma için yerleşik bir işlev eklendi.
• API bileşenlerinin ayrı ayrı başlatılabilmesi için yetenek eklendi.
• Portal API web içeriği önbelleğini yönetme yeteneği eklendi.
• İstekleri sınırlamak amacıyla hız sınırları belirleme işlevi eklendi.
• DataCenters'tan içe aktarılan verileri önbelleğe almak için yerleşik bir modül eklendi.
• Periyodik API görevleri için zamanlayıcı modülü eklendi.
• Yapılandırma dosyalarını yüklemek için modül eklendi (varsayılan yapılandırma dosyaları eklendi).
• API bileşenlerinin işlevselliğini genişletmek için eklenti desteği eklendi.
• Belirli IP'lerden API isteklerini engelleme yeteneği eklendi (türler, aralıklar, ülkeler).
• Oyun sunucusu veritabanı (PlanetDB) ile entegrasyon eklendi.
• Oyun işlemleri tarafından tetiklenecek bir işleyici veya işlev belirleme yeteneği eklendi.
• Promo kodu veya VIP öğe etkinleştirildiğinde özel bir işlev belirleme yeteneği eklendi.
• Portal API ve yönetim paneli sunucuları için ters proxy yapılandırma yetenekleri geliştirildi.
• Veritabanı tablolarındaki model ve yapı hataları düzeltildi.
• "dataModel" kategorisindeki tüm SQL modelleri kaldırıldı.
• Kontrolörlerdeki (Express v5) istisna işleme geliştirildi.

Launcher Değişiklikleri

• Launcher'da e-posta ile kayıt onaylama işlevi eklendi.
• Launcher'da e-posta ile şifre sıfırlama işlevi eklendi.
• JSON formatında sunucu listesi desteği eklendi.
• Oyunun ana menüsünde topluluk bağlantıları için URL adresleri atama yeteneği eklendi.
• Oyuna giriş yaptıktan sonra açılan sayfaya URL adresi atama yeteneği eklendi.
• Launcher'da kimlik doğrulama mantığı değiştirildi ve geliştirildi.
• Launcher'da veri doğrulama yöntemlerinde hatalar düzeltildi.
• Launcher'da bildirimlerin görüntülenmesi geliştirildi.
• reCAPTCHA yerine Launcher'da kendi CAPTCHA uygulaması eklendi.
• İç API uç noktalarının ve Launcher için URL'lerin değiştirilmesi.

Ekran Görüntüleri:




TERA Mağazası Değişiklikleri

• TERA Mağazası'nda ürün satın alırken ürün sayısını belirleme yeteneği eklendi.
• TERA Mağazası kullanıcıları ve ürünleri için indirim sistemi eklendi.
• TERA Mağazası'nda ürünler için indirim kuponları sistemi eklendi.
• TERA Mağazası'nda ürünleri hediye olarak alma yeteneği eklendi (karakter adıyla).
• TERA Mağazası'ndaki ürünleri vurgulamak için ek simgeler (etiketler) eklendi.
• Süresi dolmuş promo kodu etkinleştirildiğinde hata mesajı eklendi.
• Bir promo kodu için etkinleştirme sayısını sınırlama yeteneği eklendi.
• TERA Mağazası'na kayıt sırasında başlangıç bakiyesi ayarlama parametresi eklendi.
• Sıfır maliyetle ürün satın alırken TERA Mağazası'ndaki hata düzeltildi.
• TERA Mağazası için iç API uç noktalarının ve URL'lerin değiştirilmesi.

Ekran Görüntüleri:





Admin Paneli Değişiklikleri

• Admin panelinde form gönderildiğinde istek işleme yöntemi değiştirildi.
• API ayarları sayfasına API sürümü ve bileşenler hakkında bilgi görüntüleme yeteneği eklendi.
• Admin panelinden TERA Mağazası hoş geldin sayfası slaytlarını düzenleme işlevi eklendi.
• PlanetDB veritabanıyla karakter listesini senkronize etme işlevi eklendi (sunucu düzenleme sayfasında).
• Bazı admin paneli sayfalarında kullanıcı adı alanı gösterilmesi eklendi.
• Admin panelinde hatırlanan şifreyi koruma işlevi eklendi.
• Launcher aracılığıyla istemci davranışlarını kaydetme işlevi eklendi.
• Gateway API üzerinden yapılan işlemleri kaydetme işlevi eklendi.
• Yönetim kuyruğu görevlerini kaydetme işlevi eklendi.
• Admin panelindeki veri doğrulama yöntemlerinde hatalar düzeltildi.
• Admin panelindeki çeviri hataları düzeltildi.

Ekran Görüntüleri:





Gateway API Değişiklikleri

• Tüm uç noktalarda zaman formatı, Unix Zaman Damgası yerine ISO 8601 formatına değiştirildi.
• Tüm mevcut sunucuların listesini alacak yeni bir uç nokta eklendi.
• Belirtilen sunucu ID'sine göre çevrimiçi hesapların listesini alacak bir uç nokta eklendi.
• Belirli bir hesap ID'si ve sunucu ID'sine göre hesabı kesmek için bir uç nokta eklendi.
• Tüm kayıtlı hesapların listesini almak için bir uç nokta eklendi.
• Hesaba bağlı karakterlerin listesini almak için bir uç nokta eklendi.
• Belirtilen hesap için tüm yararlar listesini almak için bir uç nokta eklendi.
• Yeni bir hesap kaydetmek için uç nokta eklendi.
• Hesaba yarar eklemek için uç nokta eklendi.
• Hesaptan bir yarar kaldırmak için uç nokta eklendi.
• Hesap yasaklamak için uç nokta eklendi.
• Mağaza hesaplarının listesini almak için uç nokta eklendi.
• Kuponların listesini almak için uç nokta eklendi.
• Belirtilen hesap ID'sine göre etkinleştirilen kuponların listesini almak için uç nokta eklendi.
• Etkinleştirilen kuponları almak için uç nokta eklendi.
• Kupon etkinleştirme uç noktasına kuponları eklemek için uç nokta eklendi.
• Kutu listesi almak için uç nokta eklendi.
• Kutu gönderme işlevi eklendi.

Statik İçerik Dosyalarındaki Değişiklikler

• public/launcher ve public/shop dizinindeki görsel, betik ve CSS dosyalarında değişiklikler yapıldı.
• public/launcher/images/flags/en.png bayrak simgesi İngiltere bayrağıyla değiştirildi.
• public/launcher/images/flags/us.png bayrağına ABD bayrağı eklendi.
• public/fontawesome dizinine Font Awesome 5 Free dosyaları eklendi.

Veritabanı Yapısındaki Değişiklikler

• data_item_conversions, data_item_templates, data_item_strings ve data_skill_icons tabloları kaldırıldı.
  Ekli dosyayı görüntüle 499
• Veritabanı sürümleri kontrolü için global_property tablosu eklendi.
• İstemci davranış günlüğünü saklamak için report_launcher tablosu eklendi.
• Gateway API istek günlüğünü saklamak için report_gateway tablosu eklendi.
• TERA Shop'un karşılama sayfasındaki slaytları saklamak için shop_slides tablosu eklendi.
• TERA Shop kuponlarını saklamak için shop_coupons tablosu eklendi.
• Aktivasyonu yapılmış TERA Shop kuponlarına dair bilgileri saklamak için shop_coupon_activated tablosu eklendi.
• account_info tablosundaki email alanı artık benzersiz ve zorunlu hale getirildi.
• account_info tablosundaki authKey alanı artık benzersiz hale getirildi.
• server_info tablosunda tresholdLow alanı thresholdLow ve tresholdMedium alanı thresholdMedium olarak düzeltildi.
• shop_promocode_strings ve shop_category_strings tablosundaki birincil anahtarlar değiştirildi.
• Koşullar sağlandığında, veritabanı yapısındaki tüm değişiklikler artık geçiş (migration) işlemi sırasında otomatik olarak yapılmaktadır.

Sunucu Listesinde Dinamik Veri Yeniden Tanımlama Fonksiyonu:
Bu fonksiyon, istemcinin IP adresine veya diğer koşullara bağlı olarak sunucu IP adresini sunucu listesinde dinamik olarak değiştirmeye olanak tanır. GeoIP desteği sayesinde, kullanıcının bulunduğu ülkeye göre belirli bir sunucu IP adresi verilebilir. Ayrıca, belirli bir sunucu IP adresi sağlamak için IP adresi aralıkları kullanılabilir. Bu özellik, yerel ağdan doğrudan sunucuya erişim sağlamak için faydalı olabilir ve bu sayede Hairpin NAT sistemi kurulmasına gerek kalmaz. Ayrıca, No-IP, DynDNS gibi dinamik DNS hizmetlerini tam olarak destekleme yeteneği de vardır. Bu, yöneticilerin dinamik bir IP adresi kullanarak oyun sunucusunu barındırmalarına olanak sağlar.

Yapılandırma için şu adımları izleyin:

1. config/slsOverride.default.js dosyasını config/slsOverride.js olarak kopyalayın.
2. config/slsOverride.js dosyasındaki gerekli değişiklikleri yapın (dosyada bulunan yapılandırma örneklerine ve yorumlara bakın).
3. GeoIP fonksiyonunu kullanmak istiyorsanız,
   Bağlantıyı görüntüleyebilmek için Giriş Yap ya da Kayıt Ol
   Bu işlem, 15 saniyeden az sürer.
   dosyasını indirip data/geoip dizinine yerleştirin.
4. "GeoLite2-City.mmdb" dosyasını otomatik olarak indirmek ve güncellemek mümkündür. Bu özelliği etkinleştirmek için config/geoip.default.js dosyasını config/geoip.js olarak kopyalayın. Ardından config/geoip.js dosyasını açın ve autoDownload bölümündeki enabled parametresini true olarak ayarlayın.

Güncellemeyi Kurma Adımları:

1. Dosyalar:
   • Güncelleme dosyalarını indirin.
   • src dizinindeki tüm dosyaları, güncellemeden gelen yenileriyle değiştirin.
   • public/fontawesome dizinindeki tüm dosyaları, güncellemeden gelen yenileriyle değiştirin.
   • public/launcher dizinindeki tüm dosyaları, güncellemeden gelen yenileriyle değiştirin.
   • public/shop dizinindeki tüm dosyaları, güncellemeden gelen yenileriyle değiştirin.
   • Güncellemenin config dizinindeki tüm dosyalarını, kendi config dizininize kopyalayın.
   • public/captcha dizinini, güncellemeden gelen public/captcha diziniyle kendi public dizininize kopyalayın.
   • data/captcha-images dizinini, güncellemeden gelen data/captcha-images diziniyle kendi data dizininize kopyalayın.
   • share/data/shop-slides-bg.zip arşivini açın ve data/shop-slides-bg dizinine çıkartın.
   • .env.example, package.json, README.md dosyalarını ve tüm .bat dosyalarını güncelleyin.
   • npm install veya install.bat scriptini çalıştırarak güncellenmiş bağımlılıkları yükleyin.
   • .env dosyasını açın ve aşağıdaki değerleri ekleyin:

• LOG_IP_ADDRESSES_FORWARDED_FOR parametresi kaldırıldığından, artık Portal API için API_PORTAL_TRUSTPROXY_ENABLE ve API_PORTAL_TRUSTPROXY_HOSTS parametrelerini, Admin Paneli için ise ADMIN_PANEL_TRUSTPROXY_ENABLE ve ADMIN_PANEL_TRUSTPROXY_HOSTS parametrelerini kullanmalısınız (parametrelerin yorumlarına .env.example dosyasından bakabilirsiniz). Bu eklenen parametreleri ihtiyacınıza göre yapılandırın.
• Başlatıcı üzerinden şifre sıfırlama (geri yükleme) sistemini kullanmayı planlamıyorsanız, API_PORTAL_LAUNCHER_ENABLE_EMAIL_VERIFY parametresini false olarak ayarlayın. Bu durumda, "MAILER CONFIGURATION" bölümünü ve API_PORTAL_EMAIL_FROM_ADDRESS parametresini ayarlamanız gerekmez. Ancak şifre sıfırlama sistemini kullanacaksanız, SMTP sunucunuzun detaylarını ve mesajların hangi hesap adına gönderileceğini belirtmeniz gerekecek, ayrıca gönderen adresini API_PORTAL_EMAIL_FROM_ADDRESS parametresinde belirtmelisiniz.
• Admin panelindeki yeni bölümlere erişmek için, Steer panelinde ExportSteerData_steeradmin_API.sef dosyasını içeri aktarın.
• Detaylar için README.md dosyasındaki "Steer Sunucu Entegrasyonu" bölümüne başvurun.

DataCenter Dosyaları Yapılandırması:

1. Game client'tan alınan DataCenter dosyalarını (örneğin: DataCenter_Final_EUR.dat, DataCenter_Final_RUS.dat vb.) data/datasheets dizinine yerleştirin.
2. .env dosyasını açın ve aşağıdaki değerleri ekleyin:
   
   
   Spoiler: changes in .env

   
   

   Spoiler içeren içeriği görüntüleyebilmek için Giriş Yap ya da Kayıt Ol
   Bu işlem, 15 saniyeden az sürer.
   • Kullanılan istemci sürümüne bağlı olarak, eklenen parametreleri yapılandırın.
   • Sağlanan Key ve IV değerleri Live-100.02 GF #11 (Gold) oyun sürümü içindir.
   • Diğer Key ve IV değerlerini almak için TeraDataTools aracını kullanabilirsiniz (detaylar için README.md dosyasına bakın).
   • Eğer 32-bit oyun sürümünden bir DataCenter dosyası kullanıyorsanız, DATASHEET_DATACENTER_HAS_PADDING parametresini false olarak ayarlamanız gerekmektedir.

Veritabanı Yapılandırması:

1. Önemli! Mevcut veritabanınızı yedeklemeniz şiddetle tavsiye edilir.
2. account_info tablosundaki email alanı artık benzersiz ve zorunlu olduğu için, bu alanın mevcut veri satırlarınızda doldurulduğundan ve tekrar eden değerler olmadığından emin olun. Gerekirse veriyi manuel olarak düzenlemeniz gerekebilir.
3. data_item_conversions, data_item_strings, data_item_templates, data_skill_icons tablolarını silin. Bu tablolar artık gerekli değildir, çünkü mevcut sürüm, veriyi doğrudan oyun istemcinizin DataCenter'ından alacaktır.
4. İlk başlatmada ve DataCenter verisi değiştirildiğinde, DataCenter'ların sonraki yüklemelerini hızlandırmak için önbellek dosyaları oluşturulacaktır.
5. Otomatik veritabanı geçişini gerçekleştirin; bu işlem ilk başlatmada otomatik olarak yapılacaktır. Bunu yapmak için npm run start_all komutunu çalıştırın veya start_all.bat scriptini çalıştırın.
6. Geçişin hata olmadan geçtiğinden emin olun.
7. Güncellenmiş varlıklar (alternatif tasarım) için Launcher'a ait dosyalar burada bulunabilir: