HU/Resources: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
(35 intermediate revisions by the same user not shown)
Line 1: Line 1:
Resources are a key part of MTA. A resource is essentially a folder or zip file that contains a collection of files - including script files, plus a ''meta'' file that describes how the resource should be loaded. A resource can be seen as being partly equivalent to a program running in an operating system - it can be started and stopped, and multiple resources can run at once. Its worth remember though, that unlike programs on an operating system, there is no multi-tasking between resources.
A resource-k az MTA kulcsfontosságú részei. A resource az tulajdonképpen egy mappa, vagy egy zip fájl, mely fájl gyűjteményeket tartalmaz - tartalmazza a script fájlokat, plusz a ''meta'' fájlt, mely meghatározza, hogy a resource miként legyen betöltve. A resource részben egy operációs rendszeren futó programnak felel meg - ami elindítható, és leállítható, és egyszerre több resource is futhat. Érdemes azonban emlékezni arra, hogy az operációs rendszerektől eltérően egy resource nem képes egyszerre több feladatot is elláítni.


==Terminology==
==Terminology==
* '''Resource''' - A zip file or folder containing a meta.xml file and a number of resource items. These are placed in the ''mods/deathmatch/resources'' folder in the server directory.
* '''Resource''' - Egy zip fájl vagy mappa, mely tartalmazza a meta.xml fájlt és számos resource elemet. Ezek a server könyvtáron belül a ''mods/deathmatch/resources'' mappába találhatóak.
* '''Resource item''' - A file contained within a resource, currently this can be a map, script, images etc.
* '''Resource item''' - A resource-ban lévő fájl, jelenleg ez lehet egy map, script, kép, stb.


==The Meta File==
==A Meta fájl==
''See main article [[Meta.xml]] for details''
''A részletekért látogassa meg a [[HU/Meta.xml]] oldalt''


The Meta file is the core of each the resource. It describes exactly what files in the resource should be used, and how. The following is an example that covers every option there is, your meta files can have as many or as few of these tags as you require:
A Meta fájl minden resource magja. Ez pontosan leírja, hogy milyen fájlokat kell használni a resource-ban, és hogy hogyan. Az alábbiakban egy példát találunk, amely minden lehetséges opcióra kiterjed, a meta fájl tartalmazhat annyi ilyen címkét, amennyire csak szüksége van:


<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
Line 38: Line 38:
</meta>
</meta>
</syntaxhighlight>
</syntaxhighlight>
While a CTF map may have a meta.xml that looks like:
Míg egy CTF map meta.xml fájlja így néz ki:
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<meta>
<meta>
Line 49: Line 49:




Script/type, Config/type and File/type attributes specify if the script/resource should be sent to clients or not, and defaults to "server".
Script/type, Config/type és File/type paraméterek meghatározzák, hogy a script/resource az a cliensnek legyen-e küldve, vagy sem, alapértelmezetten a "server"-nek küldi.


The include tag specifies other resources that should be started before this resoucre is started. In other words, if your resource is dependent on another, you can include it so that the other resource is started first,
Az ''include'' tag megadja egy resource-nak, hogy előbb induljon el, mint egy másik resource. Más szóval, ha egy resource függ egy másiktól resource-től, akkor itt megadhatja, hogy a másik resource induljon el előbb.




Each resource has its own virtual machine (VM). This contains every script in the resource. This means that variables are not shared with other resources.  The best way to communictate with other resources is by using the ''export'' tag and exporting a function. This will enable other resources to fire this function using the [[call]] scripting function.
Minden resourcenak saját virtuális gépe van (VM). Ez tartalmazza a resource összes script-jét. Ez azt jelenti, hogy a változókat nem lehet megosztani egy másik resource-val. A legjobb módja annak, hogy más resource-kkal tudjon kommunkálni, használja az ''export'' tagot, és exportáljon function-t. Ez lehetővé teszi más resource-nak, hogy meghívja ezt a function-t a [[call]] scripting function használatával.




Scripts sent to clients are started as soon as all the scripts have been downloaded.
A cliens-nek küldött scriptek akkor indulnak el, amikor az összes scriptet letöltötte.




Scripts are able to read and write to their own resource folder with functions such as [[xmlCreateFile]] and [[fileCreate]]. They can also read and write to other resources, but must have [[Access_Control_List|ACL]] access.  
A script-ek képesek a saját resource mappájuk olvasására, és írására is az [[xmlCreateFile]] és a [[fileCreate]] függvények segítségével. Más resourcekat is olvashatnak és írhatnak, de rendelkezniük kell [[Access_Control_List | ACL]] hozzáféréssel.




Each resource can only be loaded once, the server will ensure this. If a resource is included more than once, the same instance will be used by each resource that includes it.
Minden resourcet csak egyszer lehet letölteni, ezt a server fogja biztosítani. Ha egy resource többször szerepel, akkor ugyanaz a példa lesz használva minden resource-nál ami tartalmazza.


==File storage==
==Fájl tárolása==
Resource files can either be stored in a zip or a directory. This is located in:
A resource fájlokat tárolhatja zip-ben vagy mappában egyaránt. Ezek itt találhatóak:


server/mods/deathmatch/resources/ (if you've installed your server with the client)
server/mods/deathmatch/resources/ (ha telepítette a server-t a client-el)


or
vagy


mods/deathmatch/resources/ (for dedicated server installations)
mods/deathmatch/resources/ (dedikált szerver telepítésekhez)


Each resource can have a zip file, a directory or both. In the case of both existing, the directory has precedence over the zip file, as such files can be placed in the directory to over-ride the files in the zip file. This allows directories to be used for testing and developing of maps/scripts while zip files used by end-users.
Minden resource tartalmazhat zip fájlt, könyvtárat vagy mindkettőt. Mindkettő létezése esetén a könyvtár elsőbbséget élvez a zip fájlal szemben, ezeket a fájlokat könyvtárba tehetjük, felülírjuk a fájlokat a zip fájlban. Ez engedélyezi a könyvtárak használatát mapok és scriptek tesztelésére, fejlsztésére, míg a zip fájlok a vég felhasználásra.


==Other things to note==
==Egyéb megjegyezni való==
*Resource names can't have dots in.
*Resource névben nem lehetnek pontok.
*If the resource does any file saving, the file names used should not be listed in the meta.xml
*Ha a resource bármilyen fájl mentést végez, akkor a használt fájlneveket nem lehet a meta.xml-ben feltüntetni.
*Files listed in the meta.xml should be considered read only by your scripts. Do not modify them with xmlSaveFile, FileSave etc.
*A meta.xml fájlban feltüntetett ​​fájlokat csak a scriptek olvashatják. Ne módosítja ezeket az xmlSaveFile, FileSave, stb. használatával.
*When making a zip file of your resource, do not include save files. If your resource uses save files, they must be created by your resource when needed.
*Amikor létrehoz egy zip fájlt a resource-ből, az nem tartalmazza a mentéseket. Ha a resource mentett fájlokat használ, akkor azokat szükség esetén a resource-nak kell létrehoznia.
*When making a zip file of your resource, only include files that are listed in the meta.xml. Do not include 'example' save files, otherwise bad things will happen.
*Amikor létrehoz egy zip fájlt a resource-ből, csak a meta.xml-ben feltüntetett fájlokat tartalmazza. Ne tartalmazzon 'example' mentett fájlokat, különben rossz dolgok fognak történni.
*We recommend avoiding spaces and exotic characters from resources names.
*Javasoljuk, hogy a szóköz és a különleges karakterek használatát kerülje a resource nevekből.


==Script functions==
==Script functions==
The resource system can be manipulated by script. As such, the following Serverside scripting functions are provided:
A resource rendszert scriptek segítségével lehet kezelni. A következő Serverside scripting function-ok gondoskodnak erről:
{{Resource functions}}
{{Resource functions hu}}
 
The following events are also provided:
{{Resource_events}}


Mint ahogy a következő event-ek is:
{{Resource_events hu}}


[[en:Resources]]
[[it:Introduzione alle Risorse]]
[[it:Introduzione alle Risorse]]
[[pt-br:Recursos]]
[[pt-br:Recursos]]
[[ru:Resources]]
[[ru:Resources]]
==Fordította==
'''2018.10.01.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

Latest revision as of 18:43, 21 December 2018

A resource-k az MTA kulcsfontosságú részei. A resource az tulajdonképpen egy mappa, vagy egy zip fájl, mely fájl gyűjteményeket tartalmaz - tartalmazza a script fájlokat, plusz a meta fájlt, mely meghatározza, hogy a resource miként legyen betöltve. A resource részben egy operációs rendszeren futó programnak felel meg - ami elindítható, és leállítható, és egyszerre több resource is futhat. Érdemes azonban emlékezni arra, hogy az operációs rendszerektől eltérően egy resource nem képes egyszerre több feladatot is elláítni.

Terminology

  • Resource - Egy zip fájl vagy mappa, mely tartalmazza a meta.xml fájlt és számos resource elemet. Ezek a server könyvtáron belül a mods/deathmatch/resources mappába találhatóak.
  • Resource item - A resource-ban lévő fájl, jelenleg ez lehet egy map, script, kép, stb.

A Meta fájl

A részletekért látogassa meg a HU/Meta.xml oldalt

A Meta fájl minden resource magja. Ez pontosan leírja, hogy milyen fájlokat kell használni a resource-ban, és hogy hogyan. Az alábbiakban egy példát találunk, amely minden lehetséges opcióra kiterjed, a meta fájl tartalmazhat annyi ilyen címkét, amennyire csak szüksége van:

<meta>
    <info author="eAi" description="This is a basic CTF script" version="4"/>

    <include resource="radarblips"/>
    <include resource="markermanagement" />

    <script src="ctf.lua" />
    <script src="flag.lua" />
    <script src="ctf_client.lua" type="client" />

    <file src="model.dff" />
    <file src="quitbutton.png" />
    <file src="killed.png"  />

    <html src="test.htm" default="true"/>
    <html src="logo.png" raw="true" />

    <export function="multiply" http="true" />
    <export function="getPlayerList" />
    <export function="getElementOwner" type="client"/>

    <config src="vehicle-list.xml" type="client" />
    <config src="markerconfig.xml" type="server"  />

    <map src="somestuff.map" dimension="99" />
</meta>

Míg egy CTF map meta.xml fájlja így néz ki:

<meta>
    <include resource="ctf" />
    <map src="myuberl33tctfmap.map" />

    <info author="Tom" instructions="this is uber l33t !!!!!1111111" type="map" />
</meta>


Script/type, Config/type és File/type paraméterek meghatározzák, hogy a script/resource az a cliensnek legyen-e küldve, vagy sem, alapértelmezetten a "server"-nek küldi.

Az include tag megadja egy resource-nak, hogy előbb induljon el, mint egy másik resource. Más szóval, ha egy resource függ egy másiktól resource-től, akkor itt megadhatja, hogy a másik resource induljon el előbb.


Minden resourcenak saját virtuális gépe van (VM). Ez tartalmazza a resource összes script-jét. Ez azt jelenti, hogy a változókat nem lehet megosztani egy másik resource-val. A legjobb módja annak, hogy más resource-kkal tudjon kommunkálni, használja az export tagot, és exportáljon function-t. Ez lehetővé teszi más resource-nak, hogy meghívja ezt a function-t a call scripting function használatával.


A cliens-nek küldött scriptek akkor indulnak el, amikor az összes scriptet letöltötte.


A script-ek képesek a saját resource mappájuk olvasására, és írására is az xmlCreateFile és a fileCreate függvények segítségével. Más resourcekat is olvashatnak és írhatnak, de rendelkezniük kell ACL hozzáféréssel.


Minden resourcet csak egyszer lehet letölteni, ezt a server fogja biztosítani. Ha egy resource többször szerepel, akkor ugyanaz a példa lesz használva minden resource-nál ami tartalmazza.

Fájl tárolása

A resource fájlokat tárolhatja zip-ben vagy mappában egyaránt. Ezek itt találhatóak:

server/mods/deathmatch/resources/ (ha telepítette a server-t a client-el)

vagy

mods/deathmatch/resources/ (dedikált szerver telepítésekhez)

Minden resource tartalmazhat zip fájlt, könyvtárat vagy mindkettőt. Mindkettő létezése esetén a könyvtár elsőbbséget élvez a zip fájlal szemben, ezeket a fájlokat könyvtárba tehetjük, felülírjuk a fájlokat a zip fájlban. Ez engedélyezi a könyvtárak használatát mapok és scriptek tesztelésére, fejlsztésére, míg a zip fájlok a vég felhasználásra.

Egyéb megjegyezni való

  • Resource névben nem lehetnek pontok.
  • Ha a resource bármilyen fájl mentést végez, akkor a használt fájlneveket nem lehet a meta.xml-ben feltüntetni.
  • A meta.xml fájlban feltüntetett ​​fájlokat csak a scriptek olvashatják. Ne módosítja ezeket az xmlSaveFile, FileSave, stb. használatával.
  • Amikor létrehoz egy zip fájlt a resource-ből, az nem tartalmazza a mentéseket. Ha a resource mentett fájlokat használ, akkor azokat szükség esetén a resource-nak kell létrehoznia.
  • Amikor létrehoz egy zip fájlt a resource-ből, csak a meta.xml-ben feltüntetett fájlokat tartalmazza. Ne tartalmazzon 'example' mentett fájlokat, különben rossz dolgok fognak történni.
  • Javasoljuk, hogy a szóköz és a különleges karakterek használatát kerülje a resource nevekből.

Script functions

A resource rendszert scriptek segítségével lehet kezelni. A következő Serverside scripting function-ok gondoskodnak erről:


Mint ahogy a következő event-ek is:

Fordította

2018.10.01. Surge