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
falsedö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.
AddCheckkontrolün id'sini döndürür; event adı string değilse ya da fonksiyon verilmemişsenildö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.