HeroHunt App: Kurulum
lb-phone için hero toplama uygulamasını birkaç dakikada sunucunda çalışır hâle getir; ortak dünya spawnları ilk başlatmadan itibaren hazır.
Başlamadan önce
OneSync'in açık olduğundan ve sunucu artifact'inin güncel olduğundan emin ol. Script framework'ünü kendisi tespit eder, veritabanı tablolarını ilk başlatmada kendisi oluşturur ve kendini lb-phone'a özel uygulama olarak ekler.
Gereksinimler
| Kaynak | Gerekli | Not |
|---|---|---|
| lb-phone | Evet | Uygulama, haritası ve bildirimleri telefonun içinde çalışır |
| ox_lib | Evet | Callback'ler, komutlar ve diller |
| oxmysql | Evet | Koleksiyonlar, spawnlar, görevler ve Candy geçmişi SQL'de tutulur |
| OneSync | Evet | Sunucu her yakalamayı doğrulamak için oyuncu konumlarını okur |
| qbx_core / qb-core / es_extended | İsteğe bağlı | Otomatik seçilir. Hiçbiri yoksa script standalone çalışır |
İndirme bağlantıları ve başlatma sırası için Bağımlılıklar sayfasına bak.
Kurulum adımları
Kaynağı indir
En güncel sürümü portal.cfx.re'den indir. Bkz. Satın alımı indir.
Klasör adını değiştirme
Klasörün adını hype-herohunt-app olarak bırak. Uygulama arayüzünü, hero görsellerini ve event'lerini bu isim
üzerinden yükler.
Veritabanı
Çoğu durumda bir şey yapmana gerek yok. Script her başlatmada sql/install.sql dosyasını çalıştırır ve eksik tabloları
oluşturur:
| Tablo | İçerik |
|---|---|
hero_player_data | Her koleksiyonun Candy bakiyesi ve toplamları |
hero_discoveries | Her heronun koleksiyon başına ilk yakalanışı |
hero_inventory | Hero başına kopya, toplam yakalama ve dönüşüm sayıları |
hero_world_spawns | Konumu, bölgesi ve durumuyla her dünya spawnı |
hero_tasks | Her başlatmada config/tasks.lua dosyasından eşitlenen görev tanımları |
hero_player_tasks | Periyot başına görev ilerlemesi, tamamlanma ve ödül alma |
hero_transactions | Candy geçmişi olarak gösterilen her yakalama, dönüşüm ve görev ödülü |
Konsolda Database setup failed, the resource will not run yazıyorsa veritabanı kullanıcının CREATE yetkisi
olmayabilir. sql/install.sql dosyasını bir kez elle çalıştır. MySQL 5.7+ veya MariaDB 10.3+ gerekir.
Kaynağı başlat
server.cfg dosyasına oxmysql, ox_lib, framework'ün ve lb-phone'dan sonra ekle.
ensure oxmysql
ensure ox_lib
ensure qbx_core # veya qb-core / es_extended, standalone için bu satırı ekleme
ensure lb-phone
# HypeScripts
ensure hype-herohunt-appTemel ayarları yap
config/config.lua dosyasını aç ve en azından Ownership, App, Discovery, Spawn ve Rarities ayarlarını
kontrol et. Herolar config/heroes.lua, görevler config/tasks.lua dosyasındadır. Tüm seçenekler için
Ayarlar sayfasına bak.
Başlatma sırası önemli
Framework = "auto" iken henüz başlamamış bir framework tespit edilemez. Script bu durumda standalone çalışır ve
koleksiyonları karakter yerine Rockstar lisansına göre kaydeder. ensure hype-herohunt-app satırını framework'ünün
altında tut. lb-phone sonradan yeniden başlarsa uygulama telefona kendiliğinden tekrar eklenir.
Kontrol et
Config'te Debug = true yap ve sunucuyu başlat. Konsolda şu satırları ara:
[DEBUG:SERVER] [INFO] Framework detected: qbx_core
[DEBUG:SERVER] [INFO] Ownership: character
[DEBUG:SERVER] [INFO] 0 active spawn(s) restored
[hype-herohunt-app] Ready: 50 heroes, 26 tasks, 0 active spawns
[DEBUG:CLIENT] [SUCCESS] lb-phone app added (hype-herohunt)Ready satırı Debug kapalıyken de yazılır.
Telefonu aç. HeroHunt uygulamasını App Store'dan yükle (App.defaultApp = true ise ana ekranda hazır gelir) ve
Harita sekmesini aç. Bir daire keşif alanını gösterir.
Herolar Spawn.SpawnIntervalSeconds (varsayılan: 30 saniye) içinde etrafında çıkar. Hemen test etmek için yönetici
olarak /herospawn random 5 komutunu kullan. Bkz. Komutlar.
Dairenin içindeki bir heroya dokun ve Yakala butonuna bas. Hero koleksiyonuna eklenir ve Candy kazanırsın. Her şey
çalışıyorsa Debug = false yapmayı unutma.
Nasıl çalışır
- Ortak spawnlar: herolar sunucuda, her oyuncu için aynı noktada çıkar; yakınında
Spawn.TargetPerPlayersayısından az hero olan oyuncuların etrafında oluşur. Her spawn yalnızca bir kez yakalanabilir veSpawn.DespawnAfterSecondssonra kaybolur. Aktif spawnlar kaynak yeniden başlasa da korunur. - Zemin kontrolü: her spawn noktası görünmeden önce yakındaki bir oyuncunun oyununda test edilir: zemin yüksekliği, navmesh, su, iç mekânlar, yakındaki araçlar ve yükseklik sınırları. Kara listedeki bölgelerdeki noktalar atlanır.
- Keşif haritası: Harita sekmesi oyuncuyu ve
Discovery.Radiusmetrelik bir daireyi gösterir. Dairenin içindeki herolar yakalanabilir.Discovery.PreviewRadiusmesafesine kadarki herolar soluk görünür, böylece oyuncu nereye yürüyeceğini bilir. Konumlar sadece uygulama ekranda açıkken aktarılır. - Yakalama: sunucu oyuncunun gerçek konumunu, routing bucket'ını ve kalan deneme hakkını kontrol eder. Hero, yakalama şansına göre kurtulabilir. Heroyu ilk yakalayan alır; diğerleri başkasının yakaladığını görür.
- Koleksiyon: keşfedilmemiş herolar ilk kez yakalanana kadar silüet olarak görünür. Her hero kopya sayısını, toplam yakalamayı, Candy değerini ve keşif tarihini gösterir.
- Candy: her yakalama nadirliğe göre Candy verir. Fazla kopyalar Koleksiyon veya Candy sekmesinden Candy'ye dönüştürülebilir. Candy sekmesi bakiyeyi ve tüm hareket geçmişini gösterir.
- Görevler: günlük ve haftalık görevler bir havuzdan seçilir, tüm oyuncular için aynıdır ve
Tasks.ResetHoursaatinde yenilenir. Genel görevler kalıcı hedeflerdir. Tamamlanan görevler telefon bildirimi gönderir, ödül Görevler sekmesinden alınır. - Profil: koleksiyon tamamlanma oranı, toplam yakalama, keşfedilen herolar, en nadir hero, Candy bakiyesi, dönüşümler ve tamamlanan görevler.
Spawn durumları
| Durum | Anlamı |
|---|---|
active | Dünyada ve yakalanabilir |
captured | Bir oyuncu yakaladı, captured_by koleksiyonu tutar |
expired | Süresi doldu, /heroclear ile temizlendi veya herosu kapatıldı |
active olmayan kayıtlar History.KeepSpawnHistoryDays gün sonra silinir.