Multi Theft Auto: Wiki - User contributions [en]

HU/executeBrowserJavascript

2023-01-13T01:46:09Z

Surge: /* SLásd még */

__NOTOC__
{{Client function hu}}
{{New feature/item|3.0150|1.5||
Ez a függvény végrehajt egy Javascript stringet a megadott [[Element/Browser|böngészőhöz]]. Csak helyi böngészőkkel működik.
}}

==Szintaxis==
<syntaxhighlight lang="lua">
bool executeBrowserJavascript ( browser webBrowser, string jsCode )
</syntaxhighlight>
{{OOP||[[Element/Browser|browser]]:executeJavascript}}

===Kötelező argumentumok===
*'''webBrowser:''' A webböngésző, amely végrehajtja a Javascript kódot
*'''jsCode:''' A Javascript kódszöveg

===Visszaadott érték===
Visszaad egy ''true'' értéket, ha a Javascript végrehajtása megengedett az aktuális környezetben, egyébként ''false''.

==Példa==
Ez a példa azt mutatja, hogyan jelenítheti meg a helyi játékos nevét a weboldalon.
<syntaxhighlight lang="lua">
local browser = guiGetBrowser(guiCreateBrowser(200, 200, 400, 200, true, false, false))

addEventHandler("onClientBrowserCreated", browser,
function ()
loadBrowserURL(source, "http://mta/local/example.html") --Containing <span id="nick"></span> somewhere in the file
end)

--The page has to load first
addEventHandler("onClientBrowserDocumentReady", browser,
function ()
executeBrowserJavascript(source, "document.getElementById('nick').innerHTML = '" .. getPlayerName(localPlayer) .. "'");
end)
</syntaxhighlight>

==Lásd még==
{{CEF_functions hu}}

[[en:executeBrowserJavascript]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/executeBrowserJavascript

2023-01-13T01:45:34Z

Surge:

__NOTOC__
{{Client function hu}}
{{New feature/item|3.0150|1.5||
Ez a függvény végrehajt egy Javascript stringet a megadott [[Element/Browser|böngészőhöz]]. Csak helyi böngészőkkel működik.
}}

==Szintaxis==
<syntaxhighlight lang="lua">
bool executeBrowserJavascript ( browser webBrowser, string jsCode )
</syntaxhighlight>
{{OOP||[[Element/Browser|browser]]:executeJavascript}}

===Kötelező argumentumok===
*'''webBrowser:''' A webböngésző, amely végrehajtja a Javascript kódot
*'''jsCode:''' A Javascript kódszöveg

===Visszaadott érték===
Visszaad egy ''true'' értéket, ha a Javascript végrehajtása megengedett az aktuális környezetben, egyébként ''false''.

==Példa==
Ez a példa azt mutatja, hogyan jelenítheti meg a helyi játékos nevét a weboldalon.
<syntaxhighlight lang="lua">
local browser = guiGetBrowser(guiCreateBrowser(200, 200, 400, 200, true, false, false))

addEventHandler("onClientBrowserCreated", browser,
function ()
loadBrowserURL(source, "http://mta/local/example.html") --Containing <span id="nick"></span> somewhere in the file
end)

--The page has to load first
addEventHandler("onClientBrowserDocumentReady", browser,
function ()
executeBrowserJavascript(source, "document.getElementById('nick').innerHTML = '" .. getPlayerName(localPlayer) .. "'");
end)
</syntaxhighlight>

==SLásd még==
{{CEF_functions hu}}

[[en:executeBrowserJavascript]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/Element/Collision shape

2021-12-15T19:43:09Z

Surge:

__NOTOC__
A collision shape osztály a GTA-világban a létrehozható láthatatlan collision formákat jelenti. A Collision formákat általában a fizikai személyek azonosítására használják, hogy különféle események történjenek, miután áthaladtunk rajtuk.

Az osztály elemtípusa a '''colshape'''.

==XML szintaxis==
<syntaxhighlight lang="xml">
<colcube posX="1024.768" posY="1248.1024" posZ="800.600" width="100" height="100" depth="100"/>
<colsphere posX="1024.768" posY="1248.1024" posZ="800.600" radius="100"/>
<coltube posX="1024.768" posY="1248.1024" posZ="800.600" radius="30" height="15"/>
<colrectangle posX="1024.768" posY="1248.1024" posZ="800.600" width="100" depth="61.8"/>
<colcircle posX="1024.768" posY="1248.1024" posZ="800.600" radius="30"/>
</syntaxhighlight>

===Kötelező paraméterek===
* '''posX''': A colshape X koordinátáját ábrázoló lebegőpontos szám.
* '''posY''': A colshape Y koordinátáját ábrázoló lebegőpontos szám.
* '''posZ''': A colshape Z koordinátáját ábrázoló lebegőpontos szám.
* '''radius''': A colshape sugara (spheres, tubes and circles only).
* '''width''': A colshape szélesség (rectangles and cubes only).
* '''depth''': A colshape mélysége (rectangles and cubes only).
* '''height''': A colshape magassága (cubes only).

===Tetszőleges paraméterek===
* '''dimension''': A dimenzió amiben a colshape benne van

==Related scripting functions==
{{Collision shape functions hu}}
[[Category:Element Types]]

[[en:Element/Collision shape]]
[[ru:Element/Collision shape]]
[[hu:Element/Collision shape]]
[[it:Elemento/Collision shape]]

==Fordította==
'''2018.12.07.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

HU/playSound3D

2021-09-19T22:17:14Z

Surge: /* Visszaadott értéks */

__NOTOC__
{{Client function hu}}
Létrehoz egy [[sound|hang]] [[element|elemet]] a GTA világban, majd rögtön azután le is játssza azt a játékosnak. A [[setElementPosition]]-t használhatjuk a hangelem mozgatásához azután, hogy létrehoztuk. Ne felejtse el használni a [[setElementDimension]]-t a hangelem lejátszásához a 0-adik dimenzión kívül is.<br />
<br />
{{Note_hu|
*Támogatott audió formátumok: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M and PLS.
*Teljesítményi okokból, mikor a playSound-ot használjuk egy effekt többszöri lejátszásánál (pl. fegyver lövés), javasoljuk, hogy az audiófájlokat egycsatornás WaV-ba konvertálja (mono), 22050-Hz, vagy kisebb mintavételi frekvenciával. Valamint érdemes hozzáadni egy limitet, ami szabályozza az effekt lejátszási gyakoriságát.}}
==Szintaxis==
<syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false ] )</syntaxhighlight>
<syntaxhighlight lang="lua">element playSound3D ( string soundURL, float x, float y, float z, [ bool looped = false, bool throttled = true ] )</syntaxhighlight>
{{OOP||[[Sound|Sound3D]]}}
===Kötelező argumentumok===
*'''soundPath:''' a lejátszani kívánt hang [[filepath|elérési helye]]. (A hangfájlt elő kell definiálni a [[meta.xml]] fájlban, <file /> taggel. És az [[filepath|elérési hely]] helyett az URL cím is használható )
*'''soundURL:''' az URL. (Ebben a verzióban a fájlt nem kell elő definiálni a [[meta.xml]]-ben )
*'''x:''' A térképen az X koordinátát ábrázoló [[float|lebegőpontos]] szám.
*'''y:''' A térképen az Y koordinátát ábrázoló [[float|lebegőpontos]] szám.
*'''z:''' A térképen a Z koordinátát ábrázoló [[float|lebegőpontos]] szám.

===Tetszőleges paraméterek===
{{OptionalArg hu}}

*'''looped:''' A [[boolean]] visszadja, hogy a hang ismétlődni fog-e. A hang ismétlésére használja a ''true''-t..
{{New feature/item|3.0150|1.5||
*'''throttled:''' A [[boolean]] visszadja, hogy a hang szabályozva lesz-e (pl. csökkentett letöltési sávszélességgel). A hang szabályozásához használja a "true" parancsot..
}}

===Visszatérési érték===
Visszaad egy [[sound|hang]][[element|elemet]], ha a hang sikeresen létre lett hozva, egyébként ''hamis''.

==Példa==
Ez a példa egy ismétlődő hangot hoz létre a pizza boltban.
<section name="Example" class="client" show="true">
<syntaxhighlight lang="lua">
function onResourceStart()
local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)
end
addEventHandler("onClientResourceStart", resourceRoot, onResourceStart)
</syntaxhighlight>
</section>
Ez a példa egy internetes rádiót játszik le a groove utcán.
<section name="Example 2" class="client" show="true" >
<syntaxhighlight lang="lua">
addEventHandler( 'onClientResourceStart', resourceRoot,
function( )
local uSound = playSound3D( 'http://193.34.51.25:80', 2498, -1659, 12 )
setSoundMaxDistance( uSound, 100 )
end
)
</syntaxhighlight>
</section>

==Lásd még==
{{Client_audio_functions hu}}
[[en:playSound3D]]
[[AR:playSound3D]]
[[DE:playSound3D]]
[[RU:playSound3D]]
[[PT-BR:playSound3D]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/playSound3D

2021-09-19T22:14:30Z

Surge:

__NOTOC__
{{Client function hu}}
Létrehoz egy [[sound|hang]] [[element|elemet]] a GTA világban, majd rögtön azután le is játssza azt a játékosnak. A [[setElementPosition]]-t használhatjuk a hangelem mozgatásához azután, hogy létrehoztuk. Ne felejtse el használni a [[setElementDimension]]-t a hangelem lejátszásához a 0-adik dimenzión kívül is.<br />
<br />
{{Note_hu|
*Támogatott audió formátumok: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M and PLS.
*Teljesítményi okokból, mikor a playSound-ot használjuk egy effekt többszöri lejátszásánál (pl. fegyver lövés), javasoljuk, hogy az audiófájlokat egycsatornás WaV-ba konvertálja (mono), 22050-Hz, vagy kisebb mintavételi frekvenciával. Valamint érdemes hozzáadni egy limitet, ami szabályozza az effekt lejátszási gyakoriságát.}}
==Szintaxis==
<syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false ] )</syntaxhighlight>
<syntaxhighlight lang="lua">element playSound3D ( string soundURL, float x, float y, float z, [ bool looped = false, bool throttled = true ] )</syntaxhighlight>
{{OOP||[[Sound|Sound3D]]}}
===Kötelező argumentumok===
*'''soundPath:''' a lejátszani kívánt hang [[filepath|elérési helye]]. (A hangfájlt elő kell definiálni a [[meta.xml]] fájlban, <file /> taggel. És az [[filepath|elérési hely]] helyett az URL cím is használható )
*'''soundURL:''' az URL. (Ebben a verzióban a fájlt nem kell elő definiálni a [[meta.xml]]-ben )
*'''x:''' A térképen az X koordinátát ábrázoló [[float|lebegőpontos]] szám.
*'''y:''' A térképen az Y koordinátát ábrázoló [[float|lebegőpontos]] szám.
*'''z:''' A térképen a Z koordinátát ábrázoló [[float|lebegőpontos]] szám.

===Tetszőleges paraméterek===
{{OptionalArg hu}}

*'''looped:''' A [[boolean]] visszadja, hogy a hang ismétlődni fog-e. A hang ismétlésére használja a ''true''-t..
{{New feature/item|3.0150|1.5||
*'''throttled:''' A [[boolean]] visszadja, hogy a hang szabályozva lesz-e (pl. csökkentett letöltési sávszélességgel). A hang szabályozásához használja a "true" parancsot..
}}

===Visszaadott értéks===
Visszaad egy [[sound|hang]][[element|elemet]], ha a hang sikeresen létre lett hozva, egyébként ''hamis''.

==Példa==
Ez a példa egy ismétlődő hangot hoz létre a pizza boltban.
<section name="Example" class="client" show="true">
<syntaxhighlight lang="lua">
function onResourceStart()
local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)
end
addEventHandler("onClientResourceStart", resourceRoot, onResourceStart)
</syntaxhighlight>
</section>
Ez a példa egy internetes rádiót játszik le a groove utcán.
<section name="Example 2" class="client" show="true" >
<syntaxhighlight lang="lua">
addEventHandler( 'onClientResourceStart', resourceRoot,
function( )
local uSound = playSound3D( 'http://193.34.51.25:80', 2498, -1659, 12 )
setSoundMaxDistance( uSound, 100 )
end
)
</syntaxhighlight>
</section>

==Lásd még==
{{Client_audio_functions hu}}
[[en:playSound3D]]
[[AR:playSound3D]]
[[DE:playSound3D]]
[[RU:playSound3D]]
[[PT-BR:playSound3D]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/playSound3D

2021-09-19T22:13:51Z

Surge:

__NOTOC__
{{Client function hu}}
Létrehoz egy [[sound|hang]] [[element|elemet]] a GTA világban, majd rögtön azután le is játssza azt a játékosnak. A [[setElementPosition]]-t használhatjuk a hangelem mozgatásához azután, hogy létrehoztuk. Ne felejtse el használni a [[setElementDimension]]-t a hang elem lejátszásához a 0-adik dimenzión kívül is.<br />
<br />
{{Note_hu|
*Támogatott audió formátumok: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M and PLS.
*Teljesítményi okokból, mikor a playSound-ot használjuk egy effekt többszöri lejátszásánál (pl. fegyver lövés), javasoljuk, hogy az audiófájlokat egycsatornás WaV-ba konvertálja (mono), 22050-Hz, vagy kisebb mintavételi frekvenciával. Valamint érdemes hozzáadni egy limitet, ami szabályozza az effekt lejátszási gyakoriságát.}}
==Szintaxis==
<syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false ] )</syntaxhighlight>
<syntaxhighlight lang="lua">element playSound3D ( string soundURL, float x, float y, float z, [ bool looped = false, bool throttled = true ] )</syntaxhighlight>
{{OOP||[[Sound|Sound3D]]}}
===Kötelező argumentumok===
*'''soundPath:''' a lejátszani kívánt hang [[filepath|elérési helye]]. (A hangfájlt elő kell definiálni a [[meta.xml]] fájlban, <file /> taggel. És az [[filepath|elérési hely]] helyett az URL cím is használható )
*'''soundURL:''' az URL. (Ebben a verzióban a fájlt nem kell elő definiálni a [[meta.xml]]-ben )
*'''x:''' A térképen az X koordinátát ábrázoló [[float|lebegőpontos]] szám.
*'''y:''' A térképen az Y koordinátát ábrázoló [[float|lebegőpontos]] szám.
*'''z:''' A térképen a Z koordinátát ábrázoló [[float|lebegőpontos]] szám.

===Tetszőleges paraméterek===
{{OptionalArg hu}}

*'''looped:''' A [[boolean]] visszadja, hogy a hang ismétlődni fog-e. A hang ismétlésére használja a ''true''-t..
{{New feature/item|3.0150|1.5||
*'''throttled:''' A [[boolean]] visszadja, hogy a hang szabályozva lesz-e (pl. csökkentett letöltési sávszélességgel). A hang szabályozásához használja a "true" parancsot..
}}

===Visszaadott értéks===
Visszaad egy [[sound|hang]][[element|elemet]], ha a hang sikeresen létre lett hozva, egyébként ''hamis''.

==Példa==
Ez a példa egy ismétlődő hangot hoz létre a pizza boltban.
<section name="Example" class="client" show="true">
<syntaxhighlight lang="lua">
function onResourceStart()
local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)
end
addEventHandler("onClientResourceStart", resourceRoot, onResourceStart)
</syntaxhighlight>
</section>
Ez a példa egy internetes rádiót játszik le a groove utcán.
<section name="Example 2" class="client" show="true" >
<syntaxhighlight lang="lua">
addEventHandler( 'onClientResourceStart', resourceRoot,
function( )
local uSound = playSound3D( 'http://193.34.51.25:80', 2498, -1659, 12 )
setSoundMaxDistance( uSound, 100 )
end
)
</syntaxhighlight>
</section>

==Lásd még==
{{Client_audio_functions hu}}
[[en:playSound3D]]
[[AR:playSound3D]]
[[DE:playSound3D]]
[[RU:playSound3D]]
[[PT-BR:playSound3D]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/playSound3D

2021-09-19T22:12:07Z

Surge:

__NOTOC__
{{Client function hu}}
Létrehoz egy [[sound|hang]] [[element|elemet]] a GTA világban, majd rögtön azután le is játssza azt a játékosnak. A [[setElementPosition]]-t használhatjuk a hangelem mozgatásához azután, hogy létrehoztuk. Ne felejtse el használni a [[setElementDimension]]-t, miután létrehozta a hangot a lejátszáshoz a 0-ik dimenzión kívül.<br />
<br />
{{Note_hu|
*Támogatott audió formátumok: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M and PLS.
*Teljesítményi okokból, mikor a playSound-ot használjuk egy effekt többszöri lejátszásánál (pl. fegyver lövés), javasoljuk, hogy az audiófájlokat egycsatornás WaV-ba konvertálja (mono), 22050-Hz, vagy kisebb mintavételi frekvenciával. Valamint érdemes hozzáadni egy limitet, ami szabályozza az effekt lejátszási gyakoriságát.}}
==Szintaxis==
<syntaxhighlight lang="lua">element playSound3D ( string soundPath, float x, float y, float z, [ bool looped = false ] )</syntaxhighlight>
<syntaxhighlight lang="lua">element playSound3D ( string soundURL, float x, float y, float z, [ bool looped = false, bool throttled = true ] )</syntaxhighlight>
{{OOP||[[Sound|Sound3D]]}}
===Kötelező argumentumok===
*'''soundPath:''' a lejátszani kívánt hang [[filepath|elérési helye]]. (A hangfájlt elő kell definiálni a [[meta.xml]] fájlban, <file /> taggel. És az [[filepath|elérési hely]] helyett az URL cím is használható )
*'''soundURL:''' az URL. (Ebben a verzióban a fájlt nem kell elő definiálni a [[meta.xml]]-ben )
*'''x:''' A térképen az X koordinátát ábrázoló [[float|lebegőpontos]] szám.
*'''y:''' A térképen az Y koordinátát ábrázoló [[float|lebegőpontos]] szám.
*'''z:''' A térképen a Z koordinátát ábrázoló [[float|lebegőpontos]] szám.

===Tetszőleges paraméterek===
{{OptionalArg hu}}

*'''looped:''' A [[boolean]] visszadja, hogy a hang ismétlődni fog-e. A hang ismétlésére használja a ''true''-t..
{{New feature/item|3.0150|1.5||
*'''throttled:''' A [[boolean]] visszadja, hogy a hang szabályozva lesz-e (pl. csökkentett letöltési sávszélességgel). A hang szabályozásához használja a "true" parancsot..
}}

===Visszaadott értéks===
Visszaad egy [[sound|hang]][[element|elemet]], ha a hang sikeresen létre lett hozva, egyébként ''hamis''.

==Példa==
Ez a példa egy ismétlődő hangot hoz létre a pizza boltban.
<section name="Example" class="client" show="true">
<syntaxhighlight lang="lua">
function onResourceStart()
local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)
end
addEventHandler("onClientResourceStart", resourceRoot, onResourceStart)
</syntaxhighlight>
</section>
Ez a példa egy internetes rádiót játszik le a groove utcán.
<section name="Example 2" class="client" show="true" >
<syntaxhighlight lang="lua">
addEventHandler( 'onClientResourceStart', resourceRoot,
function( )
local uSound = playSound3D( 'http://193.34.51.25:80', 2498, -1659, 12 )
setSoundMaxDistance( uSound, 100 )
end
)
</syntaxhighlight>
</section>

==Lásd még==
{{Client_audio_functions hu}}
[[en:playSound3D]]
[[AR:playSound3D]]
[[DE:playSound3D]]
[[RU:playSound3D]]
[[PT-BR:playSound3D]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/Element/Texture

2021-08-19T21:38:51Z

Surge:

__NOTOC__
A texture osztály a megjeleníthető képpontok forrását jelenti, amelyek használhatóak képként is a [[dxDrawImage]], [[dxDrawImageSection]] használatával, vagy értékként a [[dxSetShaderValue]].

Az osztály elemtípusa a '''"texture"'''.

A texture elemeket a következő függvényekkel lehet étrehozni:
* [[HU/dxCreateTexture]]
* [[HU/dxCreateRenderTarget]]
* [[HU/dxCreateScreenSource]]

[[Category:Element Types]]

[[en:Element/Texture]]
[[ru:Element/Texture]]
[[hu:Element/Texture]]

==Fordította==
'''2018.12.08.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

Element/Player

2021-02-04T12:28:23Z

Surge:

__NOTOC__
The player class represents pedestrians controlled by clients. A player object is created when a client connects to the server and destroyed when he quits. Players cannot be created or destroyed otherwise.

The element type of this class is '''"player"'''.

==Related scripting functions==
===Client===
{{Client player functions}}
===Server===
{{Player functions}}
[[Category:Element Types]]

[[hu:Element/Player]]
[[it:Elemento Player]]
[[ru:Element/Player]]
[[es:Elemento/Player]]
[[de:Element/Player]]
[[pl:Gracz]]
[[zh-cn:元素/玩家]]

HU/dxCreateShader

2020-12-15T14:56:04Z

Surge:

{{Client function hu}}
__NOTOC__
Ez a function létrehoz egy [[shader]] elemet, mely a dxDraw függvényekben használható. A sikeres shader létrehozása nem garantált, hacsak a [[shader|Effect File]] nem tartalmaz olyan biztonsági módszereket, amely minden számítógépén működni fog.

{{Tip_hu|Nagyon ajánlott a [[dxSetTestMode]] használata, amikor a dxCreateShader-t használva írunk és tesztelünk scripteket.}}

==Szintaxis==
<syntaxhighlight lang="lua">
element, string dxCreateShader ( string filepath [, float priority = 0, float maxDistance = 0, bool layered = false, string elementTypes = "world,vehicle,object,other" ] )
</syntaxhighlight>
{{OOP||[[Shader|DxShader]]}}
===Kötelező paraméterek===
*'''filepath:''' A [[shader|shader Effect File]](.fx) fájl elérési útja

===Tetszőleges paraméterek===
''A felsorolt tetszőlegesen választható paraméterek csak akkor helytállóak, ha ezeket az [[engineApplyShaderToWorldTexture]]-val használják''
*'''priority:''' Ha egynél több shadert illesztenek a world textúrához, akkor a legmagasabb prioritású shader lesz használva. Ha egynél több shader van ugyan azon a prioritáson, akkor a legutoljára létrehozott shader van használatban.
*'''maxDistance:''' If non-zero, the shader will be applied to textures nearer than maxDistance only. This can speed up rendering, but (to look good) may require the shader to fade out it's own effect as the texture reaches maxDistance.
*'''layered:''' When set to true, the shader will be drawn in a separate render pass. Several layered shaders can be drawn on the same world texture. (To avoid [http://en.wikipedia.org/wiki/Z-fighting Z fighting] artifacts, you may have to add '''DepthBias<nowiki>=</nowiki>-0.0002;''' to the technique pass, but this might cause visual artifacts when applied on vehicles)
*'''elementTypes:''' A comma seperated list of element types to restrict this shader to. Valid element types are:
** world - Textures in the GTA world
** ped - Player and ped textures
** vehicle - Vehicles textures
** object - Objects textures
** other - Element textures which are not peds, vehicles or objects
** all - Everything

===Visszatérési érték===
*'''element:''' Egy [[shader]] elem, ha sikeres, ''false'', ha érvénytelen paraméterek lettek megadva. '''Mindig ellenőrizze, hogy ez a function false értéked ad-e vissz.'''
*'''string:''' A használt módszer neve

==Példa==
<syntaxhighlight lang="lua">
addEventHandler( "onClientRender", root,
function()
if myShader then
dxDrawImage( 100, 350, 300, 350, myShader )
end
end
)

-- Use 'toggle' command to switch shader on and off
addCommandHandler( "toggle",
function()
if not myShader then
myShader = dxCreateShader( "fancything.fx" ) -- Create shader
else
destroyElement( myShader ) -- Destroy shader
myShader = nil
end
end
)
</syntaxhighlight>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.0-9.04435|Added layered and elementTypes arguments}}

==Lásd még==
{{Drawing_functions hu}}

[[en:dxCreateShader]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/dxCreateShader

2020-12-15T14:54:44Z

Surge:

{{Client function hu}}
__NOTOC__
Ez a function létrehoz egy [[shader]] elemet, mely a dxDraw függvényekben használható. A sikeres árnyék létrehozása nem garantált, hacsak a [[shader|Effect File]] nem tartalmaz olyan biztonsági módszereket, amely minden számítógépén működni fog.

{{Tip_hu|Nagyon ajánlott a [[dxSetTestMode]] használata, amikor a dxCreateShader-t használva írunk és tesztelünk scripteket.}}

==Szintaxis==
<syntaxhighlight lang="lua">
element, string dxCreateShader ( string filepath [, float priority = 0, float maxDistance = 0, bool layered = false, string elementTypes = "world,vehicle,object,other" ] )
</syntaxhighlight>
{{OOP||[[Shader|DxShader]]}}
===Kötelező paraméterek===
*'''filepath:''' A [[shader|shader Effect File]](.fx) fájl elérési útja

===Tetszőleges paraméterek===
''A felsorolt tetszőlegesen választható paraméterek csak akkor helytállóak, ha ezeket az [[engineApplyShaderToWorldTexture]]-val használják''
*'''priority:''' Ha egynél több árnyékot illesztenek a world textúrához, akkor a legmagasabb prioritású árnyék lesz használva. Ha egynél több árnyék van ugyan azon a prioritáson, akkor a legutoljára létrehozott árnyék van használatban.
*'''maxDistance:''' If non-zero, the shader will be applied to textures nearer than maxDistance only. This can speed up rendering, but (to look good) may require the shader to fade out it's own effect as the texture reaches maxDistance.
*'''layered:''' When set to true, the shader will be drawn in a separate render pass. Several layered shaders can be drawn on the same world texture. (To avoid [http://en.wikipedia.org/wiki/Z-fighting Z fighting] artifacts, you may have to add '''DepthBias<nowiki>=</nowiki>-0.0002;''' to the technique pass, but this might cause visual artifacts when applied on vehicles)
*'''elementTypes:''' A comma seperated list of element types to restrict this shader to. Valid element types are:
** world - Textures in the GTA world
** ped - Player and ped textures
** vehicle - Vehicles textures
** object - Objects textures
** other - Element textures which are not peds, vehicles or objects
** all - Everything

===Visszatérési érték===
*'''element:''' Egy [[shader|árnyék]] elem, ha sikeres, ''false'', ha érvénytelen paraméterek lettek megadva. '''Mindig ellenőrizze, hogy ez a function false értéked ad-e vissz.'''
*'''string:''' A használt módszer neve

==Példa==
<syntaxhighlight lang="lua">
addEventHandler( "onClientRender", root,
function()
if myShader then
dxDrawImage( 100, 350, 300, 350, myShader )
end
end
)

-- Use 'toggle' command to switch shader on and off
addCommandHandler( "toggle",
function()
if not myShader then
myShader = dxCreateShader( "fancything.fx" ) -- Create shader
else
destroyElement( myShader ) -- Destroy shader
myShader = nil
end
end
)
</syntaxhighlight>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.0-9.04435|Added layered and elementTypes arguments}}

==Lásd még==
{{Drawing_functions hu}}

[[en:dxCreateShader]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

User:Surge

2020-10-01T12:13:17Z

Surge:

<pageclass class="#ff55bb" style="background: #FFE2F3; subcaption="Surge’s Profile"></pageclass>

===Activity===
<font color="#ED008E">'''Translation of MTA Wiki to Hungarian.'''</font>

{| class="wikitable" style="width:32%;"
|-
! scope="col" {{S_Scripting}}
|-
| {{Scripting_the_GUI}}
|-
| {{Scripting_the_GUI_2}}
|-
| {{Scripting_the_GUI_3}}
|-
| {{Tutorial 1}}
|-
| {{Tutorial_2}}
|-
| {{Tutorial_3}}
|-
| {{S_Debugging}}
|-
| {{S_Resources}}
|-
| {{S_Resource Web Access}}
|-
| {{S_Meta.xml}}
|-
| {{S_ACL}}
|-
| {{S_Writing_Gamemodes}}
|-
| {{S_Useful_Functions}}
|-
| {{S_OOP_Introduction}}
|-
! scope="col" {{S_Reference}}
|-
| {{S_Client_Funtions}}
|-
| {{S_Classes}}
|-
| {{S_Element}}
|-
| [[HU/Element_tree|Element Tree]]
|-
! scope="col" {{S_Map_Editor}}
|-
| {{S_Editor}}
|-
| {{S_EDF}}
|-
| {{S_Plugins}}
|}

<br/>
<br/>
<font size="10"><font color="#ff55bb"><center>I love cats</center></font></font>
<br/>

User:Surge

2020-10-01T12:08:49Z

Surge:

<pageclass class="#ff55bb" style="background: #FFE2F3; subcaption="Surge’s Profile"></pageclass>

===Activity===
<font color="#ED008E">'''Translation of MTA Wiki to Hungarian.'''</font>

{| class="wikitable" style="width:32%;"
|-
! scope="col" {{S_Scripting}}
|-
| {{Scripting_the_GUI}}
|-
| {{Scripting_the_GUI_2}}
|-
| {{Scripting_the_GUI_3}}
|-
| {{Tutorial 1}}
|-
| {{Tutorial_2}}
|-
| {{Tutorial_3}}
|-
| {{S_Debugging}}
|-
| {{S_Resources}}
|-
| {{S_Resource Web Access}}
|-
| {{S_Meta.xml}}
|-
| {{S_ACL}}
|-
| {{S_Writing_Gamemodes}}
|-
| {{S_Useful_Functions}}
|-
| {{S_OOP_Introduction}}
|-
! scope="col" {{S_Reference}}
|-
| {{S_Client_Funtions}}
|-
| {{S_Classes}}
|-
| {{S_Element}}
|-
| [[HU/Element_tree|Elem fa]]
|-
! scope="col" {{S_Map_Editor}}
|-
| {{S_Editor}}
|-
| {{S_EDF}}
|-
| {{S_Plugins}}
|}

<br/>
<br/>
<font size="10"><font color="#ff55bb"><center>I love cats</center></font></font>
<br/>

User:Surge

2020-10-01T12:08:09Z

Surge:

<pageclass class="#ff55bb" style="background: #FFE2F3; subcaption="Surge’s Profile"></pageclass>

===Activity===
<font color="#ED008E">'''Translation of MTA Wiki to Hungarian.'''</font>

{| class="wikitable" style="width:32%;"
|-
! scope="col" {{S_Scripting}}
|-
| {{Scripting_the_GUI}}
|-
| {{Scripting_the_GUI_2}}
|-
| {{Scripting_the_GUI_3}}
|-
| {{Tutorial 1}}
|-
| {{Tutorial_2}}
|-
| {{Tutorial_3}}
|-
| {{S_Debugging}}
|-
| {{S_Resources}}
|-
| {{S_Resource Web Access}}
|-
| {{S_Meta.xml}}
|-
| {{S_ACL}}
|-
| {{S_Writing_Gamemodes}}
|-
| {{S_Useful_Functions}}
|-
| {{S_OOP_Introduction}}
|-
! scope="col" {{S_Reference}}
|-
| {{S_Client_Funtions}}
|-
| {{S_Classes}}
|-
| {{S_Element}}
|-
| [[HU/Element_tree]]
|-
! scope="col" {{S_Map_Editor}}
|-
| {{S_Editor}}
|-
| {{S_EDF}}
|-
| {{S_Plugins}}
|}

<br/>
<br/>
<font size="10"><font color="#ff55bb"><center>I love cats</center></font></font>
<br/>

User:Surge

2020-10-01T11:51:47Z

Surge:

<pageclass class="#ff55bb" style="background: #FFE2F3; subcaption="Surge’s Profile"></pageclass>

===Activity===
<font color="#ED008E">'''Translation of MTA Wiki to Hungarian.'''</font>

{| class="wikitable" style="width:32%;"
|-
! scope="col" {{S_Scripting}}
|-
| {{Scripting_the_GUI}}
|-
| {{Scripting_the_GUI_2}}
|-
| {{Scripting_the_GUI_3}}
|-
| {{Tutorial 1}}
|-
| {{Tutorial_2}}
|-
| {{Tutorial_3}}
|-
| {{S_Debugging}}
|-
| {{S_Resources}}
|-
| {{S_Resource Web Access}}
|-
| {{S_Meta.xml}}
|-
| {{S_ACL}}
|-
| {{S_Writing_Gamemodes}}
|-
| {{S_Useful_Functions}}
|-
| {{S_OOP_Introduction}}
|-
! scope="col" {{S_Reference}}
|-
| {{S_Client_Funtions}}
|-
| {{S_Classes}}
|-
| {{S_Element}}
|-
| {{HU/Element_tree}}
|-
! scope="col" {{S_Map_Editor}}
|-
| {{S_Editor}}
|-
| {{S_EDF}}
|-
| {{S_Plugins}}
|}

<br/>
<br/>
<font size="10"><font color="#ff55bb"><center>I love cats</center></font></font>
<br/>

HU/dxDrawImage

2020-09-01T17:28:36Z

Surge:

__NOTOC__
{{Client function hu}}

[[Image:MTAsa dxDrawImage.png|thumb|190px|Egy dxDrawImage-val felrajzolt kép.]]

Rajzol egy képet a képernyőre, de csak egy másodpercre. Hogyha azt szeretnéd, hogy a kép a képernyőn állandóan látszódjon, akkor ezt a funkciót meg kell hivnod minden képkocka frissitéskor ([[onClientRender]]).<br/>
Jobb esetben a képek dimenziója a 2 négyzete, ez azért fontos, hogy elkerüljük a lehetséges elmosodását a képnek.<br/>
<b>A kettő négyzetei: 2px, 4px, 8px, 16px, 32px, 64px, 128px, 256px, 512px, 1024px, stb...</b>

{{Tip_hu|Használd a(z) [[dxCreateTexture]] által létrehozott textúrákat, hogy '''felgyorsítsd a rajzolás'''át a képnek.}}
{{Tip_hu|Ahhoz, hogy megelőzd a kép sarkainak hibáját amikor felrajzolsz egy képet, tedd a(z) '''textureEdge'''-et '''"clamp"'''-ra, amikor meghívod a [[dxCreateTexture]] funkciót. }}
==Szintaxis==
<syntaxhighlight lang="lua">
bool dxDrawImage ( float posX, float posY, float width, float height, mixed image,
[ float rotation = 0, float rotationCenterOffsetX = 0, float rotationCenterOffsetY = 0,
int color = tocolor(255,255,255,255), bool postGUI = false ] )
</syntaxhighlight>

===Kötelező paraméterek===
*'''posX:''' A kép abszolút pozíciója a képernyő bal szélső oldalától számolva.
*'''posY:''' A kép abszolút pozíciója a képernyő tetejétől számolva.
*'''width:''' Az abszolút képszélesség
*'''height:''' Az magasság képszélesség
*'''image:''' Egy [[material]] element vagy egy [[filepath]](elérési útvonal) a képhez. (.dds képeket is felrajzolhatsz).

===Tetszőleges paraméterek===
*'''rotation:''' A kép rotációja fokokban kifejezve.
*'''rotationCenterOffsetX:''' Az abszolút X offset a kép közepétől számolva.
*'''rotationCenterOffsetY:''' Az abszolút Y offset a kép közepétől számolva.
*'''color:''' Átszinezi a képet egy [[tocolor]] által visszaadott értékre, vagy megadhatsz egy hexidecimális számot is: 0xAARRGGBB (RR = piros, GG = zöld, BB = kék, AA = átlátszóság), minden érték 0-255 között kell,hogy legyen.
*'''postGUI:''' True ha a GUIk felé akarod rajzolni, false ha a GUI-k mögé. A kép mindig a főmenü mögött lesz.

===Visszaadott értékek===
''True''-t ad vissza ha sikerült, ''false''-t ha nem.

==Példa==
Példa egy lengő ingáról a képernyő tetején, a dxDrawImage használatával.
<syntaxhighlight lang="lua">
local screenWidth,screenHeight = guiGetScreenSize() -- Get screen resolution.

function renderDisplay ( )
local seconds = getTickCount() / 1000
local angle = math.sin(seconds) * 80
-- This will draw the graphic file 'arrow.png' at the top middle of the screen
-- using the size of 100 pixels wide, and 240 pixels high.
-- The center of rotation is at the top of the image.
dxDrawImage ( screenWidth/2 - 50, 0, 100, 240, 'arrow.png', angle, 0, -120 )
end

function HandleTheRendering ( )
addEventHandler("onClientRender", root, renderDisplay) -- Keep everything visible with onClientRender.
end
addEventHandler("onClientResourceStart",resourceRoot, HandleTheRendering)
</syntaxhighlight>

==Lásd még==
{{Drawing_functions_hu}}

[[en:dxDrawImage]]

HU/isCursorShowing

2020-08-29T21:34:22Z

Surge: /* Példa */

__NOTOC__
{{Shared function hu}}
Ez a function arra szolgál, hogy meghatározza, hogy a játékos kurzora megvan-e jelenítve, vagy nincs.
{{Note_hu|Ez visszaadja a [[HU/showCursor]] segítségével beállított kurzorállapotot, ami így nem veszi figyelembe a kurzor megjelénését, ha a chatbox, a menü, vagy a console nyitva van. Ezenkívül vegye figyelembe, hogy a client oldal értesül a server oldal által beállított kurzorállapotokról, viszont a server oldal nem tud a client oldalról beállított kurzorállapotokról.}}
==Szintaxis==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool isCursorShowing ( player thePlayer )
</syntaxhighlight>

===Kötelező paraméretek===
*'''thePlayer:''' A [[player]], akinek a kurzor állapotát szeretné megkapni.

===Visszatérési érték===
Visszatérési értéke ''true'', ha a játékos kurzorja megjelenik, ''false'', ha nem, vagy ha érvétnytelen paraméterek lettek megadva.
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool isCursorShowing ( )
</syntaxhighlight>

===Visszatérési érték===
Visszatérési értéke ''true'', ha a játékos kurzorja megjelenik, ''false'', ha nem.
</section>

==Példa==
<section name="Example" class="server" show="true">
Ez a serverside function átkapcsolja a játékos kurzorállapotát.
<syntaxhighlight lang="lua">
function toggleCursor ( thePlayer )
local currentState = isCursorShowing ( thePlayer ) -- get the current cursor state as a boolean
local oppositeState = not currentState -- get the new state as its logical opposite
showCursor ( thePlayer, oppositeState ) -- set it as the new cursor state
end
</syntaxhighlight>
</section>
<section name="Clientside Example" class="client" show="true">
Egy kis csavarral ez is használható client oldalon is
<syntaxhighlight lang="lua">
function toggleCursor ()
local currentState = isCursorShowing () -- get the current cursor state as a boolean
local oppositeState = not currentState -- get the new state as its logical opposite
showCursor ( oppositeState ) -- set it as the new cursor state
end
</syntaxhighlight>
És egy kompaktabb verzió
<syntaxhighlight lang="lua">
bindKey ("b", "down", -- binds B key to toggle cursor state
function()
showCursor( not isCursorShowing() )
end)
</syntaxhighlight>
</section>

==Lásd még==
{{Cursor_functions hu}}

[[en:isCursorShowing]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/isCursorShowing

2020-08-29T21:34:08Z

Surge: /* Példa */

__NOTOC__
{{Shared function hu}}
Ez a function arra szolgál, hogy meghatározza, hogy a játékos kurzora megvan-e jelenítve, vagy nincs.
{{Note_hu|Ez visszaadja a [[HU/showCursor]] segítségével beállított kurzorállapotot, ami így nem veszi figyelembe a kurzor megjelénését, ha a chatbox, a menü, vagy a console nyitva van. Ezenkívül vegye figyelembe, hogy a client oldal értesül a server oldal által beállított kurzorállapotokról, viszont a server oldal nem tud a client oldalról beállított kurzorállapotokról.}}
==Szintaxis==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool isCursorShowing ( player thePlayer )
</syntaxhighlight>

===Kötelező paraméretek===
*'''thePlayer:''' A [[player]], akinek a kurzor állapotát szeretné megkapni.

===Visszatérési érték===
Visszatérési értéke ''true'', ha a játékos kurzorja megjelenik, ''false'', ha nem, vagy ha érvétnytelen paraméterek lettek megadva.
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool isCursorShowing ( )
</syntaxhighlight>

===Visszatérési érték===
Visszatérési értéke ''true'', ha a játékos kurzorja megjelenik, ''false'', ha nem.
</section>

==Példa==
<section name="Example" class="server" show="true">
Ez a serverside function átkapcsolja a játékos kurzorállapotát.
<syntaxhighlight lang="lua">
function toggleCursor ( thePlayer )
local currentState = isCursorShowing ( thePlayer ) -- get the current cursor state as a boolean
local oppositeState = not currentState -- get the new state as its logical opposite
showCursor ( thePlayer, oppositeState ) -- set it as the new cursor state
end
</syntaxhighlight>
</section>
<section name="Clientside Example" class="client" show="true">
Egy kis csavarral ez is használható client oldalon is
<syntaxhighlight lang="lua">
function toggleCursor ()
local currentState = isCursorShowing () -- get the current cursor state as a boolean
local oppositeState = not currentState -- get the new state as its logical opposite
showCursor ( oppositeState ) -- set it as the new cursor state
end
</syntaxhighlight>
És egy kompaktabb verzió
<syntaxhighlight lang="lua">

bindKey ("b", "down", -- binds B key to toggle cursor state
function()
showCursor( not isCursorShowing() )
end)
</syntaxhighlight>
</section>

==Lásd még==
{{Cursor_functions hu}}

[[en:isCursorShowing]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/OOP Introduction

2020-02-27T08:16:18Z

Surge: /* Bevezetés az OOP-ba */

{{Note_box_hu|Ha a hozzájárulását adta az oldal szerkesztéséhez és módosításához, vagy segített ez a tutoriál, vagy csak mondani szeretne valamit; kérem írjon visszajelzést a bal oldalon található fórum linken.}}
Ez a szkript tutoriál elmagyarázza, hogy mi az az objektumorientált programozás, és megtanít arra, hogy hogyan kell használni az MTA OOP funkcióit. Ezt [[User:Qais|qaisjp]] hozta létre ([[User talk:Qais|talk]]) 22:48, 8 June 2014 (UTC). [http://forum.mtasa.com/viewtopic.php?f=148&t=76388 Forum post.]

__TOC__
== Bevezetés az OOP-ba ==
Az OOP az az ''object orientated programming'' rövidítése. Három egyszerű szó, de valószínűleg az utolsót fogja a legjobban érteni. OOP-nak (Objektumorientált Programozásnak) nevezzük azt, amikor minden, egy objektumhoz köthető függvény az adott objektumon kerül meghívásra. Az objektum ez esetben egy osztály példánya - egy elem osztály, egy database osztály, egy játékos, egy jármű. Eredetileg minden ''procedurális'' volt, hasonlóan kellett megcsinálnia egyes scripteket:
<syntaxhighlight lang="lua">
local vehicle = createVehicle(411, 0, 0, 3)
setVehicleDamageProof(vehicle, true)
setElementFrozen(vehicle, true)
setElementHealth(vehicle, 1000)
setElementVelocity(vehicle, 0.2, 0.2, 0.2)
destroyElement(vehicle)
</syntaxhighlight>
A legtöbb esetben tudja, hogy mivel foglalkozik. A változó majdnem mindig a típushoz kapcsolódik, ezért a felrobbanó járművet ennek megfelelően nevezné el, például '''explodedVehicle''', vagy legalábbis a szövegkörnyezetben megértené, hogy az '''exploded''' magábafoglalja a járművet amikor az az '''onVehicleExplode''' event-ben van. Ezért egy hosszú függvényt kell írnia ''és'' manuálisan kell hivatkoznia a járműre amikor procedúrálisan dolgozik. Az objektumorientált programozás nagyon különbözik ettől, és minden egyes "objektel" együtt dolgozik. Ahelyett, hogy hívnia kellene egy funkciót, és a híváson belül kellene rá hivatkoznia, valójában az osztályon BELLÜLI funkciót hívja meg.

Valószínűleg azt gondolja, hogy mindent amit létre tud hozni és megadni a függvénynek az egy elem. A jármű az egy elem. A játékos is egy elem. Bármi, ami egy elem, az valójában egy osztály is. A játékosok csatlakozása létrehozza az osztály egy példányát, de a ''csatlakozás'' az nem egy elem, ez egy példány - egy objekt. A tutorial során, amikor az ''object''-ről beszélek, akkor nem a [[createObject]]-re gondolok (hacsak ezt meg nem említem), de a dolgok tisztán látása érdekében kerülni fogom a fizikai tárgyak megemlítését, amikor ezt a tutoriált írom. Itt egy menő venn diagram, amelyet az osztályok és az elemek egyszerű szervezésének bemutatására hoztam létre.
[[File:Classes,_Elements_and_Problem_children.png|500px|left|venn diagram]]
A bal oldali funkciók rendezve vannak, hogy megmutassa milyen kategóriába tartozik a visszaadott érték. Van Classes, Elements és "Problem children".
Problem children nem valódi kategóriák a kódban, hanem csak függvények, melyek szabályokat szüntetnek meg. Minden amivel játszhat azok osztályok: resources, vehicles, és teams.
Minden elem egy osztály. A helyes használat: <syntaxhighlight lang="lua">destroyElement(ped)</syntaxhighlight> ez így nem helyes: <syntaxhighlight lang="lua">destroyElement(resource)</syntaxhighlight>

A Problem children azok furcsa dolgok. Nem használhatja az összes említett függvényt (valójában nem minden elem teszi lehetővé, hogy a függvények teljes választékát alkalmazzák rajtuk, de néhányat közülök megemlítettem) a funkciók listájának "Element functions" részében, de viszont destroyElement()-et használhat rajtuk.
Vannak osztályok gyerekei, mint például a players, ami így néz ki: ''Element -> Ped -> Player''. Minden játékos Ped és minden Ped elem. Nem minden Ped játékos, és természetesen nem minden Elem játékos. A lényeg az, hogy szinte minden, amit létrehozhat vagy letölthet, hogy később újrahasználja őket, azok osztályokat használnak.

Az előző kód helyett használhatjuk ez a kódot is:
<syntaxhighlight lang="lua">
local vehicle = createVehicle(411, 0, 0, 3)
vehicle:setDamageProof(true)
vehicle:setFrozen(true)
vehicle:setHealth(1000)
vehicle:setVelocity(0.2, 0.2, 0.2)
vehicle:destroy()
</syntaxhighlight>
Ez nagyon hasonlít a táblák működéséhez, ez olyan, mint a customTable.setSomething() kivéve a ''':''' használatát, a Lua konvertáló a customTable:setSomething()-et customTable.setSomething(customTable)-be konvertálja át. Ez egy elég bizalmas dolog a ''szintaktikus cukorról'', és nem kell egyáltalán aggódnia ezzel kapcsolatban.

Ezek a funkciók elég hasznosak, de az OOP-nál több változtatás is van még, amit a következőkben fogok megmagyarázni.

== Szemléltetés, változók ==
Az OOP elhagyja a "create" részét a függvénynek, így a '''createVehicle''' helyett csak a '''Vehicle'''-t használjuk. És ez pontosan ugyanúgy működik, ez olyan, mintha a '''Vehicle = createVehicle'''-t használnánk. Elég menő, nem igaz?? Az egyetlen különbség az, hogy kihagyja a kínált extra dolgokat, a Vehicle-nek nincsenek ezek az extra dolgai, de a Player-nek már igen. Például, a getPlayerFromName() helyett használhatja a Player.getFromName()-t. Ez egy könnyű és egyszerű módja a függvények szervezésének.
{{Tip|A ''Vehicle()'' azért működik, mert ténylegesen hozzáfér a '''Vehicle.create''' függvényhez, ez lehetővé teszi, hogy elhagyja a '''.create'''-et, amikor "objekteket hoz létre"}}
Mivel az OOP az eljárás tetején helyezkedik el, sok dolgot örököltek az eljárási stílusból, de a dolgok könnyebbé tételéhez változókat használunk az összes függvényhez, melyek egyetlen információt igényelnek. Lerövidítettük a '''getElementDimension()'''-t az '''element:getDimension()'''-re, de akár még mélyebbre is tudunk menni: '''element.dimension'''. Igen, akár csak egy változó. Megadhatja ezt a változót csak úgy, mint egy normális változót és olvashat is belőle, mint egy nomrális változóból. Héj, használhatja akár így is:
<syntaxhighlight lang="lua">local function incrementDimension()
local player = Player.getRandom() -- get a random player
player.dimension = player.dimension + 1 -- increment dimension
end
setTimer(incrementDimension, 60*1000, 10) -- set a timer for sixty thousand milliseconds, sixty seconds, one minute
</syntaxhighlight>
Ez a kód fog egy random játékost majd egy másik dimenzióba helyezi tíz percen keresztül minden egyes perc után.

== Vektorok ==
A player.position is működik! De hogyan változtat meg három paramétert.. egy változó használatával? Vektorok.
A vektorok nagyon erős osztályok és többféle formában vannak, ennek a bemutatónak a céljából három dimenziós vektort fogok bemutatni elemekben megadva. A vektorok használata nagyon egyszerű és persze tetszőleges. Bárhol, ahol pozíciókat használhat, ott használhat vektorokat is.

Szóval ez egy egyszerű példája egy jármű létrehozásának és a map közepére helyezésének a vektorok használatával
<syntaxhighlight lang="lua">
-- First, create a three-dimensional vector
local position = Vector3(300, -200, 2) -- some place far away
local vehicle = Vehicle(411, position) -- create a vehicle at the position
vehicle.position = centreOfMap - Vector3(300, -200, 0) -- move the vehicle two units above the center of the map
</syntaxhighlight>

Igen, mínuszjelet használtam. A vektorok nem csak különleges módszerek a pozíciókra vagy a 3D-s forgatásokra, vagy akármi másra, matematikai számításokat is használhatunk rajtuk. A ''special'' matematikai számítást még nem dokumentálták, de én azért megpróbálok dolgozni vele. Ahogy azt az első sorban is láthatja létrehoztam egy 3D-s vektort a ''300, -200, 2'' kordinátán, és a második sorban pedig létrehoztam egy járművet ennek a pozíciójára.

A '''vehicle.position''' visszaadott egy vektort majd fogott egy másik vektort - ez olyan, mint a setElementPosition() csak "()" nélkül. Mindegy egy egyszerű változó; így a harmadik sorban megváltoztattam a jármű pozíciójának a vektorértékét. És ez az ahol a számítás történt, itt láthatja, hogy hogyan működik:
<syntaxhighlight lang="lua">
x = 300 - 300
y = -200 - -200
z = 2 - 0
</syntaxhighlight>

A vektor matematika egy kicsit bonyolultabb, de határozottan lehetővé teszi a számítási műveletek széles skáláját. Tekintse meg a Vektorokat és Mátrixokat a lenti linkeken (Mátrixok = a Matrix több formája), hogy jobban megértse hogyan működnek.

== Understanding the documentation==
The documentation for the OOP syntax intends to be very simplistic and is supported by the procedural syntax. To keep things simple, everything is consistently formatted in a certain way.
<section name="Example" class="generic" show="true">
{{OOP|Set the variable to nil to execute [[removePedFromVehicle]]|[[ped]]:warpIntoVehicle|vehicle|getPedOccupiedVehicle}}
</section>

* Sometimes a note is added to the page. This will explain any special differences in the use of OOP for that function.
* Methods can either start like ''[[player]]:'' or ''[[Player]].'' - the former is only for a function on an instance (setPlayerHealth) and the latter is a static method (getRandomPlayer).
* The counterpart section this allows you to see at a glance how the variable can be used. In most cases this can be inferred from the function page.

If you are a contributor to the wiki, please also consider reading [[Template:OOP|the OOP template]].

== Hasznos linkek ==
Egyéb hasznos OOP-vel kapcsolatos oldalak:
* [[OOP]]
* [[Vector]]
* [[Matrix]]

[[Category:OOP]]
[[Category:Incomplete]]
[[Category:Tutorials]]

[[en:OOP Introduction]]

==Fordította==
'''2018.12.03.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

HU/playSFX

2020-02-27T08:00:38Z

Surge:

__NOTOC__
{{Client function hu}}
{{New feature/item|3.0134|1.3.4|5731|
Ez a funkció lejátsza a hangokat a GTA nagy hangkonténeréből.
}}

{{Note_hu|Itt egy eszköz, amely lehetővé teszi, hogy könnyedén találj meg bank, és hangazonosítókat: [[https://community.mtasa.com/index.php?p=resources&s=details&id=7549 sfxBrowser:Download]].}}
{{Warning_hu|Sok játékos használja a GTA:SA-t (különösen a kalóz) verzióit, amelyeknek nulla hangfájljai vannak, így ők jobban tudják tömöríteni ezeket az \AUDIO\SFX\ mappájukban. (Hiányoznak adatok)
Ezek érvénytelen audió fájlok esetén ez a funkció ''hamis'' értéked ad vissza.

Akkor is ''hamis'' értéked ad vissza, ha egy töröld dalt próbál meg lejátszani a legújabb GTA:SA Steam verziójában (és ha a kliens egy GTA: SA Steam másolatát használja.|true}}

==Szintaxis==
<syntaxhighlight lang="lua">
element playSFX ( string containerName, int bankId, int soundId [, bool looped = false ] )
</syntaxhighlight>

===Kötelező argumentumok===
*'''containerName:''' The name of the audio container. Possible values are: "feet", "genrl", "pain_a", "script", "spc_ea", "spc_fa", "spc_ga", spc_na", "spc_pa"
*'''bankId:''' The audio bank id
*'''soundId:''' The sound id within the audio bank

===Tetszőleges Argumentumok===
*'''looped:''' A [[boolean]] visszadja, hogy a hang ismétlődni fog-e.

==Visszaadott érték==
Visszaad egy [[sound|hang]] elemet, ha a hang sikeresen létre lett hozva, egyébként ''hamis''.

{{New feature/item|3.0140|1.4|6443|
==Szintaxis 2==
<syntaxhighlight lang="lua">
element playSFX ( string "radio", string radioStation, int trackId [, bool looped = false ] )
</syntaxhighlight>

===Kötelező argumentumok===
*'''radio:''' The string "radio" (used to differentiate to the first syntax)
*'''radioStation:''' The radio station. Possible values are "Adverts", "Ambience", "Police", "Playback FM", "K-Rose", "K-DST", "Cutscene", "Beats", "Bounce FM", "SF-UR", "Radio Los Santos", "Radio X", "CSR 103.9", "K-Jah West", "Master Sounds 98.3", "WCTR".
*'''trackId :''' The radio track id within the radio station audio file

===Tetszőleges Argumentumok===
*'''looped:''' A [[boolean]] visszadja, hogy a hang ismétlődő-e
==Returns==
Visszaad egy [[sound|hang]] elemet, ha a hang sikeresen létre lett hozva, egyébként ''hamis''.
}}

==Példa==
A következő példa lejátsza a tűzoltó hangot (ismétlődő).
<syntaxhighlight lang="lua">
if not playSFX("script", 7, 1, true) then
outputChatBox("You have to install some missing audio files to hear the sound")
end
</syntaxhighlight>

==Lásd még==
{{Client_audio_functions hu}}

[[en:PlaySFX]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/isElementWithinColShape

2020-02-25T10:02:03Z

Surge:

{{Shared function hu}}
__NOTOC__
Ez a function arra szolgál, hogy meghatározza, hogy egy elem a collision shape-n belüle van-e. Please note that for legacy reasons, a colshape created on the client does not collide with elements already existing at that location until they first move. Azt is vegye figyelembe, hogy 1.0.3 előtt, ez nem funkcionált megfelelően, amikor a colshape mozgott.

Valamint vegye figyelembe, hogy ez a function nem ellenőrzi, hogy az elemek azonos dimenzióban és interiorban vannak-e, a további ellenőrzések manuálisan is végrehajthatóak szükség esetén

==Szintaxis==
<syntaxhighlight lang="lua">bool isElementWithinColShape ( element theElement, colshape theShape )</syntaxhighlight>
{{OOP||[[element]]:isWithinColShape}}

===Kötelező paraméterek===
*'''theElement:''' Az [[element|elem]], amit ellenőriz
*'''theShape:''' A [[colshape]] amit ellenőriz

===Visszatérési érték===
Visszatérési értéke ''true'', ha az elem a colshape-n belül van, egyébként ''false''

==Példa==
This small script is an example of detecting if a player is within a certain defined colshape. This could serve as a base to perform many functions, rather than just an output.
<syntaxhighlight lang="lua">
local circlearea = createColCircle ( 0, 0, 10 )

function ColShapeHit ( thePlayer, matchingDimension )
local detection = isElementWithinColShape ( thePlayer, circlearea )
--A variable called 'detection' stores the result of asking if the player
--who entered a colshape is within the specific colshape called 'circlearea'.
--The result is either true or false.
detection = detection and getElementDimension( thePlayer ) == getElementDimension( circlearea )
--Let's additionally check element dimensions.
if detection then
outputChatBox ( getPlayerName(thePlayer).." is in the 'circle area' col shape" )
end
--if detection was true then the player is in the col shape. Output a
--message to confirm this
end
addEventHandler ( "onColShapeHit", root, ColShapeHit )
</syntaxhighlight>

==Lásd még==
{{element functions hu}}

[[en:isElementWithinColShape]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/Resource:Editor

2020-02-25T09:58:40Z

Surge: /* Gyakran Ismételt Kérdések */

{{Resource page}}
Az MTA:SA map editor lehetővé teszi, hogy mapokat hozzon létre gamemode-ok számára.

==Kezdés==
Az editor elindításához csak egyszerűen kattintson a "Map editor" menüpontra az MTA főmenüjében.

==Menük==
Miután elindult az editor, két menüsáv fog megjelenni: a főmenü a tetején, és az elem menü a bal alsó sarokban.

===Főmenü===
Ezeket a gombokat láthatja a főmenüben:
* [[Image:Editor_New.png]] Új map létrehozása.
* [[Image:Editor_Open.png]] Meglévő map megnyitása.
* [[Image:Editor_Save.png]] Az aktuális map elmentése.
* [[Image:Editor_Save_as.png]] A map elmentése egy másik névre.
* [[Image:Editor_Options.png]] Az általános map editor beállításainak módosítása.
* [[Image:Editor_Undo.png]] Az utolsó művelet visszavonása.
* [[Image:Editor_Redo.png]] Visszaállítja az utolsó befejezetlen műveletet.
* [[Image:Editor_Locations.png]] A játék tárolt helyszínei. Az editor tartalmaz egy jelentős mértékű Interior helyszínt a San Andreas-ból, emellett készíthet saját interiort és non-interior helyszínt a listához.
* [[Image:Editor_Current_elements.png]] Listázza a map összes elemét (objektek, járművek, marker-ek, pickup-ok, stb.)
* [[Image:Editor_Map_settings.png]] A map sajátos beállításai, mint pl. a napszak, gravitáció stb. Itt megadhatja, hogy a map milyen gamemódokkal legyen kompatibilis.
* [[Image:Editor_Definitions.png]] Töltse fel az [[HU/Resource:Editor/EDF|editort definiáló fájlokat (EDF)]], amelyeket használni szeretne.
* [[Image:Editor_Test.png]] Play mode-ba helyez, hogy kipróbálhassa a mapot. Ez betölti a gamemode-ot, amelyre a map készült.

===Elem menü===
Az elem menü a maphoz új elemek hozzáadására szolgál.
* [[Image:Editor_Vehicle.png]] Egy új jármű létrehozása.
* [[Image:Editor_Object.png]] Egy új object létrehozása (épületek, utak és más elemek).
* [[Image:Editor_Pickup.png]] Egy új pickup létrehozása (health, armor, weapons and custom).
* [[Image:Editor_Marker.png]] Egy új marker létrehozása (checkpoint, ring, cylinder, arrow and corona).
* [[File:Crosshair.png‎]] World object kiválasztása.
Ezen kívül, ha [[HU/Resource:Editor/EDF|van betöltött editort definiáló fájl (EDF)]], akkor görgethet az egérrel a menüben, hogy előhozza az egyedi elemeket.

==Az editor használata==
Ez a rész ismerteti a mapok létrehozásának és módosításának módját.

===Mozgás a map körül===
Amikor először elindítja az editort, akkor ''camera mode''-ban van. A '''WSAD''' gombokkal és az egérrel mozgathatja a kamerát. Mozgás közben az '''ALT''' lenyomásával lassíthatja, vagy a '''SHIFT'''-el gyorsíthatja a kamera mozgását.

Az editor kezelőfelületének és a kezelőpaneljének eléréséhez át kell váltania 'kurzor módba'. Az '''F''' gomb használatával tud váltani a kurzor mód és a kamera mód között. Kurzor módban a nézet rögzített, és az egérrel tudja mozgatni az elemeket és használni a grafikus felületet.

A kamera módot a képernyő közepén található kereszttel lehet felismerni. Használhatja az elemek kijelöléséhez és mozgatásához, csakúgy, mint a kurzor módban.

[[Image:Editor_Crosshair.png|center]]

===Egy új map indítása===
* Indítsa el az editort, vagy ha már elindította kattintson a ''New'' menü gombra.
* Kattintson a ''Map settings'' gombra. A ''Meta'' fülben töltse ki a Name és az Author mezőket a map nevével, illetve az Ön nevével. Valamint nyissa meg a ''Gamemodes'' fület, és addja hozzá azokat a gamemódokat, amelyekre a map készült (''Added gamemodes'' listához lesznek helyezve). Ezt úgy teheti meg, hogy kiválasztja őket, majd rákattint az ''Add'' gombra, vagy kétszer rájuk kattint. Majd kattintson az OK-ra, ha készen van.
[[Image:Editor_Mapsettings.png|center]]
* Kattintson a ''Definitions'' ablakra és adja hozzá azokat a resource-okat, amelyekhez az egyéni elemeket szeretné használni. Ezek a "Map settings" ablakban kiválasztott gamemode-ekből és esetleges további resource-kből állnak. További infórmáciért az editor definitions-ról olvassa el az [[HU/Resource:Editor/EDF|EDF]] oldalt. Majd kattintson az OK-ra, ha készen van.

===Új elem létrehozása===
Nagyon egyszerűen adhat hozzá elemeket a maphoz, például járműveket, objekteket.
* Ha kamera módban van, akkor váltson kurzor módba az '''F''' megnyomásával.
* Kattintson az element menüben lévő gombra, amely a kívánt tartalmat jelöli. Például kattintson a jármű gombra egy jármű hozzáadásához.
* A kiválasztott típus egy új eleme lesz létrehozva és hozzácsatolva a kurzorhoz. Helyezze arra a helyre, ahova szeretné, és a '''bal egérrel''' engedje el.

[[Image:Editor_Addelem.png|center]]

Egyéni elemek létrehozásához, melyek a resource-ra jellemzőek vigye az egerét az element menü fölé, és görgessen addig, míg a kívánt resource elő nem jön. Vegye figyelembe, hogy ennek működése érdekében hozzá kell adnia a resource [[Resource:Editor/EDF|EDF]] fájlját a ''Definitions'' ablakba.

[[Image:Editor_Selectedf.png|center]]

===Kiválasztás===
* A '''bal egérrel''' kattintson egy elemre, hogy kiválassza azt ''billentyűzet módban''.
* A '''jobb egérrel''' kattintson hogy kiválassza azt ''egér módban''.
* Nyomja meg a '''Szóközt''', vagy kattintson egy üres területre a kijelölés megszüntetéséhez.

A kiválasztott elemeket, ha van, sárga kurzorral jelöltük. Kevés collisionnal rendelkező elemeket (különösen az objektek) könnyen észlelni tudjuk a ''High sensitivity mode'' aktiválásával az '''E''' gomb lenyomásával.

A ''Current elements'' is használható az elemek kiválasztásához. A listában szereplő elemre való dupla kattintás kiválasztja azt ''billentyűzet módba''.

===Mozgatás===
Az elemeket többféle módon is tudja mozgatni.

'''Az egérrel'''
* Egyszerűen csak húzza, majd tegye le a '''bal egérgombbal'''.
vagy:
* Válassza ki az elemet egér módban ('''jobb egér'''), vigye oda, ahová szeretné, majd tegye le.

A kameramód használatával is tudja az elemek ''távolságát'' állítani, hogy távolabb, vagy közelebb legyen a kamerához, '''jobb egérrel''' kattintson az elemre majd görgessen az egérrel '''egérgörgő'''.

'''A billentyűzettel'''
* Válassza ki az elemet billentyűzet módban ('''bal egérgomb''').
* Használja a '''nyilakat''' az elem vízszintes való mozgatásához, és a '''PgUp'''/'''PgDn''' a függőleges mozgatáshoz. Tartsa lenyomva az '''ALT''' gombot a mozgási sebesség csökkentéséhez, vagy a '''SHIFT'''-et a növeléséhez.
Alapértelmezetten az elemek relatívan mozognak a kamerához, és nincsenek tengelyükhöz rögzítve. Ezt le tudja tiltani az ''Options'' menüben.

===Forgatás===
'''Az egérrel'''

A kiválasztott elemeket a Z tengely körül elforgathatja az egérgörgővel.
* Válassza ki az elemet billentyűzet módban ('''bal egérgomb''') majd görgesse az egeret, míg a '''Left CTRL'''-t lenyomva tartja.
vagy:
* Válassza ki az elemet egér módban ('''jobb egér'''), tartsa lenyomva a '''CTRL'''-t, és görgessen az egérrel.

'''A billentyűzettel'''
* Válassza ki az elemet billentyűzet módban ('''bal egérgomb''').
* Amíg lenyomva tartja a '''CTRL'''-t (a kijelölési marker zöldre vált), használja az '''arrow keys''' és a '''PgUp'''/'''PgDn''', hogy az elemet eltérő tengelyek körül forgassa.

Ezen felül mind a két módszernél lenyomva tarthatja az '''ALT''' billentyűt a forgási sebesség csökkentéséhez, vagy a '''SHIFT'''-et a növeléséhez.

[[Image:Editor_Rotateelem.png|center]]

===Modell és egyéb tulajdonságok módosítása===
A legtöbb elemnek számos modosítási lehetősége van, melyeknek a megjelenésük és a viselkedésük megváltoztatható. Például a modellek, szín és vizuális változásokat is végezhetünk.

* Nyissa meg egy elem 'properties' ablakát dupla kattintással, vagy az '''F3''' megynyomásával.
* Végezzen olyan módosításokat, amelyeket szeretne. Például, egy autó vagy objekt modelljének megváltoztatásához kattintson a '''Browse''' gombra, mely a "model" mellett található.
* Majd kattintson az OK-ra, ha készen van.

[[Image:Editor_Props.png|center]]

===Klónozás===
Az elem kiválasztásával és a '''C''' gomb lenyomásával klónozni tudja azt.

* Egér módban a klónozott elem a kurzorhoz lesz csatolva. Nyomja le a '''bal egeret''', hogy elhelyezze a mapon.
* A billentyűzet módban a klónozott eleme az ugyan abban a helyzetbe klónozódik.

Ha lenyomva tartja a '''CTRL'''-t amíg kattint, akkor az elemet újra klónozza és megint a kurzorhoz lesz csatolva. Így könnyen el tud helyezni sok darabot valamiből.

Alternatív megoldásként a 'properties' box jobb alsó sarkában lévő ''Pullout'' gomb megnyomásával is klónozhat egy elemet.

===Törlés===
Egyszerűen válassza ki az elemet, majd nyomja meg a '''DEL''' gombot, ''(Delete)''.

Alternatív megoldásként a 'properties' box jobb alsó sarkában lévő ''Pullout'' gomb megnyomásával is törölhet egy elemet.

==Mapok készítése sajátos gamemode-okhoz==
Két dolgot kell tenni a sajátos gamemode-okhoz való mapok készítésekor:
* Kattintson a '''Map Settings''' gombra a fenti menüben, menjen a '''Gamemodes''' fülre, majd adja hozzá azokat a gamemode-okat, amelyket a mapjához szeretne használni.
* Valószínűleg majd hozzá kell adnia egy, vagy több [[HU/Resource:Editor/EDF|editort definiáló fájlt (EDF)]] is. Ez lehetővé teszi, hogy sajátos gamemode elemeket helyezzen a map-ba, mint például spawnpoints, race checkpoints, vagy CTF flags. A '''Definitions''' menü gombjára kattintva hozzáadhatja az EDF-eket a megfelelő gamemode-ekhez.

==Irányítás==
Itt található az alapértelmezett irányítások listája. Ezek megváltoztatásához menjen az MTA beállítások menüjébe, amíg az Editor el van indítva.

===Camera===
{|
|-
| camera_move_forwards
| '''w'''
|-
| camera_move_backwards
| '''s'''
|-
| camera_move_left
| '''a'''
|-
| camera_move_right
| '''d'''
|-
| high_sensitivity_mode
| '''e'''
|}

===Cloning===
{|
|-
| clone_selected_element
| '''c'''
|-
| clone_drop_modifier
| '''lctrl''' || ''(Left CTRL)''
|}

===Element manipulation===
{|
|-
| element_move_forward
| '''arrow_u''' || ''(Arrow key Up)''
|-
| element_move_backward
| '''arrow_d''' || ''(Arrow key Down)''
|-
| element_move_left
| '''arrow_l''' || ''(Arrow key Left)''
|-
| element_move_right
| '''arrow_r''' || ''(Arrow key Right)''
|-
| element_move_downwards
| '''pgdn''' || ''(Page Down)''
|-
| element_move_upwards
| '''pgup''' || ''(Page Up)''
|-
| zoom_in
| '''mouse_wheel_down'''
|-
| zoom_out
| '''mouse_wheel_up'''
|-
| quick_rotate_increase
| '''mod_rotate''' + '''mouse_wheel_up''' || ''(Left CTRL + Mouse wheel Up)''
|-
| quick_rotate_decrease
| '''mod_rotate''' + '''mouse_wheel_down''' || ''(Left CTRL + Mouse wheel Down)''
|-
| mod_rotate
| '''lctrl''' || ''(Left CTRL)''
|-
| mod_slow_speed
| '''lalt''' || ''(Left ALT)''
|-
| mod_fast_speed
| '''lshift''' || ''(Left SHIFT)''
|-
| destroy_selected_element
| '''delete'''
|-
| drop_selected_element
| '''space'''
|-
| pickup_selected_element
| '''F2'''
|-
| reset_rotation
| '''mod_rotate''' + '''r''' || ''(Left CTRL + R)''
|}

===GUI===
{|
| toggle_gui_display
| '''F4'''
|-
| toggle_cursor
| '''f'''
|-
| select_target_keyboard
| '''mouse1''' || ''(Left Mouse button)''
|-
| select_target_mouse
| '''mouse2''' || ''(Right Mouse button)''
|-
| edf_next
| '''mouse_wheel_up'''
|-
| edf_prev
| '''mouse_wheel_down'''
|-
| undo
| '''Ctrl''' + '''z'''
|-
| redo
| '''Ctrl''' + '''y'''
|-
| properties_toggle
| '''F3'''
|-
| browser_up
| '''arrow_u''' || ''(Arrow key Up)''
|-
| browser_down
| '''arrow_d''' || ''(Arrow key Down)''
|-
| browser_zoom_in
| '''mouse_wheel_up'''
|-
| browser_zoom_out
| '''mouse_wheel_down'''
|-
| browser_confirm
| '''enter'''
|-
| currentelements_up
| '''num_8''' || ''(Numpad key 8)''
|-
| currentelements_down
| '''num_2''' || ''(Numpad key 2)''
|-
| toggle_test
| '''F5'''
|}

==Multiplayer==
Az '''editor''' két részből épül fel, szerver oldalból, és client oldalból, és ezért támogatja a multiplayer-t is. Az '''editor''' más játékosokkal való használatához egyszerűen csak másolja át az összes '''editor''' resource-ot a szerverébe, indítsa el, majd engedélyezze a játékosok csatlakozását a szerverhez.

Vegye figyelemben, hogy jelenleg az editornak nincs engedélyezési rendszere, szóval minden felhasználó hozzáférhet minden function-hoz.

==Pluginok és külső resource-ok==
{{Main|HU/Resource:Editor/Plugins}}

Az edirot lehetővé teszi külső resource-ból való elemek importálását. Ez olyan resource-ok esetén hasznos, ahol olyan elemeket kell kezelniük, amelyeket már az editor nem képes elvégezni. Például, egy map resource, mely egyéni modelleket használ (és van egy script, ami importálja ezeket a modelleket) nem lehet szerkeszteni alapértelmezetten az editor-ban.

Az '''import <resourceName>''' parancs használatával a resource elemei importálhatóak lesznek az editor-ban.

==Gyakran Ismételt Kérdések==
==== A Map Editor elindításakor fekete képernyő jelenik meg ====

Általában ez a Map Editor resource-ok helytelen telepítése miatt következik be. Ha egy stabil MTASA client-et használ, kérjük teleptíse újra, és győződjön meg róla, hogy a Client and Server telepítési opciót használja.

Ha a nightly build-et használja, frissítse a legújjabb verzióra a megfelelő működéshez [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 resources (step 3)], csomagolja ki és a tartalmát helyezze a:
''MTA San Andreas\server\mods\deathmatch\resources''-ba, ahol az "MTA San Andreas" az a mappa, ahova az MTA San Andreas-ot telepítette (alapértelmezett hely: C:\Program Files\MTA San Andreas).

Tegye őket erre az elérési útra: MTA San Andreas\mods\deathmatch\resources '''ez egy gyakori hiba''' - nem fog működni, ha nem ide teszi őket. Tehát győződjön meg arról, hogy a "dőlt" útvonalon helyezte el őket.

Ha ez a probléma továbbra is fennáll, még akkor is, ha ellenőrizte a fenti megjegyzést, valamint ellenőrizte, hogy helyesen telepítette-e, talnán azért lehet, mert egy elavult '''acl.xml''' fájlt használ. [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml Itt] letölheti az lapértelmezettet. Ezt az MTA:San Andreas telepítési mappán belül a '''server/mods/deathmatch/''' mappába kell helyeznie.

==== "Map Editor" gomb használatakor ezt az üzenetet kaptam "Nem sikerült elindítani a helyi szervert. Információkért nyissa meg a konzolt" ====
Ez azért van, mert nem egy érvényes editor.conf fájl van telepítve. [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf Itt] letölheti az lapértelmezettet. Ezt az MTA:San Andreas telepítési mappán belül a '''server/mods/deathmatch/''' mappába kell helyeznie.

==== Elmentettem egy mapot, de nem találom a szerverem resources könyvtárában annak ellenére, hogy maga az Editor képes látni azt ====
Ez amiatt van, hogy a Vista/7 limitálja a nem adminként futó programok hozzáférését a Program Files könyvtárhoz. A fájlok az igazi Program Files könyvtár helyett a "VirtualStore"-ba kerülnek. A map resource-ot megtalálhatja egy ehhez hasonló könyvtárban:
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\

A Server/MTA San Andreas futtatása rendszergazdaként lehetővé teszi, hogy a map a megfelelő helyre kerüljön.

==== Más problémáim vannak a map editor-al ====

Néha az editor újra telepítése számos problémát megoldhat. Ennek legegyszerűbb módja az, ha az MTA:SA-t egy teljesen új mappába telepíti. Vagy kipóbálhatja ezeket a módszereket is:
::1. Menjen a resources mappába, '''server/mods/deathmatch/resources/''' és törölje ki az '''editor_dump''' könyvtárat
::2. Menjen a resources mappába, '''server/mods/deathmatch/resources/''' és törölje ki az '''editor_test''' könyvtárat

==== Találtam egy hibát, vagy javaslatom/visszajelzésem van a map editor-al kapcsolatban ====
Kérjük, hogy a hibák jelentése érdekében használja a [http://bugs.mtasa.com bugtracker] oldalt. Bátran csatlakozhat hozzánk az [http://www.multitheftauto.com/irc.html IRC-n] is.

[[en:Resource:Editor]]
[[ru:Resource:Editor]]
[[es:Resource:Editor]]

==Fordította==
'''2018.11.11.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

HU/Resource:Editor

2020-02-25T09:57:19Z

Surge: /* Pluginok és külső resource-ok */

{{Resource page}}
Az MTA:SA map editor lehetővé teszi, hogy mapokat hozzon létre gamemode-ok számára.

==Kezdés==
Az editor elindításához csak egyszerűen kattintson a "Map editor" menüpontra az MTA főmenüjében.

==Menük==
Miután elindult az editor, két menüsáv fog megjelenni: a főmenü a tetején, és az elem menü a bal alsó sarokban.

===Főmenü===
Ezeket a gombokat láthatja a főmenüben:
* [[Image:Editor_New.png]] Új map létrehozása.
* [[Image:Editor_Open.png]] Meglévő map megnyitása.
* [[Image:Editor_Save.png]] Az aktuális map elmentése.
* [[Image:Editor_Save_as.png]] A map elmentése egy másik névre.
* [[Image:Editor_Options.png]] Az általános map editor beállításainak módosítása.
* [[Image:Editor_Undo.png]] Az utolsó művelet visszavonása.
* [[Image:Editor_Redo.png]] Visszaállítja az utolsó befejezetlen műveletet.
* [[Image:Editor_Locations.png]] A játék tárolt helyszínei. Az editor tartalmaz egy jelentős mértékű Interior helyszínt a San Andreas-ból, emellett készíthet saját interiort és non-interior helyszínt a listához.
* [[Image:Editor_Current_elements.png]] Listázza a map összes elemét (objektek, járművek, marker-ek, pickup-ok, stb.)
* [[Image:Editor_Map_settings.png]] A map sajátos beállításai, mint pl. a napszak, gravitáció stb. Itt megadhatja, hogy a map milyen gamemódokkal legyen kompatibilis.
* [[Image:Editor_Definitions.png]] Töltse fel az [[HU/Resource:Editor/EDF|editort definiáló fájlokat (EDF)]], amelyeket használni szeretne.
* [[Image:Editor_Test.png]] Play mode-ba helyez, hogy kipróbálhassa a mapot. Ez betölti a gamemode-ot, amelyre a map készült.

===Elem menü===
Az elem menü a maphoz új elemek hozzáadására szolgál.
* [[Image:Editor_Vehicle.png]] Egy új jármű létrehozása.
* [[Image:Editor_Object.png]] Egy új object létrehozása (épületek, utak és más elemek).
* [[Image:Editor_Pickup.png]] Egy új pickup létrehozása (health, armor, weapons and custom).
* [[Image:Editor_Marker.png]] Egy új marker létrehozása (checkpoint, ring, cylinder, arrow and corona).
* [[File:Crosshair.png‎]] World object kiválasztása.
Ezen kívül, ha [[HU/Resource:Editor/EDF|van betöltött editort definiáló fájl (EDF)]], akkor görgethet az egérrel a menüben, hogy előhozza az egyedi elemeket.

==Az editor használata==
Ez a rész ismerteti a mapok létrehozásának és módosításának módját.

===Mozgás a map körül===
Amikor először elindítja az editort, akkor ''camera mode''-ban van. A '''WSAD''' gombokkal és az egérrel mozgathatja a kamerát. Mozgás közben az '''ALT''' lenyomásával lassíthatja, vagy a '''SHIFT'''-el gyorsíthatja a kamera mozgását.

Az editor kezelőfelületének és a kezelőpaneljének eléréséhez át kell váltania 'kurzor módba'. Az '''F''' gomb használatával tud váltani a kurzor mód és a kamera mód között. Kurzor módban a nézet rögzített, és az egérrel tudja mozgatni az elemeket és használni a grafikus felületet.

A kamera módot a képernyő közepén található kereszttel lehet felismerni. Használhatja az elemek kijelöléséhez és mozgatásához, csakúgy, mint a kurzor módban.

[[Image:Editor_Crosshair.png|center]]

===Egy új map indítása===
* Indítsa el az editort, vagy ha már elindította kattintson a ''New'' menü gombra.
* Kattintson a ''Map settings'' gombra. A ''Meta'' fülben töltse ki a Name és az Author mezőket a map nevével, illetve az Ön nevével. Valamint nyissa meg a ''Gamemodes'' fület, és addja hozzá azokat a gamemódokat, amelyekre a map készült (''Added gamemodes'' listához lesznek helyezve). Ezt úgy teheti meg, hogy kiválasztja őket, majd rákattint az ''Add'' gombra, vagy kétszer rájuk kattint. Majd kattintson az OK-ra, ha készen van.
[[Image:Editor_Mapsettings.png|center]]
* Kattintson a ''Definitions'' ablakra és adja hozzá azokat a resource-okat, amelyekhez az egyéni elemeket szeretné használni. Ezek a "Map settings" ablakban kiválasztott gamemode-ekből és esetleges további resource-kből állnak. További infórmáciért az editor definitions-ról olvassa el az [[HU/Resource:Editor/EDF|EDF]] oldalt. Majd kattintson az OK-ra, ha készen van.

===Új elem létrehozása===
Nagyon egyszerűen adhat hozzá elemeket a maphoz, például járműveket, objekteket.
* Ha kamera módban van, akkor váltson kurzor módba az '''F''' megnyomásával.
* Kattintson az element menüben lévő gombra, amely a kívánt tartalmat jelöli. Például kattintson a jármű gombra egy jármű hozzáadásához.
* A kiválasztott típus egy új eleme lesz létrehozva és hozzácsatolva a kurzorhoz. Helyezze arra a helyre, ahova szeretné, és a '''bal egérrel''' engedje el.

[[Image:Editor_Addelem.png|center]]

Egyéni elemek létrehozásához, melyek a resource-ra jellemzőek vigye az egerét az element menü fölé, és görgessen addig, míg a kívánt resource elő nem jön. Vegye figyelembe, hogy ennek működése érdekében hozzá kell adnia a resource [[Resource:Editor/EDF|EDF]] fájlját a ''Definitions'' ablakba.

[[Image:Editor_Selectedf.png|center]]

===Kiválasztás===
* A '''bal egérrel''' kattintson egy elemre, hogy kiválassza azt ''billentyűzet módban''.
* A '''jobb egérrel''' kattintson hogy kiválassza azt ''egér módban''.
* Nyomja meg a '''Szóközt''', vagy kattintson egy üres területre a kijelölés megszüntetéséhez.

A kiválasztott elemeket, ha van, sárga kurzorral jelöltük. Kevés collisionnal rendelkező elemeket (különösen az objektek) könnyen észlelni tudjuk a ''High sensitivity mode'' aktiválásával az '''E''' gomb lenyomásával.

A ''Current elements'' is használható az elemek kiválasztásához. A listában szereplő elemre való dupla kattintás kiválasztja azt ''billentyűzet módba''.

===Mozgatás===
Az elemeket többféle módon is tudja mozgatni.

'''Az egérrel'''
* Egyszerűen csak húzza, majd tegye le a '''bal egérgombbal'''.
vagy:
* Válassza ki az elemet egér módban ('''jobb egér'''), vigye oda, ahová szeretné, majd tegye le.

A kameramód használatával is tudja az elemek ''távolságát'' állítani, hogy távolabb, vagy közelebb legyen a kamerához, '''jobb egérrel''' kattintson az elemre majd görgessen az egérrel '''egérgörgő'''.

'''A billentyűzettel'''
* Válassza ki az elemet billentyűzet módban ('''bal egérgomb''').
* Használja a '''nyilakat''' az elem vízszintes való mozgatásához, és a '''PgUp'''/'''PgDn''' a függőleges mozgatáshoz. Tartsa lenyomva az '''ALT''' gombot a mozgási sebesség csökkentéséhez, vagy a '''SHIFT'''-et a növeléséhez.
Alapértelmezetten az elemek relatívan mozognak a kamerához, és nincsenek tengelyükhöz rögzítve. Ezt le tudja tiltani az ''Options'' menüben.

===Forgatás===
'''Az egérrel'''

A kiválasztott elemeket a Z tengely körül elforgathatja az egérgörgővel.
* Válassza ki az elemet billentyűzet módban ('''bal egérgomb''') majd görgesse az egeret, míg a '''Left CTRL'''-t lenyomva tartja.
vagy:
* Válassza ki az elemet egér módban ('''jobb egér'''), tartsa lenyomva a '''CTRL'''-t, és görgessen az egérrel.

'''A billentyűzettel'''
* Válassza ki az elemet billentyűzet módban ('''bal egérgomb''').
* Amíg lenyomva tartja a '''CTRL'''-t (a kijelölési marker zöldre vált), használja az '''arrow keys''' és a '''PgUp'''/'''PgDn''', hogy az elemet eltérő tengelyek körül forgassa.

Ezen felül mind a két módszernél lenyomva tarthatja az '''ALT''' billentyűt a forgási sebesség csökkentéséhez, vagy a '''SHIFT'''-et a növeléséhez.

[[Image:Editor_Rotateelem.png|center]]

===Modell és egyéb tulajdonságok módosítása===
A legtöbb elemnek számos modosítási lehetősége van, melyeknek a megjelenésük és a viselkedésük megváltoztatható. Például a modellek, szín és vizuális változásokat is végezhetünk.

* Nyissa meg egy elem 'properties' ablakát dupla kattintással, vagy az '''F3''' megynyomásával.
* Végezzen olyan módosításokat, amelyeket szeretne. Például, egy autó vagy objekt modelljének megváltoztatásához kattintson a '''Browse''' gombra, mely a "model" mellett található.
* Majd kattintson az OK-ra, ha készen van.

[[Image:Editor_Props.png|center]]

===Klónozás===
Az elem kiválasztásával és a '''C''' gomb lenyomásával klónozni tudja azt.

* Egér módban a klónozott elem a kurzorhoz lesz csatolva. Nyomja le a '''bal egeret''', hogy elhelyezze a mapon.
* A billentyűzet módban a klónozott eleme az ugyan abban a helyzetbe klónozódik.

Ha lenyomva tartja a '''CTRL'''-t amíg kattint, akkor az elemet újra klónozza és megint a kurzorhoz lesz csatolva. Így könnyen el tud helyezni sok darabot valamiből.

Alternatív megoldásként a 'properties' box jobb alsó sarkában lévő ''Pullout'' gomb megnyomásával is klónozhat egy elemet.

===Törlés===
Egyszerűen válassza ki az elemet, majd nyomja meg a '''DEL''' gombot, ''(Delete)''.

Alternatív megoldásként a 'properties' box jobb alsó sarkában lévő ''Pullout'' gomb megnyomásával is törölhet egy elemet.

==Mapok készítése sajátos gamemode-okhoz==
Két dolgot kell tenni a sajátos gamemode-okhoz való mapok készítésekor:
* Kattintson a '''Map Settings''' gombra a fenti menüben, menjen a '''Gamemodes''' fülre, majd adja hozzá azokat a gamemode-okat, amelyket a mapjához szeretne használni.
* Valószínűleg majd hozzá kell adnia egy, vagy több [[HU/Resource:Editor/EDF|editort definiáló fájlt (EDF)]] is. Ez lehetővé teszi, hogy sajátos gamemode elemeket helyezzen a map-ba, mint például spawnpoints, race checkpoints, vagy CTF flags. A '''Definitions''' menü gombjára kattintva hozzáadhatja az EDF-eket a megfelelő gamemode-ekhez.

==Irányítás==
Itt található az alapértelmezett irányítások listája. Ezek megváltoztatásához menjen az MTA beállítások menüjébe, amíg az Editor el van indítva.

===Camera===
{|
|-
| camera_move_forwards
| '''w'''
|-
| camera_move_backwards
| '''s'''
|-
| camera_move_left
| '''a'''
|-
| camera_move_right
| '''d'''
|-
| high_sensitivity_mode
| '''e'''
|}

===Cloning===
{|
|-
| clone_selected_element
| '''c'''
|-
| clone_drop_modifier
| '''lctrl''' || ''(Left CTRL)''
|}

===Element manipulation===
{|
|-
| element_move_forward
| '''arrow_u''' || ''(Arrow key Up)''
|-
| element_move_backward
| '''arrow_d''' || ''(Arrow key Down)''
|-
| element_move_left
| '''arrow_l''' || ''(Arrow key Left)''
|-
| element_move_right
| '''arrow_r''' || ''(Arrow key Right)''
|-
| element_move_downwards
| '''pgdn''' || ''(Page Down)''
|-
| element_move_upwards
| '''pgup''' || ''(Page Up)''
|-
| zoom_in
| '''mouse_wheel_down'''
|-
| zoom_out
| '''mouse_wheel_up'''
|-
| quick_rotate_increase
| '''mod_rotate''' + '''mouse_wheel_up''' || ''(Left CTRL + Mouse wheel Up)''
|-
| quick_rotate_decrease
| '''mod_rotate''' + '''mouse_wheel_down''' || ''(Left CTRL + Mouse wheel Down)''
|-
| mod_rotate
| '''lctrl''' || ''(Left CTRL)''
|-
| mod_slow_speed
| '''lalt''' || ''(Left ALT)''
|-
| mod_fast_speed
| '''lshift''' || ''(Left SHIFT)''
|-
| destroy_selected_element
| '''delete'''
|-
| drop_selected_element
| '''space'''
|-
| pickup_selected_element
| '''F2'''
|-
| reset_rotation
| '''mod_rotate''' + '''r''' || ''(Left CTRL + R)''
|}

===GUI===
{|
| toggle_gui_display
| '''F4'''
|-
| toggle_cursor
| '''f'''
|-
| select_target_keyboard
| '''mouse1''' || ''(Left Mouse button)''
|-
| select_target_mouse
| '''mouse2''' || ''(Right Mouse button)''
|-
| edf_next
| '''mouse_wheel_up'''
|-
| edf_prev
| '''mouse_wheel_down'''
|-
| undo
| '''Ctrl''' + '''z'''
|-
| redo
| '''Ctrl''' + '''y'''
|-
| properties_toggle
| '''F3'''
|-
| browser_up
| '''arrow_u''' || ''(Arrow key Up)''
|-
| browser_down
| '''arrow_d''' || ''(Arrow key Down)''
|-
| browser_zoom_in
| '''mouse_wheel_up'''
|-
| browser_zoom_out
| '''mouse_wheel_down'''
|-
| browser_confirm
| '''enter'''
|-
| currentelements_up
| '''num_8''' || ''(Numpad key 8)''
|-
| currentelements_down
| '''num_2''' || ''(Numpad key 2)''
|-
| toggle_test
| '''F5'''
|}

==Multiplayer==
Az '''editor''' két részből épül fel, szerver oldalból, és client oldalból, és ezért támogatja a multiplayer-t is. Az '''editor''' más játékosokkal való használatához egyszerűen csak másolja át az összes '''editor''' resource-ot a szerverébe, indítsa el, majd engedélyezze a játékosok csatlakozását a szerverhez.

Vegye figyelemben, hogy jelenleg az editornak nincs engedélyezési rendszere, szóval minden felhasználó hozzáférhet minden function-hoz.

==Pluginok és külső resource-ok==
{{Main|HU/Resource:Editor/Plugins}}

Az edirot lehetővé teszi külső resource-ból való elemek importálását. Ez olyan resource-ok esetén hasznos, ahol olyan elemeket kell kezelniük, amelyeket már az editor nem képes elvégezni. Például, egy map resource, mely egyéni modelleket használ (és van egy script, ami importálja ezeket a modelleket) nem lehet szerkeszteni alapértelmezetten az editor-ban.

Az '''import <resourceName>''' parancs használatával a resource elemei importálhatóak lesznek az editor-ban.

==Gyakran Ismételt Kérdések==
==== A Map Editor elindításakor fekete képernyő jelenik meg ====

Általában ez a Map Editor resource-ok helytelen telepítése miatt következik be. Ha egy stabil MTASA client-et használ, kérjük teleptíse újra, és győződjön meg róla, hogy a Client and Server telepítési opciót használja.

Ha a nightly build-et használja, frissítse a legújjabb verzióra a megfelelő működéshez [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 resources (step 3)], csomagolja ki és a tartalmát helyette a:
''MTA San Andreas\server\mods\deathmatch\resources''-ba, ahol az "MTA San Andreas" az a mappa, ahova az MTA San Andreas-ot telepítette (alapértelmezett hely: C:\Program Files\MTA San Andreas).

Tegye őket erre az elérési útra: MTA San Andreas\mods\deathmatch\resources '''ez egy gyakori hiba''' - nem fog működni, ha nem ide teszi őket. Tehát győződjön meg arról, hogy a "dőlt" útvonalon helyezte el őket.

Ha ez a probléma továbbra is fennáll, még akkor is, ha ellenőrizte a fenti megjegyzést, valamint ellenőrizte, hogy helyesen telepítette-e, talnán azért lehet, mert egy elavult '''acl.xml''' fájlt használ. [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml Itt] letölheti az lapértelmezettet. Ezt az MTA:San Andreas telepítési mappán belül a '''server/mods/deathmatch/''' mappába kell helyeznie.

==== "Map Editor" gomb használatakor ezt az üzenetet kaptam "Nem sikerült elindítani a helyi szervert. Információkért nyissa meg a konzolt" ====
Ez azért van, mert nem egy érvényes editor.conf fájl van telepítve. [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf Itt] letölheti az lapértelmezettet. Ezt az MTA:San Andreas telepítési mappán belül a '''server/mods/deathmatch/''' mappába kell helyeznie.

==== Elmentettem egy mapot, de nem találom a szerverem resources könyvtárában annak ellenére, hogy maga az Editor képes látni azt ====
Ez amiatt van, hogy a Vista/7 limitálja a nem adminként futó programok hozzáférését a Program Files könyvtárhoz. A fájlok az igazi Program Files könyvtár helyett a "VirtualStore"-ba kerülnek. A map resource-ot megtalálhatja egy ehhez hasonló könyvtárban:
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\

A Server/MTA San Andreas futtatása rendszergazdaként lehetővé teszi, hogy a map a megfelelő helyre kerüljön.

==== Más problémáim vannak a map editor-al ====

Néha az editor újra telepítése számos problémát megoldhat. Ennek legegyszerűbb módja az, ha az MTA:SA-t egy teljesen új mappába telepíti. Vagy kipóbálhatja ezeket a módszereket is:
::1. Menjen a resources mappába, '''server/mods/deathmatch/resources/''' és törölje ki az '''editor_dump''' könyvtárat
::2. Menjen a resources mappába, '''server/mods/deathmatch/resources/''' és törölje ki az '''editor_test''' könyvtárat

==== Találtam egy hibát, vagy javaslatom/visszajelzésem van a map editor-al kapcsolatban ====
Kérjük, hogy a hibák jelentése érdekében használja a [http://bugs.mtasa.com bugtracker] oldalt. Bátran csatlakozhat hozzánk az [http://www.multitheftauto.com/irc.html IRC-n] is.

[[en:Resource:Editor]]
[[ru:Resource:Editor]]
[[es:Resource:Editor]]

==Fordította==
'''2018.11.11.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

HU/setCursorPosition

2019-10-15T12:20:51Z

Surge: /* Problémák */

{{Client function hu}}
__NOTOC__
Ez a function beállítja az kurzor aktuális pozícióját.

==Szintaxis==
<syntaxhighlight lang="lua">
bool setCursorPosition ( int cursorX, int cursorY )
</syntaxhighlight>

===Kötelező paraméterek===

*'''cursorX:''' Position over the X axis
*'''cursorY:''' Position over the Y axis

===Visszatérési érték===

Visszatérési értéke ''true'', ha a pozíció sikeresen be lett állítva, egyébként ''false''.

==Példa==
Ez a példa a kurzor pozícióját a képernyő közepére állítja a ''centerCursor'' parancs használata után.
<syntaxhighlight lang="lua">
function centerCursorFunction()
local showing = isCursorShowing ()
if showing then -- if the cursor is showing
local screenX, screenY = guiGetScreenSize () --get the screen size in pixels
setCursorPosition (screenX/2, screenY/2) --set the cursor position to the center of the screen
else
outputChatBox( "Your cursor is not showing." )
end
end
addCommandHandler( "centerCursor", centerCursorFunction )
</syntaxhighlight>

==Problémák==
{{Issues|
{{Issue|8941|setCursorPosition javítva}}
}}

==Lásd még==
{{Client_input_functions hu}}

[[en:setCursorPosition]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/setCursorPosition

2019-10-15T12:20:28Z

Surge: /* Problémák */

{{Client function hu}}
__NOTOC__
Ez a function beállítja az kurzor aktuális pozícióját.

==Szintaxis==
<syntaxhighlight lang="lua">
bool setCursorPosition ( int cursorX, int cursorY )
</syntaxhighlight>

===Kötelező paraméterek===

*'''cursorX:''' Position over the X axis
*'''cursorY:''' Position over the Y axis

===Visszatérési érték===

Visszatérési értéke ''true'', ha a pozíció sikeresen be lett állítva, egyébként ''false''.

==Példa==
Ez a példa a kurzor pozícióját a képernyő közepére állítja a ''centerCursor'' parancs használata után.
<syntaxhighlight lang="lua">
function centerCursorFunction()
local showing = isCursorShowing ()
if showing then -- if the cursor is showing
local screenX, screenY = guiGetScreenSize () --get the screen size in pixels
setCursorPosition (screenX/2, screenY/2) --set the cursor position to the center of the screen
else
outputChatBox( "Your cursor is not showing." )
end
end
addCommandHandler( "centerCursor", centerCursorFunction )
</syntaxhighlight>

==Problémák==
{{Issues|
{{Issue|8941|setCursorPosition javitva}}
}}

==Lásd még==
{{Client_input_functions hu}}

[[en:setCursorPosition]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/account

2019-09-14T20:39:21Z

Surge:

Az '''account''' osztály a szerveren lévő [[HU/Element/Player|játékos]] felhasználóját jelenti. Bármely klienshez tartozó '''account''' objektum lekérdezhető a [[HU/getPlayerAccount]] hívással.

Minden kliens accountja egyedi, valamint infórmáicók tárolásához is használható, ami megmarad a felhasználói munkamenetben, így pályaváltáskor is. Az account nélkül csatlakozó kliensek ideiglenesen egy 'guest' accountot kapnak. Ez ugyan úgy képes információkat tárolni, mint bármelyik más account, de az adatok nem kerülnek mentésre.

Ha a játékos bejelentkezik, vagy ki, akkor a hozzárendelt account objektum megváltozik. Ezért nem szabad azt feltételeznie, hogy a klienshez csatolt account állandó marad a munkamenet során.

A PHP kód, mely ellenőrzi a jelszó hash-eket az MTA adatbáziból [[Account_PHP|itt]] találhaó.

==Related scripting functions==
===Server===
{{Account functions hu}}
[[Category:Scripting Concepts]]

[[en:Account]]
[[ru:Account]]
[[pl:Account]]
[[it:Account]]
[[de:Account]]

==Fordította==
'''2018.12.14.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

HU/Resource Web Access

2019-08-30T19:06:22Z

Surge:

A Multi Theft Auto Server egy olyan webes felületet biztosít, melyet a resource-ok sokféle módon tudnak használni. Ennek a dokumentumnak az a célja, hogy elmagyarázza mik ezek a módszerek, és hogy hogyan kell őket használni.
==Összefoglalás==
Két fontos rész alkotja ezt a rendszert. Az első az egy szabványos webszerver, amely lehetővé teszi a webböngészők számára, hogy oldalakat, és fájlokat kérjenek a resource-ból. A második egy olyan rendszer, amely lehetővé teszi a webböngészők számára, hogy a resource-ból exportált function-öket meghívja.

==Oldalak==
===A fájl megadása a meta-ban===
Megadhatja a resource meta fájljában, hogy bizonyos fájlok hozzáférhetőek legyenek a webszerveren keresztül. Ehhez adja hozzá ezt a sort:
<syntaxhighlight lang="xml">
<html src="filename.ext" />
</syntaxhighlight>
Ezt követően elérheti ezt a fájlt a webböngészőn keresztül: http://host:port/resourcename/filename.ext<br/>
Például, egy localisan futattott szerveren az alapéretelmezett http port-ot használja a webmap indításakor: http://127.0.0.1:22005/webmap/map.htm

===Bináris fájlok===
A félrevezető név ellenére a ''html'' segítségével megadott fájlok bármilyen típusúak lehetnek. Ha ezek bináris fájlok (például képek, zip fájlok), akkor meg kell adnia ezt a meta fájlban a ''raw="true"'' hozzáadásával a ''html''-hez. Ez azt jelenti, hogy a fájlok nem kerülnek előfeldolgozásra mielőtt a webböngészőnek küldenénk.

Például:
<syntaxhighlight lang="xml">
<html src="image.gif" raw="true" />
</syntaxhighlight>

===Parsed files===
Ha egy fájlt nem adjuk meg a meta-ban, mint "raw", akkor az végig megy egy előfeldolgozáson mielőtt a klienshez visszatérne. Ez az előfeldolgosás hasonlóképp műkodik, mint a PHP-nál vagy ASP-nél, csak LUA-t használ. A szabványos MTA szkripteket beágyazhatja a HTML oldalakba, ellenőrizve a kimenetet. Szinte az összes szabványos MTA funkciók működnek, plusz néhány speciális [[Template:HTTP functions|HTTP funkciók]], mint például [[httpWrite]], ez egy olyan function, amely szöveget küld a pufferbe.

Például:
<syntaxhighlight lang="html4strict">
<html>
<body>
This resource is called <* httpWrite( getResourceName(getThisResource()) ) *>
</body>
<html>
</syntaxhighlight>

Itt egy rövidítés (gyakori a PHP-ban és az ASP-ben) azaz, a fenti kódot írhajta így is:

<syntaxhighlight lang="html4strict">
<html>
<body>
This resource is called <* = getResourceName(getThisResource()) *>
</body>
<html>
</syntaxhighlight>

A HTTP funkcióktól eltekintve a beágyazott Lua a következő környezeti változókhoz fér hozzá, amelyek információkat tartalmaznak az oldalak kérésével kapcsolatban:
* '''requestHeaders''' tábla: Ez a tábla tartalmazza az összes fejlécet, melyek az oldal által lettek lekérdezve. A visszaadott fejléceket beállíthatja a [[httpSetResponseHeader]] segítségével.
* '''form''' tábla: Ez egy tábla, ami tartalmazza a HTTP GET query string és HTTP POST form paramétereket.
* '''cookies''' tábla: Ez egy táblázat az összes cookie-ről. A [[httpSetResponseCookie]] használatával modosíthatja a cookie-ket.
* '''hostname''' string : Ez egy string, mely tartalmazza az oldal által kért IP címet, vagy hostname-t.
* '''url''' string : Ez az oldal URL-je.
* '''user''' account : Ez a jelenlegi felhasználó accountja.

Fontos megjegyezni, hogy az elemzett fájlok külön virtuális gépen futnak a resource kódjának többi részétől. Ha egy function-t szeretne meghívni a resource fő kódjában, akkor exportálnia kell a function-t az elemzett fájlból a [[call]] function használatával.

==Calls==
Megadhatja, hogy a resourceban lévő exportált függvények meghívhatóak legyenek a HTTP felületről. Az összes SDKs (lentebb listázva) lehetővé teszi, hogy ezeket a függvényeket meghívja egy távolabbi helyről.

Ahhoz, hogy egy http-n keresztül elérhető függvényt létrehozzon, adja hozzá a következő sort a meta.xml fájlba:
<syntaxhighlight lang="xml">
<export function='functionName' http='true' />
</syntaxhighlight>

Írhatja úgy is a függvényét, mint bármilyen normális függvényt, visszakapva annyi értéket, amennyit csak szeretne, beleértve a táblákat, resource-okat, és a legfontosabb elemeket. Nem térhet vissza más userdata értékkel, mint pl az [[xmlnode|xmlnode]], vagy függvények.

===Protokoll===
{{note_box_hu|Nem szükséges tudnia ezeket, hacsak nem a saját HTTP kódját írja. Csak az alábbiakban [[#SDK|felsorolt SDK-k]] egyikét használhatja.}}

Calls are done by requesting ''<nowiki>http://<your IP>:<your port>/<resource_name>/call/<exported_function_name></nowiki>'' using HTTP POST. The body of the request should be a JSON array of the arguments for the function.

The request will return a JSON array of the value(s) returned from the function as the HTTP response.

The server supports HTTP Basic authentication and you can configure access via the ACL and the built-in accounts system.

===Calls from the HTTP web interface===
Using calls is probably easiest from the web interface and can be done almost seamlessly.

First, add this to your meta.xml file:
<syntaxhighlight lang="xml">
<include resource="ajax" />
</syntaxhighlight>

Secondly, add the following to the <head> section of the page you want to call from:
<syntaxhighlight lang="lua">
<* = exports.ajax:start(getResourceName(getThisResource())) *>
</syntaxhighlight>

Finally, you can create a javascript block in your page and call your functions almost as if they were local. The only difference is that the calls are aysnchronous - you should specify a callback function as the last argument for your call. This is called when the function returns.

Here's a simple example.

'''meta.xml'''
<syntaxhighlight lang="xml">
<meta>
<include resource="ajax" />
<script src='code.lua' />
<html src='page.htm' default='true' />
<export function='showChatMessage' http='true' />
</meta>
</syntaxhighlight>

'''code.lua'''
<syntaxhighlight lang="lua">
function showChatMessage ( message )
outputChatBox ( message )
return 5;
end
</syntaxhighlight>

'''page.htm'''
<syntaxhighlight lang="html4strict">
<html>
<head>
<* = exports.ajax:start(getResourceName(getThisResource())) *>
<script type='text/javascript'>
function say() {
var message = document.getElementById('message')
showChatMessage ( message.value,
function ( number ) {
// the function has been called and returned something
message.value = "The function returned " + number;
}
);
}
</script>
</head>
<body>
<input type='text' id='message' /><input type='button' value='say' onclick='say();' />
</body>
</html>
</syntaxhighlight>

You can see (fairly complex) examples of how this can be done in the resources ''resourcebrowser'', ''resourcemanager'' and ''webadmin''.

==Securing the web interface==
The [[ACL]] has a number of rights that can affect what files can be accessed.
{{Deprecated feature|3.0139|1.3.1|
* general.http: If disabled, none of the http files can be accessed (except by game clients)
** '''Important Note''': ''If 'general.http' is enabled, http access to all resources (for that ACL) is enabled by default. To disable http access you have to explicitly block access to resources that contain exported http functions.''
** '''Important Note''': ''If 'general.http' is enabled on an ACL which has a user with no password (i.e. user.* or user.guest or user.http_guest), it is essential that you explicitly block access to resources that contain exported http functions.''
* resource.'''ResourceName''': If disabled, none of the files in the resource can be accessed
* resource.'''ResourceName'''.file.'''FileName''': If disabled, the file named cannot be accessed
* resource.'''ResourceName'''.function.'''FunctionName''': If disabled, the function cannot be called
These work as with other ACL rights - you can disable them for normal users and just enable them for Admin users, or any other group of users you wish.
}}
{{New_feature|3.0139|1.3.1|
* '''resource.ResourceName.http''': If enabled, the resource will be accessible from http://server_ip:22005/ResourceName/
This works as with other ACL rights - You can enable it just for Admin users, or any other group of users you wish.
}}

==SDK==
There are a number of so-called 'SDKs' available that allow you to interface with the server from other programming languages. With these you could (in theory) write whole gamemodes. In practice this is probably a bad idea, but it is useful for statistics and administration. The PHP SDK is the most developed version. Feel free to modify or create your own SDKs - if you do please send us a copy.

* [[JavaSDK|Java SDK]]
* [[Javascript SDK]]
* [[Perl SDK]]
* [[PHP SDK]]
* [[CSharp SDK|C# SDK]]

==See Also==
[[callRemote]] - Allows game servers to call functions on PHP pages (with the PHP SDK) and on other game servers.
[[Category:Scripting Concepts]]
[[en:Resource Web Access]]
[[ru:Resource Web Access]]
[[Category:Tutorials]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/Meta.xml

2019-08-30T19:03:40Z

Surge:

A ''meta.xml'' fájl metaadatokkal látja el az MTA-t, ez a fájl tartalmazza - többek között - például a resource nevét, a betöltendő scripteket, valamint a kliensekre letöltendő fájlok listáját. XML nyelven íródik, ami a HTML-ből származik, és az XHTML alapja.

=Tags=
Az XML olyan szöveges adatformátum, amelyet széles körben használnak az adatok ábrázolásához. Az MTA XML alapú nyelvet használ a resource-ok metaadatainak leírására a következő címkék használatával:

*'''<info />''' Információ a resource-ról, lehetséges paraméterek (minden tetszőleges paraméter használható és olvasható a [[getResourceInfo]] segítségével):
** '''author:''' A resource készítője
** '''version:''' A resource verziója
** '''name:''' A resource neve
** '''description:''' A resource rövid leírása
** '''type:''' A resource típusa, ami lehet "gamemode", "script", "map" vagy "misc".
** '''gamemodes:''' A gamemódok kompatibilisek a resource-al. Ez nem a gamemode neve, hanem a gamemode resource neve. Ha azt szeretné, hogy több gamemode-dal is kompatibilis legyen, akkor ez egy vesszővel elválasztott felsorolás kell legyen. (e.g. gamemodes="test1,test2").
*'''<script />''' Script fájl ehhez a resource-hoz, a lehetséges paraméterek:
** '''src:''' A fájl relatív elérési útvonala. Például, ha közvetlenül a resource mappájában van egy "script.lua", akkor az elérési útvonala "script.lua" lesz. Ha a "scripts" mappán belül van, akkor ez "scripts/script.lua" lesz.
** '''type:''' A resource típusa: "client", "server" vagy "shared".
**'''cache:''' Amikor a script fájl típus "client", ez a beállítás szabályozza, hogy a fájl mentve legyen-e a játékos merevlemezén. Alapértelmezetten ez "true". "false" használata azt jelenti, hogy a fájl nem kerül mentésre. ''(Note: cache=false files are started at the client first, so lua file load order might differ when mixing cache settings)''
**'''validate:''' If set to "false", compatibility checks are skipped.
*'''<map />''' Map fájl ehhez a resource-hoz, a lehetséges paraméterek:
**'''src:''' fájl név .map (can be path too eg. "maps/filename.map")
**'''dimension:''' Az a dimension, amelyben a map be lesz töltve (tetszőleges)
*'''<file />''' Egy client oldali fájl. Általában ezek a képek, .txd, .col, .dff vagy .xml fájlok. Ezeket a játékosok töltik le a resource indulásakor (vagy mikor felcsatlakoznak)
**'''src:''' client oldali fájlnév (can be path too eg. "images/image.png")
**'''download:''' Autómatikus lengyen-e a letöltés, vagy sem (tetszőleges). Alapértelmezetten ez "true". "false" használata azt jelenti, hogy a resource indulásakor nem kerül letöltésre a fájl, de később még lehet a [[downloadFile]] használatával.
*'''<include />''' Include resources that this resource will use
**'''resource:''' Resource name that you want to start with this resource
**'''minversion:''' Minimum version that '''resource''' needs to be (optional)
**'''maxversion:''' Maximum version that '''resource''' needs to be (optional)
*'''<config />''' Config file (.xml) can be accessed by resource, possible parameters are:
**'''src:''' The file name of the config file
**'''type:''' The type of the config file: "client" or "server"
*'''<export />''' This exports functions from this resource, so other resources can use them with [[call]]
**'''function:''' The function name
**'''type''' Whether function is exported server-side or client-side (valid values are: "client", "server" and "shared")
**'''http:''' Can the function be called via HTTP (true/false)
*'''<html />'''
**'''src:''' The filename for the HTTP file (can be a path)
**'''default:''' The html file is one that is shown by default when visiting /resourceName/ on the server. Only one html can be default, the rest are ignored. (true/false)
**'''raw:''' The html file is not parsed by the Lua interpreter and is treated as binary data. Must be used for binary files (images mainly) (true/false)
*'''<settings><setting name="" value="" /></settings>:''' Most gamemodes use [[settings system]] to let server admins to configure it how they like. For instance you could set round time and then use [[get]] and [[set]] to get the value or change it, respectively.
*'''<min_mta_version />''' Minimum version requirements for this resource to run correctly. When authoring resources, the minimum version should usually be set to the current released version of MTA:SA (which at the moment is "{{Current Version|full}}"). See example for example.
**'''client:''' The minimum client version
**'''server:''' The minimum server version
*'''<aclrequest />''' A list of [[Access_Control_List|ACL]] rights this resource will need.
{{New items|3.0132|1.3.1 r4141|
*'''<sync_map_element_data />''' Controls whether map [[Element_data|element data]] such as "PosX" and "DoubleSided" are transferred to the client. This data is usually not required by most gamemodes or resources. (Map Editor and Interiors require this to be not set to false to work). When set in a gamemode meta.xml, the setting will apply to all maps loaded by that resource.
**'''false:''' Disable transfer of map element data for all resources. This can reduce map download times considerably.
**'''true:''' Enable transfer of map element data for all resources. (If '''false''' and '''true''' are set in different resources, true will have priority and all resources will transfer map element data)
}}
{{New items|3.0140|1.4.0 r5313|
*'''<oop />''' OOP - Please refer to [[OOP]] for documentation.
**'''false:''' Disable OOP.
**'''true:''' Enable OOP.
}}
{{New feature/item|3.0150|1.5.0|7308|
*'''<download_priority_group />''' If not set, the download priority group for a resource defaults to 0. If this is set higher than 0, then the resource will be downloaded and started on the client earlier than other resources. If set to less than 0, the resource will be downloaded and started on the client later than other resources.
}}

== Példa ==
Itt egy meta fájl példa, mely az említett tagok némelyikét használja:
{{#tag:syntaxhighlight |
<meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>

<download_priority_group>0</download_priority_group>
<min_mta_version client="{{Current Version|full}}" server="{{Current Version|full}}" />

<sync_map_element_data>false</sync_map_element_data>

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client" validate="true"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>
<script src="riemann_z_demonstration.lua" type="client" cache="false"/>
<map src="base.map" dimension="1"/>

<file src="riot_shield.txd" download="false" />
<file src="riot_shield.dff" download="false" />
<file src="riot_shield.col" download="false" />
<file src="armor.png" />
<file src="camera.png" />
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<export function="exampleExport1" type="server" />
<export function="exampleExport2" type="client" />
<export function="exampleExport3" type="shared" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
<setting name="isAllowedToShoot" value="true" />
</settings>

<aclrequest>
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="function.setPlayerMuted" access="true" />
</aclrequest>
</meta>
|lang="xml"}}
[[Category:Scripting Concepts]]

[[en:Meta.xml]]
[[cs:Meta.xml]]
[[de:Meta.xml]]
[[es:Sobre el archivo "meta.xml"]]
[[it:Meta.xml]]
[[pl:Meta.xml]]
[[ru:Meta.xml]]

HU/setCameraMatrix

2019-08-11T10:33:53Z

Surge:

__NOTOC__
{{Server client function}}
This function sets the camera's position and direction. The first three arguments are the point at which the camera lies, the last three are the point the camera faces (or the point it "looks at").

{{Note|Calling this function takes the camera's focus away from the player and sets the camera in a fixed position and rotation. The camera's focus can be brought back to the player using the [[setCameraTarget]] function.}}

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool setCameraMatrix ( player thePlayer, float positionX, float positionY, float positionZ [, float lookAtX, float lookAtY, float lookAtZ, float roll = 0, float fov = 70 ] )
</syntaxhighlight>
{{OOP||[[player]]:setCameraMatrix|cameraMatrix|getCameraMatrix}}
===Required Arguments===
*'''thePlayer:''' The player whose camera is to be changed.
*'''positionX:''' The x coordinate of the camera's position.
*'''positionY:''' The y coordinate of the camera's position.
*'''positionZ:''' The z coordinate of the camera's position.
*'''{{New feature/item|3.0141|1.4.1|7005|Instead of six coordinates, or two vectors, a Matrix can be supplied.}}'''

===Optional Arguments===
*'''lookAtX:''' The x coordinate of the point the camera faces.
*'''lookAtY:''' The y coordinate of the point the camera faces.
*'''lookAtZ:''' The z coordinate of the point the camera faces.
*'''roll:''' The camera roll angle, -180 to 180. A value of 0 means the camera sits straight, positive values will turn it counter-clockwise and negative values will turn it clockwise. -180 or 180 means the camera is upside down.
*'''fov:''' the field of view angle, 0.01 to 180. The higher this value is, the more you will be able to see what is to your sides.
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool setCameraMatrix ( float positionX, float positionY, float positionZ [, float lookAtX, float lookAtY, float lookAtZ, float roll = 0, float fov = 70 ] )
</syntaxhighlight>
{{OOP|This is under the static class '''Camera'''|Camera.setMatrix|matrix|getCameraMatrix}}

===Required Arguments===
*'''positionX:''' The x coordinate of the camera's position.
*'''positionY:''' The y coordinate of the camera's position.
*'''positionZ:''' The z coordinate of the camera's position.
*'''{{New feature/item|3.0141|1.4.1|7005|Instead of six coordinates, or two vectors, a Matrix can be supplied.}}'''

===Optional Arguments===
*'''lookAtX:''' The x coordinate of the point the camera faces.
*'''lookAtY:''' The y coordinate of the point the camera faces.
*'''lookAtZ:''' The z coordinate of the point the camera faces.
*'''roll:''' The camera roll angle, -180 to 180. A value of 0 means the camera sits straight, positive values will turn it counter-clockwise and negative values will turn it clockwise. -180 or 180 means the camera is upside down.
*'''fov:''' the field of view angle, 0.01 to 180. The higher this value is, the more you will be able to see what is to your sides.
</section>

===Returns===
Returns ''true'' if the arguments are valid, ''false'' otherwise.

==Example==
This code fixates the camera onto the Vinewood sign in Los Santos for any player that joins the server:
<section class="server" name="Server script" show="true">
<syntaxhighlight lang="lua">
function setCameraOnPlayerJoin()
-- slowly fade the camera in to make the screen visible
fadeCamera(source, true, 5)
-- set the player's camera to a fixed position, looking at a fixed point
setCameraMatrix(source, 1468.8785400391, -919.25317382813, 100.153465271, 1468.388671875, -918.42474365234, 99.881813049316)
end
addEventHandler("onPlayerJoin", root, setCameraOnPlayerJoin)</syntaxhighlight>
</section>

==See Also==
{{Client camera functions hu}}

[[en:setCameraMatrix]]

HU/addCommandHandler

2019-08-11T10:32:59Z

Surge:

__NOTOC__
{{Shared function hu}}
{{Note_box_hu|Erősen ajánlott, hogy '''ne''' használd ugyan azt a nevet a függvényedhez és a parancshoz, mivel ez kavarodáshoz vezethet, ha több függvény is használatban van. Használj olyan nevet, mely pontosabban leírja, hogy mit csinál a parancsod.}}
Ez a függvény egy parancsot csatol az egy adott script függvényhez, így amikor ezt a parancsot a szerveren használják, a függvény meghívódik.<br/>
<br/>

Több command handler-t is hozzá csatolhatunk egy parancshoz, így abban a sorrendben hívódnak meg a függvények, ahogy a handler-ek sorrendje van. Fordítva, több parancsot is hozzá lehet csatolni egy függvényhez és a '''commandName''' paramétert használva eldönthetjük, hogy hogyan kezeljük a kérést.

A felhasználóknak a parancs formátuma:

'''commandName''' ''argumentum1'' ''argumentum2''

Ez meghívható közvetlen a játékos konzoljából vagy a chat-ben a per (''/'') elé téve. A szerver oldali handler-eket a szerver admin is meg tudja hívni a szerver konzoljából ugyan úgy, ahogy a játékos meghívja a konzoljából.

{{Note_hu|Nem használhatod a "check", "list" és "test" szavakat mint parancsot.}}

==Szintaxis==

<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool addCommandHandler ( string commandName, function handlerFunction [, bool restricted = false, bool caseSensitive = true ] )
</syntaxhighlight>

===Kötelező argumentumok===
*'''commandName:''' Ez a parancs neve amit a handler-hez csatol. Ez lesz az amit a játékos a konzolba beírva, vagy a chatben használva meg tudja hívni a függvényt.
*'''handlerFunction:''' Ez a függvény amit a handler meg fog hívni. A handler-t a függvény '''után kell''' létrehozni. Ez átadja a függvények a játékost aki meghívta és a parancsot amit beírt. Ez után minden további argumentumot amit a játékos továbbá beírt (Lásd lejjebb). Ezek elhagyhatóak.
===Opcionális argumentumok===
{{OptionalArg_hu}}
*'''restricted:''' Ez meghatározza, hogy a parancs használata korlátozott-e. Amennyiben '''true''' értéket kap, az ACL alapján kitűzött korlátozásokat alkalmazza.
{{New feature|3|1.0|
*'''caseSensitive:''' Meghatározza, hogy a parancs beírása kis-/nagy-betű érzékeny-e.
}}

</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool addCommandHandler ( string commandName, function handlerFunction [, bool caseSensitive = true ] )
</syntaxhighlight>

===Kötelező argumentumok===
*'''commandName:''' Ez a parancs neve amit a handler-hez csatol. Ez lesz az amit a játékos a konzolba beírva, vagy a chatben használva meg tudja hívni a függvényt.
*'''handlerFunction:''' Ez a függvény amit a handler meg fog hívni. A handler-t a függvény '''után kell''' létrehozni. Ez átadja a függvények a játékost aki meghívta és a parancsot amit beírt. Ez után minden további argumentumot amit a játékos továbbá beírt (Lásd lejjebb). Ezek elhagyhatóak.
===Opcionális argumentumok===
{{OptionalArg_hu}}
{{New feature|3|1.0|
*'''caseSensitive:''' Meghatározza, hogy a parancs beírása kis-/nagy-betű érzékeny-e.
}}
</section>

====Handler függvény paraméterek====
Ezek azok a paraméterei a handler függvénynek, melyeket megkap a függvény a parancs meghívásakor.
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">player playerSource, string commandName [, string arg1, string arg2, ... ] </syntaxhighlight>

* '''playerSource:''' Ez az a játékos aki meghívta a parancsot vagy a [[Element/Console|szerver konzol]]. Ha nem játékos hívta meg (Pl. szerver admin vagy szerver konzol), akkor ez '''false'''.
* '''commandName:''' A parancs neve amivel meghívták a függvényt.
* '''arg1, arg2, ...:''' Minden egyes érték amit a parancs neve után szóközökkel elválasztva beírnak az egy külön változóba kerül. Ha nincs értéke egy argumentumnak akkor [[nil]]. Kezelhet egy változó számú változót a vararg kifejezés használatával, ahogy a ''Szerver példa 2''-ben az látható.
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">string commandName [, string arg1, string arg2, ... ] </syntaxhighlight>
* '''commandName:''' A parancs neve ami meghívta a függvényt.
* '''arg1, arg2, ...:''' Minden egyes érték amit a parancs neve után szóközökkel elválasztva beírnak az egy külön változóba kerül. Ha nincs értéke egy argumentumnak akkor [[nil]]. Kezelhet egy változó számú változót a vararg kifejezés használatával, ahogy a ''Szerver példa 2''-ben az látható.
</section>

===Visszaadott érték===
'''true''' ha a handler sikeresen létre lett hozva, '''false''' egyébként.

==Példák==
<section name="Server" class="server" show="true">
'''Példa 1:''' Ez a példa a "createmarker" parancsot csatolja a consoleCreateMarker függvényhez, aminek meghívása a játékos pozicióján létrehoz egy piros markert.
<syntaxhighlight lang="lua">
-- Define our function that will handle this command
function consoleCreateMarker ( playerSource, commandName )
-- If a player triggered it (rather than the admin) then
if ( playerSource ) then
-- Get that player's position
local x, y, z = getElementPosition ( playerSource )
-- Create a size 2, red checkpoint marker at their position
createMarker ( x, y, z, "checkpoint", 2, 255, 0, 0, 255 )
-- Output it in his chat box
outputChatBox ( "You got a red marker", playerSource )
end
end
-- Attach the 'consoleCreateMarker' function to the "createmarker" command
addCommandHandler ( "createmarker", consoleCreateMarker )
</syntaxhighlight>
</section>

<section name="Server" class="server" show="hide">
'''Példa 2:''' Ez a példa hasznosítja a Lua vararg kifejezését, hogy létrehozzon egy ''check_parameters'' parancsot, hogy megszámolja a beküldött argumentumok számát, összeolvassza őket egy egyesített [[HU/String|string]]-be és kiírja azt. Ez azt is megmutatja, hogy hogyan lehet használni a table.concat függvényt, hogy összeolvasszuk az összes megadott argumentumot. Ez kifejezetten hasznos, ha el akar olvasni egy üzenetet melyet a felhasználó írt be.
<syntaxhighlight lang="lua">
-- Define our function that will handle this command (which can accept a variable number of arguments after commandName)
function consoleCheckParameters ( playerSource, commandName, ... )
-- If a player, not an admin, triggered it,
if playerSource then
local arg = {...}
-- Get the number of arguments in the arg table (arg table is the same as: {...})
local parameterCount = #arg
-- Output it to the player's chatbox
outputChatBox ( "Number of parameters: " .. parameterCount, playerSource )
-- Join them together in a single comma-separated string
local stringWithAllParameters = table.concat( arg, ", " )
-- Output this parameter list to the player's chatbox
outputChatBox ( "Parameters passed: " .. stringWithAllParameters, playerSource )
end
end
-- Attach the 'consoleCheckParameters' function to the "check_parameters" command
addCommandHandler ( "check_parameters", consoleCheckParameters )
</syntaxhighlight>
</section>

<section name="Server" class="server" show="hide">
'''Példa 3:''' Ez a példa megmutatja egy szimpla függvény használatát, amely több command handler-t kezel. Ez nem ajánlott az általános használathoz, mivel nehezíti a kód érhetőségét, de ahol több command handler ugyan azt a logikát használja, hasznos lehet, hogy csökkentse az ismétlődő kód mennyiségét. Alapjáraton, kedvezőbb lenne ha ezt a megosztott logikát egy külön függvénybe helyeznénk, mivel ez több kontrollt eredményez a lefutásban.

<syntaxhighlight lang="lua">
-- make the function
function moneyCmd(player, commandName, amount)
if getElementData(player, "canUseMoneyFunctions") then -- the shared logic
if commandName == "givemoney" then
amount = tonumber(amount)
if amount then
givePlayerMoney(player, amount)
else
outputChatBox("[usage] /givemoney [amount]", player)
end
else if commandName == "takemoney" then
amount = tonumber(amount)
if amount then
takePlayerMoney(player, amount)
else
outputChatBox("[usage] /takemoney [amount]", player)
end
end
else
outputChatBox("You aren't able to use this command", player)
end
end

addCommandHandler("givemoney", moneyCmd);
addCommandHandler("takemoney", moneyCmd);
</syntaxhighlight>
</section>

<section name="Client" class="client" show="false">
'''Példa 1:''' Ez a példa teleportálja a helyi játékost egy véletlenszerű közeli pozicióra (hasznos ha a játékos beszorul valahova)

<syntaxhighlight lang="lua">function escapeMe ( commandName )
local x, y, z = getElementPosition ( localPlayer ) --Get player's position
setElementPosition ( localPlayer, x+(math.random(-10,10)), y+(math.random(-10,10)), z+(math.random(1,15)) ) --Move a player randomly to a nearby location. X is current x + a number between -10, 10 and so on.
end
addCommandHandler ( "escape", escapeMe ) --When player types "/escape" in chatbox or "escape" in console
</syntaxhighlight>
</section>

==Lásd még==
{{Server Functions hu}}

==Fordította==
*'''WorthlessCynomys'''

[[en:addCommandHandler]]

HU/setCameraClip

2019-08-11T10:31:34Z

Surge:

{{Client function hu}}
__NOTOC__
This function sets if the camera will "collide" with any objects or vehicles in its way. This means that if object clip is enabled an object is in the way of where the camera actually wants to be, the camera will try to be in front of it. This function can disable that.

{{Note| This function doesn't fix the issue of camera clip not working on objects out of world bounds.}}

==Szintaxis==
<syntaxhighlight lang="lua">
bool setCameraClip ( [ bool objects = true, bool vehicles = true ] )
</syntaxhighlight>
{{OOP||[[Camera]].setClip||getCameraClip}}

===Tetszőleges Paraméterek===
*'''objects:''' Sets if you want the camera to clip on objects.
*'''vehicles:''' Sets if you want the camera to clip on vehicles.

===Visszatérési érték===
A visszatérési értéke mindig ''true''.

==Példa==
Ez a példa lehetővé teszi, hogy keresztül nézzen az autókon.
<syntaxhighlight lang="lua">
function enableCameraThoughCars ()
setCameraClip (true,false)
outputChatBox ("Your camera can see the vehicle interior now!",255,0,0,false)
end
addEventHandler ("onClientResourceStart",resourceRoot,enableCameraThoughCars)
</syntaxhighlight>

==Lásd még==
{{Client camera functions hu}}

[[en:setCameraClip]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/createColPolygon

2019-05-16T10:58:32Z

Surge: /* Szintaxis */

__NOTOC__
{{Shared function hu}}
{{Note_box_hu|A function megfelelő működése érdekében, állítsa be a kötött pontokat az óramutató járásával ellentétes irányba.}}
Ez a function létrehoz egy collision sokszöget. Lásd [http://en.wikipedia.org/wiki/Polygon Wikipedia] a sokszög meghatározásához. The first set of X Y of this shape is not part of the colshape bounds, so can set anywhere in the game world, however for performance, place it as close to the centre of the polygon as you can. It should be noted this shape is '''2D'''. There should be at least 3 bound points set.
{{VisualizeColshape hu}}
==Szintaxis==
<syntaxhighlight lang="lua">
colshape createColPolygon ( float fCenterX, float fCenterY, float fX1, float fY1, float fX2, float fY2, float fX3, float fY3, ... )
</syntaxhighlight>
{{OOP| |ColShape.Polygon||}}
===Kötelező paraméterek===
*'''fX:''' Az collision sokszög pozíciójának X pozíciója - the position that will be returned from [[getElementPosition]].
*'''fY:''' Az collision sokszög pozíciójának Y pozíciója - the position that will be returned from [[getElementPosition]].
*'''fX1:''' The 1st X position of the collision polygon's bound point
*'''fY1:''' The 1st Y position of the collision polygon's bound point
*'''fX2:''' The 2nd X position of the collision polygon's bound point
*'''fY2:''' The 2nd Y position of the collision polygon's bound point
*'''fX3:''' The 3rd X position of the collision polygon's bound point
*'''fY3:''' The 3rd Y position of the collision polygon's bound point
*'''...''' A 3. pozíciótól annyi pontot használhat, amennyit csak szeretne, hogy létrehozza a colshape-t.

===Visszatérési érték===
Visszaad egy [[colshape]] elemet, ha sikeres, false, ha érvénytelen paraméterek lettek megadva a funkcióhoz.

==Példa==
<section name="Server" class="server" show="true">
This example displays a chat message when any element hits the colshape and allows the colshape to be created using a console function ''set_zone''.
<syntaxhighlight lang="lua">
local theZone = false

function shapeHit( element )
local descriptor = "undefined"

if getElementType( element ) == "player" then
-- Use the player's name
descriptor = getPlayerName( element )
elseif getElementType( element ) == "vehicle" then
-- Use the vehicle's model name
descriptor = getVehicleName( element ) or descriptor
end

-- Output a message in the chat box for everyone on the server
outputChatBox( descriptor .. " is in the zone!" )
end

function createZoneCommandHandler( playerSource, commandName, fX, fY, fX1, fY1, fX2, fY2, fX3, fY3, ... )
-- Verify the player has given us the minimum amount of bound points
if not ( fY and fX and fX1 and fY1 and fX2 and fX3 and fY3 ) then
return outputChatBox( "Syntax: set_zone <X> <Y> <X1> <Y1> <X2> <Y2> <X3> <Y3> [<Xn> <Yn> ...]", playerSource, 255, 100, 100 )
end

-- Create the collision shape with the numbers from the arguments
local tempCol = createColPolygon( fX, fY, fX1, fY1, fX2, fY2, fX3, fY3, ... )

if not tempCol then
return outputChatBox( "Error: Couldn't create collision polygon", playerSource, 255, 100, 100 )
end

-- Destroy the previous collision polygon shape in case we already have one
if isElement( theZone ) then
destroyElement( theZone )
end

-- Use a variable out-of-scope to keep track of the most recently created collision shape element
theZone = tempCol

-- Attach an event handler to the element to get notified whenever an element hits our collision shape
addEventHandler( "onColShapeHit", tempCol, shapeHit, false )

outputChatBox( "Success: Collision shape has been created!", playerSource, 100, 255, 100 )
end
addCommandHandler( "set_zone", createZoneCommandHandler )
</syntaxhighlight>
</section>
<section name="Server" class="server" show="hide">
This example displays a chat message when any element hits the colshape and allows the colshape to be created using a console function ''set_wall''.
<syntaxhighlight lang="lua">
local theWall = false

function shapeHit( element )
local descriptor = "undefined"

if getElementType( element ) == "player" then
-- Use the player's name
descriptor = getPlayerName( element )
elseif getElementType( element ) == "vehicle" then
-- Use the vehicle's model name
descriptor = getVehicleName( element ) or descriptor
end

-- Output a message in the chat box for everyone on the server
outputChatBox( descriptor .. " is in the zone!" )
end

function createWallCommandHandler( playerSource, commandName, fromX, fromY, toX, toY )
-- Verify the player has given us the minimum amount of bound points
if not ( fromX and fromY and toX and toY ) then
return outputChatBox( "Syntax: set_wall <fromX> <fromY> <toX> <toY>", playerSource, 255, 100, 100 )
end

-- Calculate the 90° angle for the line between the two coordinates from the arguments
local radian90DegreeAngle = math.atan2(toY - fromY, toX - fromX) + math.pi / 2

-- Depth/width of the wall
local depth = 1

-- Pre-calculate the cosinus/sinus distances
local cosinusDepth = math.cos(radian90DegreeAngle) * depth / 2
local sinusDepth = math.sin(radian90DegreeAngle) * depth / 2

-- Calculate the points in the game world
local x1, y1 = fromX - cosinusDepth, fromY - sinusDepth
local x2, y2 = toX - cosinusDepth, toY - sinusDepth
local x3, y3 = toX + cosinusDepth, toY + sinusDepth
local x4, y4 = fromX + cosinusDepth, fromY + sinusDepth

-- Create the collision shape with the calculated numbers
local tempCol = createColPolygon( fromX + (toX - fromX) / 2, fromY + (toY - fromY) / 2, x1, y1, x2, y2, x3, y3, x4, y4 )

if not tempCol then
return outputChatBox( "Error: Couldn't create collision polygon", playerSource, 255, 100, 100 )
end

-- Destroy the previous collision polygon shape in case we already have one
if isElement( theWall ) then
destroyElement( theWall )
end

-- Use a variable out-of-scope to keep track of the most recently created collision shape element
theWall = tempCol

-- Attach an event handler to the element to get notified whenever an element hits our collision shape
addEventHandler( "onColShapeHit", tempCol, shapeHit, false )

outputChatBox( "Success: Collision shape has been created!", playerSource, 100, 255, 100 )
end
addCommandHandler( "set_wall", createWallCommandHandler )
</syntaxhighlight>
</section>

==Issues==
{{Issues|
{{Issue|9742|[Fixed in 1.5.5-3.12343] Passing this function [[Vector2|Vector2s]] are not fully supported}}
}}

==Lásd még==
{{Collision shape functions hu}}

[[en:createColPolygon]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/dxDrawMaterialLine3D

2019-05-13T13:21:02Z

Surge:

__NOTOC__
{{Client function hu}}
Ez a function 3D-s vonalat rajzol a 3D-s világ két pontja között - egy képkocka erejéig van kirajzolva. Ezt az [[onClientRender]] segítségével együtt kell használni annak érdekében, hogy folyamatosan jelenjen meg.

The 3D line with a large width value effectively becomes a rectangle, so it it possible to construct basic shapes such as boxes with several large width lines and the appropriate values for 'faceToward'.

A 3D-s vonalak egy adott helyen vannak rajzolva a [[Game_Processing_Order|játékfeldolgozási sorrendben]], ezért használja az [[onClientPreRender]] a rajzoláshoz, ha a world elemhez akarja csatolni őket.

==Szintaxis==
<syntaxhighlight lang="lua">
bool dxDrawMaterialLine3D ( float startX, float startY, float startZ, float endX, float endY, float endZ, element material, float width,
[ int color = white, [ bool postGUI = false, ] float faceTowardX, float faceTowardY, float faceTowardZ ] )
</syntaxhighlight>

===Kötelező paraméterek===
* '''startX/Y/Z:''' A 3D-s vonal kezdetének pozíciója, amely egy koordinátát képvisel a GTA világában.
* '''endX/Y/Z:''' A 3D-s vonal végének pozíciója, amely egy koordinátát képvisel a GTA világában.
* '''material:''' Az [[material|anyag]], amivel a vonalat rajzolja.
* '''width:''' A vonal szélessége/vastagsága a GTA világban. (Ez a dxDrawLine3D-ben használt szélesség 1/75-öd része)

==Tetszőleges paraméterek==
{{OptionalArg hu}}
* '''color:''' A hexadecimális szín, melyet a [[tocolor]]-al vagy az 0xAARRGGBB fügvénnyel tudunk megadni (AA = átlászóság, RR = piros, GG = zöld, BB = kék).
{{New items|3.0156|1.5.5|
* '''postGUI''': Egy igaz/hamis érték mutatja, hogy a vonal bármelyik ingame GUI mögött, vagy fölött legyen-e.
|11998}}
* '''faceTowardX/Y/Z:''' The position the front of the line should face towards. If this is not set, the camera position is used, so the front of the line faces toward the camera.

===Visszatérési érték===
Visszatérési értéke ''true'', ha a művelet sikeres, egyébként ''false''.

==Példa==
Rajzol [[:File:DxDrawMaterialLine3D-example.png|egy képet]] a megadott kordinátákban -2422.68555, -608.78986, 132.56250
<syntaxhighlight lang="lua">
local redcircle = dxCreateTexture("red.png")

x,y,z = -2422.68555, -608.78986, 132.56250

size = 1

addEventHandler("onClientRender", root, function()
dxDrawMaterialLine3D(x+size, y+size, z-0.95, x-size, y-size, z-0.95, redcircle, size*2,tocolor(255, 255, 255, 255), x, y, z)
end)
</syntaxhighlight>

==Requirements==
{{Requirements|n/a|1.3.0-9.03931|}}

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.5.5-9.11998|Added postGUI argument}}

==Lásd még==
{{Drawing_functions hu}}

[[en:dxDrawMaterialLine3D]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/dxDrawLine3D

2019-05-13T13:20:40Z

Surge:

__NOTOC__
{{Client function hu}}
Ez a function 3D-s vonalat rajzol a 3D-s világ két pontja között - egy képkocka erejéig van kirajzolva. Ezt az [[onClientRender]] segítségével együtt kell használni annak érdekében, hogy folyamatosan jelenjen meg.
==Szintaxis==
<syntaxhighlight lang="lua">
bool dxDrawLine3D ( float startX, float startY, float startZ, float endX, float endY, float endZ [, int color = 0xFFFFFFFF, float width = 1.0, bool postGUI = false ] )
</syntaxhighlight>

===Kötelező paraméterek===
* '''startX:''' A 3D-s vonal kezdetének X pozíciója, amely egy koordinátát képvisel a GTA világában.
* '''startY:''' A 3D-s vonal kezdetének Y pozíciója, amely egy koordinátát képvisel a GTA világában.
* '''startZ:''' A 3D-s vonal kezdetének Z pozíciója, amely egy koordinátát képvisel a GTA világában.
* '''endX:''' A 3D-s vonal végének X pozíciója, amely egy koordinátát képvisel a GTA világában.
* '''endY:''' A 3D-s vonal végének Y pozíciója, amely egy koordinátát képvisel a GTA világában.
* '''endZ:''' A 3D-s vonal végének Z pozíciója, amely egy koordinátát képvisel a GTA világában.

==Tetszőleges paraméterek==
{{OptionalArg hu}}
* '''color:''' A hexadecimális szín, melyet a [[tocolor]]-al vagy az 0xAARRGGBB fügvénnyel tudunk megadni (AA = átlászóság, RR = piros, GG = zöld, BB = kék).
* '''width:''' A vonal szélessége/vastagsága
* '''postGUI:''' Egy igaz/hamis érték, mely azt képviseli, hogy a vonal bármelyik ingame GUI mögött, vagy fölött legyen-e (CEGUI által rajzolt).

===Visszatérési érték===
Visszatérési értéke true, ha a művelet sikeres, egyébként false.

==Example==
Ez a példa létrehoz egy 3D-s vonalat / "kötelet" egy játékos és egy jármű között.
<syntaxhighlight lang="lua">
function makeLineAppear()
testVehicle = createVehicle ( 411, 0, 0, 5 ) -- Create our test vehicle.
addEventHandler("onClientRender", root, createLine) -- onClientRender keeps the 3D Line visible.
end
function createLine ( )
x1, y1, z1 = getElementPosition ( testVehicle ) -- Get test vehicles position.
x2, y2, z2 = getElementPosition ( localPlayer ) -- Get local players position.
dxDrawLine3D ( x1, y1, z1, x2, y2, z2, tocolor ( 0, 255, 0, 230 ), 2) -- Create 3D Line between test vehicle and local player.
end
addCommandHandler("test", makeLineAppear)
</syntaxhighlight>

==Lásd még==
{{Drawing_functions hu}}

[[en:dxDrawLine3D]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/Scripting the GUI - Tutorial 1

2019-05-13T12:53:30Z

Surge:

'''GUI készítése - Tutorial 1 (Gridlists)'''

Ebben a tutoriálban fel fogjuk fedezni a gridlist-ek használatát egy járműválasztási kijelzőn egy tetszőleges kliensoldali jármű xml olvasással.

'''Ne feledje, hogy ez a tutoriál feltételezi azt, hogy tisztában van az [[HU/Introduction to Scripting the GUI|előző tutoriálban]] bemutatott összes tartalommal'''

==A jármű kiválasztásának létrehozása==

===A GUI létrehozása===
Kezdésként nyisson meg egy client oldali lua fájlt (ha követte a [[HU/Bevezetés a scriptelésbe|bevezetés a scriptelésbe]] oldalt, akkor ez a gui.lua lesz) amivel majd dolgozni fog.

Ebben a fájlban elfogjuk kezdeni megírni a saját function-ünket a GUI létrehozásához.
Ahogy azt az [[HU/Introduction to Scripting the GUI|előző tutoriálban]] említettük, a gui létrehozásakor 2 értéktípus közül tudunk választani: '''relative''' és '''absolute'''.

Ennek a tutoriálnak a céljából most '''absolute''' értékeket fogunk használni.

Ez létre fog hozni egy egyszerű GUI ablakot, egy gridlist-et, és egy gombot:
<syntaxhighlight lang="lua">
function createVehicleSelection()
-- get the screen width and height
local sWidth, sHeight = guiGetScreenSize()

-- use some simple maths to position the window in the centre of the screen
local Width,Height = 376,259
local X = (sWidth/2) - (Width/2)
local Y = (sHeight/2) - (Height/2)
windowVehicleSelection = guiCreateWindow(X,Y,Width,Height,"Vehicle Selection Window",false)

gridlistVehicleSelection = guiCreateGridList(10,26,357,192,false,windowVehicleSelection)
-- add a "Vehicle" and a "Type" collumn to the gridlist
guiGridListAddColumn(gridlistVehicleSelection,"Vehicle",0.2)
guiGridListAddColumn(gridlistVehicleSelection,"Type",0.2)

-- set the default width of the columns to roughly half the size of the gridlist (each)
guiGridListSetColumnWidth(gridlistVehicleSelection,1,0.4,true)
guiGridListSetColumnWidth(gridlistVehicleSelection,2,0.5,true)

buttonCreate = guiCreateButton(121,227,120,20,"Create",false,windowVehicleSelection)

-- add the event handler for when the button is clicked
addEventHandler("onClientGUIClick",buttonCreate,createVehicleHandler,false)

-- hide the GUI
guiSetVisible(windowVehicleSelection,false)

-- this will add all the vehicle options onto the gridlist, it is explained later in this tutorial
populateGridlist()
end
</syntaxhighlight>

Most ezt a function-t meg is kell hívnunk valamivel, különben a GUI sosem lesz létrehozva.
Ahogy az előző tutoriálban is az [[onClientResourceStart]]-ot hívtuk segítségül, hogy elvégezze ezt a feladatot.
<syntaxhighlight lang="lua">
-- when the resource is started, create the GUI and hide it
addEventHandler("onClientResourceStart",getResourceRootElement(getThisResource()),
function()
createVehicleSelection()
end
)
</syntaxhighlight>

===A GUI megjelenítése===
Az előző tutoriállal ellentétben itt azt akarjuk, hogy a játékos képes legyen az ablakot megnyitni, amikor csak szeretné, és ne akkor, amikor a resource elindul.
Így hozzáadhatunk egy [[addCommandHandler|parancsot]] ennek elvégzéséhez.
<syntaxhighlight lang="lua">
-- create the function that will show the window
function showVehicleSelection()
-- if the window isnt visible, show it
if not guiGetVisible(windowVehicleSelection) then
guiSetVisible(windowVehicleSelection,true)

showCursor(true,true)
end
end

-- add the command /vehicleselection and set it to call the showVehicleSelection function
addCommandHandler("vehicleselection",showVehicleSelection)
</syntaxhighlight>

===A Gridlist feltöltése egy táblából===
Most, hogy van egy alap GUI-nk, fel is kell töltenünk a gridlistet az összes járművünkel.

Ezt kezdésként egy egyszerű client oldali táblával fogjuk megcsinálni.
A tutoriál későbbi részében ezt a módszert kibővítjük egy .xml fájl használatával az információk tárolásához.
Kezdésként létrehozunk egy táblát, mely tartalmazza a kiválasztott járműveket, amelyeket majd le tudunk spawnolni.

A tábla tartalmazza a járműveket ebben a formában ["description"] = vehicle_id :
<syntaxhighlight lang="lua">
-- create the table and fill it with a selection of vehicle ids and names
local vehicleSelectionTable = {
["Sparrow"] = 469,
["Stuntplane"] = 513,
["BF-400"] = 581,
["Freeway"] = 463,
["Speeder"] = 452,
["Jester"] = 559,
["Sabre"] = 475,
["Police Ranger"] = 599,
["Utility Van"] = 552,
["Tug"] = 583
}
</syntaxhighlight>
Helyezze ezt a kódot a script legtetejére (nem kell, hogy egy funkción belül legyen).

Most megírhatjuk a "populateGridlist" function, amely feltölti a Gridlist-et a táblázatban szereplő összes járművel.
Ehhez egyszerűen csak végig kell mennünk a táblában szereplő értékeken, és hozzáadni a gridlist-hez.
Valamint beállítjuk a rejtett adatokat a [[guiGridListSetItemData]] használatával, hogy tároljuk a járművek id-jét:
<syntaxhighlight lang="lua">
function populateGridlist()
-- loop through the table
for name,vehicle in pairs(vehicleSelectionTable) do
-- add a new row to the gridlist
local row = guiGridListAddRow(gridlistVehicleSelection)

-- set the text in the first column to the vehicle name
guiGridListSetItemText(gridlistVehicleSelection,row,1,name,false,false)
-- set the text in the second column to the vehicle type
guiGridListSetItemText(gridlistVehicleSelection,row,2,getVehicleType(vehicle),false,false)

-- set the data for gridlist slot as the vehicle id
guiGridListSetItemData(gridlistVehicleSelection,row,1,tostring(vehicle))
end
end
</syntaxhighlight>

===A klikk kezelése===
Most, hogy elkészült a GUI-nk, észlelnünk is kell minden kattintást a "Create" gombon.
Már hozzácsatoltuk az [[onClientGUIClick]] event-et a buttonCreate-hez, így most meg kell írjuk azt a function-t, ami meghívja.
Ebben a function-ben elvégzünk néhány alapvető hibaellenőrzést, mint például, hogy meggyőződjünk arról, hogy a jármű az a listából lett-e kiválasztva.
Ezután használhatunk néhány számítási feladatot, hogy megtaláljuk a játékos pozícióját, majd elküldjök ezt az infórmációt a szervernek, hogy lespawnolja a járművet a játékos elé ([[triggerServerEvent]] használatával)
<syntaxhighlight lang="lua">
function createVehicleHandler(button,state)
if button == "left" and state == "up" then
-- get the selected item in the gridlist
local row,col = guiGridListGetSelectedItem(gridlistVehicleSelection)

-- if something is selected
if row and col and row ~= -1 and col ~= -1 then
-- get the vehicle id data from the gridlist that is selected
local selected = guiGridListGetItemData(gridlistVehicleSelection,row,col)

-- make sure the vehicle id is a number not a string
selected = tonumber(selected)

-- get the players position and rotation
local rotz = getPedRotation(getLocalPlayer())
local x,y,z = getElementPosition(getLocalPlayer())
-- find the position directly infront of the player
x = x + ( math.cos ( math.rad ( rotz+90 ) ) * 3)
y = y + ( math.sin ( math.rad ( rotz+90 ) ) * 3)

if selected and x and y and z then
-- trigger the server
triggerServerEvent("createVehicleFromGUI",getRootElement(),selected,x,y,z)

-- hide the gui and the cursor
guiSetVisible(windowVehicleSelection,false)
showCursor(false,false)
else
outputChatBox("Invalid arguments.")
end
else
-- otherwise, output a message to the player
outputChatBox("Please select a vehicle.")
end
end
end
</syntaxhighlight>

===A jármű létrehozása===
Ezen a ponton az összes szükséges client oldali kódunk már megvan, szóval nyisson meg egy szerver oldalu .lua fájlt, amivel majd dolgozni fog.

Mindenekelőtt a szerver oldalon meg kell adnunk egy egyedi event-et, amit már meghívtunk a client oldalról. Ezt megtehetjük az [[addEvent]] és az [[addEventHandler]] használatával.
Végezetűl szükségünk lesz egy pici function-re, hogy létrehozzuk a járművet:
<syntaxhighlight lang="lua">
function createMyVehicle(vehicleid,x,y,z)
-- check all the arguments exist
if vehicleid and x and y and z then
createVehicle(vehicleid,x,y,z)
end
end

addEvent("createVehicleFromGUI",true)
addEventHandler("createVehicleFromGUI",root,createMyVehicle)
</syntaxhighlight>
Vegye figyelembe a "root" változó használatát. Ez egy MTA változó, amely tartalmazza a root elemet; minden resource-nak van egy.

Ezzel be is fejeztük a tutoriál első részét. Mostanra rendelkeznie kell egy alap, működő jármű spawnoló script-el.

A második részben megnézzük a gridlist adatok kezelhetőségét, és a client oldali xml fájlok olvasását.

==A kód bővítése==
Ez a rész számos módon fogja részletezni a már meglévő kódunk fejlesztését.

===Adatok importálása===
Egy nagy előrehaladás az előző módszerhez képest, hogy külső fájlokat használunk a jármű információinak tárolásához, ez lehetővé teszi a számunkra, hogy gyorsabban és egyszerűbben kezeljünk nagy mennyiségű adatokat.
Ebben a tutoriálban clinet oldali xml fájlt fogunk használni az információ tárolásához.

Mindenek előtt létre kell hoznia egy xml fájlt, szóval keresse meg a resource könyvtárát, és hozzon létre egy új vehicles.xml fájlt:

''Ennek a tutoriálnak a céljából csak egy kis részét fogjuk felvenni a teljes járműkészletből, azonban a fájl könnyen bővíthető, így a későbbiekben majd az összeset hozzá fogjuk tudni adni''

Ha még nem biztos az xml adatok felépítésében, akkor böngézhet a [[Server_Scripting_Functions#XML_functions|MTA xml function-ok]] között a további információkért.
<syntaxhighlight lang="lua">
<root>
<group type="Bikes">
<vehicle id="581" name="BF-400"/>
<vehicle id="463" name="Freeway"/>
<vehicle id="481" name="BMX"/>
</group>
<group type="Boats">
<vehicle id="472" name="Coastguard"/>
<vehicle id="452" name="Speeder"/>
</group>
<group type="Helicopters">
<vehicle id="487" name="Maverick"/>
<vehicle id="469" name="Sparrow"/>
</group>
<group type="Planes">
<vehicle id="593" name="Dodo"/>
<vehicle id="513" name="Stuntplane"/>
</group>
<group type="Sports Cars">
<vehicle id="565" name="Flash"/>
<vehicle id="559" name="Jester"/>
<vehicle id="477" name="ZR-350"/>
</group>
<group type="2-Door">
<vehicle id="474" name="Hermes"/>
<vehicle id="475" name="Sabre"/>
</group>
<group type="Emergency">
<vehicle id="416" name="Ambulance"/>
<vehicle id="599" name="Police ranger"/>
</group>
<group type="Industrial">
<vehicle id="573" name="Dune"/>
<vehicle id="552" name="Utility van"/>
</group>
<group type="Misc">
<vehicle id="457" name="Caddy"/>
<vehicle id="583" name="Tug"/>
</group>
</root>
</syntaxhighlight>
Miután létrehozta a fájlt, ne felejtse el hozzáadni a resource meta.xml fájljához a megfelelő client taggal.

Vegye figyelembe a "type" tagot. Ez a groupon belüli járművek tetszőleges leírása, ami átnevezhető, vagy hozzáadható bármilyen szöveg.
Hasonlóképenn a vehicle "name" tag is csak egy szöveges leírás a járműről, és nem kell, hogy a jármű valódi neve legyen.

Most, hogy rendelkezünk az adatokkal, importálni tudjuk a játékba és megjeleníteni a GUI-n.
'''Ha követte ezt a tutoriált az első résztől kezdve, akkor ez az új kód a 'populateGridlist' function-ben lévő kódot cseréli ki.'''
Először be kell töltenünk a fájlt:
<syntaxhighlight lang="lua">
function populateGridlist()
-- load the file and save the root node value it returns
local rootnode = xmlLoadFile("vehicles.xml")

-- check that the file exists and has been correctly loaded
if rootnode then
-- unload the xml file
xmlUnloadFile(rootnode)
end
end
</syntaxhighlight>
Mindig bizonyosodjon meg arróla, hogy lezárta a fájlt, mikor már végeztél a szerkesztésével.

Most már elkezdhetjük az adatok gyűjtését, és hozzáadhatjuk a gridlist-hez.
We can do this by looping through the xml data (in a similar manner to looping through the vehicle table earlier in this tutorial) and adding each entry into the list.
<syntaxhighlight lang="lua">
function populateGridlist()
local rootnode = xmlLoadFile("vehicles.xml")

if rootnode then
-- first, we find every "group" node (they are direct children of the root)
for _,group in ipairs(xmlNodeGetChildren(rootnode)) do
-- add a new row to the gridlist
local row = guiGridListAddRow(gridlistVehicleSelection)

-- get the group name
local name = xmlNodeGetAttribute(group,"type")

-- set the text in the first column to the group type and indicate it is a section ('true')
-- (sections on gridlists show up in bold and cannot be clicked)
guiGridListSetItemText(gridlistVehicleSelection,row,1,name,true,false)

-- then, for every group that we find, loop all of its children (the vehicle nodes)
-- and add them into the gridlist
for _,vehicle in ipairs(xmlNodeGetChildren(group)) do
-- add a new row to the gridlist
row = guiGridListAddRow(gridlistVehicleSelection)

-- get the vehicle name and id
name = xmlNodeGetAttribute(vehicle,"name")
local id = xmlNodeGetAttribute(vehicle,"id")

-- set the text in the first column to the vehicle name
guiGridListSetItemText(gridlistVehicleSelection,row,1,name,false,false)
-- set the text in the second column to the vehicle type
guiGridListSetItemText(gridlistVehicleSelection,row,2,getVehicleType(tonumber(id)),false,false)

-- finally, set the vehicle id as data so we can access it later
guiGridListSetItemData(gridlistVehicleSelection,row,1,tostring(id))
end
end

-- unload the xml file now that we are finished
xmlUnloadFile(rootnode)
end
end
</syntaxhighlight>
Figyelje meg a for ciklus [[xmlNodeGetChildren]] függvénnyel való használatát a kódban. Ez sok időt, és energiát takarít meg nekünk, mivel nem kell manuálisan megírnunk minden egyes group-ot és járművet a listába.

Mostanra már rendelkeznie kell egy teljesen működő járműválasztási menüvel, amely minden adatot a client oldali xml fájlból olvas.
Következőnek pedig megnézzük, hogy hogyan csináljuk meg a megjelenését a lenyíló részeknek a gridlistben.

===A Gridlist megnyitása/összecsukása===
A gridlistben lévő lenyitható menük lehetővé teszik, hogy egy sokkal átláthatóbb panelt készítsünk.
Ezzel helyet takarít meg a képernyőn, és sokkal kényelmesebbé teszi az egész menüt.

===Az adatok betöltése===
Ennek a hatásnak az eléréshez (mivel ez nem a gridlisták természetes tulajdonsága) a járműinformációkat egy táblázatba kell betöltenünke (az xml fájlból), ahelyett, hogy közvetlenül a gridlist-be helyeznénk.
'''Ha követte ezt a tutoriált az első résztől kezdve, akkor ez az új kód a 'populateGridlist' function-ben lévő kódot cseréli ki'''

Ez is ugyanúgy működik, mint az előző példában szereplő xml betöltési rész, csak ahelyett, hogy az adatokat a grlidlist-be mentenénk, helyette egy táblába mentjük el.
Beállítjuk a "header" elementData-t is a gridlist cellákban, hogy meg tudjuk különböztetni, hogy melyik elem egy "group" és melyik egy jármű.
<syntaxhighlight lang="lua">
function populateGridlist()
local rootnode = xmlLoadFile("vehicles.xml")

-- create a blank global table to store our imported data
vehicleTable = {}

if rootnode then
for _,group in ipairs(xmlNodeGetChildren(rootnode)) do
-- create an entry in the gridlist for every vehicle "group"
local row = guiGridListAddRow(gridlistVehicleSelection)

local name = xmlNodeGetAttribute(group,"type")

guiGridListSetItemText(gridlistVehicleSelection,row,1,name,false,false)

-- add an entry containing the group name into the table
vehicleTable[name] = {}

-- we will use the custom data "header" to indicate that this entry can be expanded/collapsed
guiGridListSetItemData(gridlistVehicleSelection,row,1,"header")

-- then, for every group that we find, loop all of its children (the vehicle nodes) and store them in a table
for _,vehicle in ipairs(xmlNodeGetChildren(group)) do
local vname = xmlNodeGetAttribute(vehicle,"name")
local id = xmlNodeGetAttribute(vehicle,"id")

-- insert both the vehicle id and the vehicle description into the table
table.insert(vehicleTable[name],{id,vname})
end
end

-- set element data on the gridlist so we know which group is currently showing
setElementData(gridlistVehicleSelection,"expanded","none")

-- unload the xml file now that we are finished
xmlUnloadFile(rootnode)
end
end
</syntaxhighlight>

Most, hogy tároltuk az összes adatot, gyorsan kezelni is tudjuk, amikor szükséges.

===Dupla kattintás kezelése===
Annak engedélyezéséhez, hogy a játékos egyszerűen tudjon duplán kattintani a group nevére, hogy azt lenyissa/összecsukja az [[onClientGUIDoubleClick]] event-et kell használunk.
Ha ezt a gridlist-hez csatoljuk, akkor az összes dupla kattintást a group neveken észlelni tudjuk:
<syntaxhighlight lang="lua">
-- attach the onClientGUIDoubleClick event to the gridlist and set it to call processDoubleClick
addEventHandler("onClientGUIDoubleClick",gridlistVehicleSelection,processDoubleClick,false)
</syntaxhighlight>
Adja hozzá ezt a sort a createVehicleSelection-hoz, a létrehozott gridlist után.

Mivel a gridlist-ek nem önálló GUI elemek, ezért rögzítenünk kell az összes kattintást a gridlist-ről, majd feldolgozni, hogy kitudjuk szűrűni azt, amelyiket nem akarjuk figyelembe venni.
Ezt megtehetjük egy kiválasztott elem ellenőrzésével, majd ellenőrizzük, hogy az elem az a mi egyik "group" értékünk (a korábban említett "header" adat használatával):
<syntaxhighlight lang="lua">
function processDoubleClick(button,state)
if button == "left" and state == "up" then
local row,col = guiGridListGetSelectedItem(gridlistVehicleSelection)

-- if something in the gridlist has been selected
if row and col and row ~= -1 and col ~= -1 then
-- if it is a header
if guiGridListGetItemData(gridlistVehicleSelection,row,col) == "header" then
local selected = guiGridListGetItemText(gridlistVehicleSelection,row,col)

-- call the function to collapse or expand the menu and pass which section it is as an argument
changeGridlistState(selected)
end
end
end
end
</syntaxhighlight>

Miután leszűkítettük a dupla kattintás, hogy csak a header-en történő kattintásra reagáljon, azután megfelelően tudjuk lenyitni/összecsuk őket.
Ez könnyen megtehető úgy, hogy új szövegértékeket adunk meg a gridlistben az újonnan lenyitott/összezárt csoportot figyelembe véve, ami azt a meggyőző illúziót kelti, hogy a menüelemek lenyitothatók/összezárhatók.

Ne feledje, hogy a következő kódnak a nagy része újra felhasználásra került a tutorial előző részeiből. Bár általában ez rossz gyakorlat a kód részleteinek az ilyen módon történő másolása, ennek a példának a célja, hogy sokkal könnyebb legyen ezt megérteni.
<syntaxhighlight lang="lua">
function changeGridlistState(group)
if group then
-- if the group is already expanded, we want to collapse it
if getElementData(gridlistVehicleSelection,"expanded") == group then
-- first, we clear all previous data from the gridlist
guiGridListClear(gridlistVehicleSelection)

-- now, loop all the group entries in the vehicle table that we created earlier
for group,_ in pairs(vehicleTable) do
-- add each group to the list and mark them with "header"
local row = guiGridListAddRow(gridlistVehicleSelection)

guiGridListSetItemText(gridlistVehicleSelection,row,1,group,false,false)
guiGridListSetItemData(gridlistVehicleSelection,row,1,"header")
end

-- update the data to indicate that no groups are currently expanded
setElementData(gridlistVehicleSelection,"expanded","none")

-- otherwise, we want to expand it
else
guiGridListClear(gridlistVehicleSelection)

local row = guiGridListAddRow(gridlistVehicleSelection)

guiGridListSetItemText(gridlistVehicleSelection,row,1,group,false,false)
guiGridListSetItemData(gridlistVehicleSelection,row,1,"header")

-- loop every vehicle in the specified groups table
for _,vehicle in ipairs(vehicleTable[group]) do
-- add them to the gridlist and set the vehicle id as data
row = guiGridListAddRow(gridlistVehicleSelection)

-- format a "-" into the string to make it visually easier to distinguish between groups and vehicles
guiGridListSetItemText(gridlistVehicleSelection,row,1,"- "..vehicle[2],false,false)
guiGridListSetItemText(gridlistVehicleSelection,row,2,getVehicleType(tonumber(vehicle[1])),false,false)

guiGridListSetItemData(gridlistVehicleSelection,row,1,tostring(vehicle[1]))
end

-- update the data to indicate which group is currently expanded
setElementData(gridlistVehicleSelection,"expanded",group)
end
end
end
</syntaxhighlight>

Ezzel be is fejeztük a tutoriál második részét.

A további GUI tutoriálokért látogassa meg a [[HU/Scripting the GUI - Tutorial 2|GUI készítése - Tutorial 2 (Gates and Keypads)]] oldalt.

[[Category:GUI_Tutorials]]

[[en:Scripting the GUI - Tutorial 1]]

==Fordította==
'''2018.11.25.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

HU/Introduction to Scripting the GUI - Part 2

2019-05-13T12:50:40Z

Surge: /* A játékos kickelése */

Ebben a tutoriálban létre fogunk hozni egy egyszerű ''szabályok'' ablakot egy elfogadási gombbal, és egy listával a szerver összes szabályairól, és infórmációiról.

{{Note_hu|Vegye figyelembe, hogy ez a tutoriál a [[Introduction to Scripting the GUI|Bevezetés a GUI készítésébe]] tartalmára épül.}}
<br/>
==A GUI készítése==

===Alapbeállítások===
Az első dolog, amit létre kell hoznunk, az a GUI elem.
Ehhez a tutoriálhoz egy [[Element/GUI/Window|ablakot]], egy [[Element/GUI/Button|gombot]] és egy [[Element/GUI/Text_label|címkét]] használunk.
'''Abszolút''' pozícióértékeket fogunk használni.

Ahogy az [[HU/Introduction to Scripting the GUI|előző tutoriálban]] is említettük, minden GUI-t client oldalon kell létrehozni.

Ha követte az utasításokat az előző tutoriálból, akkor nyissa meg a gui.lua fájlt, amivel majd dolgozni fog.

Ha nem, lépjen a /Your MTA Server/mods/deathmatch/resources/myserver/ könyvtárba, és hozzon létre egy mappát "client" néven.
A /client/ könyvtárban hozzon létre egy szöveges fájlt "gui.lua" néven.

Ha még nem tette meg, ne felejtse el hozzáadni az új gui.lua fájlt a meta.xml-hez a fő resource-ba, és adja meg client script-ként:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

===Ablak létrehozása===
Ebben a fájlban írni fogunk egy function-t, ami kirajzolja az ablakot:
<syntaxhighlight lang="lua">
-- create the function that will hold our gui creation code
function createRulesWindow()
-- get the screen width and height
local sWidth, sHeight = guiGetScreenSize()

-- create the window, using some maths to find the centre of the screen
local Width,Height = 445,445
local X = (sWidth/2) - (Width/2)
local Y = (sHeight/2) - (Height/2)

-- create the window
rulesWindow = guiCreateWindow(X,Y,Width,Height,"Rules",false)

-- stop players from being able to simply move the window out of the way
guiWindowSetMovable(rulesWindow,false)

-- stop players from being able to resize the window
guiWindowSetSizable(rulesWindow,false)
end
</syntaxhighlight>
Ez létre fog hozni egy alap ablakot a képernyő közepére, ez az ablak nem mozgatható és méretezhető.

===Gomb létrehozása===
Most létrehozzuk a gombot az ablak aljára, melyre a játékos rá tud kattintani, hogy elfogadja a szabályokat:

'''Mostpedig több kódot adunk hozzá a már meglévő 'createRulesWindow' function-ünkhöz. Ez nem egy új function, hanem a már meglévőt helyettesíti.'''
<syntaxhighlight lang="lua">
function createRulesWindow()
-- get the screen width and height
local sWidth, sHeight = guiGetScreenSize()

-- create the window, using some maths to find the centre of the screen
local Width,Height = 445,445
local X = (sWidth/2) - (Width/2)
local Y = (sHeight/2) - (Height/2)

-- create the window and save the window gui element in a variable called 'rulesWindow'
rulesWindow = guiCreateWindow(X,Y,Width,Height,"Rules",false)

-- stop players from being able to simply move the window out of the way
-- note that we use our 'rulesWindow' variable to make changes to the window
guiWindowSetMovable(rulesWindow,false)

-- stop players from being able to resize the window
guiWindowSetSizable(rulesWindow,false)

-- create the button and save the button gui element in a variable called 'rulesButton'
rulesButton = guiCreateButton(137,394,158,37,"Accept",false,rulesWindow)
end
</syntaxhighlight>

===Címke létrehozása===
Most hozzáadjuk a címkét az ablakunk közepére, hogy megjelenítsük a szabályainkat:

'''Mostpedig több kódot adunk hozzá a már meglévő 'createRulesWindow' function-ünkhöz. Ez nem egy új function, hanem a már meglévőt helyettesíti.'''
<syntaxhighlight lang="lua">
function createRulesWindow()
-- get the screen width and height
local sWidth, sHeight = guiGetScreenSize()

-- create the window, using some maths to find the centre of the screen
local Width,Height = 445,445
local X = (sWidth/2) - (Width/2)
local Y = (sHeight/2) - (Height/2)

-- create the window and save the window gui element in a variable called 'rulesWindow'
rulesWindow = guiCreateWindow(X,Y,Width,Height,"Rules",false)

-- stop players from being able to simply move the window out of the way
-- note that we use our 'rulesWindow' variable to make changes to the window
guiWindowSetMovable(rulesWindow,false)

-- stop players from being able to resize the window
guiWindowSetSizable(rulesWindow,false)

-- create the button and save the button gui element in a variable called 'rulesButton'
rulesButton = guiCreateButton(137,394,158,37,"Accept",false,rulesWindow)

-- create the label and save the label gui element in a variable called 'rulesLabel'
-- we set the text of the label to our rules
rulesLabel = guiCreateLabel(10,25,425,359,[[
Welcome to my MTA Server!

Please carefully read the rules before accepting.

By accepting the rules, you are agreeing to play by them.
Anyone caught breaking these rules will be kicked and/or banned from this server.

If you do not accept the rules within 90 seconds, you will be kicked.

1: No cheating.

2: No bug abuse.

3: No mods to your game.

4: No flaming.

5: Respect other players.

6: Be nice!]],false,rulesWindow)

-- set the horizontal alignment of the label to center (ie: in the middle of the window)
-- also note the final argument "true"
-- this turns on wordwrap so if your text goes over the edge of the label, it will wrap around and start a new line automatically
guiLabelSetHorizontalAlign(rulesLabel,"center",true)
end
</syntaxhighlight>

''Vegye figyelembe, hogy a szöveg egy másik módon van hozzáadva (nem használunk idézőjeleket, "").''

===Szöveg===
''Két'' módja létezik a címke szövegének megadására.
A legtöbb esetben az ajánlott módszer az, hogy az összes szöveget idézőjelek közé írja be:
<syntaxhighlight lang="lua">
guiSetText(guiElement,"My text here")
</syntaxhighlight>

Azonban, ha egynél több sort szeretnénk a szövegünkbe helyezni, akkor ugyan olyan könnyen használhatjuk a második módszert.
Csupán a helyzettől, és a személyes választástól függ, hogy melyik módszert válasszuk.
A tisztánlátás érdekében röviden ismertetem mind a kettőt.

Idézőjelek használata esetén használhatjuk az újsor karaktert: "\n" Ez lehetővé teszi a számunkra, hogy új sort szúrjunk a szövegünkbe.
Például:
<syntaxhighlight lang="lua">
guiSetText(guiElement,"This is line 1. \n This is line 2. \n This is line 3.")
</syntaxhighlight>
<br/>
Azonban, ha zárójeleket közé helyezzük a szöveget idézőjelek helyett, akkor nem kell aggódni azon, hogy egy plusz karaktert addjunk a szöveghez.
Könnyedén beírhatjuk azt a szöveget, amit majd meg szeretnénk jeleníteni a címkében. Például:
<syntaxhighlight lang="lua">
guiSetText(guiElement,[[This is line 1.
This is line 2.
This is line 3.]])
</syntaxhighlight>

Mindkét példa ugyan azt a szöveget fogja létrehozni a címkében.
Egyedűl attól függ, hogy melyik módszert szeretné választani a használathoz.

===A function használata===
A createRulesWindow function most már kész, de nem fog csinálni semmit, míg meg nem hívjuk.
Ajánlott az összes GUI létrehozás, amikor a client resource elindul. Rejtse el őket, majd amikor szükség van rá, jelenítse meg a játékosnak.

Ezért írni fogunk egy eseménykezelőt az [[onClientResourceStart]]-ra, hogy hozza létre az ablakot:
<syntaxhighlight lang="lua">
-- attach the event handler to the root element of the resource
-- this means it will only trigger when its own resource is started
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
-- call the createRulesWindow function to create our gui
createRulesWindow()
end
)
</syntaxhighlight>

Mivel ez egy ''szabályok'' ablak, ezért ezt meg kell jelenítenünk a játékosnak, amikor csatlakozik.
Szerencsére a GUI elemek alapértelmezetten láthatóek, ezért nem kell több kódot írni ennek megvalósítása érdekében.

Azonban láthatóvá kell tenni a kurzort a játékosoknak is.
Ezt megtehetjük ugyan azzal az eventel használva, [[onClientResourceStart]], így módosítani tudjuk a fenti kódot, hogy láthatóvá tegye a kurzort:

'''Mostpedig több kódot adunk hozzá a már meglévő 'onClientResourceStart' event-ünkhöz. Ez nem egy új function, hanem a már meglévőt helyettesíti.'''
<syntaxhighlight lang="lua">
-- attach the event handler to the root element of the resource
-- this means it will only trigger when its own resource is started
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
-- call the createRulesWindow function to create our gui
createRulesWindow()

-- show the cursor to the player
showCursor(true,true)
end
)
</syntaxhighlight>

Most már van egy kész ''szabályok'' ablakunk. Ezután megkell írnunk a gomb müködését az elfogadás gombhoz.

==A gomb megírása==
Most, hogy létrehoztuk a GUI-t, működővé is kell hogy tegyük.

===A klikk észlelése===
Ha egy játékos rákattint a GUI bármely részére, akkor az "[[onClientGUIClick]]" event meg fog hívodni arra a GUI részre, amelyre kattintott. Ez lehetővé teszi a számunkra, hogy kennyedén észlelni tudjunk bármilyen kattintást a GUI elemen, amit használni akarunk.
Például, hozzá tudjuk csatolni a 'rulesButton' eventet a gombhoz, hogy érzékelje a kattintásokat rajta:
<syntaxhighlight lang="lua">
-- attach the event onClientGUIClick to rulesButton and set it to trigger the 'acceptRules' function
addEventHandler("onClientGUIClick", rulesButton, acceptRules, false)
</syntaxhighlight>
'''Vegye figyelembe, hogy az utolsó paraméter az "false". Ez azt mutatja, hogy az event közvetlenül csak a rulesButton-on hívodik meg, és nem akkor, ha az event magasabb, vagy alacsonyabb ágon van. Gui elem csatolása közben, ha "true"-ra állítja, akkor az azt jelenti, hogy bármely ugyan azon ágon lévő elemre kattintás során az event meghívodik.'''

Ezt a kódot már hozzá is adhatjuk a 'createRulesWindow' function-höz. Gyakori hiba, hogy eventeket próbálnak meg csatolni egy nem létező GUI-hoz, ezért győződjön meg arról, hogy mindig a létrehozott GUI elem után csatolja az eventet (ebben az esetben a gomb):
<syntaxhighlight lang="lua">
function createRulesWindow()
-- create all our GUI elements
...

-- now add our onClientGUIClick event to the button we just created
addEventHandler("onClientGUIClick", rulesButton, acceptRules, false)
</syntaxhighlight>

===A klikk kezelése===
Most, hogy észlelni tudjuk, hogy a játékos mikor kattint a gombra, írnunk kell egy kódot, ami kezelni tudja ezt, amikor a játékos kattint.
A mi [[onClientGUIClick]] event handler-ünkben azt mondtuk, hogy hívja meg a 'acceptRules' function-t, amikor a 'rulesButton'-ra kattintottak.
Ezért most már használhatjuk a 'acceptRules' function-t annak ellenőrzésére, hogy mi történik a gomb megnyomásakor:
<syntaxhighlight lang="lua">
-- create the function and define the 'button' and 'state' parameters
-- (these are passed automatically by onClientGUIClick)
function acceptRules(button,state)
-- if our accept button was clicked with the left mouse button, and the state of the mouse button is up
if button == "left" and state == "up" then
-- hide the window and all the components
guiSetVisible(rulesWindow, false)

-- hide the mouse cursor
showCursor(false,false)

-- output a message to the player
outputChatBox("Thank you for accepting our rules. Have fun!")

-- if the warning timer exists
if rulesWarningTimer then
-- stop the timer and set the variable to nil
-- this is the timer used to kick players who do not accept the rules. We will cover this in more detail in the next section.
killTimer(rulesWarningTimer)
rulesWarningTimer = nil
end
end
end
</syntaxhighlight>
Most, amikor a gombot megnyomják, akkor az ablak és a kurzor elrejtődik.

==Elfogadás ellenőrzése==
Jelenleg a mi ablakunk akkkor fog megjelenni, amikor a játékos csatlakozik a szerverre, és csak az elfogadás után tünik el.
Azonban, ha nem fogjadja el, akkor bármeddig a szerveren maradhat a nyitott ablakkal együtt.

===Az időzítő beállítása===
Ennek elkerülésének érdekében egy [[setTimer]]-t adunk hozzá, hogy egy bizonyos idő után kickelje a játékost, ha nem fogadta el a szabályokat.
Előszőr is szükségünk lesz egy globális változóra, hogy tárolni tudjuk az időt:
<syntaxhighlight lang="lua">
local rulesWarningTimer = nil
</syntaxhighlight>
Helyezze ezt a sort a script legtetejére (nem kell, hogy a function-on belül legyen)

Ezután létre hozzuk az időzítőt:

'''Mostpedig több kódot adunk hozzá a már meglévő 'createRulesWindow' function-ünkhöz'''
<syntaxhighlight lang="lua">
function createRulesWindow()
-- create all of our gui
...

-- set a timer for 30 seconds and set it to call our 'inactivePlayer' function with "1" as an argument
rulesWarningTimer = setTimer(inactivePlayer,30000,1,1)
end
</syntaxhighlight>
Helyezze ezt a [[setTimer]] sort a 'createRulesWindow' function közepére.
Ez létre fog hozni egy időzítőt, amely 30 másodperc után fog meghívódni.

===Figyelmeztetés===
Most megfogjuk írni az 'inactivePlayer' function-ünket, hogy figyelmeztetést adjon a játékosnak, és végül kickelje is ki, ha nem fogadja el:
<syntaxhighlight lang="lua">
-- create our function and define the 'status' parameter
-- the value of status will be passed from our setTimer function call
function inactivePlayer(status)
-- if status is 1 (this means it is the first warning)
if status == 1 then
-- output a warning
outputChatBox("Please accept our rules or be kicked.")

-- set another timer to call inactivePlayer in another 30 seconds, with "2" as an argument
rulesWarningTimer = setTimer(inactivePlayer,30000,1,2)

-- if status is 2 (the second warning)
elseif status == 2 then
-- output a final warning
outputChatBox("FINAL WARNING: Please accept our rules or be kicked.")

-- set a final timer to call inactivePlayer in another 30 seconds, with "3" as an argument
rulesWarningTimer = setTimer(inactivePlayer,30000,1,3)
elseif status == 3 then
-- trigger the server so we can kick the player
triggerServerEvent("clientKickInactivePlayer",getLocalPlayer())
end
end
</syntaxhighlight>
Vegye figyelembe a [[triggerServerEvent]] használatát, hogy meghívja a szervert. Tapasztalatának kell lennie a client-server kommunikációjáról [[HU/Introduction to Scripting the GUI|az előző tutorialból]].
Ha nincs, vissza mehet és elolvashatja a teljes magyarázatot.

Ezzel be is fejeztük a teljes clint oldali kódunkat ehhez a tutoriálhoz.

===A játékos kickelése===
Most foglalkoznunk kell azzal a server oldali eventel, amit a client oldalon hívtunk meg. Nyissa meg a server oldali lua fájlt, amivel dolgozni fogunk.

Kezdésként hozzá fogjuk adni az eventet a szerverhez:
<syntaxhighlight lang="lua">
-- add the event, note the final argument "true" indicates it can be triggered from the client
addEvent("clientKickInactivePlayer",true)
-- add an event handler for this event to trigger the kickInactivePlayer function
addEventHandler("clientKickInactivePlayer",root,kickInactivePlayer)
</syntaxhighlight>
'''Győződjön meg arról, hogy hozzáadta az event handler-t miután meghatározta a 'kickInactivePlayer' function-t.'''

Vegye figyelembe az [[addEvent]] és az [[addEventHandler]] használatát a szerveren. Mostanra már rendelkeznie kell némi tapasztalattal a client-server kommunikációjáról az [[Introduction to Scripting the GUI|előző tutorialból]]. Ha nincs, vissza mehet és elolvashatja a teljes magyarázatot.

Végezetűl hozzáadjuk a 'kickInactivePlayer' function-t, hogy kezelje a játékos kickelését:
<syntaxhighlight lang="lua">
-- create our function
function kickInactivePlayer()
-- kick the player
kickPlayer(client,"Please accept our rules.")
end
</syntaxhighlight>
Vegye figyelembe a 'client' változó használatát, ez egy MTA specifikus változó, ami az eseményt hívó client-et (player elementet) tartalmazza.

'''Vegye figyelembe, hogy a [[kickPlayer]]-nek rendelkeznie kell ACL hozzáféréssel.'''

'''Ez a legegyszerűbb módja a resouce hozzáadásának az ACL-ben:'''
<syntaxhighlight lang="xml">
<group name="Admin">
...
<object name="resource.YourResourceName" />
...
</group>
</syntaxhighlight>
További információért az [[ACL]]-ról, látogassa meg [[ACL]] wiki oldalt.

Ez fejezi be ezt a tutoriált. Most már rendelkeznie kell egy teljesen működő 'szabályok' ablakkal a szerverén.

A GUI-val való további segítségért látogassa meg a [[:Category:GUI_Tutorials_hu|GUI tutorials]] oldalt.

[[Category:GUI_Tutorials]]

[[en:Introduction to Scripting the GUI - Part 2]]

==Fordította==
'''2018.11.08.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

HU/Element/Effect

2019-01-25T15:42:42Z

Surge: /* Related scripting functions */

{{New items|3.0140|1.4|
Az Effect osztály a játékban az egyedi effect-eket jelenti, mint például a füst, tűz, stb.

Az osztály elemtípusa a '''"effect"'''.
}}

__TOC__
== Effect lista ==
82 effect van.
<syntaxhighlight lang="lua">--Egy tábla tartalmazza az összes effect nevet.
local effectNames = {
"blood_heli","boat_prop","camflash","carwashspray","cement","cloudfast","coke_puff","coke_trail","cigarette_smoke",
"explosion_barrel","explosion_crate","explosion_door","exhale","explosion_fuel_car","explosion_large","explosion_medium",
"explosion_molotov","explosion_small","explosion_tiny","extinguisher","flame","fire","fire_med","fire_large","flamethrower",
"fire_bike","fire_car","gunflash","gunsmoke","insects","heli_dust","jetpack","jetthrust","nitro","molotov_flame",
"overheat_car","overheat_car_electric","prt_blood","prt_boatsplash","prt_bubble","prt_cardebris","prt_collisionsmoke",
"prt_glass","prt_gunshell","prt_sand","prt_sand2","prt_smokeII_3_expand","prt_smoke_huge","prt_spark","prt_spark_2",
"prt_splash","prt_wake","prt_watersplash","prt_wheeldirt","petrolcan","puke","riot_smoke","spraycan","smoke30lit","smoke30m",
"smoke50lit","shootlight","smoke_flare","tank_fire","teargas","teargasAD","tree_hit_fir","tree_hit_palm","vent","vent2",
"water_hydrant","water_ripples","water_speed","water_splash","water_splash_big","water_splsh_sml","water_swim","waterfall_end",
"water_fnt_tme","water_fountain","wallbust","WS_factorysmoke"
}</syntaxhighlight>
{|class="wikitable" style="text-align: center; font-size: 12px;"
|-
!width="150"|Name
!width="300"|Description


|-
|blood_heli
|bloody explosion
|-
|boat_prop
|a surf
|-
|camflash
|small flare
|-
|carwashspray
|steam, as on a carwash
|-
|cement
|cement
|-
|cloudfast
|fast clouds

|-
|coke_puff
|puff of a coke
|-
|coke_trail
|a pouring water
|-
|cigarette_smoke
|a smoke from a cigarette
|-
|explosion_barrel
|explosion and splinters of a box
|-
|explosion_crate
|explosion and splinters of the large box
|-
|explosion_door
|a smoke with sparks
|-
|exhale
|a small smoke
|-
|explosion_fuel_car
|explosion, as from the machine
|-
|explosion_large
|the large explosion
|-
|explosion_medium
|average explosion
|-
|explosion_molotov
|explosion, as from a molotov cocktail
|-
|explosion_small
|small explosion
|-
|explosion_tiny
|very small explosion
|-
|extinguisher
|foam of the fire extinguisher
|-
|flame
|small fire
|-
|fire
|fire
|-
|fire_med
|average fire
|-
|fire_large
|large fire
|-
|flamethrower
|fire of the flamethrower
|-
|fire_bike
|fire, as from a burning motorcycle
|-
|fire_car
|fire, as from the burning machine
|-
|gunflash
|as the bullet from a trunk takes off
|-
|gunsmoke
|a smoke from a gun
|-
|insects
|insects
|-
|heli_dust
|a dust, as from the helicopter
|-
|jetpack
|a jetpacks fire
|-
|jetthrust
|fire from the muffler of the machine, as during use of nitrogen
|-
|nitro
|nitro
|-
|molotov_flame
|fire from a Molotov Cocktail
|-
|overheat_car
|smoke from damaged car
|-
|overheat_car_electric
|wrecked electro-machine
|-
|prt_blood
|spark? maybe meant to be a mini red blood splash
|-
|prt_boatsplash
|foam
|-
|prt_bubble
|bubble
|-
|prt_cardebris
|splinters from a box
|-
|prt_collisionsmoke
|a dense white smoke
|-
|prt_glass
|a crashing glass
|-
|prt_gunshell
|shells
|-
|prt_sand
|sand, which was scattered
|-
|prt_sand2
|there is less sand, than in previous animation
|-
|prt_smokeII_3_expand
|a grey smoke
|-
|prt_smoke_huge
|there is a lot of grey smoke
|-
|prt_spark
|of a spark
|-
|prt_spark_2
|the large sparks
|-
|prt_splash
|burst
|-
|prt_wake
|a wave
|-
|prt_watersplash
|sparks
|-
|prt_wheeldirt
|sparks from wheels of the car
|-
|petrolcan
|a jet
|-
|puke
|belch
|-
|riot_smoke
|there is a lot of smoke
|-
|spraycan
|spray
|-
|smoke30lit
|a smoke
|-
|smoke30m
|a rich smoke
|-
|smoke50lit
|more richer smoke
|-
|shootlight
|a light being shot out (used for searchlights), sparks and glass
|-
|smoke_flare
|a light being shot out, sparks and glass, it makes a good firework effect
|-
|tank_fire
|a shot from the tank
|-
|teargas
|gas, as from gas grenade
|-
|teargasAD
|gas, as from small gas grenade
|-
|tree_hit_fir
|leaf falling
|-
|tree_hit_palm
|falling of pair large leafs
|-
|vent
|slowly dissipating a smoke
|-
|vent2
|practically too most
|-
|water_hydrant
|the large flow of water
|-
|water_ripples
|circles on water
|-
|water_speed
|the large sparks from water
|-
|water_splash
|small sparks from water
|-
|water_splash_big
|average sparks
|-
|water_splsh_sml
|sparks, only them it is not visible almost
|-
|water_swim
|small sparks at navigation
|-
|waterfall_end
|there is a lot of pair
|-
|water_fnt_tme
|the large flow of water
|-
|water_fountain
|water of a fountain
|-
|wallbust
|a disappearing heap pair
|-
|WS_factorysmoke
|smoke
|}

==Related scripting functions==
===Client===
* [[HU/createEffect]]
* [[HU/setEffectSpeed]]
* [[HU/getEffectSpeed]]
* [[HU/setEffectDensity]]
* [[HU/getEffectDensity]]

[[Category:Element Types]]

[[en:Element/Effect]]
[[ru:Element/Effect]]

==Fordította==
'''2018.12.08.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

User:Surge

2019-01-21T14:08:24Z

Surge:

<pageclass class="#ff55bb" style="background: #FFE2F3; subcaption="Surge’s Profile"></pageclass>

===Activity===
<font color="#ED008E">'''Translation of MTA Wiki to Hungarian.'''</font>

{| class="wikitable" style="width:32%;"
|-
! scope="col" {{S_Scripting}}
|-
| {{Scripting_the_GUI}}
|-
| {{Scripting_the_GUI_2}}
|-
| {{Scripting_the_GUI_3}}
|-
| {{Tutorial 1}}
|-
| {{Tutorial_2}}
|-
| {{Tutorial_3}}
|-
| {{S_Debugging}}
|-
| {{S_Resources}}
|-
| {{S_Resource Web Access}}
|-
| {{S_Meta.xml}}
|-
| {{S_ACL}}
|-
| {{S_Writing_Gamemodes}}
|-
| {{S_Useful_Functions}}
|-
| {{S_OOP_Introduction}}
|-
! scope="col" {{S_Reference}}
|-
| {{S_Client_Funtions}}
|-
| {{S_Classes}}
|-
| {{S_Element}}
|-
! scope="col" {{S_Map_Editor}}
|-
| {{S_Editor}}
|-
| {{S_EDF}}
|-
| {{S_Plugins}}
|}

<br/>
<br/>
<font size="10"><font color="#ff55bb"><center>I love cats</center></font></font>
<br/>

HU/createPed

2018-12-30T17:21:07Z

Surge: /* Szintaxis */

__NOTOC__
{{Shared function hu}}
Létrehoz egy pedet a GTA világban.

==Szintaxis==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">ped createPed ( int modelid, float x, float y, float z [, float rot = 0.0, bool synced = true ] )</syntaxhighlight>

===Kötelező paraméterek===
*'''modelid:''' Egy egész szám, ami meghatározza a [[Character_Skins|GTASA skin ID]]-t.
*'''x:''' A térképen az X koordinátát ábrázoló lebegőpontos szám.
*'''y:''' A térképen az Y koordinátát ábrázoló lebegőpontos szám.
*'''z:''' A térképen az Z koordinátát ábrázoló lebegőpontos szám.

==Tetszőleges paraméterek==
{{OptionalArg hu}}<br/>
*'''rot:''' Egy lebegőpontos szám ami a forgást jelöli fokokban.
*'''synced:''' Egy boolean érték, ami meghatározza, hogy a ped syncelve lesz-e. A sync kikapcsolása hasznos lehet fagyasztott, vagy statikus pedeknél a szerver teljesítményének javítására.
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">ped createPed ( int modelid, float x, float y, float z [, float rot = 0.0 ] )</syntaxhighlight>

===Kötelező paraméterek===
*'''modelid:''' Egy egész szám, mely meghatározza a [[Character_Skins|GTASA skin ID]]-t.
*'''x:''' A térképen az X koordinátát ábrázoló lebegőpontos szám.
*'''y:''' A térképen az Y koordinátát ábrázoló lebegőpontos szám.
*'''z:''' A térképen az Z koordinátát ábrázoló lebegőpontos szám.

==Tetszőleges paraméterek==
{{OptionalArg hu}}<br/>
*'''rot:''' Egy lebegőpontos, szám ami a forgást jelöli fokokban.
</section>

===Visszatérési érték===
Visszatérési értéke egy ped elem, ha sikeresen létre lett hozva.

==Példa==

<section name="Server" class="server" show="true">
Ez a példa létrehoz egy pedet, amikor a resource elindul:
<syntaxhighlight lang="lua">
function pedLoad ( name )
createPed ( 120, 5540.6654, 1020.55122, 1240.545 )
end
addEventHandler ( "onResourceStart", getResourceRootElement(), pedLoad )
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
Ez a példa létrehoz egy pedet, és sérthetetlenné teszi:
<syntaxhighlight lang="lua">
thePed = createPed(120, 5540.6654, 1020.55122, 1240.545) -- Creates a ped
function cancelPedDamage()
cancelEvent() -- Cancels the onClientPedDamage event
end
addEventHandler("onClientPedDamage", thePed, cancelPedDamage) -- When thePed is damaged, cancelPedDamage is called
</syntaxhighlight>
</section>

==Issues==
{{Issues|
{{Issue|7371|Network troubled players can ruin ped sync}}
{{Issue|5113|setPedControlState doesn't work on the control "enter_exit"}}
{{Issue|6287|Sync distance of unoccupied vehicles and peds should match stream distance}}
{{Issue|8790|Using setElementHealth on a dead ped makes it invincible}}
{{Issue|5725|Ped fireing Projectiles doesn't work}}
{{Issue|4921|Improve ped synchronization}}
{{Issue|5840|ped position not synced to server after falling through the ground}}
{{Issue|6682|Server doesnt update ped position after warping it to vehicle}}
{{Issue|6506|Ped animation is only visible if it was set while player was in stream distance from source ped}}
{{Issue|4596|Serverside peds have their animations not applied for joining players}}
{{Issue|4504|Peds shooting incorrectly}}
{{Issue|4008|Can't use giveWeapon() directly after createPed()}}
}}

==Lásd még==
{{Ped functions hu}}

[[en:createPed]]
[[pl:createPed]]
[[ru:createPed]]

==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

HU/Scripting the GUI - Tutorial 3

2018-12-26T21:24:22Z

Surge: /* A GUI létrehozása */

'''GUI készítése - Tutorial 3 (Görgethető hírek)'''

Ebben a tutoriálban megvizsgáljuk, hogy hogyan hozhatunk létre egy görgethető hírek GUI-t,
lehetővé téve a gyors és egyszerű szerver frissítések és más szerver információk megjelenítését a játékosnak.
Az összes híreket egy kliens oldali xml fájlban fogjuk tárolni, és néhány egyszerű xml olvasást fogunk használni, hogy betöltjük őket a játékba.

We will then animate the news item to scroll along the bottom of the screen, updating the news text once it has scrolled beyond the edge of the screen.

'''Ne feledje, hogy ez a tutoriál feltételezi azt, hogy tisztában van az [[HU/Introduction to Scripting the GUI|előző tutoriálban]] bemutatott összes tartalommal'''

==A hírek létrehozása==
Kezdésként nyisson meg egy client oldali lua fájlt (ha követte a [[HU/Bevezetés a scriptelésbe|bevezetés a scriptelésbe]] oldalt, akkor ez a gui.lua lesz) amivel majd dolgozni fog.

===A GUI létrehozása===
Az előző tutoriálok használata után most már jól kell ismernie a GUI létrehozásának lépéseit, ezért nem is fogunk túl nagy részleteiben belemenni.
<syntaxhighlight lang="lua">
function createNewsFeed()
-- get the screen width and height
local sWidth, sHeight = guiGetScreenSize()

-- create the gridlist, using some maths to find the bottom-centre of the screen
local Width,Height = 800,45
local X = (sWidth/2) - (Width/2)
local Y = sHeight - (Height/2)

-- the gridlist will act as the background to our news reel
newsGridlist = guiCreateGridList(X,Y,Width,Height,false)

-- create the label in the same place, but as a child of the gridlist
-- also make it half the height of the gridlist, as half of the gridlist is off the bottom of the screen
newsLabel = guiCreateLabel(X,Y,Width,Height/2,"Test text",false,newsGridlist)

-- call our function to read the news out of the xml file
loadNews()

-- load the first news item in the table
updateNewsItem(1)

-- define a global variable called 'currentItem' with the value 1
currentItem = 1
end

addEventHandler("onClientResourceStart",resourceRoot,createNewsFeed)
</syntaxhighlight>
Ne feledje, hogy a címke az a gridlist gyermekeként lett étrehozva.
Not only is this good practice in general, but it means that we can freely move parts of the label beyond the edge of the gridlist without them showing, which is critical to the visual effect of this tutorial.

Valamint a 'resourceRoot' változó használatát se feledje el. Ez egy olyan MTA változó, amely a használt resource root elem értékét tartalmazza.

A 'currentItem' változóval fogjuk nyomon követni, hogy jelenleg mely híreket jelenítjük meg.

===A hírek megírása===
Most, hogy létrehoztuk a GUI-nkat, szükségünk lesz néhány hírre amivel ezt megtöltjük.
Ehhez egy külsű kliens oldali xml fájlt fogunk használni, hogy beolvassuk a híreket.

Menjen a resource mappába és hozzon létre egy új xml fájlt newsfeed.xml néven (ne felejtse hozzáadni a meta.xml-hez a megfelelő client taggal).

Ebben a fájlban adja meg az alábbi információkat:
<syntaxhighlight lang="lua">
<root>
<news>This is an example news item.</news>
<news>From the 'Scripting the GUI' tutorial.</news>
<news>Showing scrolling news text.</news>
<news>Written on a GUI news feed.</news>
</root>
</syntaxhighlight>
Ahogy azt láthatja minden hírelemet <news>-ként határoztunk meg, melynek értéke a megjelenítendő hírszöveg.
Nincs korlátozás arra vonatkozóan, hogy mennyi hírelemet adhat hozzá.

===A hírek összegyűjtése===
Miután megírtuk a híreinket, összekell gyűjtenünk őket és tárolni egy táblában a kliens oldalon.
Ezt akkor fogjuk megtenni, amikor a resource elindul, ez megment minket attól, hogy folyamatosan hozzá nyúljunk az xml-hez az új hírek miatt.

Először meg kell adnunk egy táblázatot az elemek tárolásához:
<syntaxhighlight lang="lua">
local newsItems = {}
</syntaxhighlight>
Adja hozzá ezt a sort a script tetejére.
Győzödjön meg arról, hogy nem egy függvényben van benne, különben nem fog működni azon a függvényen kívül (ezt a "local" előtag jelzi).
Ha a script egész részében van meghatározva, akkor az összes függvényben működni fog.

Ezután be kell töltenünk az xml fájlt:
<syntaxhighlight lang="lua">
function loadNews()
-- load our "newsfeed.xml" file
local newsfile = xmlLoadFile("newsfeed.xml")

-- if it was successfully loaded
if newsfile then

-- always remember to unload files once you are finished
xmlUnloadFile(newsfile)
end
end
</syntaxhighlight>
'''Ne felejtse el bezárni a fájlt, miután már nem használja őket.'''

Végül hozzáadhatunk több kódot a loadNews függvényünkhoz, hogy beolvassa a híreket a newsItems táblánkba:
<syntaxhighlight lang="lua">
function loadNews()
local newsfile = xmlLoadFile("newsfeed.xml")

if newsfile then
-- loop through all the children of the root node (the "news" nodes)
for index,itemNode in ipairs(xmlNodeGetChildren(newsfile)) do
-- get the text (the news item) from the node
local item = xmlNodeGetValue(itemNode)

-- insert it into our newsItems table
table.insert(newsItems,item)
end

xmlUnloadFile(newsfile)
end
end
</syntaxhighlight>
Most ven egy 'newsItems'-nek nevezett táblánk, amely az összes hír szöveget egy xml fájlban tartja.

==A hírek frissítése==
Most, hogy létrehoztuk a GUI-t, és a hírek is készen állnak, írnunk kell még néhány kódot, hogy frissítsük a játékosok számára bemutatott híreket.
Mint azt korábban említettük, a hírek a 'newsLabel' GUI címkéjén fognak megjelenni.

Ehhez egy egyszerű függvényt fogunk írni, hogy megkapjuk a következő hírt a 'newsItems' táblánkból és megjelenítjük a címkénken.
<syntaxhighlight lang="lua">
-- define our function with a newIndex parameter, so that we can pass which news item we want to show
function updateNewsItem(newIndex)
-- get the new news item from the table
local item = newsItems[newIndex]

-- update the label text
guiSetText(newsLabel,item)

-- update the 'currentItem' global variable
currentItem = newIndex
end
</syntaxhighlight>

===A címke méretezése===
Ahhoz, hogy a híreket a lehető legpontosabban tudjuk görgetni, képesnek kell lennünk arra, hogy a GUI címke ugyanakkora méretű legyen, mint a megjelenített hírek szövege.

Bár ez egy kicsit bonyolultnak tűnhet, de a [[guiLabelGetTextExtent]] fügvénnyel ez nagyon egyszerűen elvégezhető.
Ez jelzi a címkén jelenleg látható szöveg terjedelmét, vagy szélességét.
Szóval néhány az 'updateNewsItems' függvényünkön történő módosítás után ezt kapjuk:
<syntaxhighlight lang="lua">
function updateNewsItem(newIndex)
local item = newsItems[newIndex]

guiSetText(newsLabel,item)

currentItem = newIndex

-- get the current dimensions of the gui label
local width,height = guiGetSize(newsLabel,false)

-- get the text width of the label
local extent = guiLabelGetTextExtent(newsLabel)

-- update the size of the label with the new width (we do not change the height)
guiSetSize(newsLabel,extent,height,false)
end
</syntaxhighlight>

===A címke elhelyezése===
Now that our GUI label is the correct width, we need to move it to a position where it is ready to scroll onto the screen.

Again, we can do this with a small modification to our 'updateNewsItems' function:
<syntaxhighlight lang="lua">
function updateNewsItem(newIndex)
local item = newsItems[newIndex]

guiSetText(newsLabel,item)

currentItem = newIndex

local width,height = guiGetSize(newsLabel,false)

local extent = guiLabelGetTextExtent(newsLabel)

guiSetSize(newsLabel,extent,height,false)

-- set the positon to the far right side of the gridlist, ready to scroll on to the left
guiSetPosition(newsLabel,1,0,true)
end
</syntaxhighlight>
Note the use of '''relative''' position values in the final line of the function.

In this case, it is far easier than calculating pixel values.

You can use both relative and absolute in the same script if you want to, the only limitation is that you cannot mix them in the same function call. The type of values you are using is defined by the final argument (true or false).

This means you cannot do the following and have it set to 400 pixels in, but 0.5% down
<syntaxhighlight lang="lua">
guiSetPosition(yourElement,400,0.5,false)
</syntaxhighlight>
The final argument "false" means both 400 and 0.5 will be read as pixel values.

==Scrolling the News==
The next step is to animate our news feed.

===Looking at Frames===
To do this, we will introduce a new event: [[onClientRender]].
As stated on the [[onClientRender]] wiki page, this event is called every time GTA renders a new frame (ie: very often).

As usual, to use this event we will need to create an event handler for it:
<syntaxhighlight lang="lua">
addEventHandler("onClientRender",root,scrollNews)
</syntaxhighlight>
This will call our scrollNews function every frame, which we will then use to update the position of our news item.

'''Make sure you add this handler after you have defined your scrollNews function.'''

For our purposes, [[onClientRender]] has one main advantage over, for example, [[setTimer]].
As it is called every frame (and therefore is dependant on the players FPS), the movement of the news item will always appear to be completely smooth,
unlike using a timer which would often appear to lag.

===Moving the News===
In our 'updateNewsItem' function, we position the 'newsLabel' to the far right, so we will scroll in from the right to the left.

For this we will simply move the X position by -1 every frame:
<syntaxhighlight lang="lua">
function scrollNews()
-- if the newsLabel exists
if newsLabel then
-- get the current position of the label
local x,y = guiGetPosition(newsLabel,false)

-- set the new x position of the label as the old position -1
guiSetPosition(newsLabel,x-1,y,false)
end
end
</syntaxhighlight>

===Looping around===
Now that our news scrolls across the screen, we need to be able to check when it has scrolled too far to the left
so we can start scrolling from the far-right side again.

We will also need to update the news item, so we should check the next item exists, and if it doesn't, go back to the first.

For this we will use some simple maths in a modification to our 'scrollNews' function:
<syntaxhighlight lang="lua">
function scrollNews()
local x,y = guiGetPosition(newsLabel,false)

local labelWidth, labelHeight = guiGetSize(newsLabel,false)

-- if the far right position of the label (x + labelWidth) is greater than or equal to 0 (ie: still showing on the gridlist)
if ((x-1) + labelWidth) >= 0 then
-- compensate for a small off-by-one bug in MTA
if x <= 0 then x = x - 1 end

-- update the position as normal
guiSetPosition(newsLabel,x-1,y,false)

-- otherwise, we move on to the next item and reset the position
else
-- get the total number of items in the 'newsItems' table
local totalItems = #newsItems

-- if the next item on our list does not exist in our table
if (currentItem + 1) > totalItems then
-- loop back to the first item in the list
updateNewsItem(1)
else
-- otherwise move onto the next item in the list
updateNewsItem(currentItem + 1)
end
end
end
</syntaxhighlight>
Notice the use of the '#' symbol to get the size of the 'newsItems' table.
This is the Lua length operator, but it only works on tables that have numerical indexes (like an array or a list).
It also works on strings, eg: #"hello" would return 5.

That completes this section of the tutorial.
For ideas on how to further improve and advance this code, continue reading the next section.

==Improving the code==
This section will detail several ways to improve upon the code you now have.

===GUI Customisation===
To give your GUI a more unique feel, you have the ability to customise some aspects of your GUI elements.

For ideas on what is possible, browse the [[Client_Scripting_Functions#GUI_functions|MTA GUI functions]].

For the purposes of this tutorial, we will be using Font, Colour and Alpha.

To start, we will change the alpha of the background gridlist GUI element we are using.
To set the alpha, use [[guiSetAlpha]] and pass a value between 1 and 0; 1 being fully opaque and 0 being fully transparent.
<syntaxhighlight lang="lua">
guiSetAlpha(newsGridlist,0.8)
</syntaxhighlight>
Place this line of code in your 'createNewsFeed' function, after your gridlist has been created.

I find an alpha level of 0.8 looks best, however this is personal preference and you can experiment to suit your needs.

Next, we will look at the font of the label text.
To set the font, use [[guiSetFont]] and pass the string name of the font you want to use (available to see on the [[Standard GUI Font Names]] page).
<syntaxhighlight lang="lua">
guiSetFont(newsLabel,"default-bold-small")
</syntaxhighlight>
Place this line of code in your 'createNewsFeed' function, after your label has been created.

Finally, we will look at setting the colour of the label text.
To set the colour, use [[guiLabelSetColor]] and pass the individual red,green and blue values.
<syntaxhighlight lang="lua">
guiLabelSetColor(newsLabel,255,70,0)
</syntaxhighlight>
Place this line of code in your 'createNewsFeed' function, after your label has been created.

This will give your news items an orange-red colour.

===Multiple News Items===
In its current form, this code is only capable of showing one news item at a time.
However, with a few modifications we can show multiple news items at once, one after another.

To begin with, we need to make sure we have a 'newItems' table defined at the very start of our script,
as well as a 'distance' variable that will control the pixel distance between each news item:
<syntaxhighlight lang="lua">
local newsItems = {}
local distance = 30
</syntaxhighlight>
So put these lines at the top of the file.

Next, we will not know how many items we have (and consequently, how many labels we need) until we have loaded the file.
With that in mind, we will move around some of the code in our 'createNewsFeed' function to support this:
<syntaxhighlight lang="lua">
function createNewsFeed()
-- get the screen width and height
local sWidth, sHeight = guiGetScreenSize()

-- create the gridlist, using some maths to find the bottom-centre of the screen
local Width,Height = 800,45
local X = (sWidth/2) - (Width/2)
local Y = sHeight - (Height/2)

-- the gridlist will act as the background to our news reel
newsGridlist = guiCreateGridList(X,Y,Width,Height,false)

guiSetAlpha(newsGridlist,0.8)

-- call our function to read the news out of the xml file, before we create the labels
loadNews()

-- define a table to hold our labels
newsLabel = {}

-- now we can loop all our news items, and create a label for each one
for index,item in ipairs(newsItems) do

-- because we now have one label for every item, we can just set the text here and it wont need to be changed again.
newsLabel[index] = guiCreateLabel(0,0,Width,Height/2,item,false,newsGridlist)

guiSetFont(newsLabel[index],"default-bold-small")

guiLabelSetColor(newsLabel[index],255,70,0)

-- modify the width of the label to fit the text
local extent = guiLabelGetTextExtent(newsLabel[index])
guiSetSize(newsLabel[index],extent,Height/2,false)

-- get the size of the gridlist
local x,y = guiGetSize(newsGridlist,false)

-- loop from 1 until index-1 in steps of 1
-- this allows us to loop every label before the label we are currently on
for i=1, index-1, 1 do
-- tally up the sizes of all labels before our current one and store them in x
local width = guiGetSize(newsLabel[i],false)
x = x + width
end

-- put a 'distance' pixel gap between each news item
x = x + (distance*(index-1))

-- set the positon to the far right side of the gridlist, ready to scroll on to the left
guiSetPosition(newsLabel[index],x,0,false)
end
end
</syntaxhighlight>

Now we need to update our 'updateNewsItem' function to account for having multiple labels:
<syntaxhighlight lang="lua">
function updateNewsItem(newIndex)
-- find the index of the news item directly infront (in the looping order) of the newIndex item
local index = newIndex - 1
if index == 0 then index = #newsItems end

-- find the position of the right-edge of the label directly infront of the newIndex label
local x = guiGetPosition(newsLabel[index],false)
local width = guiGetSize(newsLabel[index],false)
x = x + width

-- add a 'distance' pixel gap in
x = x + distance

-- check the new position isnt actually on the gridlist (ie: so it wont suddenly appear in the centre of the list)
local gridlistWidth = guiGetSize(newsGridlist,false)

if x < gridlistWidth then
-- if it is, simple move it back to the edge
x = gridlistWidth
end

-- set the new position
guiSetPosition(newsLabel[newIndex],x,0,false)
end
</syntaxhighlight>

Finally, we need to make some small adjustments to our 'scrollNews' function:
<syntaxhighlight lang="lua">
function scrollNews()
if newsItems then
-- loop every news item
for index,item in ipairs(newsItems) do
local x,y = guiGetPosition(newsLabel[index],false)

local labelWidth, labelHeight = guiGetSize(newsLabel[index],false)

-- if the far right position of the label (x + labelWidth) is greater than or equal to 0 (ie: still showing on the gridlist)
if ((x-1) + labelWidth) >= 0 then
-- compensate for a small off-by-one bug in MTA
if x <= 0 then x = x - 1 end

-- update the position as normal
guiSetPosition(newsLabel[index],x-1,y,false)

-- otherwise, we move on to the next item and reset the position
else
updateNewsItem(index)
end
end
end
end
</syntaxhighlight>

You should now have multiple news items scrolling along your news feed simultaneously.

===Globally controlled scroll speed===
As with the 'distance' variable above, we can set a global variable for controlling the scroll speed of the news items as well.
Note that the speed will still be dependant on the players FPS (ie: lower FPS means slightly slower scrolling).

To do this, we simply need to create the variable at the start of our code:
<syntaxhighlight lang="lua">
local scrollSpeed = 1
</syntaxhighlight>
Put this line at the top of your file.

Then, we just replace the instance of "x-1" in our 'scrollNews' function with "x-scrollSpeed":
<syntaxhighlight lang="lua">
function scrollNews()
...
-- update the position as normal
guiSetPosition(newsLabel[index],x-scrollSpeed,y,false)
...
end
end
</syntaxhighlight>
That concludes this section of the tutorial.

For previous GUI tutorials, see [[HU/Scripting the GUI - Tutorial 2|GUI készítése - Tutorial 2 (Gates + Keypads)]]

[[Category:GUI_Tutorials]]

[[en:Scripting the GUI - Tutorial 3]]

HU/How you can help

2018-12-26T19:21:36Z

Surge: /* Dokumentáció */

__NOTOC__
A Multi Theft Autot nagyon sok módon tudod segíteni. Örülünk, hogy segíthetünk neked, és ezáltal hamarosan te is a közösség fontos tagjává válhatsz. Ezen a lapon megtalálhatod az összes lehetőséget, és a hozzájuk tartozó leírásokat.
==Az MTA SA kódolása==
* Javítsd a játékot, készíts új funkciókat! ([[HU/Coding guidelines|Kódolási útmutató]])

==Scriptelés==
* Készíts egy játékmódot
**[[HU/Scripting Introduction|Bevezetés a Scriptelésbe]]
**[http://www.lua.org/pil/index.html "Lua Programozás" kézikönyv]
* Készíts egy HTTP adminisztrációs oldalt.
**[[HU/Resource Web Access|Resource internet hozzáférés]]
* Készíts egy programot, mely segítséget nyújthat a többi fejlesztőnek!
==Mappolás==
* Készíts egy mapot a Map Editorral egy létező játékmódhoz.
**[[HU/Resource:Editor|Map Editor kézikönyv]]

==Web fejlesztés==
* Dolgozz lil_Toady - val, és tölts fel új resourcekat a Community Center - be!
* Készíts egy új statisztika rendszer a [[PHP SDK]] segítségével!

==Dokumentáció==
Mielőtt bármilyen változtatást csinálsz: [[MTA_Wiki:Editing_Guidelines|Szerkesztési útmutató]]
* Készítsd el a [[HU/:Category:Incomplete|befejezetlen funkciók]] dokumentálását. - ha nem tudsz valamit, az IRC csatornán segíthetnek!
* Készíts példákat a [[HU/:Category:Needs Example|a példa nélkül funkciókhoz, eseményekhez]] - mielőtt azonban megjeleníted, teszteld őket!
* Nézd meg és erősítsd meg az [[HU/:Category:Needs Checking|ellenőrizetlen lapokat]] - bizonyosodj meg róla, hogy pontosan ellenőrizz, és próbáld megoldani a problémákat.
* Készíts példákat az [[Category:Scripting Concepts|MTA belső tartalmához]].
* Írj útmutatókat
* Fordítsd lapokat, hogy az országodbeli játékosok is használhassák a wikit!
* Készíts dokumentációkat a [[Undocumented Items|nem dokumentált lapokhoz]]

==Speciális feladatok==
* Keress problémákat/hibákat a scriptelési funkciókban!
* Segíts készíteni és javítani játékmódokat. Vedd fel a kapcsolatot az eredeti szerzővel!
* Az internet hozzáférésű resourcek sak a Mozilla Firefox - al kompatibilisek. Segíts, és tedd elérhetővé Internet Explorer - en, Safarin, és Google Chrome - on! Vedd fel a kapcsolatot [[User_talk:EAi|eAi]] - vel!

[[en:How you can help]]
[[pl:Jak możesz pomóc]]
[[ru:How you can help]]
[[uk:How you can help]]
[[es:Cómo puedes ayudar]]
[[tr:Nasıl yardımcı olabilirsiniz]]

HU/Resource:Admin

2018-12-25T20:59:46Z

Surge:

{{Resource page}}
Egy gyors tutoriál arról, hogy hogyan kaphat admin jogokat és hogyan telepítheti az admin resource-t.

<section name="MTA 1.0.0 vagy régebbi" class="server" show="false">
'''Figyelem:''' 1.0.5 MTA óta az accounts.xml fájlok el lettek távolítva és sqlite-val lett kicserélve.

Először nyissa meg az '''accounts.xml''' fájlt, mely a '''server\mods\deathmatch\'''-en belül található, és adja hozzá a saját fiókjának részleteit, ahogy a következő példa is mutatja.

<syntaxhighlight lang="xml"> <accounts>
<autologin>1</autologin>
<account name="Console" password="" />
<account name="Someguy" password="1234" />
</accounts>
</syntaxhighlight>
</section>

Egy fiók létrehozásához az '''MTA {{padleft:|3|{{Current Version|full}}}}'''-ban használja a következő parancsokat

'''Figyelem:''' Ehhez a művelethez a szervernek futnia kell
<syntaxhighlight lang="lua">
addaccount <username> <password>
</syntaxhighlight>

'''Figyelem:''' A szervernek nem szabad futnia, amíg az alábbi acl fájlt szerkeszti

Nyissa meg az '''acl.xml''' fájl, mely ugyanabban a mappában található, majd addja hozzá magát object-ként az Admin group-ba a 'user.*' szintaxis használatával, ahol a '*' a fiók nevét jelöli.

<syntaxhighlight lang="xml"> 
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="user.Someguy" />
<object name="resource.admin" />
</group>
</syntaxhighlight>

Most nyissa meg az '''mtaserver.conf''' fájlt és görgessen a legaljára, győződjön meg róla, hogy az admin resource hozzá van adva, hogy akkor induljon el, amikor a szerver (figyelem: protected="1" azt jelenti, hogy nem lehet megállítani).

<syntaxhighlight lang="conf"> <resource src="admin" startup="1" protected="0"> 
<resource src="helpmanager" startup="1" protected="0">
<resource src="mapcycler" startup="1" protected="0">
<resource src="mapmanager" startup="1" protected="0">
</syntaxhighlight>

Most, hogy végzett a szerver fájlokkal, végre elindíthatja. Csatlakozzon a szerverre és jelentkezzen be a fiók adataivel: használja a 'login [username] <password>'. Ha azt írja, hogy "press 'p' to open admin panel", akkor mindent megfelelően csinált, gratulálok! Ha nem, akkor kezdje el újra a legelelejétől.
[[Category:Scripting Concepts]]

[[en:Resource:Admin]]
[[it:Resource:Admin]]
[[ru:Resource:Admin]]

==Fordította==
'''2018.12.25.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

Resource:Admin

2018-12-25T20:56:17Z

Surge:

{{Resource page}}
A quick tutorial on how to get admin rights and install admin resource.

<section name="MTA 1.0.0 and lower" class="server" show="false">
'''Note:''' Since mta 1.0.5 the accounts.xml file has been removed and replaced by sqlite.

At first, open the '''accounts.xml''' file located in '''server\mods\deathmatch\''' and add a line with your account details, like on the following example.

<syntaxhighlight lang="xml"> <accounts>
<autologin>1</autologin>
<account name="Console" password="" />
<account name="lil_Toady" password="1234" />
</accounts>
</syntaxhighlight>
</section>

To add an account in '''MTA {{padleft:|3|{{Current Version|full}}}}''' use the following command in the server

'''Note:''' The server needs to run for this action
<syntaxhighlight lang="lua">
addaccount <username> <password>
</syntaxhighlight>

'''Note:''' Server should not be running when you are editing the acl file below

Then you open the '''acl.xml''' file located in the same folder and add yourself as an object to the Admin group by using the 'user.*' syntax, where * would be your account name.

<syntaxhighlight lang="xml"> 
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="user.lil_Toady" />
<object name="resource.admin" />
</group>
</syntaxhighlight>

Now open your '''mtaserver.conf''' file and scroll to the bottom, make sure the admin resource is added to the ones that start with the server (note: protected="1" means that it can not be stopped).

<syntaxhighlight lang="conf"> <resource src="admin" startup="1" protected="0"> 
<resource src="helpmanager" startup="1" protected="0">
<resource src="mapcycler" startup="1" protected="0">
<resource src="mapmanager" startup="1" protected="0">
</syntaxhighlight>

Now that you're done with server files, you can finally start it. Connect to the server itself and login with your account details: use 'login [username] <password>'. If it tells you to press 'p' you have done everything right, congratulations! If not, do this from the very beginning.
[[Category:Scripting Concepts]]

[[hu:Resource:Admin]]
[[it:Resource:Admin]]
[[ru:Resource:Admin]]

HU/Resource:Admin

2018-12-25T20:55:07Z

Surge:

{{Resource page}}
Egy gyors tutoriál arról, hogy hogyan kaphat admin jogokat és hogyan telepítheti az admin resource-t.

<section name="MTA 1.0.0 vagy régebbi" class="server" show="false">
'''Figyelem:''' 1.0.5 MTA óta az accounts.xml fájlok el lettek távolítva és sqlite-val lett kicserélve.

Először nyissa meg az '''accounts.xml''' fájlt, mely a '''server\mods\deathmatch\'''-en belül található, és adja hozzá a saját fiókjának részleteit, ahogy a következő példa is mutatja.

<syntaxhighlight lang="xml"> <accounts>
<autologin>1</autologin>
<account name="Console" password="" />
<account name="Someguy" password="1234" />
</accounts>
</syntaxhighlight>
</section>

Egy fiók létrehozásához az '''MTA {{padleft:|3|{{Current Version|full}}}}'''-ban használja a következő parancsokat

'''Figyelem:''' Ehhez a művelethez a szervernek futnia kell
<syntaxhighlight lang="lua">
addaccount <username> <password>
</syntaxhighlight>

'''Figyelem:''' A szervernek nem szabad futnia, amíg az alábbi acl fájlt szerkeszti

Nyissa meg az '''acl.xml''' fájl, mely ugyanabban a mappában található, majd addja hozzá magát object-ként az Admin group-ba a 'user.*' szintaxis használatával, ahol a '*' a fiók nevét jelöli.

<syntaxhighlight lang="xml"> 
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="user.Someguy" />
<object name="resource.admin" />
</group>
</syntaxhighlight>

Most nyissa meg az '''mtaserver.conf''' fájlt és görgessen a legaljára, győződjön meg róla, hogy az admin resource hozzá van adva, hogy akkor induljon el, amikor a szerver (figyelem: protected="1" azt jelenti, hogy nem lehet megállítani).

<syntaxhighlight lang="conf"> <resource src="admin" startup="1" protected="0"> 
<resource src="helpmanager" startup="1" protected="0">
<resource src="mapcycler" startup="1" protected="0">
<resource src="mapmanager" startup="1" protected="0">
</syntaxhighlight>

Most, hogy végzett a szerver fájlokkal, végre elindíthatja. Csatlakozzon a szerverre és jelentkezzen be a fiók adataivel: használja a 'login [username] <password>'. Ha azt írja, hogy "press 'p' to opne admin panel", akkor mindent megfelelően csinált, gratulálok! Ha nem, akkor kezdje el újra a legelelejétől.
[[Category:Scripting Concepts]]

[[en:Resource:Admin]]
[[it:Resource:Admin]]
[[ru:Resource:Admin]]

==Fordította==
'''2018.12.25.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

HU/Resource:Admin

2018-12-25T20:54:57Z

Surge:

{{Resource page}}
Egy gyors tutoriál arról, hogy hogyan kaphat admin jogokat és hogyan telepítheti az admin resource-t.

<section name="MTA 1.0.0 vagy régebbi" class="server" show="false">
'''Figyelem:''' 1.0.5 MTA óta az accounts.xml fájlok el lettek távolítva és sqlite-val lett kicserélve.

Először nyissa meg az '''accounts.xml''' fájlt, mely a '''server\mods\deathmatch\'''-en belül található, és adja hozzá a saját fiókjának részleteit, ahogy a következő példa is mutatja.

<syntaxhighlight lang="xml"> <accounts>
<autologin>1</autologin>
<account name="Console" password="" />
<account name="Someguy" password="1234" />
</accounts>
</syntaxhighlight>
</section>

Egy fiók létrehozásához az '''MTA {{padleft:|3|{{Current Version|full}}}}'''-ban használja a következő parancsokat

'''Figyelem:''' Ehhez a művelethez a szervernek futnia kell
<syntaxhighlight lang="lua">
addaccount <username> <password>
</syntaxhighlight>

'''Figyelem:''' A szervernek nem szabad futnia, amíg az alábbi acl fájlt szerkeszti

Nyissa meg az '''acl.xml''' fájl, mely ugyanabban a mappában található, majd addja hozzá magát object-ként az Admin group-ba a 'user.*' szintaxis használatával, ahol a '*' a fiók nevét jelöli.

<syntaxhighlight lang="xml"> 
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="user.Someguy" />
<object name="resource.admin" />
</group>
</syntaxhighlight>

Most nyissa meg az '''mtaserver.conf''' fájlt és görgessen a legaljára, győződjön meg róla, hogy az admin resource hozzá van adva, hogy akkor induljon el, amikor a szerver (figyelem: protected="1" azt jelenti, hogy nem lehet megállítani).

<syntaxhighlight lang="conf"> <resource src="admin" startup="1" protected="0"> 
<resource src="helpmanager" startup="1" protected="0">
<resource src="mapcycler" startup="1" protected="0">
<resource src="mapmanager" startup="1" protected="0">
</syntaxhighlight>

Most, hogy végzett a szerver fájlokkal, végre elindíthatja. Csatlakozzon a szerverre és jelentkezzen be a fiók adataivel: használja a 'login [username] <password>'. Ha azt írja, hogy "press 'p' to opne admin panel", akkor mindent megfelelően csinált, gratulálok! Ha nem, akkor kezdje el újra a legelelejétől.
[[Category:Scripting Concepts]]

[[en:Resource:Admin]]
[[it:Resource:Admin]]
[[ru:Resource:Admin]]

==Fordította==
'''2018.12.25.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

HU/Resource:Admin

2018-12-25T20:54:26Z

Surge:

{{Resource page}}
Egy gyors tutoriál arról, hogy hogyan kaphat admin jogokat és hogyan telepítheti az admin resource-t.

<section name="MTA 1.0.0 vagy régebbi" class="server" show="false">
'''Figyelem:''' 1.0.5 MTA óta az accounts.xml fájlok el lettek távolítva és sqlite-val lett kicserélve.

Először nyissa meg az '''accounts.xml''' fájlt, mely a '''server\mods\deathmatch\'''-en belül található, és adja hozzá a saját fiókjának részleteit, ahogy a következő példa is mutatja.

<syntaxhighlight lang="xml"> <accounts>
<autologin>1</autologin>
<account name="Console" password="" />
<account name="Someguy" password="1234" />
</accounts>
</syntaxhighlight>
</section>

Egy fiók létrehozásához az '''MTA {{padleft:|3|{{Current Version|full}}}}'''-ban használja a következő parancsokat

'''Figyelem:''' Ehhez a művelethez a szervernek futnia kell
<syntaxhighlight lang="lua">
addaccount <username> <password>
</syntaxhighlight>

'''Figyelem:''' A szervernek nem szabad futnia, amíg az alábbi acl fájlt szerkeszti

Nyissa meg az '''acl.xml''' fájl, mely ugyanabban a mappában található, majd addja hozzá magát object-ként az Admin group-ba a 'user.*' szintaxis használatával, ahol a '*' a fiók nevét jelöli.

<syntaxhighlight lang="xml"> 
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="user.Someguy" />
<object name="resource.admin" />
</group>
</syntaxhighlight>

Most nyissa meg az '''mtaserver.conf''' fájlt és görgessen a legaljára, győződjön meg róla, hogy az admin resource hozzá van adva, hogy akkor induljon el, amikor a szerver (figyelem: protected="1" azt jelenti, hogy nem lehet megállítani).

<syntaxhighlight lang="conf"> <resource src="admin" startup="1" protected="0"> 
<resource src="helpmanager" startup="1" protected="0">
<resource src="mapcycler" startup="1" protected="0">
<resource src="mapmanager" startup="1" protected="0">
</syntaxhighlight>

Most, hogy végzett a szerver fájlokkal, végre elindíthatja. Csatlakozzon a szerverre és jelentkezzen be a fiók adataivel: használja a 'login [username] <password>'. Ha azt írja, hogy "press 'p' to opne admin panel", akkor mindent megfelelően csinált, gratulálok! Ha nem, akkor kezdje el újra a legelelejétől.
[[Category:Scripting Concepts]]

[[en:Resource:Admin]]
[[it:Resource:Admin]]
[[ru:Resource:Admin]]

==Fordította==
'''2018.12.25.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

HU/Resource:Admin

2018-12-25T20:51:01Z

Surge:

{{Resource page}}
Egy gyors tutoriál arról, hogy hogyan kaphat admin jogokat és hogyan telepítheti az admin resource-t.

<section name="MTA 1.0.0 vagy régebbi" class="server" show="false">
'''Figyelem:''' 1.0.5 MTA óta az accounts.xml fájlok el lettek távolítva és sqlite-val lett kicserélve.

Először nyissa meg az '''accounts.xml''' fájlt, mely a '''server\mods\deathmatch\'''-en belül található, és adja hozzá a saját fiókjának részleteit, ahogy a következő példa is mutatja.

[[Image:admin_accounts.png]]
</section>

Egy fiók létrehozásához az '''MTA {{padleft:|3|{{Current Version|full}}}}'''-ban használja a következő parancsokat

'''Figyelem:''' Ehhez a művelethez a szervernek futnia kell
<syntaxhighlight lang="lua">
addaccount <username> <password>
</syntaxhighlight>

'''Figyelem:''' A szervernek nem szabad futnia, amíg az alábbi acl fájlt szerkeszti

Nyissa meg az '''acl.xml''' fájl, mely ugyanabban a mappában található, majd addja hozzá magát object-ként az Admin group-ba a 'user.*' szintaxis használatával, ahol a '*' a fiók nevét jelöli.

<syntaxhighlight lang="xml"> 
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="user.Someguy" />
<object name="resource.admin" />
</group>
</syntaxhighlight>

Most nyissa meg az '''mtaserver.conf''' fájlt és görgessen a legaljára, győződjön meg róla, hogy az admin resource hozzá van adva, hogy akkor induljon el, amikor a szerver (figyelem: protected="1" azt jelenti, hogy nem lehet megállítani).

<syntaxhighlight lang="conf"> <resource src="admin" startup="1" protected="0"> 
<resource src="helpmanager" startup="1" protected="0">
<resource src="mapcycler" startup="1" protected="0">
<resource src="mapmanager" startup="1" protected="0">
</syntaxhighlight>

Most, hogy végzett a szerver fájlokkal, végre elindíthatja. Csatlakozzon a szerverre és jelentkezzen be a fiók adataivel: használja a 'login [username] <password>'. Ha azt írja, hogy "press 'p' to opne admin panel", akkor mindent megfelelően csinált, gratulálok! Ha nem, akkor kezdje el újra a legelelejétől.
[[Category:Scripting Concepts]]

[[en:Resource:Admin]]
[[it:Resource:Admin]]
[[ru:Resource:Admin]]

==Fordította==
'''2018.12.25.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

Resource:Admin

2018-12-25T20:50:21Z

Surge:

{{Resource page}}
A quick tutorial on how to get admin rights and install admin resource.

<section name="MTA 1.0.0 and lower" class="server" show="false">
'''Note:''' Since mta 1.0.5 the accounts.xml file has been removed and replaced by sqlite.

At first, open the '''accounts.xml''' file located in '''server\mods\deathmatch\''' and add a line with your account details, like on the following example.

[[Image:admin_accounts.png]]
</section>

To add an account in '''MTA {{padleft:|3|{{Current Version|full}}}}''' use the following command in the server

'''Note:''' The server needs to run for this action
<syntaxhighlight lang="lua">
addaccount <username> <password>
</syntaxhighlight>

'''Note:''' Server should not be running when you are editing the acl file below

Then you open the '''acl.xml''' file located in the same folder and add yourself as an object to the Admin group by using the 'user.*' syntax, where * would be your account name.

<syntaxhighlight lang="xml"> 
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="user.lil_Toady" />
<object name="resource.admin" />
</group>
</syntaxhighlight>

Now open your '''mtaserver.conf''' file and scroll to the bottom, make sure the admin resource is added to the ones that start with the server (note: protected="1" means that it can not be stopped).

<syntaxhighlight lang="conf"> <resource src="admin" startup="1" protected="0"> 
<resource src="helpmanager" startup="1" protected="0">
<resource src="mapcycler" startup="1" protected="0">
<resource src="mapmanager" startup="1" protected="0">
</syntaxhighlight>

Now that you're done with server files, you can finally start it. Connect to the server itself and login with your account details: use 'login [username] <password>'. If it tells you to press 'p' you have done everything right, congratulations! If not, do this from the very beginning.
[[Category:Scripting Concepts]]

[[hu:Resource:Admin]]
[[it:Resource:Admin]]
[[ru:Resource:Admin]]

Resource:Admin

2018-12-25T20:49:33Z

Surge:

{{Resource page}}
A quick tutorial on how to get admin rights and install admin resource.

<section name="MTA 1.0.0 and lower" class="server" show="false">
'''Note:''' Since mta 1.0.5 the accounts.xml file has been removed and replaced by sqlite.

At first, open the '''accounts.xml''' file located in '''server\mods\deathmatch\''' and add a line with your account details, like on the following example.

[[Image:admin_accounts.png]]
</section>

To add an account in '''MTA {{padleft:|3|{{Current Version|full}}}}''' use the following command in the server

'''Note:''' The server needs to run for this action
<syntaxhighlight lang="lua">
addaccount <username> <password>
</syntaxhighlight>

'''Note:''' Server should not be running when you are editing the acl file below

Then you open the '''acl.xml''' file located in the same folder and add yourself as an object to the Admin group by using the 'user.*' syntax, where * would be your account name.

<syntaxhighlight lang="xml"> 
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="user.lil_Toady" />
<object name="resource.admin" />
</group>
</syntaxhighlight>

Now open your '''mtaserver.conf''' file and scroll to the bottom, make sure the admin resource is added to the ones that start with the server (note: protected="1" means that it can not be stopped).

<syntaxhighlight lang="conf"> <resource src="admin" startup="1" protected="0"> -- This is
<resource src="helpmanager" startup="1" protected="0">
<resource src="mapcycler" startup="1" protected="0">
<resource src="mapmanager" startup="1" protected="0">
</syntaxhighlight>

Now that you're done with server files, you can finally start it. Connect to the server itself and login with your account details: use 'login [username] <password>'. If it tells you to press 'p' you have done everything right, congratulations! If not, do this from the very beginning.
[[Category:Scripting Concepts]]

[[hu:Resource:Admin]]
[[it:Resource:Admin]]
[[ru:Resource:Admin]]

HU/Resource:Admin

2018-12-25T20:49:00Z

Surge:

{{Resource page}}
Egy gyors tutoriál arról, hogy hogyan kaphat admin jogokat és hogyan telepítheti az admin resource-t.

<section name="MTA 1.0.0 vagy régebbi" class="server" show="false">
'''Figyelem:''' 1.0.5 MTA óta az accounts.xml fájlok el lettek távolítva és sqlite-val lett kicserélve.

Először nyissa meg az '''accounts.xml''' fájlt, mely a '''server\mods\deathmatch\'''-en belül található, és adja hozzá a saját fiókjának részleteit, ahogy a következő példa is mutatja.

[[Image:admin_accounts.png]]
</section>

Egy fiók létrehozásához az '''MTA {{padleft:|3|{{Current Version|full}}}}'''-ban használja a következő parancsokat

'''Figyelem:''' Ehhez a művelethez a szervernek futnia kell
<syntaxhighlight lang="lua">
addaccount <username> <password>
</syntaxhighlight>

'''Figyelem:''' A szervernek nem szabad futnia, amíg az alábbi acl fájlt szerkeszti

Nyissa meg az '''acl.xml''' fájl, mely ugyanabban a mappában található, majd addja hozzá magát object-ként az Admin group-ba a 'user.*' szintaxis használatával, ahol a '*' a fiók nevét jelöli.

<syntaxhighlight lang="xml"> 
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="user.Someguy" />
<object name="resource.admin" />
</group>
</syntaxhighlight>

Most nyissa meg az '''mtaserver.conf''' fájlt és görgessen a legaljára, győződjön meg róla, hogy az admin resource hozzá van adva, hogy akkor induljon el, amikor a szerver (figyelem: protected="1" azt jelenti, hogy nem lehet megállítani).

<syntaxhighlight lang="conf"> <resource src="admin" startup="1" protected="0"> 
<resource src="helpmanager" startup="1" protected="0">
<resource src="mapcycler" startup="1" protected="0">
<resource src="mapmanager" startup="1" protected="0">
</syntaxhighlight>

Most, hogy végzett a szerver fájlokkal, végre elindíthatja. Csatlakozzon a szerverre és jelentkezzen be a fiók adataivel: használja a 'login [username] <password>'. Ha azt írja, hogy "press 'p' to opne admin panel", akkor mindent megfelelően csinált, gratulálok! Ha nem, akkor kezdje el újra a legelelejétől.
[[Category:Scripting Concepts]]

[[en:Resource:Admin]]
[[it:Resource:Admin]]
[[ru:Resource:Admin]]

==Fordította==
'''2018.12.25.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>