Uyumluluk

Ahır adaptörleri

Ahırlar uygulamasının atları ve arabaları gum_stables, vorp_stables ya da rsg-horses'tan nasıl okuduğu, her birinin neyi desteklediği ve başka bir ahır script'inin nasıl bağlanacağı.

Ahırlar uygulaması karakterin atlarını ve arabalarını gösterir; bazı ahır script'leriyle aktif atı seçebilir ya da atı çağırabilir. Ahır script'ine framework/frameworks.lua içindeki bir adaptörle (FXStables) ulaşır.

#Desteklenen ahır script'leri

Mod Script Atlar Arabalar Aktif atı seçme Atı çağırma
gum gum_stables (VORP) evet evet varsayılan kapalı hayır
vorp vorp_stables-lua (VORP) evet evet evet hayır
rsg rsg-horses 2.x (RSG) evet rsg-wagons ile evet evet
internal yok hayır hayır hayır hayır
custom senin ne doldurursan
  • gum_stables horses ve wagons tablolarından okunur. Client kodu korumalı olduğu için defter atı çağıramaz. Aktif atı seçmek selected sütununu değiştirir; gum_stables kendi kopyasını bellekte tutabileceği için varsayılan olarak kapalıdır. Ahır adları Gum.StableNames ayarından, yoksa gum_stables/cfg/configCoords.lua dosyasından gelir.
  • vorp_stables stables tablosundan okunur (type = 'horse' ve type = 'cart'). Aktif at değişince defter, vorp_stables'tan listesini yeniden yüklemesini ister (stables:loadRuntime event'i).
  • rsg-horses player_horses tablosundan okunur. At seçmek, rsg-horses'un kendi server event'iyle aynı SQL'i çalıştırır ve rsg-horses:client:horseActivated gönderir. Çağırma, rsg-horses:client:FleeHorse ve rsg-horses:client:SpawnHorse gönderir. Arabalar, rsg-wagons başlamışken player_wagons tablosundan gelir.
  • internal hiçbir ahır script'inin bağlı olmadığı anlamına gelir. Uygulama bunu söyler ve hiçbir şey listelemez.

#Mod nasıl seçilir

apps/stables/config.lua:

luaMode = 'auto', -- auto | vorp | rsg | gum | internal | custom

'auto' şunu seçer:

  1. framework RSG ise ve rsg-horses başlamışsa rsg,
  2. framework VORP ise ve gum_stables başlamışsa gum,
  3. framework VORP ise ve vorp_stables başlamışsa vorp,
  4. aksi halde internal.

#Ayarlar

Anahtar Varsayılan Ne yapar
Mode 'auto' Yukarıya bak
Wagons true Arabalar sekmesini gösterir (yalnızca liste)
ModelLabels {} At modelleri için adlar, { A_C_Horse_Arabian_White = 'Arap Beyaz' }. Yoksa ad modelden üretilir.
WagonLabels {} Araba modelleri için adlar, { cart04 = 'Ciftlik arabasi' }
Gum.AllowSetActive false Defterin gum_stables'ta aktif atı seçmesine izin verir. Açmadan önce oyunda test et.
Gum.StableNames nil { [1] = 'Valentine', ... }; boş: gum_stables'ın config'inden okunur
Vorp.AllowSetActive true Defterin vorp_stables'ın varsayılan atını değiştirmesine izin verir
Rsg.AllowCall true Defterin rsg-horses ile atı çağırmasına izin verir
Rsg.StableNames {} { valentine = 'Valentine Ahiri' }

#Adaptör sözleşmesi

Her adaptör FXStables.Adapters içinde bir tablodur:

Fonksiyon Döndürür Zorunlu
Available() true ya da false, reason evet
List(src, char) { { id, name, model, label, gender, stable, active, health, dead }, ... } evet
Call(src, char, id) true ya da false, reason hayır; script atı çağıramıyorsa hiç yazma
SetActive(src, char, id) true ya da false, reason hayır
AllowCall(), AllowSetActive() boolean hayır; üstteki ikisi için config anahtarı
Wagons(src, char) { { id, name, model, label, stable, active, condition }, ... } hayır; yalnızca liste, script tutuyorsa condition 0 ile 100 arası
  • At ve araba id'leri ahır script'inin kendi sayısal id'leridir.
  • char.id 'vorp:...' ya da 'rsg:...' olur. FXFramework.CharacterKey(char, 'vorp') iki noktadan sonraki kısmı döndürür.
  • Call ve SetActive içinde atın char karakterine ait olduğunu kontrol et. Gelen adaptörler bunu id'yi List içinde arayarak yapar.

#Özel adaptör yazmak

Mode = 'custom' yap ve framework/frameworks.lua içindeki custom adaptörünü doldur. Dosya bu şablonla gelir:

lualocal customStables = {}
FXStables.Adapters.custom = customStables
function customStables.Available()
    -- return GetResourceState('my_stables') == 'started'
    return false, 'Ozel ahir baglantisi yapilmamis.'
end
function customStables.List(src, char)
    -- local rows = MySQL.query.await('SELECT id,name,model,active FROM my_horses WHERE owner=?', { char.id })
    -- return { { id = 1, name = 'Duman', model = 'A_C_Horse_Arabian_White', label = 'Arabian White', active = true } }
    return {}
end
-- The wagons the character owns (read only):
-- function customStables.Wagons(src, char)
--     return { { id = 1, name = 'Yuk arabasi', model = 'cart04', active = true, condition = 90 } }
-- end
-- Remove the comment marks to enable calling / choosing from the book:
-- function customStables.Call(src, char, horseId)
--     TriggerClientEvent('my_stables:client:callHorse', src, horseId)
--     return true
-- end
-- function customStables.SetActive(src, char, horseId)
--     return exports.my_stables:SetActiveHorse(char.id, horseId) == true
-- end

my_stables, tablosu ve event'leri senin kendi script'inin yerine geçer.