Event ve state

Kontroller (checks)

Resource'unun telefonun açılmasını ya da bir oyuncu işlemini server tarafında engellemesini sağlayan veto hook'ları.

Kontrol (check), bir işlemi engelleyebilen bir fonksiyondur. AddCheck export'uyla eklersin, RemoveCheck ile kaldırırsın. İkisi de hem client hem server tarafında vardır.

lua-- server
local id = exports['fx-phone']:AddCheck('sendMessage', function(src, conversationId, body)
    if Player(src).state.gagged then return false end
end)

exports['fx-phone']:RemoveCheck(id)

#Kurallar

  • Engellemek için false döndür. Başka her şey, hiçbir şey döndürmemek dahil, işlemin geçmesine izin verir.
  • Hata fırlatan bir kontrol hiçbir zaman engellemez.
  • Bir event'in bütün kontrolleri, biri engelleyene kadar sırayla çalışır.
  • Kontroller, onları ekleyen resource durduğunda kaldırılır.
  • AddCheck kontrolün id'sini döndürür; event adı string değilse ya da fonksiyon verilmemişse nil döndürür.

#Event'ler

Event Taraf Argümanlar Engellendiğinde
openPhone client yok Telefon kapalı kalır. İkinci değer olarak döndürülen bir string oyuncuya bildirim olarak gösterilir
sendMessage server src, conversationId, body İşlem denied ile başarısız olur
createCall server src, number Arama denied ile başarısız olur
transfer server src, targetIdentifier, amount Transfer denied ile başarısız olur
buyCrypto server src, coinId, quantity, cost Satın alma denied ile başarısız olur
createDarkchat server src, tag Kanal oluşturulmaz
post server aşağıya bak Gönderi denied ile başarısız olur
lua-- client: no phone in jail
exports['fx-phone']:AddCheck('openPhone', function()
    if LocalPlayer.state.inJail then return false, 'Phones are not allowed here.' end
end)

#sendMessage

Bir oyuncu Mesajlar'da, Wisp'te, bir sosyal uygulamanın direkt mesajlarında ya da Anon'da mesaj göndermeden önce çalışır. conversationId sohbetin id'sidir; Anon odaları 'anon:<room id>', Anon notları 'anon:notes', Wisp durum paylaşımları ise 'wisp:status' kullanır.

#transfer

Bir banka transferinden önce, sohbet içinde para gönderilmeden ya da istenmeden önce ve FXLive'da ücretli bir hediyeden önce çalışır.

#post

Birkaç uygulama için, iki farklı argüman biçimiyle çalışır:

Uygulama Argümanlar
Chirp, Pixl ve TikKok (Clips) gönderileri src, { app, body, media }
Yeniden paylaşımlar src, { app, repostOf, media }
Yorumlar src, { app, body, comment = true, postId }
Pixl hikâyeleri src, { app, story = true, media }
Pazar Yeri src, 'marketplace', title
Haberler src, 'news', title

#Kontrollerin kapsamadıkları

Kontroller, oyuncuların telefonda yaptıkları için çalışır. Mesaj, banka, kripto ve gönderi export'ları (örneğin SendMessage, AddTransaction, AddCrypto) sistem adına çalışır ve kontrolleri tetiklemez. Arama export'ları istisnadır: CreateCall ve StartVideoCall aramayı oyuncuyla aynı yoldan başlatır, bu yüzden createCall kontrolü onlar için de çalışır.

Export imzaları Diğer (client) ve Diğer (server) sayfalarındadır.