Keretbeállítás·

Keretrendszer beállítása és munkakörök létrehozása ESX, QBCore és Qbox alatt

Gyakorlati útmutató kezdő FiveM-szervertulajdonosoknak. Telepítsd a keretrendszert, hozd létre a munkaköröket és rangokat, értsd meg a szolgálati állapot és a vezetői jogosultságok működését, majd ellenőrizd, hogy a beállítások mentésre kerülnek.

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.

  1. Nyissa meg a txAdmin és válasszon egy friss recept telepítés egy új szerver adat könyvtárban.
  2. Válassza ki a keret hivatalos receptjét: ESX Legacy, QBCore vagy Qbox.
  3. 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.
  4. 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.
  5. 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ásokGrade kulcsok ebben az útmutatóban
ESX ÖrökségMariaDB: jobs és job_gradesSQL-értékek 0, 1
QBCoreqb-core/shared/jobs.luaStrings: ['0'], ['1']
QboxCommentqbx_core/shared/jobs.luaSzá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:

Check existing jobs
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.

Create the example job
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:

Server console
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.

qb-core/shared/jobs.lua
['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.

qbx_core/shared/jobs.lua
['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:

In-game chat
/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.

SzimptomElső ellenőrzés
Job nem rendelhető elPontos kulcs, meglévő besorolási fokozat és betöltött fogalommeghatározások
Parancs megtagadvaKeretengedélyek és ACE konfiguráció
A forrás nem sikerül a Lua edit utánElső konzolhiba, vessző és fogszabályzó
Helyes munka, de nincs menüMunkahely, konfigurált hely, osztály és a szolgálat
Rossz fizetésOsztá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.