MTADEV Tudástár

Használható MTA:SA fejlesztői dokumentáció

Gyakorlati leírások Lua, resource struktúra, SQL, biztonság, optimalizálás, moderáció és Discord/web összekötés témákban. Nem csak szöveg: ellenőrzőlisták és másolható példák is vannak.

9 cikk 9 kategória gyakorlati példák
Tudástár / Resource felépítés

Resource struktúra és meta.xml

A rendezett resource sokkal könnyebben telepíthető, moderálható és javítható. Feltöltés előtt mindig ellenőrizd, hogy a resource önállóan érthető-e.

Ajánlott mappaszerkezet

resource-name/
  meta.xml
  README.md
  shared/
    config.lua
  client/
    main.lua
    ui.lua
  server/
    main.lua
    permissions.lua
  assets/
    img/
    sound/
  sql/
    install.sql

Példa meta.xml

<meta>
    <info author="MtaDev" name="Inventory System" version="1.0.0" type="script" />

    <script src="shared/config.lua" type="shared" />
    <script src="server/main.lua" type="server" />
    <script src="client/main.lua" type="client" />
    <script src="client/ui.lua" type="client" />

    <file src="assets/img/background.png" />
</meta>

Mit írj a README-be?

  • Mire való a resource?
  • Milyen MTA verzióval tesztelted?
  • Kell-e SQL import?
  • Kell-e ACL jog?
  • Milyen más resource kell hozzá?
  • Hogyan lehet konfigurálni?
  • Van-e ismert hiba?

Feltöltés előtti checklist

  • Nincs benne jelszó, token, adatbázis hozzáférés.
  • Nincs benne `.env`, `.sql` dump érzékeny adatokkal vagy szerver IP/jelszó.
  • A fájlnevek nem tartalmaznak furcsa karaktereket.
  • A resource neve egyértelmű és nem ütközik alap resource névvel.
  • Van verziószám és changelog.