Client exportları

SIM

Oyuncunun telefonundaki SIM'leri ve GhostNet kartını okuyan client export'ları.

İki SIM yuvasının, SIM kartların ve GhostNet kartının nasıl çalıştığı SIM kartlar sayfasında açıklanır. Server export'ları SIM (server) sayfasındadır.

#HasSim

Telefonda çalışan bir numara olup olmadığını döndürür.

lua---@return boolean hasSim
exports['fx-phone']:HasSim()
luaif not exports['fx-phone']:HasSim() then return end

#GetSimLines

Telefondaki her numarayı SIM yuvasına göre döndürür.

lua---@return { slot: integer, number: string }[] lines
exports['fx-phone']:GetSimLines()
luafor _, line in ipairs(exports['fx-phone']:GetSimLines()) do print(line.slot, line.number) end
  • Hizmet veren her SIM için bir kayıt: tek SIM'de bir, iki hatta iki, hiç yoksa boş bir tablo.
  • GhostNet kartının numarası yoktur ve listelenmez.
  • Config.Sim.Enabled = false olduğunda sonuç, 1. yuvadaki yerleşik numaradır.
  • Bu export server'a sorar ve yanıtı bekler. Her karede çağırma.

#GetSimInfo

Ayarlar > SIM'in bu oyuncunun telefonu hakkında gösterdiği her şeyi döndürür.

lua---@return table|nil info
exports['fx-phone']:GetSimInfo()
lualocal info = exports['fx-phone']:GetSimInfo()
if info and info.sim then print(info.sim.number, info.sim.carrier) end
Alan Değer
enabled Config.Sim.Enabled açık mı
slots { [1] = card, [2] = card }: her yuvada ne olduğu, boş yuva için false
lines GetSimLines ile aynı liste
primary Birincil hattın yuvası (1 ya da 2) veya false
sim Birincil hattın SIM'i: { iccid, number, kind, registered, ownerName, carrier, status, insertedAt, type, slot, primary }. Hiçbir hat çalışmıyorsa takılı ilk SIM. SIM yoksa nil
prefs { calls, texts }: 'primary' ya da 'ask'
emergency String olarak acil durum numaraları
cards Oyuncunun envanterinde olup SIM ekranının listelediği kartlar
esims Oyuncunun kapalı olan kendi eSIM'leri
pending Oyuncunun envanterden kullandığı ama henüz takmadığı kart ya da false
cooldown { slot1, slot2 }: her yuvanın yeni bir SIM kabul etmesine kalan saniye

slots içindeki bir kart şunlardan biridir:

  • SIM: { type = 'line', slot, number, kind, registered, ownerName, carrier, status, iccid, insertedAt, primary }. kind değeri 'physical' ya da 'esim'; status değeri 'active', 'blocked', 'lost' ya da 'inactive' olur. SIM kartlar kapalıyken 1. yuva yerleşik numaradır ve builtin = true taşır.
  • GhostNet kartı: { type = 'ghost', slot, line, carrier, enabled, status, active, activatedAt, expiresAt }.

Bu export server'a sorar ve yanıtı bekler. Her karede çağırma.

#HasSecondSim

GhostNet kartının şu anda çalışıp çalışmadığını döndürür: telefonda takılı, açık ve süresi dolmamış olmalı.

lua---@return boolean active
exports['fx-phone']:HasSecondSim()
luaif exports['fx-phone']:HasSecondSim() then openBlackMarket() end
  • Değer, server'ın güncel tuttuğu yerel bir kopyadan gelir; bu yüzden bu export beklemez.

#GetSecondSim

Hangi yuvada olursa olsun telefondaki GhostNet kartını döndürür.

lua---@return { type: 'ghost', slot: integer, line: string, carrier: string, enabled: boolean, status: 'active'|'expired', active: boolean, activatedAt: integer, expiresAt: integer }|nil sim
exports['fx-phone']:GetSecondSim()
lualocal sim = exports['fx-phone']:GetSecondSim()
if sim then print(sim.slot, sim.expiresAt) end
  • Telefonda GhostNet kartı yoksa nil döner. İki zaman değeri unix saniyesidir.
  • Kart her değiştiğinde fx-phone:sim2:changed client event'i aynı tabloyla (ya da nil ile) tetiklenir. Bkz. Client event'leri.