FiveM alatt a resource egy önállóan betölthető egység: lehet script, kezelőfelület, jármű vagy térkép. A fájlok bemásolása csak a kezdet; a manifestet, függőségeket, keretrendszert és szükség esetén az adatbázismódosításokat is ellenőrizni kell.
Az alábbi sorrend külön tesztkörnyezetben használható biztonságosan. Éles szerveren egy resource újraindítása játékosokat és folyamatban lévő műveleteket is érinthet, ezért legyen előre egyeztetett időpont és visszaállási terv.
1. Ellenőrizd a letöltést és a függőségeket
- Hivatalos készítőtől vagy engedélyezett terjesztőtől származik-e, és jogosult vagy-e használni?
- Megfelelő-e a játékkiadás, artifact, keretrendszer és a dokumentált kiadás?
- Van-e szükséges adatbázisadapter, könyvtár, inventory vagy más resource?
- Szükséges-e SQL-import, konfigurációmódosítás vagy külön licencaktiválás?
2. Tedd a tényleges resource mappáját a megfelelő helyre
- Készíts mentést az érintett fájlokról és adatbázisról; a SQL-módosítások visszavonása nem mindig egyszerű.
- Bontsd ki a csomagot tesztkörnyezetben. Keresd meg a resource gyökerében a manifestet, rendszerint fxmanifest.lua fájlt.
- A kapott szerveradat-könyvtár resources mappájába a tényleges resource kerüljön, ne a letöltés teljes, többszörösen beágyazott mappája.
- Állítsd be a dokumentált konfigurációt, a titkokat pedig ne tedd megosztott vagy kliensoldali konfigurációba.
- A készítő előírása szerint kezeld a függőségeket és az adatbázissémát. Az éles adatbázis helyett először tesztadatbázist használj.
3. Refresh és ensure: nem ugyanaz a művelet
A szerver konzoljában a refresh újra átvizsgálja a resources könyvtárat. Az ensure elindítja a megadott resource-ot, vagy újraindítja, ha már fut. A sajat_resource csak példanév: a saját, ellenőrzött mappanevedet add meg.
refresh
ensure sajat_resource4. Nem elég, hogy nincs piros hiba
- Olvasd el a resource betöltési naplóját, és ellenőrizd a hiányzó függőségeket.
- Teszteld azt a műveletet, amelyre a script készült, normál játékosfiókkal is.
- Ellenőrizd az adatmentést kilépés és új belépés után, ha a script tartós állapotot kezel.
- Figyeld a teljesítményt és a hibákat ugyanazon teszt mellett a változtatás előtt és után.
5. Tipikus telepítési hibák
| Jelenség | Vizsgálandó ok |
|---|---|
| A resource nem található | Mappanév, beágyazott könyvtár, manifest és refresh. |
| Hiányzó export vagy dependency | A függőség verziója, indítása és betöltési sorrendje. |
| SQL vagy connection hiba | Adapter, hitelesítés, adatbázisséma és a készítő migrációja. |
| Működik adminnal, játékossal nem | Dokumentált jogosultságok és szerveroldali ellenőrzések. |
| Csak újraindítás után hibázik | server.cfg, indítási sorrend és nem mentett konfiguráció. |
