FlexHour

A FlexHour luxusóra-rendszer FiveM-re. A játékosok egy butik eladójától vesznek órát, összeállítják, hordják, mutogatják, szervizeltetik és elcserélik. Mellette egy teljes hamisítvány-kereskedelem is fut.

• Kb. 10 000 sor kód
• 23 óramodell és 25 754 lehetséges kombináció
• 14 számozott limitált kiadás
• 708 alkatrészmodell és 399 textúra (256x256)

A csomag két resource: concept_flexhour (a script) és flexhour_boutique (a besétálható butik belső tere). A butiknak saját útmutatója van: FlexHour butik.

Kézbesítés

A FlexHour Cfx Asset Escrow-t használ. A Tebexes fizetés után a resource-ok a Keymasteren jelennek meg a Granted Assets alatt, azon a Cfx.re fiókon, amellyel fizetéskor beléptél.

• A concept_flexhour és a flexhour_boutique ugyanabban a vásárlásban jön, két külön letöltésként. Töltsd le és telepítsd mindkettőt.
• Ne nevezd át a mappákat. Az itemek és más resource-ok concept_flexhour néven hívják a scriptet. Ha átnevezed a mappát, ezt kapod: No such export useBox in resource concept_flexhour.
• A config.lua és a locales/ fájlok szerkeszthetők maradnak. A többi escrow-védett.

Követelmények

Telepítés

1. Tedd a concept_flexhour és a flexhour_boutique mappát a resources mappádba.
2. Add hozzá őket a server.cfg-hez a függőségeik után. A bridge a már futó resource-okból tölti be a moduljait, ezért a frameworköd, az inventoryd és a targeted után indítsd:

ensure ox_lib
ensure oxmysql
ensure your_framework          # es_extended / qb-core / qbx_core / ox_core
ensure ox_inventory            # or your inventory
ensure ox_target               # or your target
ensure concept_bridge
ensure concept_flexhour
ensure flexhour_boutique       # the boutique interior, after concept_flexhour
add_ace group.admin flexhour.admin allow

3. Regisztráld az itemeket (lásd Itemek), és másold át a képeket.
4. Indítsd el a szervert. Az adatbázistáblák automatikusan létrejönnek.
5. Adminként futtasd a /fhmodels parancsot. Kilistázza azokat az óramodelleket, amelyek nincsenek streamelve. Ha a lista üres, a stream/ mappa teljes.

Itemek

Minden óramodell külön item, fh_ néven. Az összeállítás az item metaadatában tárolódik: tokfém, számlap, lünetta, jég, sorozatszám, gravírozás és állapot. Boltok, cserék és más scriptek is kioszthatnak egy adott modellt.

ox_inventory

1. Másold be a docs/ox_items.lua tartalmát (mind a 23 modell) az ox_inventory/data/items.lua fájlba.
2. Add hozzá a dobozt és a replika-készletet:

['flexhour_box'] = {
    label = 'FlexHour Box',
    weight = 450,
    stack = false,
    close = true,
    description = 'Something shiny inside.',
    client = { export = 'concept_flexhour.useBox' },
},
['flexhour_replica_kit'] = {
    label = 'Replica Kit',
    weight = 900,
    stack = true,
    close = true,
    description = 'Blank case, cheap movement, dial stencils, gold plating. Not from any boutique.',
},

3. Másold a web/img/*.png és a web/img/items/*.png fájlokat az ox_inventory/web/images/ mappába. 78 óraikon van: modellenként és tokanyagonként egy, plusz limitált kiadásonként egy. Minden óra a metadata.image mezőn keresztül mutat a saját ikonjára.

qb-stílusú inventoryk

Add hozzá az itemeket a docs/qb_items.lua fájlból (QBCore formátum). A FlexHour induláskor használhatóként regisztrálja őket. Ezeken az inventorykon az item a modell nevét és képét mutatja. Az összeállítás részletei az item info mezőjében és a megtekintő nézetben vannak (I, amíg viseled az órát).

Frameworkök, inventoryk és targetek

A FlexHour a concept_bridge-en keresztül éri el a frameworköt (pénz, azonosító, munkák), az inventoryt, a targetet és az értesítéseket.

Beállítás

A config.lua tartalmaz minden beállítást, amit egy szerver megváltoztathat. Írd át az értéket, és indítsd újra a resource-ot. Ha kihagysz egy beállítást, a FlexHour a gyári alapértékét használja. Ami nem beállítás, azt a config.lua-ból nem lehet felülírni.

Általános

Eladók

A Config.Clerks a butik eladóinak listája. A gyári eladó Vinewoodban áll a_f_y_business_02 modellel, WORLD_HUMAN_STAND_IMPATIENT scenarióval és bliple (sprite 617, szín 46, méret 0.8), és a budget, mid, luxury és mythic szinteket árulja.

Ha a flexhour_boutique fut, az eladója a butik pultja mögött áll. Ez a pozíció a data/clerks.json fájlba mentődik, amely elsőbbséget élvez a config.lua-val szemben. Ha butik nélkül futtatod a FlexHourt, nyisd meg a /fhclerk menüt, és válaszd a Put the config.lua clerks back lehetőséget.

Alkudozás (Config.Negotiate)

Szervizek (Config.Services)

Limitált kiadások (Config.Limited)

A Config.Limited adja meg, hogy az egyes limitált modellekből összesen hány darab létezhet. Lásd: Limitált kiadások.

Viselés (Config.Wear)

Rablás (Config.Wear.rob)

Hamisítványok (Config.Fakes)

A három helyszínt játékon belül a /fhfake dealer, /fhfake workshop vagy /fhfake fence paranccsal teheted le. A letett helyszínek a data/fakes.json fájlba mentődnek, amely elsőbbséget élvez a config.lua-val szemben.

Nyelvek

Minden, amit a játékosok olvasnak, a locales/.json fájlokból jön: értesítések, menük, a bolt oldala (ui_*), az alkudozás kártyái (card_*), az eladó árulkodó jelei (tell_*), és amit az eladók, az orgazda és a díler mondanak (neg_*).

Mellékelt nyelvek: angol (en), magyar (hu), német (de), spanyol (es) és francia (fr). A FlexHour az ox_lib nyelvi beállítását használja. Írd a server.cfg-be:

setr ox:locale "en"   # or "hu", "de", "es", "fr"

Új nyelv hozzáadásához másold az en.json-t .json néven, és fordítsd le az értékeket. Az alkudozás találós kérdései mind az öt nyelven a szerveren vannak. Az órák, anyagok és szíjak nevei terméknevek, nem fordítjuk őket.

Parancsok

Játékosok

Az illesztő gizmo így működik:

• Húzd a piros, zöld és kék fogantyúkat az óra mozgatásához.
• A TAB forgatásra vált, és méretezésre is, ha az allowScale be van kapcsolva.
• Üres területen húzva a kamera körbeforog. Görgetéssel nagyítasz.
• A H áthelyezi az órát a másik csuklóra. Az R visszaállítja.
• Az ENTER menti az illesztést. A BACKSPACE megszakítja.

Adminok (flexhour.admin)

Jogosultságok

Az admin eszközök a Config.AdminAce ACE-t ellenőrzik (alapértelmezés: flexhour.admin):

add_ace group.admin flexhour.admin allow

Mielőtt játékosok csatlakoznak, győződj meg róla, hogy a Config.AdminOpenToAll értéke false. true esetén minden játékos admin: adhatnak maguknak órát, letehetnek eladókat és vitrineket, és az ACE sor semmit sem ér. Amíg be van kapcsolva, a konzol minden indításkor piros figyelmeztetést ír ki.

Funkciók

Vásárlás és a konfigurátor

Az eladó nyitja meg a boltot. A játékos kiválaszt egy modellt, majd a tokfémet, a számlapot, a szíjat és a szíj színét, a lünettát, a mutatókat és a jégszintet. Minden szintnek saját opciói vannak. A játékos TryOnSeconds ideig felpróbálhatja az órát, aztán megveheti, vagy előbb alkudhat. Delivery = 'box' esetén az óra egy flexhour_box dobozban érkezik. A doboz használata kicsomagolási rituálét játszik le a pulton, és a játékos addig tartja a dobozt, amíg az X-szel el nem rakja.

Minden eredeti óra egyedi sorozatszámot kap (FH-…), amely a nyilvántartásba kerül (flexhour_serials).

Alkudozás

Minden eladó minden alkalommal rejtett személyiséget kap, öt vonásból: hiúság, kapzsiság, büszkeség, hűség és idegesség. A testbeszéd utalásokat ad. A játékos kártyákat játszik ki — például Bók, Készpénz, Lealkudás, Blöff, Törzsvásárló, Konkurens, Csomag és Történet —, és vegyes körökön megy végig: az eladó olvasása, találós kérdések és egy memóriajáték. Az eredmény a végső ajánlat. A díler és az orgazda ugyanígy egy utcai paklit használ.

Vitrinek

Az adminok a /fhstand paranccsal tesznek le vitrineket, és a vitrin menüjéből töltik fel minden párnáját. A vitrinek a címkén lévő áron adnak el, amelynek a listaár 70–160%-a között kell lennie, és a készletük korlátlan. A 30 m-en belül lévő vitrinnél az adott eladóval lehet alkudni. Ebben a verzióban a játékosoknak nem lehet saját vitrinjük, és limitált kiadás nem tehető vitrinbe.

Viselés és mutogatás

Egy játékos egyszerre egy órát visel, bármelyik csuklón. A beépített illesztések lefedik a freemode karaktereket. Egyedi pedekhez az adminok ped modellenként mentenek illesztést, a játékosok pedig finomhangolhatják a sajátjukat. A többi játékos közelről látja az órát: élő mutatók, csillanások, és éjjel világító kövek. A játékos műveletei: villantás, megtekintés és ujjhúzás.

Szervizek

Az eladó szíjcserét, újrabevonatot, jegelést, gravírozást, polírozást és eredetiségvizsgálatot kínál. Az eredetiségvizsgálat egy eredeti órának authDays napig érvényes papírokat ad. Replikánál kimutatja, hogy hamisítvány.

Limitált kiadások

14 számozott darab van. Mindegyik rögzített összeállítás, olyan számlappal, kivitellel vagy szíjjal, amilyen egyik szériaórának sem lehet. A szerver korlátozza, hány létezhet, és minden vevő saját számot kap (például „No. 3 / 10”). Ha minden darab elkelt, a kiadás eltűnik a boltból. Az eladók a bolt listájának Limited editions csoportjában árulják őket.

Limitált kiadáson a jegelés, a gravírozás és a polírozás engedélyezett. A szíjcserét és az újrabevonatot elutasítják, hogy a darab eredeti maradjon.

Hamisítványok

A hamisítvány-kereskedelem három lépésben működik:

1. Díler: egy véletlenszerű órához ad el replika-készletet. A készlet dönti el a modellt, a kivitelt, a számlapot és a szíj színét. A játékos alkudhat, de ha bosszantja a dílert, nő az ár.
2. Műhely: a játékos egy rejtett munkapadnál, egy minijátékkal készíti el a másolatot. Ha az eredeti órát használja mintának, jobb lesz a másolat.
3. Orgazda: kérdés nélkül megvesz bármilyen órát. Az ár a minőségtől és az állapottól függ. Egyes eladásokat jelentenek a rendőrségnek.

A replika valódinak tűnik az inventoryban, de a sorozatszáma nincs a nyilvántartásban, és minél gyengébb a minősége, annál több árulkodó jelet mutat: ferde számlapnyomat, elcsúszó idő, akadozó vagy álló másodpercmutató, gyorsabb kopás és átkopó aranybevonat.

Viselt órák

Az alapértelmezett Config.Wear.keepWorn = false mellett az óra mindig inventory item, viselés közben is. A helyén marad, és ami az inventoryval történik, az az órával is: halál utáni törlés, motozás vagy egy másik rablós script.

keepWorn = true esetén az óra felvételekor kikerül az inventoryból, és a FlexHour a flexhour_wrist táblában tartja. Levéve újra item lesz. Viselés közben semmi, ami az inventoryval történik, nem veheti el: halál utáni törlés, elkobzás, motozás, eldobás, stash vagy csomagtartó. Az óra eladásához, elajándékozásához, eltárolásához vagy szervizeltetéséhez a játékosnak előbb le kell vennie a /watch paranccsal.

Ha a keepWorn értékét visszaállítod false-ra, minden karakter a következő belépéskor visszakapja a viselt óráját az inventoryjába.

Rablás

Viselt órát csak egy módon lehet elvenni: a FlexHour rablásával. Egy játékos, aki olyan viselő mellett áll, aki halott, feltartja a kezét vagy bilincsben van, a target opcióval, az [E] felirattal vagy a /stealwatch paranccsal elveheti az órát. Ugyanaz az óra, ugyanazzal a sorozatszámmal kerül a rabló zsebébe. Más resource-ok a flexhour:watchRobbed eseményre reagálhatnak.

A GTA saját órái

A játék ruhamenüi órát tehetnek a bal csuklóra (prop slot 6) vagy karkötőt a jobbra (slot 7). gameWatch = 'hide' esetén a GTA kiegészítő lekerül, amíg FlexHour óra van azon a csuklón. Ha egy ruhamenü ezalatt menti az öltözéket, az a kiegészítő nélkül mentődik. Vagy vedd le a FlexHour órát az öltözék mentése előtt, vagy állítsd a gameWatch értékét 'off'-ra.

Exportok és események

Szerver exportok

-- Give a player a watch. build = { base = '', material = ..., dial = ..., strap = ..., iced = 0 }
-- Only base is required; anything you leave out or set to something invalid falls back to that model's defaults.
-- boxed = true (default) delivers it in a flexhour_box. Returns true, serial.
local ok, serial = exports.concept_flexhour:GiveWatch(source, { base = 'timor_basic' }, true)

-- Release the watch a deleted or banned character was wearing (keepWorn = true).
-- identifier = the character id from your framework (the owner column of flexhour_wrist), or an online player's server id.
-- Returns true, serial, or false when nothing was on that wrist.
local released, serial = exports.concept_flexhour:ReleaseWrist(identifier)

A modell-azonosítókat a shared/catalog.lua fájlban találod (FH.BaseOrder). Az fh_ előtag nélküli itemnév is működik.

Kliens exportok (item használat)

A concept_flexhour.useBox és a concept_flexhour.useWatch azok az item exportok, amelyeket az inventory hív. Neked nem kell meghívnod őket.

Szerver események

AddEventHandler('flexhour:watchRobbed', function(robber, victim, serial, build)
    -- log it, alert the police, ...
end)

Adatbázis

A táblák az első indításkor jönnek létre:

Teljesítmény

A FlexHour csak azt építi meg, amit ténylegesen látsz. A korlátok rögzítettek:

• Más játékosok óráit 40 m-en belül építi meg, egyszerre legfeljebb 40-et.
• Teljes részletesség (számlap, mutatók, jég, lünetta) csak a 18 m-en belüli 12 legközelebbi órán.
• A vitrinórák 40 m-en belül jelennek meg, egyszerre legfeljebb 60.
• A propok kis adagokban (képkockánként 8) jelennek meg, hogy ne legyen akadás.

Hibaelhárítás

Szerverösszeomlás után

Az inventory nem ír minden változást azonnal az adatbázisba, így egy kemény összeomlás néhány percet visszaállíthat.

• ox_inventory: pontosan kezelve. A FlexHour visszavon minden fel- vagy levételt, amit az ox_inventory még nem mentett.
• qb-inventory, ps-inventory, jpr-inventory, lj-inventory: pontosan kezelve. Az inventory minden fel- és levételkor ment.
• Más inventoryk: egy közvetlenül összeomlás előtt felvett vagy levett óra duplikálódhat vagy eltűnhet.

A szervert a txAdminon keresztül állítsd le, ne az ablak bezárásával.

Élesítés előtt

• Ellenőrizd, hogy a Config.AdminOpenToAll értéke false.
• Ellenőrizd, hogy a /fhmodels nem listáz semmit.
• Ellenőrizd, hogy a nyelv be van állítva (setr ox:locale).
• Ha a butikot is futtatod, ellenőrizd, hogy a flexhour_boutique a concept_flexhour után indul.

Támogatás és frissítések

• Discord: discord.gg/HPTZzHHwe6. Nyiss ticketet a frameworköddel, az inventoryddal és a konzol hibájával.
• A frissítések életre szólóan ingyenesek. Az új verziót a Keymasterről töltheted le. Minden kiadás megtalálható a termékoldal Változásnapló fülén.