Keretrendszer beállítása és munkakörök létrehozása ESX, QBCore és Qbox alatt
A munkakeret az alapja a FiveM szerver. Mielőtt a garázsok, tabletek vagy vállalkozások, kap karakter létrehozása, az adatbázis és a munkaköri megbízás működik. Ez az útmutató magában foglalja a friss telepítés és egy kis példa munkát ESX Legacy, QBCore vagy Qbox. Kövesse a szakaszt a keret; telepítése mind a három együtt nem része a beállítás.
Kezdőlap tiszta telepítéssel
Készíts egy Cfx.re fiókot, egy szerver regisztrációs kulcsot, egy megfelelő FXServer leletet és egy futó MariaDB szolgáltatást. Használd a kiválasztott keret által támogatott adatbázis verziót; a Qbox kifejezetten MariaDB-öt igényel, és nem támogatja a MySQL-ot vagy a XAMPP-t. A kezelt tárhelyen használd a szolgáltató szerverét és txAdmin vezérlőket. Lásd a hivatalos FiveM szerverbeállítási útmutatót és Qbox követelmények.
- Nyissa meg a txAdmin és válasszon egy friss recept telepítés egy új szerver adat könyvtárban.
- Válassza ki a keret hivatalos receptjét: ESX Legacy, QBCore vagy Qbox.
- Adja meg a szerver kulcsát és javítsa ki a MariaDB kapcsolat adatait. Használjon egy dedikált adatbázis fiókot a szerver adatbázisához való hozzáféréssel.
- Futtassa le a receptet, vizsgálja felül a generált konfigurációt és indítsa el a szervert. Tartsa meg a recept függőségeit és erőforrás sorrendjét.
- Csatlakozzon, hozzon létre egy karaktert, csatlakozzon újra és erősítse meg, hogy a karakter továbbra is betölti, mielőtt hozzáadna más forrásokat.
Receptek letöltési források és futtassa a telepítés SQL. Ne importáljon egy második teljes keret schema után, vagy telepítsen egy új receptet egy meglévő szerver. Hátra mind a fájlokat és adatbázist, mielőtt később változások. A keret-specifikus telepítési lépések, kövesse Az ESX telepítési útmutatója, QBCore-félék Windows útmutató vagy A Qbox telepítési útmutatója.
Értsd meg, mit tartalmaz valójában egy munka
Minden munkakörhöz tartozik egy belső azonosító, egy megjelenített név és több számozott rang. A példákban a(z) sky_example azonosítót, illetve a(z) 0 és 1 rangot használjuk. A keretrendszerben, a munkakör szkriptjében és az integrációkban is ugyanezt az azonosítót add meg. Az „Example Company” a játékosoknak megjelenő név.
| Freme | Általános fogalommeghatározások | Grade kulcsok ebben az útmutatóban |
|---|---|---|
| ESX Örökség | MariaDB: jobs és job_grades | SQL-értékek 0, 1 |
| QBCore | qb-core/shared/jobs.lua | Strings: ['0'], ['1'] |
| QboxComment | qbx_core/shared/jobs.lua | Számok: [0], [1] |
A munka regisztrációja megteremti a keretazonosságát. Játék, garázsok, tároló, főnök menük és üzleti számláknak saját kompatibilis erőforrásokra és konfigurációra van szükségük. A keretmunka nem befejezett vállalkozás. A fenti helyszínek követik a ESX schema, QBCore állások fájl és Qbox állások fájl.
ESX Legacy: hozzon létre munkát a MariaDB
Nyissa meg a szerverre beállított adatbázist, ne egy másik szerver adatbázisát. Először ellenőrizze, hogy a példakulcs már létezik-e:
SELECT name FROM jobs WHERE name = 'sky_example';
SELECT grade FROM job_grades WHERE job_name = 'sky_example';
Csak akkor futtasd a következő beszúrásokat, ha egyik ellenőrzés sem ad vissza sort. Ha a munkakör már létezik, nézd át és szerkeszd a meglévő rekordjait, így elkerülöd a duplikációt.
INSERT INTO jobs (name, label)
VALUES ('sky_example', 'Example Company');
INSERT INTO job_grades
(job_name, grade, name, label, salary, skin_male, skin_female)
VALUES
('sky_example', 0, 'employee', 'Employee', 100, '{}', '{}'),
('sky_example', 1, 'boss', 'Manager', 200, '{}', '{}');
job_name minden osztályt a feladathoz köt. A grade oszlop a besoroláshoz használt rang; a sor automatikus id nem a rang. A fokozatok nélküli munkát figyelmen kívül hagyják. Újratölti a munkakatalógus a szerverkonzolon keresztül:
refreshjobs
Jelenleg ESX Legacy start oxmysql, akkor esx_lib, akkor es_extended; régebbi oktatóanyagok elhagyhatják esx_libTartsa meg a függőségek által biztosított recept. Lásd a jelenlegi recept- konfiguráció valamint munkabetöltés végrehajtása.
Egy esx_society integráció, belső osztálynév boss Az alapértelmezett főnök konfigurációja alapján felismerhető. A látható címke, amely csak a Manager-t tartalmazza, nem ad semmit. A Társaság regisztrációja, könyvelése és függőségi sorrendje továbbra is külön beállítási lépéseket tesz. a társadalom dokumentációja ha a munkaforrásod használja.
QBCore: adj hozzá egy bejegyzést a munkaasztalhoz
Nyitott qb-core/shared/jobs.lua. Helyezze be ezt. a meglévő munkaasztalon belül, a többi munkaköri bejegyzés mellett és a zárószerkezet előtt. Tartsa meg a meglévő táblázat nyilatkozatot és minden meglévő állást; ez egy bejegyzés, nem pedig egy helyettesítő fájl.
['sky_example'] = {
label = 'Example Company',
defaultDuty = false,
offDutyPay = false,
grades = {
['0'] = { name = 'Employee', payment = 100 },
['1'] = { name = 'Manager', payment = 200, isboss = true },
},
},
Tartsa osztályozott billentyűk húrok, beleértve a fokozat nulla. Ellenőrizze vesszők és fogszabályzó körül szomszédos bejegyzések, mentse, majd végre egy tervezett teljes szerver újraindítása így függő források betölteni ugyanazt a meghatározást. FiveM's refresh parancs erőforrást és manifesztet tárol; nem tölt újra futót Lua munkaasztal. Ne hozzon létre ESX- stílus jobs SQL sorok QBCoreEz... a munka meghatározása élő Lua, míg a karakter adatok még használja az adatbázist.
isboss jelöli a menedzser fokozatot; nem ad framework-admin parancs jogosultságokat. A kompatibilis menedzsment erőforrásnak továbbra is biztosítania és beállítania kell a tényleges menüt és annak helyét.
Qbox: saját munkafájl és numerikus fokozatok használata
Nyisd meg ezt a fájlt: qbx_core/shared/jobs.lua. Illeszd ezt a bejegyzést a(z) return { ... } által visszaadott táblába, a záró kapcsos zárójel elé. Hagyd meg a táblában a többi bejegyzést is. A(z) Qbox itt számokat használ rangazonosítóként. A(z) QBCore szöveges kulcsait alakítsd át, mielőtt bemásolod őket.
['sky_example'] = {
label = 'Example Company',
defaultDuty = false,
offDutyPay = false,
grades = {
[0] = { name = 'Employee', payment = 100 },
[1] = { name = 'Manager', payment = 200, isboss = true, bankAuth = true },
},
},
Mentse el és hajtsa végre a tervezett teljes szerver újraindítását. bankAuth külön-külön isboss és használja kompatibilis banki integrációk; sem a zászló nem hoz létre egy fiókot vagy menüpontot. hivatalos Qbox a munka meghatározása.
Qbox magában foglalja a multijob támogatást. Álláshatára, és hogy a /setjob válthatja vagy bővítheti-e a tagságot, konfigurálható. A támogatott tagsági parancsokat több munkahely kezelése során használja; ne feltételezze, hogy a külső QBCore multijob erőforrás kompatibilis. Lásd: Qbox parancsok és multijob konfiguráció.
Jelzés, vizsgálat és újracsatlakozás
Csatlakozz egy tesztkarakterrel olyan fiókból, amely rendelkezik a szükséges keretrendszer- és ACE-parancsjogosultságokkal. Ezeket a txAdmin-bejelentkezés önmagában nem adja meg. Ha a(z) Qbox keretrendszerben aktív a(z) requireOptIn, az adminparancsok előtt használd a(z) /optin parancsot. Az alábbi 1 helyére írd be a csatlakozott tesztkaraktered aktuális szerverazonosítóját. A(z) /job parancs a parancsot kiadó játékos munkakörét jeleníti meg:
/setjob 1 sky_example 0
/job
/setjob 1 sky_example 1
/job
Ellenőrizze, hogy mindkét osztály mutatja a várható munkát és rangot. ESX, QBCore valamint QboxComment; QboxA feltételes bejelentkezési csekk benne van parancsvégrehajtás.
A QBCore és a Qbox esetében ez a példa kiindul a szolgálatból, és letiltja a szolgálaton kívüli fizetést. Használja a telepített munkalehetőséget; nincs univerzális /duty parancs, amit felvehet. A bejelentkezési beállítások azt is befolyásolják, hogy a mentett feladat vagy a defaultDuty nyer. Ezután kapcsolja össze és ellenőrizze a mentett munkát, osztályzatot és a tervezett szolgálati viselkedést.
Mielőtt megnyitja a munkát a játékosok, tesztelje az engedélyeket mindkét fokozattal. Az alkalmazott nem fér hozzá funkciókra fenntartott menedzsment. Várja meg a konfigurált fizetési fizetési intervallumot, ahelyett, hogy a fizetést közvetlenül a kijelölés után; a példa összege a helytartók a gazdaság. Ha egy csekk nem sikerül, olvassa el az első vonatkozó konzol hiba, és oldja meg, mielőtt hozzá egy másik erőforrás.
| Szimptom | Első ellenőrzés |
|---|---|
| Job nem rendelhető el | Pontos kulcs, meglévő besorolási fokozat és betöltött fogalommeghatározások |
| Parancs megtagadva | Keretengedélyek és ACE konfiguráció |
| A forrás nem sikerül a Lua edit után | Első konzolhiba, vessző és fogszabályzó |
| Helyes munka, de nincs menü | Munkahely, konfigurált hely, osztály és a szolgálat |
| Rossz fizetés | Osztályozott fizetés, vámszabályok és bérszámfejtési/számlási konfiguráció |
Kapcsolat Sky munka után
Miután a keretkijelölés működik, kövesse a Sky telepítési útmutatót, és konfigurálja a telepített munkaforrást ugyanazzal a keretkulcsgal és fokozatokkal. Használja a Jobs Base megosztott funkciókat a vonatkozó megosztott beállításokhoz. Csak akkor konfiguráljon egy szolgálaton kívüli munkapárot, ha a kiválasztott Sky setup használ egyet, és hozzon létre mindkét munkát minden szükséges fokozattal.
Utolsó ellenőrzés: 2026. október 25. A fenti források a keretrendszerek hivatalos dokumentációi, karbantartott telepítési receptjei és GitHub-implementációi. Újabb kiadás példáinak alkalmazása előtt ellenőrizd a telepített verziódat.