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.MaxKeysanahtar sahibi olur (varsayılan8); uygulamadaki sınırın aynısı. Tapuda zaten o kadar varsafalse, '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