Server exportları

Tapular ve anahtarlar

Kartlarim'daki mülk tapularını veren, devreden ve silen, vergi satırını değiştiren ve anahtar sahiplerini yöneten server export'ları.

Tapular Kartlarim'daki mülk kâğıtlarıdır: bir ev, bir çiftlik, bir dükkân ya da bir ahır. Bir ev ya da kapı script'i bunları verir ve kapıları kimin açabileceğini sorar. target, dönüş değerleri, nedenler ve izin listesi kuralları Belgeler ile aynıdır.

Tapulara özel ek nedenler:

Neden Ne zaman
invalid_type type, Config.Kartlarim.DeedTypes içinde bir anahtar değil
invalid_name name boş
owner GiveDeedKey ile sahibine anahtar verilmek istendi
exists O karakterin zaten anahtarı var
max_keys GiveDeedKey: tapuda zaten Config.Kartlarim.MaxKeys kadar anahtar sahibi var (varsayılan 8)

#AddDeed

Bir karaktere tapu verir.

lua---@param target integer|string player server id or character id
---@param data table deed fields, see below
---@return integer|false id
---@return string parcelOrReason the parcel number, or the reason
exports['fx-pocketbook']:AddDeed(target, data)
lualocal id, parcel = exports['fx-pocketbook']:AddDeed(source, {
    type = 'ev',
    name = 'Blue house on Main Street',
    place = 'Valentine',
    coords = vector3(-250.1, 680.4, 113.3),
    tax = { cents = 2400, days = 7 },
})
Alan Ne yapar
type Zorunlu. Config.Kartlarim.DeedTypes içinde bir anahtar: varsayılan olarak ev, ciftlik, dukkan, ahir.
name Zorunlu. En fazla 80 karakter.
place Kasaba ya da bölge, en fazla 120 karakter.
parcel Parsel numarası, en fazla 32 karakter. Varsayılan: türün prefix değeri ve dört rakam, örneğin EV-1016.
size Büyüklük yazısı, en fazla 64 karakter.
coords vector3 ya da { x, y, z }. Kartlarim'daki "konumu işaretle" bunu kullanır.
registered Tescil zamanı (unix). Varsayılan: şimdi.
ownerName Sahibin adı, en fazla 120 karakter. Varsayılan: çevrimiçi karakterin adı.
signer İmzanın altındaki ad, en fazla 80 karakter.
role İmzalayanın unvanı, en fazla 64 karakter.
tax { cents, dueAt, days, state }, bkz. SetDeedTax.

#RemoveDeed

Bir tapuyu siler. Anahtarları da onunla birlikte silinir.

lua---@param id integer deed id
---@return boolean|false ok
---@return string? reason
exports['fx-pocketbook']:RemoveDeed(id)
luaexports['fx-pocketbook']:RemoveDeed(7)

#TransferDeed

Tapuyu yeni bir sahibe verir, örneğin bir satıştan sonra.

lua---@param id integer deed id
---@param target integer|string new owner
---@param ownerName? string name on the deed; default the online character's name
---@param keepKeys? boolean false removes every key; anything else keeps them
---@return boolean|false ok
---@return string? reason
exports['fx-pocketbook']:TransferDeed(id, target, ownerName, keepKeys)
luaexports['fx-pocketbook']:TransferDeed(7, buyerSource, nil, false)
  • Yeni sahibin bu tapuda anahtarı varsa o anahtar silinir (sahibin anahtara ihtiyacı yoktur).

#SetDeedTax

Tapudaki vergi satırını değiştirir. Yalnızca gösterilir. Vergiyi tahsil etmek senin script'inin işidir.

lua---@param id integer deed id
---@param tax table { cents, dueAt?, days?, state? }
---@return boolean|false ok
---@return string? reason
exports['fx-pocketbook']:SetDeedTax(id, tax)
luaexports['fx-pocketbook']:SetDeedTax(7, { cents = 2400, days = 7, state = 'due' })
Alan Ne yapar
cents Sent cinsinden tutar.
dueAt Son ödeme zamanı (unix).
days Son ödemeye kalan gün; dueAt verilmezse kullanılır.
state 'paid', 'due' ya da 'none'. Varsayılan: cents 0'dan büyükse 'due', değilse 'none'.

#GiveDeedKey

Bir karaktere tapunun anahtarını verir. Aile, ortak ya da çalışanlar için kullan.

lua---@param id integer deed id
---@param target integer|string key holder
---@param holderName? string name shown in the key list
---@return boolean|false ok
---@return string? reason
exports['fx-pocketbook']:GiveDeedKey(id, target, holderName)
luaexports['fx-pocketbook']:GiveDeedKey(7, 'vorp:31', 'Arthur Morgan')
  • Bir tapuda en fazla Config.Kartlarim.MaxKeys anahtar sahibi olur (varsayılan 8); uygulamadaki sınırın aynısı. Tapuda zaten o kadar varsa false, 'max_keys' döner.

#TakeDeedKey

Anahtarı geri alır.

lua---@param id integer deed id
---@param target integer|string key holder
---@return boolean|false ok
---@return string? reason
exports['fx-pocketbook']:TakeDeedKey(id, target)
luaexports['fx-pocketbook']:TakeDeedKey(7, 'vorp:31')

#GetDeedAccess

Bir karakterin tapunun kapılarını açıp açamayacağını döndürür. Kapı script'leri için yapılmıştır.

lua---@param target integer|string
---@param id integer deed id
---@return string|false access 'owner', 'key' or false
exports['fx-pocketbook']:GetDeedAccess(target, id)
lualocal access = exports['fx-pocketbook']:GetDeedAccess(source, doorDeedId)
if access then UnlockDoor(doorId) end

#GetDeeds

Bir karakterin sahibi olduğu tapuları (en fazla 40) döndürür. Başkalarının tapularındaki anahtarlar dahil değildir.

lua---@param target integer|string
---@return table|false list { { id, type, name, parcel, place }, ... }
exports['fx-pocketbook']:GetDeeds(target)
luafor _, deed in ipairs(exports['fx-pocketbook']:GetDeeds(source) or {}) do
    print(deed.id, deed.name, deed.parcel)
end