Özellikler

Fans (fx-fansapp)

Paketle gelen içerik üreticisi abonelik uygulaması, telefona nasıl kurulduğu ve ana ayarları.

#Nedir

fx-fansapp bir içerik üreticisi ve abonelik uygulamasıdır. İçerik üreticileri içerik paylaşır; diğer oyuncular abone olur, bahşiş verir ve gönderilerin kilidini açar. Her şey oyun içi banka hesabından ödenir.

  • Profil ve içerik üreticisi modu. Uygulamanın, framework girişinden bağımsız, kullanıcı adı ve parolayla kendi girişi vardır. Oturum telefonda Config.SessionHours boyunca tutulur. Avatar, kapak görseli, biyografi ve kategori; tek dokunuşla içerik üreticisi olunur.
  • Gönderiler. Ücretsiz, yalnızca abonelere ya da izleme başına ücretli. Görselli veya videolu metin. Beğenme, yorum yapma, kaydetme, paylaşma, gizleme.
  • Abonelikler. Aylık, ayrıca içerik üreticisinin belirlediği indirimlerle 3, 6 ve 12 aylık paketler. Ücretsiz deneme, promosyon kodları, otomatik yenileme ve istendiği an iptal.
  • Bahşişler ve izleme başına ödeme. Bir gönderiye ya da profile bahşiş verilir. Kilitli gönderiler bir kez ödenir.
  • Özel mesajlar. Ücretsiz, yalnızca abonelere ya da ücretli.
  • Sıralı akış. Puanlama server tarafında yapılır; ağırlıklar config.lua içindedir.
  • İçerik üreticisi stüdyosu. Çekilebilir bakiye, toplam kazanç, her gelir kalemi için bir hesap dökümü, abone listesi ve fiyatlandırma.
  • Moderasyon. Yetkililer uygulamayı açtıklarında moderatör olur: gönderileri silebilir ya da gizleyebilir, banlayabilir, profilleri yönetebilir, rapor kuyruğunu işleyebilir ve denetim kaydını okuyabilir. Her eylem yetki bazında kapatılabilir.
  • Bildirimler. Uygulama içi bir gelen kutusu ve telefon bildirimleri.

#Gereksinimler

Resource Zorunlu
fx-phone Evet (uygulama lb-phone ya da cylex_phone'a da kurulur)
oxmysql Evet
qb-core, qbx_core veya es_extended Biri; otomatik algılanır
ox_lib Yalnızca Qbox'ta
Bir banka resource'u İsteğe bağlı; platform komisyonunu bir şirket hesabına ödemek için
fx-companyapp İsteğe bağlı; komisyonu bir şirket defterine de yansıtır

#Kurulum

cfgensure fx-phone
ensure fx-fansapp

Framework, oxmysql ve telefon bundan önce ensure edilmiş olmalıdır.

  • Veritabanı. İçe aktaracak bir şey yok. Resource her başlangıçta eksik fans_* tablolarını ve sütunlarını oluşturur. Veritabanı kullanıcısının CREATE yetkisi olmalıdır; yoksa setup/sql/install.sql dosyasını elle içe aktar.
  • Parola tuzu. İlk oyuncu kaydolmadan önce config_server.lua içindeki ConfigServer.PasswordSalt değerini kendi rastgele metninle ayarla. Sonradan değiştirmek kayıtlı bütün uygulama parolalarını geçersiz kılar.
  • Yetkililer. Kimin yetkili olduğunu ConfigServer.Admin içinde, framework yetki grubuna ya da identifier listesine göre ayarla.

#Telefona nasıl kaydolur

Config.Phone.Resource = "auto" olduğunda uygulama çalışan telefona kurulur. FX Phone adaptörü (client/phone/fxphone.lua) onu Config.AppIdentifier (varsayılan fans), Config.AppName, Config.AppDeveloper, Config.DefaultApp ve Config.AppPrice kullanarak exports['fx-phone']:AddCustomApp ile kaydeder.

Server tarafında bildirimler exports['fx-phone']:SendNotification üzerinden gider; Config.Phone.BankHistory = true olduğunda ödemeler AddTransaction ile telefonun banka geçmişine yazılır.

Uygulamanın hiç başlamamasını istiyorsan Config.BundledApps içinde ['fx-fansapp'] = false yap. Bkz. Uygulamalar.

#Öne çıkan config ayarları

config.lua her client tarafından indirilir. İçine gizli bilgi koyma.

Ayar Anlamı
Config.AppIdentifier, Config.AppName, Config.DefaultApp, Config.AppPrice Uygulamanın telefonda nasıl göründüğü
Config.Locale tr veya en. Eksik anahtarlar İngilizceye düşer
Config.Framework Algılama yanlış olanı seçmedikçe auto bırak
Config.Theme Başlangıç teması
Config.Account, Config.Currency Hayranların ödeme yaptığı ve içerik üreticilerine ödemenin yapıldığı hesap, para birimi simgesi
Config.PlatformFee Her gelir kaleminden platform payı, 0.00 ile 0.50 arası
Config.FeeSociety nil komisyonu ekonomiden çıkarır; bir string bir şirket hesabını belirtir
Config.Banking Şirket hesabına hangi banka resource'unun ödeme yaptığı
Config.SessionHours, kullanıcı adı ve parola uzunluk sınırları, Config.AllowForgotPassword Hesap kuralları
Config.Pricing İçerik üreticilerinin içinde kalması gereken en düşük ve en yüksek fiyatlar
Config.Bundles Paket süreleri ve indirim üst sınırları
Config.MonthDurationDays Bir abonelik ayının kaç gerçek gün olduğu
Config.AutoRenew, Config.RenewIntervalMinutes Otomatik yenileme ve yenileyicinin ne sıklıkla çalıştığı
Config.Media İzin verilen medya uzantıları ve sınırlar
Config.Feed, Config.Affinity Akış puanlama ağırlıkları
Config.Notify Hangi olayların telefon bildirimi gönderdiği
Config.Categories İçerik üreticisinin seçebileceği etiketler
Config.FeaturedPrice, Config.FeaturedDays, Config.CreatorPrice Öne çıkarma ve içerik üreticisi ücretleri

config_server.lua yalnızca server tarafındadır:

Ayar Amacı
ConfigServer.PasswordSalt Uygulama parolaları için tuz. Kendi değerini ayarla
ConfigServer.Admin Kimin yetkili olduğu (gruplar, identifier'lar), ban davranışı (BanBlocksApp, BanScope) ve eylem bazında yetkiler
ConfigServer.Webhooks Kategori başına Discord log kanalları (admin, economy, account, content, report). Adres yoksa sistem sessiz kalır

#Güvenlik modeli

Resource'un README dosyasından:

  • Para, yetkiler ve fiyatlar server tarafında belirlenir. Client'tan gelen bir tutar, fiyat ya da hedef id asla doğrudan kullanılmaz ve her fiyat Config.Pricing sınırlarına göre kırpılır.
  • Giriş, kayıt, parola sıfırlama, gönderi paylaşma, yorumlar, mesajlar, arama ve raporlar için hız sınırları uygulanır.
  • Kilitli medya, ona sahip olmaması gereken bir client'a asla gönderilmez.
  • Banlar oyuncunun kimliğine bağlıdır; bu yüzden banlanan bir oyuncu yeni bir hesapla yeniden içerik üreticisi olamaz.

#Veritabanı tabloları

fans_profiles, fans_posts, fans_post_likes, fans_bookmarks, fans_post_hides, fans_comments, fans_subs, fans_tips, fans_ppv_unlocks, fans_dms, fans_notifications, fans_earnings, fans_post_seen, fans_affinity, fans_bans, fans_reports, fans_admin_log. Hiçbir framework tablosu değiştirilmez.

#Export'lar

Export Taraf Amacı
GetVersionStatus() Server Güncelleme kontrolünün sonucu: { state, current, latest, behind }

Uygulamanın başka export'u yoktur.