https://wiki.multitheftauto.com/api.php?action=feedcontributions&user=Lil+Toady&feedformat=atomMulti Theft Auto: Wiki - User contributions [en]2024-03-29T06:45:42ZUser contributionsMediaWiki 1.39.3https://wiki.multitheftauto.com/index.php?title=User:Lil_Toady&diff=39723User:Lil Toady2014-06-06T14:48:54Z<p>Lil Toady: </p>
<hr />
<div>{{MTA Developer}}<br />
<br />
===TODO:===<br />
* OOP tostring<br />
* Handle vectors in CLuaArgument<br />
* Optimize destroyElement<br />
* Release packets queue after function call<br />
* Enhance files and timers (gc)<br />
<br />
===OOP Metatable Structure===<br />
<syntaxhighlight lang="lua"><br />
-- Exposed to global environment<br />
Element = {<br />
create = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
create = createVehicle,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
-- Hidden in lua registry, applied to userdata<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__call = __class.create,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__call = __class.create,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight></div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=User:Lil_Toady&diff=39722User:Lil Toady2014-06-06T14:47:18Z<p>Lil Toady: </p>
<hr />
<div>{{MTA Developer}}<br />
<br />
===TODO:===<br />
* OOP tostring<br />
* Handle vectors in CLuaArgument<br />
* Optimize destroyElement<br />
* Release packets queue after function call<br />
* Enhance files and timers (gc)<br />
<br />
===OOP Metatable Structure===<br />
<syntaxhighlight lang="lua"><br />
-- Exposed to global environment<br />
Element = {<br />
create = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
create = createVehicle,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
-- Hidden in lua registry, applied to userdata<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__call = Element.create,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__call = Vehicle.create,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight></div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=User:Lil_Toady&diff=35692User:Lil Toady2013-05-03T19:50:18Z<p>Lil Toady: </p>
<hr />
<div>{{MTA Developer}}<br />
<br />
===TODO:===<br />
* OOP tostring<br />
* Handle vectors in CLuaArgument<br />
* Optimize destroyElement<br />
* Release packets queue after function call<br />
* Enhance files and timers (gc)<br />
<br />
===OOP Metatable Structure===<br />
<syntaxhighlight lang="lua"><br />
-- Exposed to global environment<br />
Element = {<br />
create = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
create = createVehicle,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
-- Hidden in lua registry, applied to userdata<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight></div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=User:Lil_Toady&diff=35618User:Lil Toady2013-04-28T16:03:48Z<p>Lil Toady: </p>
<hr />
<div>{{MTA Developer}}<br />
<br />
===TODO:===<br />
* OOP tostring<br />
* Handle vectors in CLuaArgument<br />
* Optimize destroyElement<br />
* Release packets queue after function call<br />
* Enhance timers (gc)<br />
<br />
===OOP Metatable Structure===<br />
<syntaxhighlight lang="lua"><br />
-- Exposed to global environment<br />
Element = {<br />
create = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
create = createVehicle,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
-- Hidden in lua registry, applied to userdata<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight></div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=User:Lil_Toady&diff=35600User:Lil Toady2013-04-27T22:21:58Z<p>Lil Toady: </p>
<hr />
<div>{{MTA Developer}}<br />
<br />
===TODO:===<br />
* OOP tostring<br />
* OOP vectors<br />
* Optimize destroyElement<br />
* Release packets queue after function call<br />
* Enhance timers (gc)<br />
<br />
===OOP Metatable Structure===<br />
<syntaxhighlight lang="lua"><br />
-- Exposed to global environment<br />
Element = {<br />
create = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
create = createVehicle,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
-- Hidden in lua registry, applied to userdata<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight></div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=User:Lil_Toady&diff=35586User:Lil Toady2013-04-26T19:59:01Z<p>Lil Toady: </p>
<hr />
<div>{{MTA Developer}}<br />
<br />
===TODO:===<br />
* OOP tostring<br />
* OOP vectors<br />
* Optimize destroyElement<br />
* Release packets queue after function call<br />
<br />
===OOP Metatable Structure===<br />
<syntaxhighlight lang="lua"><br />
-- Exposed to global environment<br />
Element = {<br />
create = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
create = createVehicle,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
-- Hidden in lua registry, applied to userdata<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight></div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=User:Lil_Toady&diff=35585User:Lil Toady2013-04-26T19:55:22Z<p>Lil Toady: </p>
<hr />
<div>{{MTA Developer}}<br />
<br />
===TODO:===<br />
* OOP tostring<br />
* OOP vectors<br />
* Optimize destroyElement<br />
* Release packets queue after function call<br />
<br />
===OOP Metatable Structure===<br />
<syntaxhighlight lang="lua"><br />
Element = {<br />
create = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
create = createVehicle,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight></div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=User:Lil_Toady&diff=35584User:Lil Toady2013-04-26T19:54:35Z<p>Lil Toady: </p>
<hr />
<div>{{MTA Developer}}<br />
<br />
===TODO:===<br />
* OOP tostring<br />
* OOP vectors<br />
* Optimize destroyElement<br />
* Release packets queue after function call<br />
<br />
===OOP Metatable Structure===<br />
<syntaxhighlight lang="lua"><br />
Element = {<br />
create = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
create = createElement,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight></div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=User:Lil_Toady&diff=35583User:Lil Toady2013-04-26T19:52:53Z<p>Lil Toady: /* OOP Metatable Structure: */</p>
<hr />
<div>{{MTA Developer}}<br />
<br />
===TODO:===<br />
* OOP tostring<br />
* OOP vectors<br />
* Optimize destroyElement<br />
* Release packets queue after function call<br />
<br />
===OOP Metatable Structure:===<br />
<syntaxhighlight lang="lua"><br />
Element = {<br />
create = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
create = createElement,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight></div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=User:Lil_Toady&diff=35582User:Lil Toady2013-04-26T19:51:57Z<p>Lil Toady: </p>
<hr />
<div>{{MTA Developer}}<br />
<br />
===TODO:===<br />
* OOP tostring<br />
* OOP vectors<br />
* Optimize destroyElement<br />
* Release packets queue after function call<br />
<br />
===OOP Metatable Structure:===<br />
<br />
Element = {<br />
create = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
create = createElement,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=User:Woovie&diff=35574User:Woovie2013-04-25T23:05:36Z<p>Lil Toady: Undo revision 35572 by Lil Toady (talk)</p>
<hr />
<div>{{MTA Developer}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=User:Woovie&diff=35572User:Woovie2013-04-25T23:02:20Z<p>Lil Toady: </p>
<hr />
<div>Penis</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=CreateTextItem&diff=35570CreateTextItem2013-04-25T22:58:32Z<p>Lil Toady: </p>
<hr />
<div><pageclass class="#228B22" subcaption="Useful Function"></pageclass><br />
<lowercasetitle/><br />
<br />
__NOTOC__<br />
{{Useful Function}}<br />
'''With this function you can create any text you want with any size color visible to who you want and this function server side only!'''<br />
<br /><br /><br />
<br />
<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua"><br />
bool CreateTextItem ( player playerToAdd , time, int red = 255, int green = 255, int blue = 255, float scale = 1, string text, [ float x, float y, string alignX = "left", string alignY = "top"] )<br />
</syntaxhighlight><br />
<br />
===Required Arguments===<br />
<br />
* '''playerToAdd: The player that should observe the textdisplay.'''<br />
* '''time: The number of times you want to the remove The textdisplay ,number of milliseconds (the minimum is 50)(1000 milliseconds = 1 second)'''<br />
* '''red: A value between 0 and 255 indicating how red the text should be.'''<br />
* '''green: A value between 0 and 255 indicating how green the text should be.'''<br />
* '''blue: A value between 0 and 255 indicating how blue the text should be.'''<br />
* '''scale: A floating point value indicating the scale of the text. The default is 1.0, which is around 12pt.'''<br />
* '''text: A string of text you want to display'''<br />
<br />
<br />
<br />
===Optional Arguments===<br />
<br />
* x: A floating point number between 0.0 and 1.0 indicating how far across the screen the text should be shown, as a percentage of the width, from the left hand side.<br />
* y: A floating point number between 0.0 and 1.0 indicating how far down the screen the text should be shown, as a percentage of the height, from the top.<br />
* scale: A floating point value indicating the scale of the text. The default is 1.0, which is around 12pt.<br />
* alignX: A string representing the X-alignment of the text. ("left", "center", "right")<br />
* alignY: A string representing the Y-alignment of the text. ("top", "center", "bottom")<br />
<br />
<br />
===Important Note===<br />
* '''You can't use ''''getRootElement()'''' element you will get some errors you have to use getElementsByType to get All Players!'''<br />
<br />
<br />
==Code==<br />
<section name="Function source" class="server" show="true"><syntaxhighlight lang="lua"><br />
function CreateTextItem ( player, time, r, g, b, scale, text, x, y, alignX, alignY)<br />
if not player or not time or not text then return end<br />
if not tonumber(r) and not tonumber(g) and not tonumber(b) then r, g, b = 255, 0, 0 end<br />
if not scale then scale = 1 end<br />
if ( isElement( player ) and type ( text ) == 'string' and tonumber( time) ) then<br />
local Display = textCreateDisplay ()<br />
local newtextItem = textCreateTextItem ( text, x or 0.5, y or 0.5, 2, r, g, b, 255, scale, alignX or "center", alignY or "center" )<br />
textDisplayAddText ( Display, newtextItem )<br />
textDisplayAddObserver ( Display, player )<br />
setTimer(textDestroyTextItem, time, 1, newtextItem)<br />
setTimer(textDestroyDisplay, time, 1, Display)<br />
end <br />
end<br />
</syntaxhighlight></section><br />
<br />
==Example==<br />
<section name="Server Example" class="server" show="true"><br />
This Example creates a text item. A text item represents a single area of text, much like a label !<br />
<syntaxhighlight lang="lua"><br />
addCommandHandler("Create",<br />
function ( element , cmd , item ) <br />
local Text = tostring ( item )<br />
if ( Text ) then<br />
CreateTextItem ( element, 5000, 255, 255, 0, 5,Text )<br />
end<br />
end<br />
)</syntaxhighlight><br />
</section><br />
<br />
==Example==<br />
<section name="Server Full Example" class="server" show="true"><br />
This Example creates a text item. A text item represents a single area of text, much like a label !<br />
<syntaxhighlight lang="lua"><br />
function CreateTextItem ( player, time, r, g, b, scale, text, x, y, alignX, alignY)<br />
if not player or not time or not text then return end<br />
if not r and not g and not b then r, g, b = 255, 0, 0 end<br />
if not scale then scale = 1 end<br />
if ( isElement( player ) and type ( text ) == 'string' and tonumber( time) ) then<br />
local Display = textCreateDisplay ()<br />
local newtextItem = textCreateTextItem ( text, x or 0.5, y or 0.5, 2, r, g, b, 255, scale, alignX or "center", alignY or "center" )<br />
textDisplayAddText ( Display, newtextItem )<br />
textDisplayAddObserver ( Display, player )<br />
setTimer(textDestroyTextItem, time, 1, newtextItem)<br />
setTimer(textDestroyDisplay, time, 1, Display)<br />
end <br />
end<br />
<br />
addCommandHandler("Test",<br />
function ( ) <br />
for _,v in ipairs ( getElementsByType("player") ) do<br />
CreateTextItem ( v, 5000, 255, 255, 0, 5,"Test Text" )<br />
end<br />
end<br />
)<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Useful_Functions}}<br />
<br />
[[Category:Useful Functions]]</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=User:Lil_Toady&diff=35568User:Lil Toady2013-04-25T22:54:53Z<p>Lil Toady: </p>
<hr />
<div>{{MTA Developer}}<br />
<br />
===TODO:===<br />
* OOP tostring<br />
* OOP vectors<br />
* Optimize destroyElement<br />
* Release packets queue after function call</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=Press_Coverage&diff=28697Press Coverage2011-12-18T21:46:18Z<p>Lil Toady: </p>
<hr />
<div>The folowing is a list of press coverage during MTA's history, it may not be full and only contains the sources we are aware of.<br />
<br />
=Written press=<br />
<br />
* Power Unlimited | March 2003 - [http://files.mtasa.com/media/Power_Unlimited-2003_Mar.jpg Page 1], [http://files.mtasa.com/media/Power_Unlimited-2003_Mar-Translation.txt Translation]<br />
* PC Gamer | May 2003 - [http://files.mtasa.com/media/PC_Gamer-2003_May.jpg Page 1]<br />
* Hyper | September 2003 - [http://files.mtasa.com/media/Hyper-2003_Sep-AU.jpg Page 1], [http://files.mtasa.com/media/Hyper-2003_Sep-AU-Translation.txt Translation]<br />
* Igromania | September 2003 [http://files.mtasa.com/media/Igromania-2003_Sep_1-RU.jpg Page 1], [http://files.mtasa.com/media/Igromania-2003_Sep_2-RU.jpg Page 2], [http://files.mtasa.com/media/Igromania-2003_Sep-RU-Translation.txt Translation], [http://www.igromania.ru/articles/46216/Multi_Theft_Auto_Setevoi_bespredel_Osnovy_igry_v_GTA_3_po_ceti_i_cherez_internet.htm On-line copy]<br />
* Computer Games | October 2003 - [http://files.mtasa.com/media/Computer_Games-2003_Oct.jpg Page 1]<br />
* PC Gameplay | December 2003 - [http://files.mtasa.com/media/PC_Gameplay-2003_Dec.jpg Page 1], [http://files.mtasa.com/media/PC_Gameplay-2003_Dec-Translation.txt Translation]<br />
* PC Gamer | April 2004 - [http://files.mtasa.com/media/PC_Gamer-2004_Apr.jpg Page 1]<br />
* GamePro | June 2005 - [http://files.mtasa.com/media/GamePro_June_2005_4.jpg Page 1]<br />
* PC Zone | March 2006 - [http://files.mtasa.com/media/PCZone_March_2006.jpg Page 1]<br />
* Igromania | April 2006<br />
* GameStar | January 2008 - [http://files.mtasa.com/media/GameStar-Jan_2008-DE.jpg Page 1]<br />
* Total PC Gaming | Issue 26, October 2009 - [http://files.mtasa.com/media/TPCG_Issue_26.pdf Page 1] (preprint) (included on DVD)<br />
<br />
=TV=<br />
<br />
* G4TV.com | [http://www.youtube.com/watch?v=B6FqSiJBMgM Multi Theft Auto @ G4TV.com @ YouTube] | October 10 2003<br />
<br />
=Internet=<br />
<br />
While MTA has been mentioned and reviewed in a lot of articles, and here is a list of those which were recorded. It is worth noting that this list is very incomplete.<br />
<br />
* MegaGames | [http://www.megagames.com/news/multiplayer-killing-spree-vc?tab=description Multiplayer Killing Spree in VC] | April 04 2003<br />
<br />
* IGN | [http://pc.ign.com/articles/519/519510p2.html True Crime - Streets of L.A. review] | May 27 2004<br />
<br />
''The on-foot combat modes, Dojo Master and Battle Master, feel more like minigames than full-fledged modes. Dojo Master, the melee mode, has exactly one round. You knock the guy out and boom, the round ends and you're kicked to a summary screen. And the camera was just plain not right, seemingly unable to properly pull back and frame the scene. I had to move myself out of the way of the camera many times so I could see what was going on. Battle Master, also known as "last man standing," is also exactly one round, with very small maps and only one life per player. '''All in all, multiplayer doesn't rise to the level of something I'd recommend over, say, Multi-Theft Auto'''.''<br />
<br />
* IGN | [http://pc.ign.com/articles/605/605982p1.html GTA San Andreas PC Hands-On] | April 19 2005<br />
<br />
''Other than that, there won't be any new content--no new vehicles, weapons, missions, et cetera. '''Nor will Rockstar add any multiplayer, but I think it's safe to expect another Multi-Theft Auto from the MTA Team not too long after release'''.''<br />
<br />
* Gamespy [http://xbox360.gamespy.com/xbox-360/saints-row/718937p1.html Saints Row preview] | August 29 2006<br />
<br />
''In spite of its popularity among console owners, it is PC gamers who've reaped the most benefits from the Grand Theft Auto series. '''Besides the numerous skins and tweaks available, one of the most infamous mods for GTA is the one known as Multi Theft Auto'''. The modification allows players to get online and battle against other players for dominance. '''The idea has extended to other sandbox-style games, but like their single-player counterparts, the MTA cloning worked about as well as the GTA cloning.''' That is, no one's really come close to emulating it. Anyone involved in Saints Row who says that GTA had no influence on their title probably also has some beachfront property in Omaha to sell you.<br />
<br />
With that out of the way, THQ sponsored an event in San Francisco to preview the multiplayer portion of Volition's next-gen title. We didn't go near the single-player portion of the game, instead opting to stay on the designated path of system link gameplay to see how Saints Row performs. '''What we saw was the concept of what would be known as another GTA clone extended to its next logical point on the 360: cloning Multi Theft Auto.'''''<br />
<br />
* OSDir.com | [http://osdir.com/Article4775.phtml Multi Theft Auto: Hacking Multi-Player Into Grand Theft Auto With Open Source] | March 29 2005<br />
<br />
OSDir.com did an interview with four of MTA's developers about the open source software they use in the process of creating MTA.<br />
<br />
* Fileplanet | [http://files.mtasa.com/media/FilePlanet-Mar_2006.jpg Frontpage] | March 16 2006<br />
<br />
MTA was covered for several days on the Fileplanet frontpage after the initial MTA:SA release.<br />
<br />
* Global Gaming | [http://www.ggl.com/?controller=News&id=2982&method=article Homebrews: Multi-Theft Auto] | May 5 2006<br />
<br />
* Mega Games | [http://www.megagames.com/news/multi-theft-auto-san-andreas Multi Theft Auto - San Andreas] | February 6 2006<br />
<br />
* Neowin | [http://www.neowin.net/index.php?act=view&id=32142 Multi Theft Auto: San Andreas Released] | January 24 2006<br />
<br />
* Games Galore | [http://games.techwhack.com/54/multi-theft-auto/ Multi Theft Auto] | September 4 2006<br />
<br />
* GameSpot | [http://www.gamespot.com/pages/unions/read_article.php?topic_id=24250612&union_id=338 MTA: San Andreas Is Here!!!] | January 24 2006<br />
<br />
* Slashdot | [http://games.slashdot.org/article.pl?sid=08%2F11%2F24%2F0237259& Multi Theft Auto - San Andreas Goes Open Source] | November 24 2008<br />
<br />
* Linux Magazine | [http://www.linux-magazine.com/Online/News/Open-Source-Mod-for-Grand-Theft-Auto Open-Source Mod for Grand Theft Auto] | November 24 2008<br />
<br />
* GamingBolt | [http://gamingbolt.com/15-modders-who-changed-pc-gaming 15 Modders who changed PC gaming] | March 20 2010<br />
<br />
The MTA Team were labelled as one of 15 modders who changed PC gaming, turning Grand Theft Auto San Andreas into ''"into the one truly decent, fully functioning multiplayer segment to a great game"''.<br />
<br />
* PCGames.de | [http://www.pcgames.de/Bestenlisten-Thema-203022/Bilder/Die-Top-10-der-einflussreichsten-Modder-Diese-Mods-haben-die-Branche-aufgemischt-744688/galerie/1274990/ Die Top 10 der einflussreichsten Modder (Top 10 Most Influential Modders) ] | April 9 2010<br />
<br />
The MTA Team were classed as one of the Top 10 most influential modders of all time.<br />
<br />
* usercreated | [http://usercreated.org/2010/04/12/unmissable-mods-month-multi-theft-auto/ Unmissable Mods Month: Multi Theft Auto ] | April 12 2010<br />
<br />
Multi Theft Auto was characterized as an "''Unmissable mod''" that was "''an incredibly elegant way of forcing multiplayer onto an engine that was never designed for it in the first place''".<br />
<br />
* 1UP.com | [http://www.1up.com/do/reviewPage?pager.offset=1&cId=3180268&p=2 APB Review] | July 6 2010<br />
Multi Theft Auto distinguished as a ''"cheaper, better multiplayer PC [game]"'' to All Points Bulletin, a commercial RPG.<br />
<br />
* FilePlanet Blog | [http://blog.fileplanet.com/2011/08/29/monday-mod-multi-theft-auto-san-andreas/ Monday Mod: Multi Theft Auto: San Andreas] | August 29 2011<br />
Multi Theft Auto was praised for the ''"[the charm] from the user generated content all thanks to the Multi Theft Auto toolkit"''</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=Press_Coverage&diff=28696Press Coverage2011-12-18T21:45:46Z<p>Lil Toady: </p>
<hr />
<div>The folowing is a list of press coverage during MTA's history.<br />
<br />
=Written press=<br />
<br />
* Power Unlimited | March 2003 - [http://files.mtasa.com/media/Power_Unlimited-2003_Mar.jpg Page 1], [http://files.mtasa.com/media/Power_Unlimited-2003_Mar-Translation.txt Translation]<br />
* PC Gamer | May 2003 - [http://files.mtasa.com/media/PC_Gamer-2003_May.jpg Page 1]<br />
* Hyper | September 2003 - [http://files.mtasa.com/media/Hyper-2003_Sep-AU.jpg Page 1], [http://files.mtasa.com/media/Hyper-2003_Sep-AU-Translation.txt Translation]<br />
* Igromania | September 2003 [http://files.mtasa.com/media/Igromania-2003_Sep_1-RU.jpg Page 1], [http://files.mtasa.com/media/Igromania-2003_Sep_2-RU.jpg Page 2], [http://files.mtasa.com/media/Igromania-2003_Sep-RU-Translation.txt Translation], [http://www.igromania.ru/articles/46216/Multi_Theft_Auto_Setevoi_bespredel_Osnovy_igry_v_GTA_3_po_ceti_i_cherez_internet.htm On-line copy]<br />
* Computer Games | October 2003 - [http://files.mtasa.com/media/Computer_Games-2003_Oct.jpg Page 1]<br />
* PC Gameplay | December 2003 - [http://files.mtasa.com/media/PC_Gameplay-2003_Dec.jpg Page 1], [http://files.mtasa.com/media/PC_Gameplay-2003_Dec-Translation.txt Translation]<br />
* PC Gamer | April 2004 - [http://files.mtasa.com/media/PC_Gamer-2004_Apr.jpg Page 1]<br />
* GamePro | June 2005 - [http://files.mtasa.com/media/GamePro_June_2005_4.jpg Page 1]<br />
* PC Zone | March 2006 - [http://files.mtasa.com/media/PCZone_March_2006.jpg Page 1]<br />
* Igromania | April 2006<br />
* GameStar | January 2008 - [http://files.mtasa.com/media/GameStar-Jan_2008-DE.jpg Page 1]<br />
* Total PC Gaming | Issue 26, October 2009 - [http://files.mtasa.com/media/TPCG_Issue_26.pdf Page 1] (preprint) (included on DVD)<br />
<br />
=TV=<br />
<br />
* G4TV.com | [http://www.youtube.com/watch?v=B6FqSiJBMgM Multi Theft Auto @ G4TV.com @ YouTube] | October 10 2003<br />
<br />
=Internet=<br />
<br />
While MTA has been mentioned and reviewed in a lot of articles, and here is a list of those which were recorded. It is worth noting that this list is very incomplete.<br />
<br />
* MegaGames | [http://www.megagames.com/news/multiplayer-killing-spree-vc?tab=description Multiplayer Killing Spree in VC] | April 04 2003<br />
<br />
* IGN | [http://pc.ign.com/articles/519/519510p2.html True Crime - Streets of L.A. review] | May 27 2004<br />
<br />
''The on-foot combat modes, Dojo Master and Battle Master, feel more like minigames than full-fledged modes. Dojo Master, the melee mode, has exactly one round. You knock the guy out and boom, the round ends and you're kicked to a summary screen. And the camera was just plain not right, seemingly unable to properly pull back and frame the scene. I had to move myself out of the way of the camera many times so I could see what was going on. Battle Master, also known as "last man standing," is also exactly one round, with very small maps and only one life per player. '''All in all, multiplayer doesn't rise to the level of something I'd recommend over, say, Multi-Theft Auto'''.''<br />
<br />
* IGN | [http://pc.ign.com/articles/605/605982p1.html GTA San Andreas PC Hands-On] | April 19 2005<br />
<br />
''Other than that, there won't be any new content--no new vehicles, weapons, missions, et cetera. '''Nor will Rockstar add any multiplayer, but I think it's safe to expect another Multi-Theft Auto from the MTA Team not too long after release'''.''<br />
<br />
* Gamespy [http://xbox360.gamespy.com/xbox-360/saints-row/718937p1.html Saints Row preview] | August 29 2006<br />
<br />
''In spite of its popularity among console owners, it is PC gamers who've reaped the most benefits from the Grand Theft Auto series. '''Besides the numerous skins and tweaks available, one of the most infamous mods for GTA is the one known as Multi Theft Auto'''. The modification allows players to get online and battle against other players for dominance. '''The idea has extended to other sandbox-style games, but like their single-player counterparts, the MTA cloning worked about as well as the GTA cloning.''' That is, no one's really come close to emulating it. Anyone involved in Saints Row who says that GTA had no influence on their title probably also has some beachfront property in Omaha to sell you.<br />
<br />
With that out of the way, THQ sponsored an event in San Francisco to preview the multiplayer portion of Volition's next-gen title. We didn't go near the single-player portion of the game, instead opting to stay on the designated path of system link gameplay to see how Saints Row performs. '''What we saw was the concept of what would be known as another GTA clone extended to its next logical point on the 360: cloning Multi Theft Auto.'''''<br />
<br />
* OSDir.com | [http://osdir.com/Article4775.phtml Multi Theft Auto: Hacking Multi-Player Into Grand Theft Auto With Open Source] | March 29 2005<br />
<br />
OSDir.com did an interview with four of MTA's developers about the open source software they use in the process of creating MTA.<br />
<br />
* Fileplanet | [http://files.mtasa.com/media/FilePlanet-Mar_2006.jpg Frontpage] | March 16 2006<br />
<br />
MTA was covered for several days on the Fileplanet frontpage after the initial MTA:SA release.<br />
<br />
* Global Gaming | [http://www.ggl.com/?controller=News&id=2982&method=article Homebrews: Multi-Theft Auto] | May 5 2006<br />
<br />
* Mega Games | [http://www.megagames.com/news/multi-theft-auto-san-andreas Multi Theft Auto - San Andreas] | February 6 2006<br />
<br />
* Neowin | [http://www.neowin.net/index.php?act=view&id=32142 Multi Theft Auto: San Andreas Released] | January 24 2006<br />
<br />
* Games Galore | [http://games.techwhack.com/54/multi-theft-auto/ Multi Theft Auto] | September 4 2006<br />
<br />
* GameSpot | [http://www.gamespot.com/pages/unions/read_article.php?topic_id=24250612&union_id=338 MTA: San Andreas Is Here!!!] | January 24 2006<br />
<br />
* Slashdot | [http://games.slashdot.org/article.pl?sid=08%2F11%2F24%2F0237259& Multi Theft Auto - San Andreas Goes Open Source] | November 24 2008<br />
<br />
* Linux Magazine | [http://www.linux-magazine.com/Online/News/Open-Source-Mod-for-Grand-Theft-Auto Open-Source Mod for Grand Theft Auto] | November 24 2008<br />
<br />
* GamingBolt | [http://gamingbolt.com/15-modders-who-changed-pc-gaming 15 Modders who changed PC gaming] | March 20 2010<br />
<br />
The MTA Team were labelled as one of 15 modders who changed PC gaming, turning Grand Theft Auto San Andreas into ''"into the one truly decent, fully functioning multiplayer segment to a great game"''.<br />
<br />
* PCGames.de | [http://www.pcgames.de/Bestenlisten-Thema-203022/Bilder/Die-Top-10-der-einflussreichsten-Modder-Diese-Mods-haben-die-Branche-aufgemischt-744688/galerie/1274990/ Die Top 10 der einflussreichsten Modder (Top 10 Most Influential Modders) ] | April 9 2010<br />
<br />
The MTA Team were classed as one of the Top 10 most influential modders of all time.<br />
<br />
* usercreated | [http://usercreated.org/2010/04/12/unmissable-mods-month-multi-theft-auto/ Unmissable Mods Month: Multi Theft Auto ] | April 12 2010<br />
<br />
Multi Theft Auto was characterized as an "''Unmissable mod''" that was "''an incredibly elegant way of forcing multiplayer onto an engine that was never designed for it in the first place''".<br />
<br />
* 1UP.com | [http://www.1up.com/do/reviewPage?pager.offset=1&cId=3180268&p=2 APB Review] | July 6 2010<br />
Multi Theft Auto distinguished as a ''"cheaper, better multiplayer PC [game]"'' to All Points Bulletin, a commercial RPG.<br />
<br />
* FilePlanet Blog | [http://blog.fileplanet.com/2011/08/29/monday-mod-multi-theft-auto-san-andreas/ Monday Mod: Multi Theft Auto: San Andreas] | August 29 2011<br />
Multi Theft Auto was praised for the ''"[the charm] from the user generated content all thanks to the Multi Theft Auto toolkit"''</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=AntiCheat_Codes&diff=27281AntiCheat Codes2011-10-02T13:25:59Z<p>Lil Toady: </p>
<hr />
<div>*AC #1 - Trainer<br />
**Classic health/amour hack detector<br />
***False positive note: Has triggered FP in the past. Should not FP in 1.0.5<br />
*AC #2 - Not used<br />
*AC #3 - Not used<br />
*AC #4 - Trainer<br />
**Detects presence of trainer.<br />
***Capital letters in the message are for tagging particular trainers<br />
*AC #5 - Trainer<br />
**Detects use of trainer. <br />
*VF #6 - Trainer<br />
**Detects use of trainer<br />
***player movement<br />
***health/damage<br />
***weapons<br />
***money<br />
***gamespeed<br />
***game cheats<br />
**aimbot <br />
*AC #7 - Not yet<br />
*VF #8 - Misc<br />
**Detects unauthorized mods.<br />
***Capital letters in the message are for tagging particular items e.g.<br />
****CLEO - Cleo detected<br />
****RENDER - Wall hack detected<br />
*AC #11 - More trainers<br />
*VF #11 - Dll injector / Trainer<br />
<br><br />
----<br />
====Acronyms==== <br />
*AC = Anti cheat<br />
*VF = Verify fail<br />
<br><br />
----<br />
====False positives====<br />
With the current release there should be no false positives.<br />
If you know of any, please tell us.</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=Server_Manual&diff=25544Server Manual2011-04-16T16:36:45Z<p>Lil Toady: /* Client Checks */</p>
<hr />
<div>__TOC__<br />
<br />
==Getting started==<br />
It is much easier than it looks to get a server up and running for your internet or LAN buddies; follow this wiki article and you will hopefully be on your way to hosting your own MTA:SA server in no time!<br />
<br />
==Installing the server==<br />
The dedicated server application is available in different flavours depending on the platform of the server.<br />
<br />
===Linux installation===<br />
There are different ways of getting a Linux server up and running:<br />
* [[Building MTASA Server on GNU Linux]]<br />
* [http://linux.mtasa.com Getting a precompiled package]<br />
<br />
===Windows installation===<br />
Installation of the MTA:SA server on Windows is easy as pie.<br />
*Go to the [http://mtasa.com/ download page] and download the installer.<br />
*Once the installer is downloaded, open it.<br />
*Select a folder where you want to install the server.<br />
*Click Install.<br />
*Done!<br />
<br />
''For a full explanation of acl.xml (access control list) read: [[Access_Control_List|Access Control List]]''<br/><br/><br />
<br />
==Configuring your server==<br />
The Multi Theft Auto dedicated server is initially configurable through it's console window, from within the game, and from a webbrowser. In order to make use of the two last options, it is necessary to add at least one administrator user to your configuration file.<br />
<br />
===General configuration===<br />
All general configuration options can be found in the 'mods/deathmatch/'''mtaserver.conf'''' file and can be opened by any regular text editor.<br />
<br />
This file is fairly straightforward; every variable has a description of what to do with it and how to change it.<br />
<br />
===Port forwarding===<br />
If you run your server on your own private computer, and you have an router between the internet and your computer. You need to forward 3 ports.<br />
<br />
First of all open the file 'mods/deathmatch/'''mtaserver.conf'''' and search for the next lines:<br />
<syntaxhighlight lang="xml"><br />
<serverport>22004</serverport> <br />
<httpport>22005</httpport><br />
</syntaxhighlight><br />
<br />
The ports are needed to setup the server correctly. We explain later how to set them, but first if you want your server to appear in the server browser there is another port we need, and that is the ASE port. <br />
(quick example for how to turn ASE on or off):<br />
<syntaxhighlight lang="xml"><br />
<ase>1</ase> <!-- 0 = off, 1 = on --><br />
</syntaxhighlight><br />
<br />
Now we going to forward the ports in your router, which is not needed if you already have all ports open, or if you don't have a router with a firewall. If so, skip this part.<br />
<br />
If you don't know how port forwarding works in your router, go to the [http://portforward.com/ Port Forward website], find your router model there, and follow the instructions there.<br />
<br />
In almost every router you can set the port type: UDP or TCP. The following list will explain which port type is needed for what:<br />
<br />
<br />
Main server port: UDP<br />
<br />
HTTP Port: TCP<br />
<br />
ASE Port: UDP (this is needed if you want your server to appear in the server list)<br />
<br />
<br />
The ASE port is also simple to get:<br />
<br />
ASE port = Main server port + 123<br />
<br />
So, if you have the main server port set to 22003, then the ASE port will be 22126.<br />
<br />
Good luck!<br />
<br />
''In the latest version of the server, you can check the port status by using the server command ''''openports''''.''<br />
<br />
===Client Checks===<br />
<br />
The MTA server can be configured to disable the anti-cheat. It can also allow specific or all files to be modified (e.g. handling.cfg), and make sure clients are of a minimum version.<br />
<br />
All of these settings are within the file 'mods/deathmatch/'''mtaserver.conf''''.<br />
<br />
<br />
If you want to turn off the anti-cheat, search for the following line:<br />
<syntaxhighlight lang="xml"><br />
<disableac></disableac></syntaxhighlight><br />
MTA has multiple, different anti-cheats which can be disabled, and as such the disableac setting is a comma separated setting. To disable anti-cheat #2, use: 2. To disable #2 and #3, use: 2,3. ([[AntiCheat_Codes]])<br />
<br />
<br />
If you want to force a minimum client version, search for the following line:<br />
<syntaxhighlight lang="xml"><br />
<minclientversion></minclientversion><br />
</syntaxhighlight><br />
Accepted values look like: 1.0.4-9.01746.0. Paired together with verifyclientsettings, a value of 1.0.3-9.00000.0 will make sure that clients are new enough for the file check.<br />
<br />
<br />
If you want to specify which modified files are disallowed, search for the following line:<br />
<syntaxhighlight lang="xml"><br />
<verifyclientsettings>-1</verifyclientsettings></syntaxhighlight><br />
The value of this setting can be -1 (default), 0 (off), or the addition of the file flags in the table below. (e.g. to block just melee.dat and weapons.dat, you would add 16 and 1048576)<br />
<br />
{| class="TablePager" style="min-width: 0%;"<br />
|-<br />
!Flag<br />
!Description<br />
|-<br />
|1<br />
|Verify "data/carmods.dat"<br />
|-<br />
|4<br />
|Verify "data/handling.cfg"<br />
|-<br />
|16<br />
|Verify "data/melee.dat"<br />
|-<br />
|64<br />
|Verify "data/object.dat"<br />
|-<br />
|256<br />
|Verify "data/surface.dat"<br />
|-<br />
|1024<br />
|Verify "data/surfaud.dat"<br />
|-<br />
|4096<br />
|Verify "data/surfinfo.dat"<br />
|-<br />
|16384<br />
|Verify "data/vehicles.ide"<br />
|-<br />
|65536<br />
|Verify "data/water.dat"<br />
|-<br />
|262144<br />
|Verify "data/water1.dat"<br />
|-<br />
|1048576<br />
|Verify "data/weapon.dat"<br />
|-<br />
|4194304<br />
|Verify "anim/ped.ifp" & check above filenames (1.0.4 and above)<br />
|}<br />
<br />
===Adding administrators===<br />
It is strongly recommended to add at least one administrator to your server in order to make use of the built-in webserver to easily maintain and configure your server. This administrator will then also be able to log-in from within the game and control the server.<br />
<br />
To add an administrator to your server, follow these steps:<br><br />
<ol><br />
<li>While the server is running, add a new account by typing '''addaccount name password''' into the server window. For example, to add user BennyLava you could type:<br />
<div style="margin: 10px 10px 10px 10px;"><br />
<syntaxhighlight lang="xml"><br />
addaccount BennyLava 123password<br />
</syntaxhighlight><br />
</div><br />
<div style="margin: 10px 10px 10px 20px;"><br />
''Note: If you do not have access to the server window, and the 'admin' resource is running, you can add the example account by issuing the chatbox command '''/register BennyLava 123password'''''<br />
</div><br />
<li>The server should display a message confirming the account has been added.<br />
<li>Next, shutdown the server by typing '''shutdown''' into the server window.<br />
<li>Make sure your server is stopped; if your server is still running, the following changes you make will be overwritten</li><br />
<li>Open the file 'mods/deathmatch/'acl.xml'''' with any text editor</li><br />
<li>Add the account to the ''Admin'' group by using the XML-syntax below<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<ACL><br />
...<br />
<group name="Admin"><br />
<acl name="Admin"/><br />
...<br />
<object name="user.BennyLava" /><br />
</group><br />
...<br />
</ACL><br />
</syntaxhighlight><br />
</div><br />
<br />
You can actually add your user to any group you want. Each group is linked to an ACL ([[Access Control List]]). Each ACL contains a series of specific allowed or denied rights. These groups exist so different users can be assigned different rights. The ''Admin'' group points to the ''Admin'' ACL, which is empty (thus allowing all possible commands). The ''Everyone'' group points to the ''Default'' ACL that puts a series of restrictions on the available commands (to disallow regular players from using admin commands).<br />
</li><br />
<li><br />
You're done! You can add as many administrators or users as you want this way, take a look at some of the other groups and ACLs for example. The ACL is also accessible through the [[Access_Control_List|Lua scripting engine]].<br><br />
<br />
It is recommended to take a look at the web interface, we will explain how to do this below.<br />
</li><br />
</ol><br />
'''Note''': There are also ways to add accounts and edit rights for the server while it's running. "addaccount <user> <password>" is an internal command to add accounts, but you will have to use the web interface to add these accounts to specific groups/ACLs!<br /><br />
<br />
===Using the web interface===<br />
The dedicated server comes with a few Lua [[resources]] that provide a nice little web interface to your server. This can be used to easily maintain your server, as it allows you to add users, start/stop resources, and more.<br />
<br />
The web interface resources are enabled by default and are served through the built-in HTTP web server. To make sure the built-in HTTP web server runs on a port you like (22005 by default), follow these steps:<br />
<ol><br />
<li>Make sure your server is stopped<br />
<li>Open the file '''mods/deathmatch/mtaserver.conf''' with any text editor</li><br />
<li>Verify that the HTTP server is enabled:<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<httpserver>1</httpserver><br />
</syntaxhighlight><br />
</div><br />
</li><br />
<li>Change the HTTP server port to your liking:<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<httpport>22005</httpport><br />
</syntaxhighlight><br />
</div><br />
</li><br />
<li>Save and close the configuration file</li><br />
<li>Start your server</li><br />
<li>If you happened to have changed the start-up resources in your configuration file, make sure the following resources are started:<br />
<br />
# resourcebrowser<br />
# resourcemanager<br />
# webadmin<br />
# webmap<br />
<br />
These are automatically started in the default configuration file, in case you just installed your server.<br />
</li><br />
<li>Open a web browser (Internet Explorer 6 or 7 are NOT supported; use [http://www.mozilla.com/firefox Mozilla Firefox], [http://www.google.com/chrome Google Chrome], [http://www.apple.com/safari/download Apple Safari], [http://www.opera.com Opera] or others) and navigate to the HTTP server URL: '''http://server:port/'''. For example, If you are running a local server on HTTP port 22005, use '''http://127.0.0.1:22005/'''.</li><br />
<li>Enter the username and password of the administrator you added in the previous section.</li><br />
</ol><br />
<br />
<br /><br />
You should now be able to maintain your server from the web interface.<br />
<br />
=== Configuring an external web server ===<br />
The built-in web server is also used to serve files that are required by resources running on your server to any player that is connected to your server. For example, if you are running a game script with a scripted graphical user interface, or custom models, these need to be transferred to every connected player in order to function properly. This is done by either the built-in web server, or an external web server (that is usually a bit faster) but needs to be set up separately.<br />
<br />
For performance or consistency reasons during the game, you could choose to make use of such an external web server if you have one set up. The external web server needs to be accessible for the public, so any client will be able to download the necessary client-side files in order to join and play on your server.<br />
<br />
To enable downloading off an external web server, you should configure the ''httpdownload'' and ''httpdownloadurl'' tags in your server configuration:<br />
<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload> <br />
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl><br />
</syntaxhighlight></div><br />
<br />
Since all the default resources provided with the dedicated server are zipped, and are normally automatically extracted by the built-in web server, you now have to provide a way for the clients to download the compressed files to their computers. To configure MTA to maintain a copy of only your unzipped client resources, set ''httpautoclientfiles'' in your server configuration: <br />
<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><httpautoclientfiles>1</httpautoclientfiles><br />
</syntaxhighlight></div><br />
<br />
Now when you launch the server, the directory '''<SERVER>/mods/deathmatch/resource-cache/http-client-files''' will contain the correct client files for hosting on an external web server. If the web server is on the same machine, you can simply link the appropriate web server directory to '''http-client-files'''. If the web server is on a separate machine, ensure it has access to '''http-client-files''' via a network path, or maintain a remote copy using synchronization software.<br />
<br />
'''Note 1''': Please try to avoid any special characters (e.g. ~, !) in your download URLs.<br /><br />
'''Note 2''': Please do not use a trailing slash in your download URL (e.g. ''hxxp://www.myserver.tld/directory'' rather than ''hxxp://www.myserver.tld/directory/'')<br />
<br />
==Starting your server==<br />
Begin by making sure that you have finished all configuration of your server, starting your server is the last stage so everything must be ready!<br />
<br />
To start your server double click on MTA Server.exe, make sure you allow it through any firewalls and forward ports where necessary.<br />
<br />
==Installing/Updating resources on your server==<br />
Resources can come in two formats, either a ZIP format or just a normal folder with the script files inside it. The MTA:SA server supports both these methods.<br />
<br />
# Move or copy the new resource to your <SERVER>\mods\deathmatch\resources folder.<br />
# In the server window type in the command "refresh" (without the quotes), this will re-scan the resources folder and update the live resources where necessary.<br />
<br />
==Uninstalling resources==<br />
Resources can easily be removed from your server if you no longer want them.<br />
<br />
# Delete the ZIP file or the folder of the resource you wish to uninstall<br />
# In the server window type in the command "refresh" (without the quotes), this will re-scan the resources folder and update the live resources where necessary.<br />
<br />
==Administrating your server==<br />
You can start resources by typing the command "start resourcename" in the server console, or stop ones with "stop resourcename".<br />
<br />
It's also possible to execute these and other admin commands from the in-game console (which you can bring up with the ` key or F8); for this to work, you first need to log in with the command "login username password". Additionally, you can press the p key to bring up the admin panel: this is a graphical interface which allows you to easily kick or ban misbehaving players, among others.<br />
<br />
For further commands, type "help" in a console.<br />
<br />
==Starting a map/gamemode==<br />
See the commands section of the documentation for [[Resource:Map manager|mapmanager]] for more information.<br />
<br />
==Useful Notes==<br />
<br />
# You may also update the resources while in-game as long as you have the correct access levels by typing "refresh" in the clients console or "/refresh" in the chat window. This may cause a second of lag if you have many resources.<br />
# In the above instructions, <SERVER> is the path to your server's main directory. In most cases this is C:\Program Files\MTA San Andreas\server<br />
# You can choose a different config file for the server to use by passing it in the command line after a --config argument, e.g. mtaserver.exe --config anotherconfig.cfg.<br />
# Do not be alarmed by the warning regarding the parsing of the settings.xml file. This happens because your server installation is still clean and unused.<br />
<br />
====Need further help?====<br />
Why not pop over to our [http://forum.mtasa.com/ Forums] or join us on [irc://irc.multitheftauto.com/mta IRC] (irc.multitheftauto.com #mta - [http://www.mirc.com mIRC])<br />
<br />
[[es:Manual Servidor Deathmatch]]<br />
[[de:MTA DM Server Anleitung]]<br />
[[it:Manuale del Server]]<br />
[[nl:Deathmatch Server Manual]]<br />
[[ru:Deathmatch Server Manual]]<br />
[[pl:Server Manual]]</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=AntiCheat_Codes&diff=25543AntiCheat Codes2011-04-16T16:33:55Z<p>Lil Toady: Created page with "*AC #1 - Trainer **Classic health/amour hack detector ***False positive note: Has triggered FP in the past. Should not FP in 1.0.5 *AC #2 - Not used *AC #3 - Not used *AC #4 - Tr..."</p>
<hr />
<div>*AC #1 - Trainer<br />
**Classic health/amour hack detector<br />
***False positive note: Has triggered FP in the past. Should not FP in 1.0.5<br />
*AC #2 - Not used<br />
*AC #3 - Not used<br />
*AC #4 - Trainer<br />
**Detects presence of trainer.<br />
***Capital letters in the message are for tagging particular trainers<br />
*AC #5 - Trainer<br />
**Detects use of trainer. <br />
*VF #6 - Trainer<br />
**Detects use of trainer<br />
***player movement<br />
***health/damage<br />
***weapons<br />
***money<br />
***gamespeed<br />
***game cheats<br />
**aimbot <br />
*AC #7 - Not yet<br />
*VF #8 - Misc<br />
**Detects unauthorized mods.<br />
***Capital letters in the message are for tagging particular items e.g.<br />
****CLEO - Cleo detected<br />
****RENDER - Wall hack detected<br />
<br />
<br />
General False positive note:<br />
---------------------------<br />
With the current release of 1.0.5, there should be no false positives.<br />
If you know of any, please tell us.</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=IterElements&diff=24122IterElements2010-07-29T15:32:02Z<p>Lil Toady: </p>
<hr />
<div>{{Useful Function}}<br />
<lowercasetitle/><br />
__NOTOC__<br />
This function is useful for '''for''' loops. You don't have to type ''ipairs( getElementsByType( "player" ) )'' but simply ''iterElements( "player" )''. It's very useful if you have many for loops in your code.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">iterator iterElements( string elementType )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
* '''elementType''': Type of the elements that you want to iterate through.<br />
<br />
==Code==<br />
<syntaxhighlight lang="lua"><br />
function iterElements( elementType )<br />
local i = 0;<br />
local tab = getElementsByType( elementType );<br />
return function( )<br />
i = i + 1;<br />
if tab[ i ] then<br />
return i, tab[ i ];<br />
end<br />
end<br />
end<br />
</syntaxhighlight><br />
<br />
<br />
==Example==<br />
This example will iterate through all players and vehicles. It will heal the players, give them $1000, send them a message informing them about the action and fix all vehicles when the resource starts.<br />
<syntaxhighlight lang="lua"><br />
addEventHandler( "onResourceStart", getResourceRootElement( ),<br />
function( )<br />
for _, plr in iterElements( "player" ) do<br />
setElementHealth( plr, 100 );<br />
givePlayerMoney( plr, 1000 );<br />
outputChatBox( "You've just been healed and given $1000!", plr );<br />
end<br />
<br />
for _, veh in iterElements( "vehicle" ) do<br />
fixVehicle( veh );<br />
end<br />
end<br />
)<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Useful_Functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=ForcePlayerMap&diff=24095ForcePlayerMap2010-07-23T11:48:29Z<p>Lil Toady: Undo revision 24088 by Chumillas (Talk)</p>
<hr />
<div>{{Server function}}<br />
__NOTOC__<br />
This function is used to forcefully show a player's radar map.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">bool forcePlayerMap ( player thePlayer, bool forceOn )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''thePlayer''': A [[player]] object referencing the specified player<br />
*'''forceOn''': A boolean value representing whether or not the players radar map will be forced on<br />
<br />
===Returns===<br />
Returns ''true'' if the player's radar map was forced on, ''false'' otherwise.<br />
<br />
==Example==<br />
This example forces the radar map of the player named "dave" on for 10 seconds, if it hasn't been already<br />
<syntaxhighlight lang="lua"><br />
-- Get the player named "dave"<br />
dave = getPlayerFromName ( "dave" )<br />
-- Make sure we found him<br />
if ( dave ) then<br />
if not isPlayerMapForced ( dave ) then -- if his radar map isn't already forced on<br />
forcePlayerMap ( dave, true ) -- force it on<br />
setTimer ( forcePlayerMap, 10000, 1, dave, false ) -- stop forcing in 10 seconds<br />
end<br />
end<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Player functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=ForcePlayerMap&diff=24094ForcePlayerMap2010-07-23T11:48:12Z<p>Lil Toady: Undo revision 24093 by Chumillas (Talk)</p>
<hr />
<div>{{Server function}}<br />
__NOTOC__<br />
This function is used to forcefully show a player's radar map.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">bool forcePlayerMap ( player thePlayer, bool forceOn )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''thePlayer''': A [[player]] object referencing the specified player<br />
*'''forceOn''': A boolean value representing whether or not the players radar map will be forced on<br />
<br />
===Returns===<br />
Returns ''true'' if the player's radar map was forced on, ''false'' otherwise.<br />
<br />
==Example==<br />
<section name="Server" class="server" show="true"><br />
This example forces the radar map of the player named "dave" on for 10 seconds, if it hasn't been already<br />
<syntaxhighlight lang="lua"><br />
-- Get the player named "Pedro"<br />
dave = getPlayerFromName ( "Pedro" )<br />
-- Make sure we found him<br />
if ( dave ) then<br />
if not isPlayerMapForced ( dave ) then -- if his radar map isn't already forced on<br />
forcePlayerMap ( dave, true ) -- force it on<br />
setTimer ( forcePlayerMap, 10000, 1, dave, false ) -- stop forcing in 10 seconds<br />
end<br />
end<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Player functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=RU/Client_Manual&diff=19008RU/Client Manual2009-04-11T16:53:01Z<p>Lil Toady: Undo revision 19003 by Pawn (Talk)</p>
<hr />
<div>__TOC__<br />
<br />
{{anc-rome-stub}}<br />
==Введение==<br />
Multi Theft Auto: San Andreas является самым последним мультиплеером из всех мультиплееров, созданных поклонниками игр Grand Theft Auto (только PC версий). Для получения информации о мультиплеерах для игр GTA3 и Vice City, посетите [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Эта модификация не является официально поддерживаемой Rockstar Games и Take 2 Interactive.<br />
<br />
Обратите внимание на то, что клиентское приложение MTA:SA Deathmatch находится на стадии бета-тестирования, что означает приложение может аварийно завершать работу или являться причиной возникновения неожиданных результатов.<br />
<br />
==Перед началом установки==<br />
<br />
Перед тем, как установить Multi Theft Auto: San Andreas, сначала убедитесь в том, что для игры GTA:SA не установлены какие-либо модификации. Они могут явиться причиной неправильной работе MTA. Если вы желаете оставить в игре режим одного игрока, вы можете повторно установить San Andreas в другую директорию на жестком диске.<br />
<br />
Также убедитесь, в том что у вас установлена одна из следующих операционных систем '''Windows XP''', '''Windows 2000''', '''Windows Vista''' или '''Windows Server 2003''' и что системные требования вашего компьютера соответствуют требованиям работы игры в одиночном режиме. обратите внимание на то, что если запускаете одиночный режим игры на компьютере обладающем минимальными системными требованиями, вы будете испытывать некоторые замедления в работе MTA, вызванные высокой загрузкой процессора.<br />
<br />
'''Обратите внимание: MTA:SA работает только с GTA:SA EXE v1.0.''' Если вы приобрели игру недавно, то возможно у вас более поздняя версия игры.<br />
<br />
Если у вас возникли ошибки в работе мультиплеера, убедитесь в том, что они описаны на странице [[Known_Issues_-_FAQ|Известные ошибки]], или свяжитесь с нами по IRC каналу по адресу irc://irc.multitheftauto.com/mta<br />
<br />
===Системные требования===<br />
Минимальные системные требования компьютера для Multi Theft Auto: San Andreas незначительно отличаются от системных требований игры Grand Theft Auto: San Andreas.<br />
* процессор класса Intel Pentium 4 или AMD Athlon XP<br />
* 512МБ ОЗУ<br />
* Установленная без модификаций игра Grand Theft Auto: San Andreas версии 1.0 или 1.1 (американская или европейская)<br />
* 3.7ГБ свободного места на жестком диске (3.6ГБ для установки Grand Theft Auto)<br />
* видеокарта семейства nVidia GeForce 4 или ATI Radeon 8xxx с 64MB ОЗУ и поддержкой DirectX 9.0<br />
* звуковая карта или кодек с поддержкой DirectX 9.0<br />
* клавиатура и мышь<br />
* широкополосный доступ в интернет для стабильной игры через сеть<br />
<br />
Для дополнительных возможностей игры рекомендуется использовать видеокарту, имеющую поддержку пиксельных шейдеров версии 2.0 (видеокарта семейства nVidia GeForce FX или выше, ATI Radeon 9xxx или выше).<br />
<br />
Для быстрой загрузки игры рекомендуется использовать больший объем оперативной памяти.<br />
<br />
==Установка игры==<br />
<br />
'''Этот раздел имеет смысл читать после того, как у вас будет установочный файл мультиплеера'''<br />
<br />
# Если у вас его нет, то перейдите на сайт http://www.mtabeta.com, зарегистрируйтесь и скачайте установщик клиентского приложения MTA:SA.<br />
# Запустите установочный файл. Вы увидите диалоговое окно приветствия, затем прочитайте Лицензионное соглашение с конечным пользователем (EULA). Вы должны быть согласны с условиями лицензионного соглашения для продолжения установки.<br />
# Далее вам будет необходимо выбрать один из трех вариантов: создать учетную запись, использовать уже имеющуюся учетную запись или не использовать учетную запись. После этого возможны два варианта продолжения установки.<br />
<br><br />
'''Выбран первый вариант: создать учетную запись'''<br><br />
Выполните создание новой учетной записи на MTABeta.com, после чего введите ваш логин и пароль в окно программы установки<br><br />
'''Выбран второй вариант: использовать уже имеющуюся учетную запись'''<br><br />
Введите данные учетной записи в программу установки<br />
<br><br><br />
# Затем вам будет необходимо выбрать компоненты для установки.<br />
#* '''Client''' интерфейсы игры, является обязательным компонентом.<br />
#* '''MTA Server''' позволяет вам использовать ваш собственный компьютер в качестве сервера.<br />
#* '''MTA Server > Editor''' используется для создания новых карт, является необязательным компонентом.<br />
# Затем вам необходимо выбрать директорию, в которую будет произведена установка. Вы качестве этой директории вы должны указать директорию, в которой установлена San Andreas. По умолчанию это: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''. Нажмите кнопку '''Install''' для выполнения установки.<br />
# После завершения установки, вам будет предложено запустить MTA: San Andreas. Выберите эту опцию по своему усмотрению и нажмите кнопку '''Finish'''.<br />
# Вы можете также запускать MTA:DM из меню Пуск, когда пожелаете.<br />
<br />
==Запуск игры==<br />
# Запустите Multi Theft Auto щелкнув левой кнопкой мыши по иконке расположенной на вашем рабочем столе или выбрав в меню Пуск пункт '''MTA:San Andreas'''.<br />
# Запуститься GTA: San Andreas и после загрузки игры вы увидите главное меню MTA:SA. Ниже показаны варианты меню:<br />
<br />
{| border="0" align="center"<br />
| width="188" |<br />
[[Image:MENU_QuickConnect.jpg]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – этот пункт позволяет вам соединиться с сервером, IP или URL адрес и порт которого вам уже известен. Этот вариант полезен, когда вы точно знаете, на каком сервере вы хотите играть и поэтому вам не нужно искать его в списке всех серверов.</font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
[[Image:MENU_ServerBrowser.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – при выборе этого пункта отображается список доступных для игры серверов. </font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
[[Image:Settings.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– это пункт позволяет вам сменить ваш nickname в игре, настроить управление и свойства дисплея.</font><br />
<br />
<br /><br /><br />
|-<br />
| width="188" |<br />
[[Image:MENU_About.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– этот пункт позволяет вам посмотреть список участников проекта.</font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
<br><br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– этот пункт позволяет вам создавать собственные карты, контрольные точки, рампы, препятствия и другие объекты. Эти карты вы можете затем загрузить на сервер, чтобы вы могли играть на них с другими игроками.</font><br />
<br />
<br /><br /><br />
|-<br />
| width="188" |<br />
<br><br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– этот пункт позволяет вам выйти из игры на рабочий стол Windows.</font><br />
<br />
<br /><br /><br />
|}<br />
<br />
Простейшим способом начать игру - выбрать в меню пункт '''Browse Servers'''. Появится новое окно:<br />
<br />
<center>[[Image:manual_image006a.jpg]]</center> '''Will need to be updated'''<br />
<br />
Если сервера не отображаются, нажмите кнопку '''Refresh''' и MTA просканирует сервера и отобразит их список.<br />
<br />
* В столбце '''Name''' отображается название каждого сервера.<br />
* В столбце '''Players''' отображается число игроков и максимально возможное число игроков на сервере, в формате [Имеющееся число игроков] / [Максимальное число игроков].<br />
* В столбце '''Ping''' отображается время задержки в миллисекундах между вашим компьютером и сервером. Время задержки - это время между моментом отправки вашим компьютером пакетов данных серверу и моментом получения ответного сообщения от сервера, поэтому чем больше время задержки, тем больше вы будете испытывать задержек в работе клиентского приложения с конкретным сервером. Обычно, сервера расположенные недалеко от вас по географическому местоположению должны иметь более низкое время задержки.<br />
* В столбце '''Host''' отображается IP адрес сервера. Вы можете использовать этот адрес для будущих соединений с этим же сервером посредством выбора пункта меню Quick Connect в главном меню.<br />
<br />
По каждому столбцу можно щелкать указателем мыши для упорядочивания значений столбца по возрастанию или убыванию.<br />
<br />
Для оптимальной работы приложения и процесса игры, выбирайте сервера с наилучшим балансом между числом игроков и временем задержки.<br />
<br />
После того как вы выбрали нужный вам сервер, выберите его строку списка и щелкните левой кнопкой мыши кнопку '''Connect''' в верхнем правом углу диалогового окна. Если процесс соединения будет выполнен успешно, вы соединиться с сервером и автоматически включиться в процесс игры.<br />
<br />
<!--===Запуск игры из ASE (The All-Seeing Eye)===<br />
<br />
Если вам не нравится встроенный в игру просмотр серверов MTA:San Andreas, вы можете захотеть использовать '''The All-Seeing Eye''', который позволит вам просмотреть список игровых серверов, и применить настраиваемые фильтры поиска. Этот учебник поможет вам установить ASE, и покажет как легко с ним работать.<br />
# Скачайте ASE по адресу http://videogames.yahoo.com/multiplayer и установите.<br />
# '''Следующее применимо к MTA:SA вплоть до версии 1.0 dp2, и будет скорее всего зафиксировано в дальнейшей версии''' <br /> Скачайте [http://www.xup.in/dl,19686489/ASELauncher.zip/ ASELauncher] и извлеките ASELauncher.exe в директорию, где установлен MTA (по умолчанию, это C:\Program Files\MTA San Andreas). Эта небольшая программа конвертирует командную строку ASE в формат понятный MTA. <br />
# Теперь добавьте MTA:SA в ваш список игр в ASE:<br />
#* В ASE щелкните левой кнопкой мыши ''Tools'' -> ''Options'', и выберите вкладку ''Games''<br />
#* Откройте категорию ''Not installed'' и выберите в списке ''Multi Theft Auto'' <br />
#* Выберите ''Visible in filter list'', щелкните ''Browse'' и выберите в '''ASELauncher.exe''' вашу директорию MTA San Andreas<br />
#* Оставьте поле ''Player name'' пустым, и нажмите кнопку ''OK''<br />
# Запуститься '''Multi Theft Auto'''. После того, как вы нажмете кнопку ''Refresh'' на панели инструментов, вы увидите список сервером для всех версий MTA. Теперь добавьте модификатор для того, чтобы отображалась текущая версия '''1.0 dp2'''<br />
#* Щелкните правой кнопкой мыши по ''Multi Theft Auto'' и выберите пункт ''New...''<br />
#* В нижнем левом углу выберите ''Modifier'' и замените MYMOD на '''MTADP2'''<br />
#* Введите название модификатора в поле ''Name'', например '''MTA:SA 1.0 dp2'''<br />
#* Вставьте следующий код фильтра (со строкой номера):<br /><tt>1 if version != "1.0dp2" remove</tt><br />
#* Щелкните ''OK''<br />
#* Ваш новый модификатор отображается в ''My filters''<br />
# Все готово! Теперь активируйте ваш модификатор для того, чтобы отображать только вашу версию игры, выберите игру ''Multi Theft Auto'', и дважды щелкните по строке, содержащей сервер, чтобы начать игру.<br />
--><br />
==Как играть==<br />
<br />
MTA:SA предоставляет полную систему написания сценариев, которая позволяет создателем игровых карт настраивать многие элементы игры различным образом, вплоть до создания своих собственных новых игровых режимов. Игра объединяет множество игроков, с некоторыми исключениями, отличающими многопользовательский режим от однопользовательского.<br />
<br />
В многопользовательской игре нет пешеходов и на дорогах нет машин, "искусственно" управляемых алгоритмами самой игры. Вашими оппонентами на игровой карте являются только другие игроки, или союзники если это карта командной игры. Вы можете общаться с ними используя окно чата, расположенное в левом верхнем углу экрана, нажав клавишу '''T'''. Чтобы переписываться только с игроками вашей команды, нажмите клавишу '''Y'''.<br />
<br />
Редактор карт MTA позволяет создателям карт добавлять различные объекты GTA в свои карты включая дороги, взрывающиеся баки, рампы, строения, возвышенности и так далее. Не только для этих, но и для других объектов могут быть написаны сценарии движения, модели изменения и исчезновения. Это позволит сделать игровой процесс более интересным и разнообразным. <br />
<br />
Окно просмотра игроков будет отображать очки, заработанные игроком. По умолчанию, отображаются только имена и время задержки, но сценарии могут добавить дополнительные столбцы, которые являются специфичными определенному режиму игры. Например, режим игры "deathmatch" может иметь столбец перечисляющий общее число убийств, но создатель карт может выбирать сам и добавить дополнительные колонки для числа смертей вашего персонажа, длительности вашей игры, а также поместить очки, заработанные вами.<br />
<br />
==Управление==<br />
<br />
===Клавиши управления в игре===<br />
<br />
* F8 (или клавиша "тильда") - Консоль<br />
* F9 - Помощь игрового сервера<br />
* F11 - Показать карту SA ''(следующий список клавиш используется при отображении карты)''<br />
**numpad +/- - Увеличить/уменьшить масштаб карты<br />
**numpad 4, 8, 6, 2 - переместиться влево, вверх, вправо, вниз по карте<br />
**numpad 0 - переключиться между режимами карты: закрепить карту за локальным игроком (карта следует за меткой игрока) и свободное передвижение (карта остается неподвижной) <br />
* F12 - Сделать снимок изображения экрана<br />
* T - Чат<br />
* Y - Командный чат<br />
* TAB - Список игроков (если ресурс [[Scoreboard]] запущен на сервере)<br />
<br />
==Команды консоли==<br />
<br />
'''bind defaults''' Сбросить настроийки управления на настройки по умолчанию<br />
<br />
Нажатие '''~ (тильда)''' или '''F8''' доступ к консоли, затем вводится команда, за которой при необходимости следуют параметры (если нужно) затем нажимается Enter.<br />
<br />
;'''maps''' :Отобразить список всех карт доступных на сервере. <br />
<br />
;'''nick [nickname]''' :Изменить nickname, отображаемый в игре на тот, который служит параметром в данной команде.<br />
<br />
;'''msg [nickname] [message]''' или '''pm [nickname] [message]''' :Отправить личное сообщение игроку, который определяется параметром [nickname]. Только игрок, определенный вами может увидеть это сообщение. И '''msg''' и '''pm''' выполняют одну и ту же функцию.<br />
<br />
;'''quit''' или '''exit''' :Выполнить разрыв связи с сервером и выйти из игры на рабочий стол Windows. Выполняет ту же функцию, что и кнопка Quit в главном меню.<br />
<br />
;'''ver''' :Отобразить номер версии и информацию об авторских правах программного обеспечения.<br />
<br />
;'''time''' :Отобразить текущее время.<br />
<br />
;'''disconnect''' :Разорвать соединение с игровым сервером и вернуться в главное меню.<br />
<br />
;'''say [text]''' :Позволяет вам продолжить общение с игроками через окно чата из консоли.<br />
<br />
;'''ignore [nickname]''' :Не отображать любой текст, введенный игроком, которого вы игнорируете. Чтобы отменить игнорирование сообщений игрока введите команду '''ignore [nickname]''' снова.<br />
<br />
'''Совет:''' Вы можете использовать эти команды непосредственно в окне чата, поместив перед ними / (слеш).<br />
<br />
Список команд консоли можно увидеть, введя в консоли команду '''help''' и нажав клавишу Enter. Любая карта может также иметь дополнительные команды, к которым вы можете получить доступ введя в консоли команду '''commands'''.<br />
<br />
==Коды ошибок и их описание==<br />
'''Ошибки загрузки'''<br><br />
0: UNKNOWN_ERROR<br><br />
1: INVALID_FILE_DESCRIPTORS<br><br />
2: INVALID_MAX_FILE_DESCRIPTOR<br><br />
3: INVALID_SELECT_RETURN<br><br />
4: INVALID_INITIAL_MULTI_PERFORM<br><br />
5: INVALID_MULTI_PERFORM_CODE<br><br />
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br><br />
7: UNEXPECTED_CURL_MESSAGE<br><br />
8: UNABLE_TO_CONNECT<br><br />
9: UNABLE_TO_DOWNLOAD_FILE<br><br />
10: FAILED_TO_INITIALIZE_DOWNLOAD<br><br />
<br />
'''Неустранимые ошибки'''<br><br />
1: no local player model on ingame event<br><br />
2: no local player on ingame event<br><br />
3: server downloads disabled<br><br />
4: no local player model on player-list packet<br><br />
5: no local player on player-list packet<br><br />
6: invalid custom data length on entity-add packet<br><br />
7: invalid bitstream data on entity-add packet<br><br />
8: system entity on entity-add packet<br><br />
9: failed to create object on entity-add packet<br><br />
10: failed to create pickup on entity-add packet<br><br />
11: failed to create vehicle on entity-add packet<br><br />
12: invalid team-name length on entity-add packet<br><br />
13: invalid lua-event name length in lua-event packet<br><br />
14: invalid resource name length in resource-start packet<br><br />
<br />
'''Ошибки типа 'Unable to enter vehicle''''<br><br />
1: script cancelled<br><br />
2: script cancelled (jack)<br><br />
3: current occupier is entering/exiting<br><br />
4: invalid seat<br><br />
5: not close enough<br><br />
6: already in a vehicle<br><br />
7: already entering/exiting<br><br />
8: invalid vehicle (trailer)<br><br />
<br />
[[de:MTA DM Client Anleitung]]<br />
[[en:Deathmatch Client Manual]]<br />
[[it:Manuale del Client]]<br />
[[nl:Deathmatch Client Manual]]</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=%D0%93%D0%BB%D0%B0%D0%B2%D0%BD%D0%B0%D1%8F_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0&diff=19001Главная страница2009-04-11T16:39:03Z<p>Lil Toady: /* Map Editor */</p>
<hr />
<div>__NOTOC__<br />
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Добро пожаловать в Wiki разработчиков Multi Theft Auto: San Andreas Deathmatch. <br />
Здесь вы найдёте информацию по разработке игровых модов и карт для Multi Theft Auto.<br />
<br />
Есть много [[How you can help|способов помочь нам]] сделать MTA лучше - создать карту, игровой режим, добавить описание функции скриптинга, написать пример кода, руководство, или просто играть в MTA и сообщать о найденых багах на форум.<br />
<br />
Пожалуйста, отнеситесь с пониманием к неизбежному появлению ошибок и помните, что многие вещи еще не сделаны доконца!<br />
<br />
Если у вас есть какие-либо вопросы по скриптингу, вы можете задать их в нашем [[IRC Channel |IRC канале]].<br />
<br />
'''Для редактирования статей вам понадобится [http://community.mtasa.com/ MTA Community] аккаунт.'''<br />
Пожалуйста зарегистрируйтесь на сайте [http://community.mtasa.com MTA Community] и используйте полученные логин/пароль для авторизации здесь. Акты вандализма будут караться баном вашего аккаунта.<br />
<br />
Теперь Wiki поддерживает инструмент '''[http://gears.google.com/ Google Gears]''', позволяющий вам просматривать статиь оффлайн. Для этого установите Google Gears и кликните по ссылке Go Offline в нижней части страницы. Будьте готовы к тому, что скачивание всех страниц может занять до часа(!), когда загрузка будет завершена, вы увидите сообщение об этом рядом с той ссылкой. После этого вы сможете переключить ваш браузер в оффлайн режим, или просто отключить интернет, и просматривать вики дальше.<br />
<br />
<div style="border: 2px dotted navy; padding: 4px; margin: 10px">Последняя стабильная версия '''Multi Theft Auto: San Andreas Deathmatch''' - '''{{Current Version|full}}'''. Посетите [http://mtasa.com/dp.html эту страницу] для её скачивания. Также вы можете скачать ночные [http://nightly.mtasa.com сборки для разработчиков], чтобы использовать последние нововведения.</div><br />
<br />
</div><br />
<br />
<div style="clear:both;"></div><br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<br />
|-<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
====Начало====<br />
<br />
* [[RU/Deathmatch_Client_Manual|Руководство по клиентской части MTA]]<br />
* [[RU/Deathmatch_Server_Manual|Руководство по серверной части MTA]]<br />
* [[RU/Known_Issues_-_FAQ|Известные проблемы MTA:SA DM]]<br />
* [[RU/Scripting Introduction|Введение в скриптинг]]<br />
* [[RU/Introduction to Scripting the GUI | Введение в скриптинг GUI (графический пользовательский интерфейс)]]<br />
* [[RU/Debugging| Руководство по отладке]] - Как найти ошибки в ваших скриптах.<br />
* [[RU/MTA Classes | Классы MTA]] - Детальные описания всех специфических типов MTA<br />
** [[RU/Element|MTA Элементы]] / [[RU/Element tree | Дерево элементов]]<br />
* [[RU/Resources| Введение в ресурсы]]<br />
** [[RU/Resource Web Access | Ресурс Web Access]]<br />
** [[:Category:Resource|Каталог ресурсов]]<br />
** [[RU/Meta.xml | Meta.xml]]<br />
* [[RU/Map_manager|Менеджер карт]]<br />
* [[RU/Introduction_to_Scripting_the_GUI|Введение в скриптинг пользовательских интерфейсов]]<br />
* [[RU/Writing_Gamemodes| Создание игровых режимов]]<br />
<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Базы данных====<br />
В этой секции описаны все возможности LUA, предоставляемые MTA и ресурсами.<br />
* [[:Category:Resource|Каталог ресурсов]] - Изучите это, чтобы писать хорошие скрипты<br />
* [[Client side scripts | Клиентские скрипты]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Основная помощь по Lua====<br />
Страницы, которые могут вам помочь в изучении LUA<br />
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)] <br />
*[http://www.lua.org/pil/index.html Руководство по программированию на LUA (англ.)]<br />
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki (англ.)]<br />
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]<br />
</div><br />
<br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Map Editor====<br />
*[[RU/Resource:Editor|Руководство]]<br />
*[[RU/Resource:Editor/EDF|Editor Definition Format]]<br />
*[[RU/Resource:Editor/Plugins|Плагины]]<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;"><br />
<br />
====Описание====<br />
* [[Client Scripting Functions|Функции, выполняемые на стороне клиента]]<br />
* [[Client Scripting Events|События, генерируемые на стороне клиента]]<br />
* [[Server Scripting Functions|Функции, выполняемые на стороне сервера]]<br />
* [[Server Scripting Events|События, генерируемые на стороне сервера]]<br />
<!-- Incomplete * [[Module functions|Server-side external module scripting functions list]] --><br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Список идентификаторов====<br />
*[[Animations|Анимации]]<br />
*[[Character Skins | Скины персонажей]]<br />
*[[CJ_Clothes|Одежда]]<br />
*[[Garage|Идентификаторы гаражей]]<br />
*[[Interior IDs | Интерьеры]]<br />
*[[Template:Projectiles|Projectiles]]<br />
*[[Template:Blip_Icons|Метки радара]]<br />
*[[Template:Sounds|Звуки]]<br />
*[[Vehicle IDs|Транспорт]]<br />
*[[Template:Vehicle_colors|Цвета транспорта]]<br />
*[[Vehicle Upgrades|Апгрейды транспорта]]<br />
*[[Weapons|оружие]]<br />
*[[Weather|Погода]]<br />
</div><br />
<br />
|-<br />
| colspan="2" |<br />
|}<br />
[[pl:Main Page]]<br />
[[en:Main Page]]<br />
[[it:Pagina principale]]<br />
[[nl:Main Page]]<br />
[[de:Hauptseite]]</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=RU/Resource:Editor&diff=18999RU/Resource:Editor2009-04-11T16:37:10Z<p>Lil Toady: New page: {{Resource page}} The MTA:SA map editor allows you to create maps for gamemodes. ==Начало== Чтобы запустить редактор, просто нажмите на "Map edi...</p>
<hr />
<div>{{Resource page}}<br />
The MTA:SA map editor allows you to create maps for gamemodes.<br />
<br />
==Начало==<br />
Чтобы запустить редактор, просто нажмите на "Map editor" в главном MTA меню.<br />
<br />
==Меню==<br />
После запуска вы увидите два меню: в главном меню вверху, и элемент меню в левом нижнем углу.<br />
<br />
===Главное меню===<br />
Это меню состоит из нескольких кнопок:<br />
* [[Image:Editor_New.png]] Создать новую карту.<br />
* [[Image:Editor_Open.png]] Открыть существующую карту.<br />
* [[Image:Editor_Save.png]] Сохранить карту.<br />
* [[Image:Editor_Save_as.png]] Сохраните карту под другим именем.<br />
* [[Image:Editor_Options.png]] Общие настройки карты.<br />
* [[Image:Editor_Undo.png]] Отменить последнее действие.<br />
* [[Image:Editor_Redo.png]] Восстановить отмененное действие.<br />
* [[Image:Editor_Locations.png]] Stored game world locations. The editor comes with a great list of San Andreas Interior locations but you can also add your own interior and non-interior locations to the list.<br />
* [[Image:Editor_Current_elements.png]] List all the elements the map contains (objects, vehicles, markers, pickups etc.)<br />
* [[Image:Editor_Map_settings.png]] Map specific settings, like time of day, gravity etc. Here you can also specify what gamemodes the map is compatible with.<br />
* [[Image:Editor_Definitions.png]] Load [[Resource:Editor/EDF|editor definition files (EDF)]] that you want to use. <br />
* [[Image:Editor_Test.png]] Go into play mode to try out the map. This will load up the gamemode the map is made for.<br />
<br />
===Элементы меню===<br />
The element menu is used to add new elements to the map.<br />
* [[Image:Editor_Vehicle.png]] Create a new vehicle.<br />
* [[Image:Editor_Object.png]] Create a new object (buildings, roads and other scenery).<br />
* [[Image:Editor_Pickup.png]] Create a new pickup (health, armor, weapons).<br />
* [[Image:Editor_Marker.png]] Create a new marker.<br />
<br />
Additionally, if you have [[Resource:Editor/EDF|editor definitions loaded]], you can roll the mousewheel in this menu to bring up custom elements.<br />
<br />
==Использование редактора==<br />
This section explains how to create and modify maps.<br />
<br />
===Перемещение по карте===<br />
When you initially start the editor, you are in ''camera mode''. You are able to use the '''WSAD''' keys to move the camera and the mouse to pan the camera. While moving around, you can hold '''ALT''' to move more slowly or '''SHIFT''' to go faster.<br />
<br />
To access the editor's interface and control panel you need to switch to ''cursor mode''. You can toggle between cursor mode and camera mode with the '''F''' key. When in cursor mode, your view is fixed, and you can use the mouse cursor to manipulate elements and use the graphical interface.<br />
<br />
Camera mode can be recognized by a crosshair in the center of the screen. You can use it to select and move elements just like in cursor mode.<br />
<br />
[[Image:Editor_Crosshair.png|center]]<br />
<br />
===Запуск карты===<br />
* Start the editor, or if it is already started, click the ''New'' menu button.<br />
* Click the ''Map settings'' button. In the ''Meta'' tab, fill in the Name and Author fields with the name of the map and your name respectively. Also open the ''Gamemodes'' tab and add the gamemodes your map is meant for (they will be moved to the ''Added gamemodes'' list). You can do this by selecting them and clicking ''Add'', or by double clicking them. Click OK when you're done.<br />
[[Image:Editor_Mapsettings.png|center]]<br />
* Click the ''Definitions'' window and add the resources of which you want to use the custom elements. These will consist of the gamemodes you selected in the ''Map settings'' window, plus eventual additional resources. For more information about editor definitions, see [[Resource:Editor/EDF|EDF]]. Click OK when you're done.<br />
<br />
===Создание новых элементов===<br />
Adding elements to your map, such as vehicles and objects, is very straightforward.<br />
* If you are in camera mode, switch to cursor mode first by pressing '''F'''.<br />
* Click the button in the element menu that represents what you want. E.g., click the button with a car on it to add a vehicle.<br />
* A new element of the selected type will be created and attached to your cursor. Move it to the location where you want it and '''left click''' to drop it off.<br />
<br />
<br />
[[Image:Editor_Addelem.png|center]]<br />
<br />
<br />
To create custom elements that are specific to a resource, hover the cursor over the element menu and turn the scroll wheel until the desired resource comes up. Note that for this to work, you first have to add the [[Resource:Editor/EDF|EDF]] file of the resource in the ''Definitions'' window.<br />
<br />
[[Image:Editor_Selectedf.png|center]]<br />
<br />
===Выбор===<br />
* '''Left click''' an element to select it in ''keyboard mode''.<br />
* '''Right click''' it to select it in ''mouse mode''.<br />
* Press the '''Spacebar''' or click in an empty area to deselect.<br />
<br />
The selected element, if any, is denoted by a yellow cone marker. Elements (particularly objects) with poor collisions can be detected easier by enabling ''High sensitivity mode'', by pressing the '''E''' key. This increases detection at the expense of accuracy.<br />
<br />
The ''Current elements'' dialog can also be used to select elements. Double-clicking an item within the list will select it in ''Keyboard mode''.<br />
<br />
===Перемещение===<br />
Moving elements can be done in several ways.<br />
<br />
'''With the mouse'''<br />
* Simply drag and drop with the '''left mouse button'''.<br />
Or:<br />
* Select the element in mouse mode ('''right click'''), move it to where you want it, and click to drop it off.<br />
<br />
You can also adjust the ''Hold distance'' of an element toward and away from the camera by switching to camera mode, '''right clicking''' the element, and rolling the '''mouse wheel'''.<br />
<br />
'''With the keyboard'''<br />
* Select the element in keyboard mode ('''left click''').<br />
* Use the '''arrow keys''' to move the element in the horizontal plane, and '''PgUp'''/'''PgDn''' to move it vertically. Hold '''ALT''' to decrease the movement speed, or '''SHIFT''' to increase it.<br />
<br />
By default, elements move relative to the camera and are not locked to any axes. This can be disabled in the ''Options'' menu.<br />
<br />
===Вращение===<br />
'''With the mouse'''<br />
<br />
You can rotate selected elements around the Z axis with the mouse wheel.<br />
* Select the element in keyboard mode ('''left click''') and roll the mouse wheel while holding '''Left CTRL'''.<br />
Or:<br />
* Select the element in mouse mode ('''right click'''), hold '''CTRL''', and roll the mouse wheel.<br />
<br />
'''With the keyboard'''<br />
* Select the element in keyboard mode ('''left click''').<br />
* While holding '''CTRL''' (the selection marker will turn green), use the '''arrow keys''' and '''PgUp'''/'''PgDn''' to rotate the element around the different axes.<br />
<br />
With both methods you can additionally hold '''ALT''' to decrease the rotation speed or '''SHIFT''' to increase it.<br />
<br />
<br />
[[Image:Editor_Rotateelem.png|center]]<br />
<br />
===Смена модели===<br />
Most elements have a variety of options that can be altered to change their appearance and behaviour. Examples are the model, color and visual upgrades of a car.<br />
<br />
* Open the properties window of an element by either double clicking it or by selecting it and pressing '''F3'''.<br />
* Make any alterations that you want. For example, to change the model of a car or object, click the '''Browse''' button next to "model" to open the model browser.<br />
* Click OK when you're done.<br />
<br />
[[Image:Editor_Props.png|center]]<br />
<br />
===Копирование===<br />
You can clone an element by selecting it and pressing '''C'''. <br />
<br />
* In mouse mode the cloned element will be attached to your cursor. '''Left click''' to place it in the map.<br />
* In keyboard mode the cloned element will be cloned in the identical position.<br />
<br />
If you hold '''CTRL''' while clicking, the element will be cloned again and will again be attached to the cursor. This way you can easily place large quantities of something.<br />
<br />
Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to clone an element.<br />
<br />
===Удаление===<br />
Simply select the element and press '''DEL''' ''(Delete)''.<br />
<br />
Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to delete an element.<br />
<br />
==Управление==<br />
Here is a list of all default controls. To change them please go to the MTA Settings menu while the Editor is started.<br />
<br />
===Камера===<br />
{|<br />
|-<br />
| camera_move_forwards<br />
| '''w'''<br />
|-<br />
| camera_move_backwards<br />
| '''s'''<br />
|-<br />
| camera_move_left<br />
| '''a'''<br />
|-<br />
| camera_move_right<br />
| '''d'''<br />
|-<br />
| high_sensitivity_mode<br />
| '''e'''<br />
|}<br />
<br />
===Клонирование===<br />
{|<br />
|-<br />
| clone_selected_element<br />
| '''c'''<br />
|-<br />
| clone_drop_modifier<br />
| '''lctrl''' || ''(Left CTRL)''<br />
|}<br />
<br />
===Манипуляции с элементами===<br />
{|<br />
|-<br />
| element_move_forward<br />
| '''arrow_u''' || ''(Arrow key Up)''<br />
|-<br />
| element_move_backward<br />
| '''arrow_d''' || ''(Arrow key Down)''<br />
|-<br />
| element_move_left<br />
| '''arrow_l''' || ''(Arrow key Left)''<br />
|-<br />
| element_move_right<br />
| '''arrow_r''' || ''(Arrow key Right)''<br />
|-<br />
| element_move_downwards<br />
| '''pgdn''' || ''(Page Down)''<br />
|-<br />
| element_move_upwards<br />
| '''pgup''' || ''(Page Up)''<br />
|-<br />
| zoom_in<br />
| '''mouse_wheel_down'''<br />
|-<br />
| zoom_out<br />
| '''mouse_wheel_up'''<br />
|-<br />
| quick_rotate_increase<br />
| '''mod_rotate''' + '''mouse_wheel_up''' || ''(Left CTRL + Mouse wheel Up)''<br />
|-<br />
| quick_rotate_decrease<br />
| '''mod_rotate''' + '''mouse_wheel_down''' || ''(Left CTRL + Mouse wheel Down)''<br />
|-<br />
| mod_rotate<br />
| '''lctrl''' || ''(Left CTRL)''<br />
|-<br />
| mod_slow_speed<br />
| '''lalt''' || ''(Left ALT)''<br />
|-<br />
| mod_fast_speed<br />
| '''lshift''' || ''(Left SHIFT)''<br />
|-<br />
| destroy_selected_element<br />
| '''delete'''<br />
|-<br />
| drop_selected_element<br />
| '''space'''<br />
|-<br />
| pickup_selected_element<br />
| '''F2'''<br />
|-<br />
| reset_rotation<br />
| '''mod_rotate''' + '''r''' || ''(Left CTRL + R)''<br />
|}<br />
<br />
===GUI===<br />
{|<br />
| toggle_gui_display<br />
| '''F4'''<br />
|-<br />
| toggle_cursor<br />
| '''f'''<br />
|-<br />
| select_target_keyboard<br />
| '''mouse1''' || ''(Left Mouse button)''<br />
|-<br />
| select_target_mouse<br />
| '''mouse2''' || ''(Right Mouse button)''<br />
|-<br />
| edf_next<br />
| '''mouse_wheel_up'''<br />
|-<br />
| edf_prev<br />
| '''mouse_wheel_down'''<br />
|-<br />
| undo<br />
| '''Ctrl''' + '''z'''<br />
|-<br />
| redo<br />
| '''Ctrl''' + '''y'''<br />
|-<br />
| properties_toggle<br />
| '''F3'''<br />
|-<br />
| browser_up<br />
| '''arrow_u''' || ''(Arrow key Up)''<br />
|-<br />
| browser_down<br />
| '''arrow_d''' || ''(Arrow key Down)''<br />
|-<br />
| browser_zoom_in<br />
| '''mouse_wheel_up'''<br />
|-<br />
| browser_zoom_out<br />
| '''mouse_wheel_down'''<br />
|-<br />
| browser_confirm<br />
| '''enter'''<br />
|-<br />
| currentelements_up<br />
| '''num_8''' || ''(Numpad key 8)''<br />
|-<br />
| currentelements_down<br />
| '''num_2''' || ''(Numpad key 2)''<br />
|-<br />
| toggle_test<br />
| '''F5'''<br />
|}<br />
<br />
==Мультиплеер==<br />
The editor is built with both serverside and clientside components, and therefore supports multiplayer out of the box. To use the editor in multiplayer with other players, simply copy all of the editor's resources into your server, start the '''editor''' resource and allow other players to join.<br />
<br />
Please note that currently the editor lacks any permissions system, ao all users have access to every function.<br />
<br />
==Плагины и внешние ресурсы==<br />
{{Main|Resource:Editor/Plugins}}<br />
<br />
The editor allows basic importing of elements from external resources. This is useful for resources that may have to manipulate an element in a specific way that cannot be performed by the editor. For example, a map resource which uses custom models (and has a script to import these models) cannot be manipulated by default within the editor. <br />
<br />
By using the '''import <resourceName>''' command in console the resource's elements can be imported within the editor.<br />
<br />
==FAQ==<br />
==== I get an "Could not start the local server. See console for details" when using the "Map Editor" button====<br />
This is because you do not have a valid editor.conf installed. You can download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.<br />
<br />
==== I have saved a map but cannot find it in my server's resources directory, despite the Editor itself being able to see it ====<br />
This is due to the fact that Vista limits write-access for non-admin processes in Program Files directory. Files get written in the "VirtualStore" dir instead of real Program Files folder. You should be able to locate your map resource in a similar directory to:<br />
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\<br />
<br />
Running the Server/MTA San Andreas with Administrative rights will allow the map to be saved to the proper location.<br />
<br />
==== I have found a bug or have a suggestion/feedback for the map editor ====<br />
Please use the official [http://bugs.mtasa.com bugtracker] for reporting bugs. Feel free to also join us on [http://mtasa.com/irc.html IRC].<br />
<br />
<nowiki>Insert non-formatted text here</nowiki></div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=Resource:Editor&diff=18998Resource:Editor2009-04-11T16:36:25Z<p>Lil Toady: </p>
<hr />
<div>{{Resource page}}<br />
The MTA:SA map editor allows you to create maps for gamemodes.<br />
<br />
==Starting==<br />
To start the editor, simply click the "Map editor" menu item in the main MTA menu.<br />
<br />
==Menus==<br />
Once the editor has started, you are presented with two menu bars: the main menu at the top, and the element menu in the lower left.<br />
<br />
===Main menu===<br />
These are the buttons in the main menu:<br />
* [[Image:Editor_New.png]] Create a new map.<br />
* [[Image:Editor_Open.png]] Open an existing map.<br />
* [[Image:Editor_Save.png]] Save the map you're working on.<br />
* [[Image:Editor_Save_as.png]] Save your map under a different name.<br />
* [[Image:Editor_Options.png]] Alter general map editor settings.<br />
* [[Image:Editor_Undo.png]] Undo the last action.<br />
* [[Image:Editor_Redo.png]] Restore the last undone action.<br />
* [[Image:Editor_Locations.png]] Stored game world locations. The editor comes with a great list of San Andreas Interior locations but you can also add your own interior and non-interior locations to the list.<br />
* [[Image:Editor_Current_elements.png]] List all the elements the map contains (objects, vehicles, markers, pickups etc.)<br />
* [[Image:Editor_Map_settings.png]] Map specific settings, like time of day, gravity etc. Here you can also specify what gamemodes the map is compatible with.<br />
* [[Image:Editor_Definitions.png]] Load [[Resource:Editor/EDF|editor definition files (EDF)]] that you want to use. <br />
* [[Image:Editor_Test.png]] Go into play mode to try out the map. This will load up the gamemode the map is made for.<br />
<br />
===Element menu===<br />
The element menu is used to add new elements to the map.<br />
* [[Image:Editor_Vehicle.png]] Create a new vehicle.<br />
* [[Image:Editor_Object.png]] Create a new object (buildings, roads and other scenery).<br />
* [[Image:Editor_Pickup.png]] Create a new pickup (health, armor, weapons).<br />
* [[Image:Editor_Marker.png]] Create a new marker.<br />
<br />
Additionally, if you have [[Resource:Editor/EDF|editor definitions loaded]], you can roll the mousewheel in this menu to bring up custom elements.<br />
<br />
==Using the editor==<br />
This section explains how to create and modify maps.<br />
<br />
===Moving around the map===<br />
When you initially start the editor, you are in ''camera mode''. You are able to use the '''WSAD''' keys to move the camera and the mouse to pan the camera. While moving around, you can hold '''ALT''' to move more slowly or '''SHIFT''' to go faster.<br />
<br />
To access the editor's interface and control panel you need to switch to ''cursor mode''. You can toggle between cursor mode and camera mode with the '''F''' key. When in cursor mode, your view is fixed, and you can use the mouse cursor to manipulate elements and use the graphical interface.<br />
<br />
Camera mode can be recognized by a crosshair in the center of the screen. You can use it to select and move elements just like in cursor mode.<br />
<br />
[[Image:Editor_Crosshair.png|center]]<br />
<br />
===Starting a new map===<br />
* Start the editor, or if it is already started, click the ''New'' menu button.<br />
* Click the ''Map settings'' button. In the ''Meta'' tab, fill in the Name and Author fields with the name of the map and your name respectively. Also open the ''Gamemodes'' tab and add the gamemodes your map is meant for (they will be moved to the ''Added gamemodes'' list). You can do this by selecting them and clicking ''Add'', or by double clicking them. Click OK when you're done.<br />
[[Image:Editor_Mapsettings.png|center]]<br />
* Click the ''Definitions'' window and add the resources of which you want to use the custom elements. These will consist of the gamemodes you selected in the ''Map settings'' window, plus eventual additional resources. For more information about editor definitions, see [[Resource:Editor/EDF|EDF]]. Click OK when you're done.<br />
<br />
===Creating new elements===<br />
Adding elements to your map, such as vehicles and objects, is very straightforward.<br />
* If you are in camera mode, switch to cursor mode first by pressing '''F'''.<br />
* Click the button in the element menu that represents what you want. E.g., click the button with a car on it to add a vehicle.<br />
* A new element of the selected type will be created and attached to your cursor. Move it to the location where you want it and '''left click''' to drop it off.<br />
<br />
<br />
[[Image:Editor_Addelem.png|center]]<br />
<br />
<br />
To create custom elements that are specific to a resource, hover the cursor over the element menu and turn the scroll wheel until the desired resource comes up. Note that for this to work, you first have to add the [[Resource:Editor/EDF|EDF]] file of the resource in the ''Definitions'' window.<br />
<br />
[[Image:Editor_Selectedf.png|center]]<br />
<br />
===Selecting===<br />
* '''Left click''' an element to select it in ''keyboard mode''.<br />
* '''Right click''' it to select it in ''mouse mode''.<br />
* Press the '''Spacebar''' or click in an empty area to deselect.<br />
<br />
The selected element, if any, is denoted by a yellow cone marker. Elements (particularly objects) with poor collisions can be detected easier by enabling ''High sensitivity mode'', by pressing the '''E''' key. This increases detection at the expense of accuracy.<br />
<br />
The ''Current elements'' dialog can also be used to select elements. Double-clicking an item within the list will select it in ''Keyboard mode''.<br />
<br />
===Moving===<br />
Moving elements can be done in several ways.<br />
<br />
'''With the mouse'''<br />
* Simply drag and drop with the '''left mouse button'''.<br />
Or:<br />
* Select the element in mouse mode ('''right click'''), move it to where you want it, and click to drop it off.<br />
<br />
You can also adjust the ''Hold distance'' of an element toward and away from the camera by switching to camera mode, '''right clicking''' the element, and rolling the '''mouse wheel'''.<br />
<br />
'''With the keyboard'''<br />
* Select the element in keyboard mode ('''left click''').<br />
* Use the '''arrow keys''' to move the element in the horizontal plane, and '''PgUp'''/'''PgDn''' to move it vertically. Hold '''ALT''' to decrease the movement speed, or '''SHIFT''' to increase it.<br />
<br />
By default, elements move relative to the camera and are not locked to any axes. This can be disabled in the ''Options'' menu.<br />
<br />
===Rotating===<br />
'''With the mouse'''<br />
<br />
You can rotate selected elements around the Z axis with the mouse wheel.<br />
* Select the element in keyboard mode ('''left click''') and roll the mouse wheel while holding '''Left CTRL'''.<br />
Or:<br />
* Select the element in mouse mode ('''right click'''), hold '''CTRL''', and roll the mouse wheel.<br />
<br />
'''With the keyboard'''<br />
* Select the element in keyboard mode ('''left click''').<br />
* While holding '''CTRL''' (the selection marker will turn green), use the '''arrow keys''' and '''PgUp'''/'''PgDn''' to rotate the element around the different axes.<br />
<br />
With both methods you can additionally hold '''ALT''' to decrease the rotation speed or '''SHIFT''' to increase it.<br />
<br />
<br />
[[Image:Editor_Rotateelem.png|center]]<br />
<br />
===Changing model and other properties===<br />
Most elements have a variety of options that can be altered to change their appearance and behaviour. Examples are the model, color and visual upgrades of a car.<br />
<br />
* Open the properties window of an element by either double clicking it or by selecting it and pressing '''F3'''.<br />
* Make any alterations that you want. For example, to change the model of a car or object, click the '''Browse''' button next to "model" to open the model browser.<br />
* Click OK when you're done.<br />
<br />
[[Image:Editor_Props.png|center]]<br />
<br />
===Cloning===<br />
You can clone an element by selecting it and pressing '''C'''. <br />
<br />
* In mouse mode the cloned element will be attached to your cursor. '''Left click''' to place it in the map.<br />
* In keyboard mode the cloned element will be cloned in the identical position.<br />
<br />
If you hold '''CTRL''' while clicking, the element will be cloned again and will again be attached to the cursor. This way you can easily place large quantities of something.<br />
<br />
Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to clone an element.<br />
<br />
===Deleting===<br />
Simply select the element and press '''DEL''' ''(Delete)''.<br />
<br />
Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to delete an element.<br />
<br />
==Controls==<br />
Here is a list of all default controls. To change them please go to the MTA Settings menu while the Editor is started.<br />
<br />
===Camera===<br />
{|<br />
|-<br />
| camera_move_forwards<br />
| '''w'''<br />
|-<br />
| camera_move_backwards<br />
| '''s'''<br />
|-<br />
| camera_move_left<br />
| '''a'''<br />
|-<br />
| camera_move_right<br />
| '''d'''<br />
|-<br />
| high_sensitivity_mode<br />
| '''e'''<br />
|}<br />
<br />
===Cloning===<br />
{|<br />
|-<br />
| clone_selected_element<br />
| '''c'''<br />
|-<br />
| clone_drop_modifier<br />
| '''lctrl''' || ''(Left CTRL)''<br />
|}<br />
<br />
===Element manipulation===<br />
{|<br />
|-<br />
| element_move_forward<br />
| '''arrow_u''' || ''(Arrow key Up)''<br />
|-<br />
| element_move_backward<br />
| '''arrow_d''' || ''(Arrow key Down)''<br />
|-<br />
| element_move_left<br />
| '''arrow_l''' || ''(Arrow key Left)''<br />
|-<br />
| element_move_right<br />
| '''arrow_r''' || ''(Arrow key Right)''<br />
|-<br />
| element_move_downwards<br />
| '''pgdn''' || ''(Page Down)''<br />
|-<br />
| element_move_upwards<br />
| '''pgup''' || ''(Page Up)''<br />
|-<br />
| zoom_in<br />
| '''mouse_wheel_down'''<br />
|-<br />
| zoom_out<br />
| '''mouse_wheel_up'''<br />
|-<br />
| quick_rotate_increase<br />
| '''mod_rotate''' + '''mouse_wheel_up''' || ''(Left CTRL + Mouse wheel Up)''<br />
|-<br />
| quick_rotate_decrease<br />
| '''mod_rotate''' + '''mouse_wheel_down''' || ''(Left CTRL + Mouse wheel Down)''<br />
|-<br />
| mod_rotate<br />
| '''lctrl''' || ''(Left CTRL)''<br />
|-<br />
| mod_slow_speed<br />
| '''lalt''' || ''(Left ALT)''<br />
|-<br />
| mod_fast_speed<br />
| '''lshift''' || ''(Left SHIFT)''<br />
|-<br />
| destroy_selected_element<br />
| '''delete'''<br />
|-<br />
| drop_selected_element<br />
| '''space'''<br />
|-<br />
| pickup_selected_element<br />
| '''F2'''<br />
|-<br />
| reset_rotation<br />
| '''mod_rotate''' + '''r''' || ''(Left CTRL + R)''<br />
|}<br />
<br />
===GUI===<br />
{|<br />
| toggle_gui_display<br />
| '''F4'''<br />
|-<br />
| toggle_cursor<br />
| '''f'''<br />
|-<br />
| select_target_keyboard<br />
| '''mouse1''' || ''(Left Mouse button)''<br />
|-<br />
| select_target_mouse<br />
| '''mouse2''' || ''(Right Mouse button)''<br />
|-<br />
| edf_next<br />
| '''mouse_wheel_up'''<br />
|-<br />
| edf_prev<br />
| '''mouse_wheel_down'''<br />
|-<br />
| undo<br />
| '''Ctrl''' + '''z'''<br />
|-<br />
| redo<br />
| '''Ctrl''' + '''y'''<br />
|-<br />
| properties_toggle<br />
| '''F3'''<br />
|-<br />
| browser_up<br />
| '''arrow_u''' || ''(Arrow key Up)''<br />
|-<br />
| browser_down<br />
| '''arrow_d''' || ''(Arrow key Down)''<br />
|-<br />
| browser_zoom_in<br />
| '''mouse_wheel_up'''<br />
|-<br />
| browser_zoom_out<br />
| '''mouse_wheel_down'''<br />
|-<br />
| browser_confirm<br />
| '''enter'''<br />
|-<br />
| currentelements_up<br />
| '''num_8''' || ''(Numpad key 8)''<br />
|-<br />
| currentelements_down<br />
| '''num_2''' || ''(Numpad key 2)''<br />
|-<br />
| toggle_test<br />
| '''F5'''<br />
|}<br />
<br />
==Multiplayer==<br />
The editor is built with both serverside and clientside components, and therefore supports multiplayer out of the box. To use the editor in multiplayer with other players, simply copy all of the editor's resources into your server, start the '''editor''' resource and allow other players to join.<br />
<br />
Please note that currently the editor lacks any permissions system, ao all users have access to every function.<br />
<br />
==Plugins & External resources==<br />
{{Main|Resource:Editor/Plugins}}<br />
<br />
The editor allows basic importing of elements from external resources. This is useful for resources that may have to manipulate an element in a specific way that cannot be performed by the editor. For example, a map resource which uses custom models (and has a script to import these models) cannot be manipulated by default within the editor. <br />
<br />
By using the '''import <resourceName>''' command in console the resource's elements can be imported within the editor.<br />
<br />
==FAQ==<br />
==== I get an "Could not start the local server. See console for details" when using the "Map Editor" button====<br />
This is because you do not have a valid editor.conf installed. You can download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.<br />
<br />
==== I have saved a map but cannot find it in my server's resources directory, despite the Editor itself being able to see it ====<br />
This is due to the fact that Vista limits write-access for non-admin processes in Program Files directory. Files get written in the "VirtualStore" dir instead of real Program Files folder. You should be able to locate your map resource in a similar directory to:<br />
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\<br />
<br />
Running the Server/MTA San Andreas with Administrative rights will allow the map to be saved to the proper location.<br />
<br />
==== I have found a bug or have a suggestion/feedback for the map editor ====<br />
Please use the official [http://bugs.mtasa.com bugtracker] for reporting bugs. Feel free to also join us on [http://mtasa.com/irc.html IRC].<br />
<br />
|-<br />
| colspan="2" |<br />
|}<br />
[[ru:Resource:Editor]]</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=Resource:Editor&diff=18997Resource:Editor2009-04-11T16:35:05Z<p>Lil Toady: </p>
<hr />
<div>{{Resource page}}<br />
The MTA:SA map editor allows you to create maps for gamemodes.<br />
<br />
==Starting==<br />
To start the editor, simply click the "Map editor" menu item in the main MTA menu.<br />
<br />
==Menus==<br />
Once the editor has started, you are presented with two menu bars: the main menu at the top, and the element menu in the lower left.<br />
<br />
===Main menu===<br />
These are the buttons in the main menu:<br />
* [[Image:Editor_New.png]] Create a new map.<br />
* [[Image:Editor_Open.png]] Open an existing map.<br />
* [[Image:Editor_Save.png]] Save the map you're working on.<br />
* [[Image:Editor_Save_as.png]] Save your map under a different name.<br />
* [[Image:Editor_Options.png]] Alter general map editor settings.<br />
* [[Image:Editor_Undo.png]] Undo the last action.<br />
* [[Image:Editor_Redo.png]] Restore the last undone action.<br />
* [[Image:Editor_Locations.png]] Stored game world locations. The editor comes with a great list of San Andreas Interior locations but you can also add your own interior and non-interior locations to the list.<br />
* [[Image:Editor_Current_elements.png]] List all the elements the map contains (objects, vehicles, markers, pickups etc.)<br />
* [[Image:Editor_Map_settings.png]] Map specific settings, like time of day, gravity etc. Here you can also specify what gamemodes the map is compatible with.<br />
* [[Image:Editor_Definitions.png]] Load [[Resource:Editor/EDF|editor definition files (EDF)]] that you want to use. <br />
* [[Image:Editor_Test.png]] Go into play mode to try out the map. This will load up the gamemode the map is made for.<br />
<br />
===Element menu===<br />
The element menu is used to add new elements to the map.<br />
* [[Image:Editor_Vehicle.png]] Create a new vehicle.<br />
* [[Image:Editor_Object.png]] Create a new object (buildings, roads and other scenery).<br />
* [[Image:Editor_Pickup.png]] Create a new pickup (health, armor, weapons).<br />
* [[Image:Editor_Marker.png]] Create a new marker.<br />
<br />
Additionally, if you have [[Resource:Editor/EDF|editor definitions loaded]], you can roll the mousewheel in this menu to bring up custom elements.<br />
<br />
==Using the editor==<br />
This section explains how to create and modify maps.<br />
<br />
===Moving around the map===<br />
When you initially start the editor, you are in ''camera mode''. You are able to use the '''WSAD''' keys to move the camera and the mouse to pan the camera. While moving around, you can hold '''ALT''' to move more slowly or '''SHIFT''' to go faster.<br />
<br />
To access the editor's interface and control panel you need to switch to ''cursor mode''. You can toggle between cursor mode and camera mode with the '''F''' key. When in cursor mode, your view is fixed, and you can use the mouse cursor to manipulate elements and use the graphical interface.<br />
<br />
Camera mode can be recognized by a crosshair in the center of the screen. You can use it to select and move elements just like in cursor mode.<br />
<br />
[[Image:Editor_Crosshair.png|center]]<br />
<br />
===Starting a new map===<br />
* Start the editor, or if it is already started, click the ''New'' menu button.<br />
* Click the ''Map settings'' button. In the ''Meta'' tab, fill in the Name and Author fields with the name of the map and your name respectively. Also open the ''Gamemodes'' tab and add the gamemodes your map is meant for (they will be moved to the ''Added gamemodes'' list). You can do this by selecting them and clicking ''Add'', or by double clicking them. Click OK when you're done.<br />
[[Image:Editor_Mapsettings.png|center]]<br />
* Click the ''Definitions'' window and add the resources of which you want to use the custom elements. These will consist of the gamemodes you selected in the ''Map settings'' window, plus eventual additional resources. For more information about editor definitions, see [[Resource:Editor/EDF|EDF]]. Click OK when you're done.<br />
<br />
===Creating new elements===<br />
Adding elements to your map, such as vehicles and objects, is very straightforward.<br />
* If you are in camera mode, switch to cursor mode first by pressing '''F'''.<br />
* Click the button in the element menu that represents what you want. E.g., click the button with a car on it to add a vehicle.<br />
* A new element of the selected type will be created and attached to your cursor. Move it to the location where you want it and '''left click''' to drop it off.<br />
<br />
<br />
[[Image:Editor_Addelem.png|center]]<br />
<br />
<br />
To create custom elements that are specific to a resource, hover the cursor over the element menu and turn the scroll wheel until the desired resource comes up. Note that for this to work, you first have to add the [[Resource:Editor/EDF|EDF]] file of the resource in the ''Definitions'' window.<br />
<br />
[[Image:Editor_Selectedf.png|center]]<br />
<br />
===Selecting===<br />
* '''Left click''' an element to select it in ''keyboard mode''.<br />
* '''Right click''' it to select it in ''mouse mode''.<br />
* Press the '''Spacebar''' or click in an empty area to deselect.<br />
<br />
The selected element, if any, is denoted by a yellow cone marker. Elements (particularly objects) with poor collisions can be detected easier by enabling ''High sensitivity mode'', by pressing the '''E''' key. This increases detection at the expense of accuracy.<br />
<br />
The ''Current elements'' dialog can also be used to select elements. Double-clicking an item within the list will select it in ''Keyboard mode''.<br />
<br />
===Moving===<br />
Moving elements can be done in several ways.<br />
<br />
'''With the mouse'''<br />
* Simply drag and drop with the '''left mouse button'''.<br />
Or:<br />
* Select the element in mouse mode ('''right click'''), move it to where you want it, and click to drop it off.<br />
<br />
You can also adjust the ''Hold distance'' of an element toward and away from the camera by switching to camera mode, '''right clicking''' the element, and rolling the '''mouse wheel'''.<br />
<br />
'''With the keyboard'''<br />
* Select the element in keyboard mode ('''left click''').<br />
* Use the '''arrow keys''' to move the element in the horizontal plane, and '''PgUp'''/'''PgDn''' to move it vertically. Hold '''ALT''' to decrease the movement speed, or '''SHIFT''' to increase it.<br />
<br />
By default, elements move relative to the camera and are not locked to any axes. This can be disabled in the ''Options'' menu.<br />
<br />
===Rotating===<br />
'''With the mouse'''<br />
<br />
You can rotate selected elements around the Z axis with the mouse wheel.<br />
* Select the element in keyboard mode ('''left click''') and roll the mouse wheel while holding '''Left CTRL'''.<br />
Or:<br />
* Select the element in mouse mode ('''right click'''), hold '''CTRL''', and roll the mouse wheel.<br />
<br />
'''With the keyboard'''<br />
* Select the element in keyboard mode ('''left click''').<br />
* While holding '''CTRL''' (the selection marker will turn green), use the '''arrow keys''' and '''PgUp'''/'''PgDn''' to rotate the element around the different axes.<br />
<br />
With both methods you can additionally hold '''ALT''' to decrease the rotation speed or '''SHIFT''' to increase it.<br />
<br />
<br />
[[Image:Editor_Rotateelem.png|center]]<br />
<br />
===Changing model and other properties===<br />
Most elements have a variety of options that can be altered to change their appearance and behaviour. Examples are the model, color and visual upgrades of a car.<br />
<br />
* Open the properties window of an element by either double clicking it or by selecting it and pressing '''F3'''.<br />
* Make any alterations that you want. For example, to change the model of a car or object, click the '''Browse''' button next to "model" to open the model browser.<br />
* Click OK when you're done.<br />
<br />
[[Image:Editor_Props.png|center]]<br />
<br />
===Cloning===<br />
You can clone an element by selecting it and pressing '''C'''. <br />
<br />
* In mouse mode the cloned element will be attached to your cursor. '''Left click''' to place it in the map.<br />
* In keyboard mode the cloned element will be cloned in the identical position.<br />
<br />
If you hold '''CTRL''' while clicking, the element will be cloned again and will again be attached to the cursor. This way you can easily place large quantities of something.<br />
<br />
Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to clone an element.<br />
<br />
===Deleting===<br />
Simply select the element and press '''DEL''' ''(Delete)''.<br />
<br />
Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to delete an element.<br />
<br />
==Controls==<br />
Here is a list of all default controls. To change them please go to the MTA Settings menu while the Editor is started.<br />
<br />
===Camera===<br />
{|<br />
|-<br />
| camera_move_forwards<br />
| '''w'''<br />
|-<br />
| camera_move_backwards<br />
| '''s'''<br />
|-<br />
| camera_move_left<br />
| '''a'''<br />
|-<br />
| camera_move_right<br />
| '''d'''<br />
|-<br />
| high_sensitivity_mode<br />
| '''e'''<br />
|}<br />
<br />
===Cloning===<br />
{|<br />
|-<br />
| clone_selected_element<br />
| '''c'''<br />
|-<br />
| clone_drop_modifier<br />
| '''lctrl''' || ''(Left CTRL)''<br />
|}<br />
<br />
===Element manipulation===<br />
{|<br />
|-<br />
| element_move_forward<br />
| '''arrow_u''' || ''(Arrow key Up)''<br />
|-<br />
| element_move_backward<br />
| '''arrow_d''' || ''(Arrow key Down)''<br />
|-<br />
| element_move_left<br />
| '''arrow_l''' || ''(Arrow key Left)''<br />
|-<br />
| element_move_right<br />
| '''arrow_r''' || ''(Arrow key Right)''<br />
|-<br />
| element_move_downwards<br />
| '''pgdn''' || ''(Page Down)''<br />
|-<br />
| element_move_upwards<br />
| '''pgup''' || ''(Page Up)''<br />
|-<br />
| zoom_in<br />
| '''mouse_wheel_down'''<br />
|-<br />
| zoom_out<br />
| '''mouse_wheel_up'''<br />
|-<br />
| quick_rotate_increase<br />
| '''mod_rotate''' + '''mouse_wheel_up''' || ''(Left CTRL + Mouse wheel Up)''<br />
|-<br />
| quick_rotate_decrease<br />
| '''mod_rotate''' + '''mouse_wheel_down''' || ''(Left CTRL + Mouse wheel Down)''<br />
|-<br />
| mod_rotate<br />
| '''lctrl''' || ''(Left CTRL)''<br />
|-<br />
| mod_slow_speed<br />
| '''lalt''' || ''(Left ALT)''<br />
|-<br />
| mod_fast_speed<br />
| '''lshift''' || ''(Left SHIFT)''<br />
|-<br />
| destroy_selected_element<br />
| '''delete'''<br />
|-<br />
| drop_selected_element<br />
| '''space'''<br />
|-<br />
| pickup_selected_element<br />
| '''F2'''<br />
|-<br />
| reset_rotation<br />
| '''mod_rotate''' + '''r''' || ''(Left CTRL + R)''<br />
|}<br />
<br />
===GUI===<br />
{|<br />
| toggle_gui_display<br />
| '''F4'''<br />
|-<br />
| toggle_cursor<br />
| '''f'''<br />
|-<br />
| select_target_keyboard<br />
| '''mouse1''' || ''(Left Mouse button)''<br />
|-<br />
| select_target_mouse<br />
| '''mouse2''' || ''(Right Mouse button)''<br />
|-<br />
| edf_next<br />
| '''mouse_wheel_up'''<br />
|-<br />
| edf_prev<br />
| '''mouse_wheel_down'''<br />
|-<br />
| undo<br />
| '''Ctrl''' + '''z'''<br />
|-<br />
| redo<br />
| '''Ctrl''' + '''y'''<br />
|-<br />
| properties_toggle<br />
| '''F3'''<br />
|-<br />
| browser_up<br />
| '''arrow_u''' || ''(Arrow key Up)''<br />
|-<br />
| browser_down<br />
| '''arrow_d''' || ''(Arrow key Down)''<br />
|-<br />
| browser_zoom_in<br />
| '''mouse_wheel_up'''<br />
|-<br />
| browser_zoom_out<br />
| '''mouse_wheel_down'''<br />
|-<br />
| browser_confirm<br />
| '''enter'''<br />
|-<br />
| currentelements_up<br />
| '''num_8''' || ''(Numpad key 8)''<br />
|-<br />
| currentelements_down<br />
| '''num_2''' || ''(Numpad key 2)''<br />
|-<br />
| toggle_test<br />
| '''F5'''<br />
|}<br />
<br />
==Multiplayer==<br />
The editor is built with both serverside and clientside components, and therefore supports multiplayer out of the box. To use the editor in multiplayer with other players, simply copy all of the editor's resources into your server, start the '''editor''' resource and allow other players to join.<br />
<br />
Please note that currently the editor lacks any permissions system, ao all users have access to every function.<br />
<br />
==Plugins & External resources==<br />
{{Main|Resource:Editor/Plugins}}<br />
<br />
The editor allows basic importing of elements from external resources. This is useful for resources that may have to manipulate an element in a specific way that cannot be performed by the editor. For example, a map resource which uses custom models (and has a script to import these models) cannot be manipulated by default within the editor. <br />
<br />
By using the '''import <resourceName>''' command in console the resource's elements can be imported within the editor.<br />
<br />
==FAQ==<br />
==== I get an "Could not start the local server. See console for details" when using the "Map Editor" button====<br />
This is because you do not have a valid editor.conf installed. You can download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.<br />
<br />
==== I have saved a map but cannot find it in my server's resources directory, despite the Editor itself being able to see it ====<br />
This is due to the fact that Vista limits write-access for non-admin processes in Program Files directory. Files get written in the "VirtualStore" dir instead of real Program Files folder. You should be able to locate your map resource in a similar directory to:<br />
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\<br />
<br />
Running the Server/MTA San Andreas with Administrative rights will allow the map to be saved to the proper location.<br />
<br />
==== I have found a bug or have a suggestion/feedback for the map editor ====<br />
Please use the official [http://bugs.mtasa.com bugtracker] for reporting bugs. Feel free to also join us on [http://mtasa.com/irc.html IRC].<br />
<br />
|-<br />
| colspan="2" |<br />
|}<br />
[[ru:Main Page]]</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=AddBan&diff=18280AddBan2009-01-24T20:56:36Z<p>Lil Toady: </p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function will add a ban for the specified IP/username/serial to the server.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason ] ) <br />
</syntaxhighlight><br />
'''Note:''' One of the three: IP, Username or Serial have to be specified.<br />
<br />
===Required Arguments=== <br />
*'''IP:''' The IP to be banned. If you don't want to ban by IP, set this to ''nil''.<br />
*'''Username:''' The username to be banned. If you don't want to ban by username, set this to ''nil''.<br />
*'''Serial:''' The serial to be banned. If you don't want to ban by serial, set this to ''nil''.<br />
<br />
===Optional Arguments=== <br />
{{OptionalArg}} <br />
*'''responsibleElement:''' The element that is responsible for banning the IP/username/serial. This can be a player or the root ([[getRootElement]]()).<br />
*'''reason:''' The reason the IP/username/serial will be banned from the server.<br />
<br />
===Returns===<br />
Returns ''true'' if the IP/username/serial was banned succesfully, ''false'' if invalid arguments are specified.<br />
<br />
==Example==<br />
<syntaxhighlight lang="lua"><br />
--TODO<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Admin functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=AddBan&diff=18279AddBan2009-01-24T20:56:23Z<p>Lil Toady: </p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function will add a ban for the specified IP/username/serial to the server.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
[[ban]] addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason ] ) <br />
</syntaxhighlight><br />
'''Note:''' One of the three: IP, Username or Serial have to be specified.<br />
<br />
===Required Arguments=== <br />
*'''IP:''' The IP to be banned. If you don't want to ban by IP, set this to ''nil''.<br />
*'''Username:''' The username to be banned. If you don't want to ban by username, set this to ''nil''.<br />
*'''Serial:''' The serial to be banned. If you don't want to ban by serial, set this to ''nil''.<br />
<br />
===Optional Arguments=== <br />
{{OptionalArg}} <br />
*'''responsibleElement:''' The element that is responsible for banning the IP/username/serial. This can be a player or the root ([[getRootElement]]()).<br />
*'''reason:''' The reason the IP/username/serial will be banned from the server.<br />
<br />
===Returns===<br />
Returns ''true'' if the IP/username/serial was banned succesfully, ''false'' if invalid arguments are specified.<br />
<br />
==Example==<br />
<syntaxhighlight lang="lua"><br />
--TODO<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Admin functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=AddBan&diff=18278AddBan2009-01-24T20:53:18Z<p>Lil Toady: </p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function will add a ban for the specified IP/username/serial to the server.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason ] ) <br />
</syntaxhighlight><br />
'''Note:''' One of the three: IP, Username or Serial have to be specified.<br />
<br />
===Required Arguments=== <br />
*'''IP:''' The IP to be banned. If you don't want to ban by IP, set this to ''nil''.<br />
*'''Username:''' The username to be banned. If you don't want to ban by username, set this to ''nil''.<br />
*'''Serial:''' The serial to be banned. If you don't want to ban by serial, set this to ''nil''.<br />
<br />
===Optional Arguments=== <br />
{{OptionalArg}} <br />
*'''responsibleElement:''' The element that is responsible for banning the IP/username/serial. This can be a player or the root ([[getRootElement]]()).<br />
*'''reason:''' The reason the IP/username/serial will be banned from the server.<br />
<br />
===Returns===<br />
Returns ''true'' if the IP/username/serial was banned succesfully, ''false'' if invalid arguments are specified.<br />
<br />
==Example==<br />
<syntaxhighlight lang="lua"><br />
--TODO<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Admin functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=AddBan&diff=18277AddBan2009-01-24T20:52:09Z<p>Lil Toady: </p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function will add a ban for the specified IP/username/serial to the server.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason ] ) <br />
</syntaxhighlight><br />
'''Note''': One of the three: IP, Username or Serial have to be specified.<br />
<br />
===Required Arguments=== <br />
*'''IP:''' The IP to be banned. If you don't want to ban by IP, set this to ''nil''.<br />
*'''Username:''' The username to be banned. If you don't want to ban by username, set this to ''nil''.<br />
*'''Serial:''' The serial to be banned. If you don't want to ban by serial, set this to ''nil''.<br />
<br />
===Optional Arguments=== <br />
{{OptionalArg}} <br />
*'''responsibleElement:''' The element that is responsible for banning the IP/username/serial. This can be a player or the root ([[getRootElement]]()).<br />
*'''reason:''' The reason the IP/username/serial will be banned from the server.<br />
<br />
===Returns===<br />
Returns ''true'' if the IP/username/serial was banned succesfully, ''false'' if invalid arguments are specified.<br />
<br />
==Example==<br />
<syntaxhighlight lang="lua"><br />
--TODO<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Admin functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=AddBan&diff=18276AddBan2009-01-24T20:51:45Z<p>Lil Toady: </p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function will add a ban for the specified IP/username/serial to the server.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason ] ) <br />
</syntaxhighlight><br />
''Note'': One of the three: IP, Username or Serial have to be specified.<br />
<br />
===Required Arguments=== <br />
*'''IP:''' The IP to be banned. If you don't want to ban by IP, set this to ''nil''.<br />
*'''Username:''' The username to be banned. If you don't want to ban by username, set this to ''nil''.<br />
*'''Serial:''' The serial to be banned. If you don't want to ban by serial, set this to ''nil''.<br />
<br />
===Optional Arguments=== <br />
{{OptionalArg}} <br />
*'''responsibleElement:''' The element that is responsible for banning the IP/username/serial. This can be a player or the root ([[getRootElement]]()).<br />
*'''reason:''' The reason the IP/username/serial will be banned from the server.<br />
<br />
===Returns===<br />
Returns ''true'' if the IP/username/serial was banned succesfully, ''false'' if invalid arguments are specified.<br />
<br />
==Example==<br />
<syntaxhighlight lang="lua"><br />
--TODO<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Admin functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=AddBan&diff=18275AddBan2009-01-24T20:51:03Z<p>Lil Toady: </p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function will add a ban for the specified IP/username/serial to the server.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason ] ) <br />
</syntaxhighlight><br />
'Note': One of the three: IP, Username or Serial have to be specified.<br />
<br />
===Required Arguments=== <br />
*'''IP:''' The IP to be banned. If you don't want to ban by IP, set this to ''nil''.<br />
*'''Username:''' The username to be banned. If you don't want to ban by username, set this to ''nil''.<br />
*'''Serial:''' The serial to be banned. If you don't want to ban by serial, set this to ''nil''.<br />
<br />
===Optional Arguments=== <br />
{{OptionalArg}} <br />
*'''responsibleElement:''' The element that is responsible for banning the IP/username/serial. This can be a player or the root ([[getRootElement]]()).<br />
*'''reason:''' The reason the IP/username/serial will be banned from the server.<br />
<br />
===Returns===<br />
Returns ''true'' if the IP/username/serial was banned succesfully, ''false'' if invalid arguments are specified.<br />
<br />
==Example==<br />
<syntaxhighlight lang="lua"><br />
--TODO<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Admin functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=Element/Sound&diff=18045Element/Sound2008-12-28T18:07:23Z<p>Lil Toady: </p>
<hr />
<div>The sound element represents a custom sound sent to the client via the use of the file parameter inside the meta file and created either by [[playSound]] or [[playSound3D]].<br />
<br />
A sound element is created using [[playSound3D]] or [[playSound]] and can be manipulated with the following element functions:.<br />
<br />
* [[setElementPosition]]<br />
* [[setElementDimension]]<br />
<br />
<br />
Sound elements can also be manipulated using the other [[Template:Client audio functions|Client audio functions]].<br />
<br />
<br />
The element type of this class is '''"sound"'''.<br />
<br />
==Related scripting functions==<br />
===Client===<br />
{{Client audio functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=Template:Client_player_events&diff=17714Template:Client player events2008-09-21T14:15:08Z<p>Lil Toady: </p>
<hr />
<div>*[[onClientPlayerJoin]]<br />
*[[onClientPlayerQuit]]<br />
*[[onClientPlayerWeaponFire]]<br />
*[[onClientPlayerWeaponSwitch]]<br />
*[[onClientPlayerTarget]]<br />
*[[onClientPlayerDamage]]<br />
*[[onClientPlayerSpawn]]<br />
*[[onClientPlayerWasted]]<br />
*[[onClientPlayerVehicleEnter]]<br />
*[[onClientPlayerVehicleExit]]<br />
*[[onClientPlayerChangeNick]]<br />
*[[onClientPlayerStuntStart]]<br />
*[[onClientPlayerStuntFinish]]</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=Template:Client_player_events&diff=17651Template:Client player events2008-09-04T20:51:50Z<p>Lil Toady: </p>
<hr />
<div>*[[onClientPlayerJoin]]<br />
*[[onClientPlayerQuit]]<br />
{{New feature|3|DP3|<br />
*[[onPlayerChat]]<br />
}}<br />
*[[onClientPlayerWeaponFire]]<br />
*[[onClientPlayerWeaponSwitch]]<br />
*[[onClientPlayerTarget]]<br />
*[[onClientPlayerDamage]]<br />
*[[onClientPlayerSpawn]]<br />
*[[onClientPlayerWasted]]<br />
*[[onClientPlayerVehicleEnter]]<br />
*[[onClientPlayerVehicleExit]]<br />
*[[onClientPlayerChangeNick]]<br />
*[[onClientPlayerStuntStart]]<br />
*[[onClientPlayerStuntFinish]]</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=Template:Client_other_events&diff=17650Template:Client other events2008-09-04T20:51:16Z<p>Lil Toady: </p>
<hr />
<div>*[[onClientConsole]]<br />
*[[onClientRender]]<br />
{{New feature|3|DP3|<br />
*[[onClientPreRender]]<br />
}}<br />
{{New feature|2|DP2|<br />
*[[onClientExplosion]] (DPv2)<br />
}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=Template:Client_other_events&diff=17649Template:Client other events2008-09-04T20:51:03Z<p>Lil Toady: </p>
<hr />
<div>*[[onClientConsole]]<br />
*[[onClientRender]]<br />
{{New feature|3|DP3|<br />
*[[onClientPreRender]]<br />
*[[onPlayerChat]]<br />
}}<br />
{{New feature|2|DP2|<br />
*[[onClientExplosion]] (DPv2)<br />
}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=SpawnVehicle&diff=17634SpawnVehicle2008-08-24T21:20:57Z<p>Lil Toady: Undo revision 17633 by Lil Toady (Talk)</p>
<hr />
<div>{{Server function}}<br />
__NOTOC__<br />
Spawns a vehicle at any given position and rotation<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
bool spawnVehicle ( vehicle theVehicle, float x, float y, float z, float rx, float ry, float rz )<br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''theVehicle:''' The vehicle you wish to spawn<br />
*'''x:''' The x position you wish to spawn the vehicle at<br />
*'''y:''' The x position you wish to spawn the vehicle at<br />
*'''z:''' The x position you wish to spawn the vehicle at<br />
*'''rx:''' The x rotation you wish to spawn the vehicle at<br />
*'''ry:''' The y rotation you wish to spawn the vehicle at<br />
*'''rz:''' The z rotation you wish to spawn the vehicle at<br />
<br />
===Returns===<br />
Returns ''true'' if the vehicle spawned successfully, ''false'' if the passed argument does not exist or is not a vehicle.<br />
<br />
==Example==<br />
There is no exmple.<br />
<br />
==Related scripting functions==<br />
{{Vehicle functions}}<br />
[[Category:Element Types]]</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=SpawnVehicle&diff=17633SpawnVehicle2008-08-24T21:19:04Z<p>Lil Toady: Undo revision 17632 by Syytuvanaema (Talk)</p>
<hr />
<div>{{Server function}}<br />
__NOTOC__<br />
Spawns a vehicle at any given position and rotation<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
bool spawnVehicle ( vehicle theVehicle, float x, float y, float z, float rx, float ry, float rz )<br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''theVehicle:''' The vehicle you wish to spawn<br />
*'''x:''' The x position you wish to spawn the vehicle at<br />
*'''y:''' The x position you wish to spawn the vehicle at<br />
*'''z:''' The x position you wish to spawn the vehicle at<br />
*'''rx:''' The x rotation you wish to spawn the vehicle at<br />
*'''ry:''' The y rotation you wish to spawn the vehicle at<br />
*'''rz:''' The z rotation you wish to spawn the vehicle at<br />
<br />
===Returns===<br />
Returns ''true'' if the vehicle spawned successfully, ''false'' if the passed argument does not exist or is not a vehicle.<br />
<br />
==Example==<br />
NEEDS CHECKING<br />
<section name="Example: Server" class="server" show="true"><br />
This script spawns a car 5 units to the right of player.<br />
<syntaxhighlight lang="lua"><br />
function spawncar( source, commandName, carid )<br />
if ( isPlayerInVehicle ( source ) == false ) then<br />
local x, y, z = getElementPosition ( source )<br />
local rotZ = getPlayerRotation ( source )<br />
x = x + ( ( math.cos ( math.rad ( rotZ ) ) ) * 5 )<br />
y = y + ( ( math.sin ( math.rad ( rotZ ) ) ) * 5 )<br />
if ( spawnVehicle ( carid, x, y, z, 0, 0, rotZ ) ) then<br />
outputChatBox ( "You spawned a car!", source, 0, 255, 0, true )<br />
else<br />
outputChatBox ( "Failed to spawn a car!", source, 0, 255, 0, true )<br />
end<br />
end<br />
end<br />
addCommandHandler ( "car", spawncar )<br />
</syntaxhighlight><br />
</section><br />
<br />
==Related scripting functions==<br />
{{Vehicle functions}}<br />
[[Category:Element Types]]</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=Known_Issues_-_FAQ&diff=16919Known Issues - FAQ2008-05-29T15:06:45Z<p>Lil Toady: </p>
<hr />
<div>Post here your proposed Q&A, regarding the known problems with MTA:SA DM and their solutions, especially problems we're encountering now, that might be also encountered by users in the final release. You're also welcome to edit them grammar/style wise.<br />
<br />
== Client ==<br />
<br />
=== General ===<br />
==== Does MTASA:DM work with v1.01 or v2.00 of GTA San Andreas? ====<br />
No. Please see [http://forum.mtavc.com/viewtopic.php?t=15151 this forum topic] for instructions on patching the exe<br />
<br />
==== Initial black screen/hanging GTA splash screens ====<br />
* '''MTA shows a permanent black screen or hanging GTA splash screens.'''<br />
<br />
It may be necessary that during/after the logo splash screens in Grand Theft Auto you have to give some input in order to skip the videos correctly. Try to click your left-mouse button a few times, or tapping a few keys.<br />
<br />
* '''MTA shows a permanent black screen after the GTA splash screens (possibly with text in the bottom right corner).'''<br />
<br />
This can be related to a lack of support for DirectX or video card features, on your system, which are needed to run the dynamically rendered menu. This dynamic menu is enabled by default. Try disabling the dynamic menu by downloading the adjusted [http://www.mtasa.com/files/coreconfig.xml coreconfig.xml] file and placing it in our ''GTA San Andreas\MTA'' directory (overwriting any existing files).<br />
<br />
==== Halt after MTA splash screen ====<br />
* '''Nothing happens after the 'Stop playing with yourself' splash screen'''<br />
<br />
If you use nVidia GeForce, try turning off nView Desktop Manager before starting MTA.<br />
<br />
Also try deleting GTA San Andreas settings file ("gta_sa.set") in "Documents\GTA San Andreas User Files" folder<br />
<br />
==== Crash after MTA splash screen ====<br />
* '''MTA crashes after the 'Stop playing with yourself' logo. Both single player and the MTA: Race ran fine before.'''<br />
<br />
Try downloading the latest DirectX Runtime files from [http://www.microsoft.com/downloads/details.aspx?FamilyID=2da43d38-db71-4c1b-bc6a-9b6652cd92a3&DisplayLang=en Microsoft]. Also check in Task Manager, if gta_sa.exe process isn't already running.<br />
<br />
If you run at any substandard resolutions (e.g. 960x720), try to change your resolution to a commonly supported one (e.g. 640×480, 800×600, 1024×768, 1152×864, 1280×1024) by launching Grand Theft Auto: San Andreas in normal mode, setting the new resolution and exiting.<br />
<br />
==== Assertion in CMainMenu.cpp line 106 upon launching MTASA ====<br />
* '''I'm getting an assertion in CMainMenu.cpp (line 106) after I have launched MTASA. I'm able to ignore it, but then game crashes after I try to connect to a server.'''<br />
<br />
This is likely caused by GTASA or MTASA being installed in a path that contains non-ASCII characters (eg. Cyrillic, Polish, Japanese) in it. <br />
<br />
To resolve this, you need to uninstall MTASA and GTASA, then install them in such paths that don't contain such characters.<br />
<br />
==== Controls not working ====<br />
* '''My controls don't seem to work as they should.'''<br />
<br />
Try using the 'copygtacontrols' command in the console.<br />
<br />
==== Incorrect models ====<br />
* '''Woman model's breasts look awkward ingame / I'm seeing odd, spider-like shaped player models.'''<br />
<br />
This is caused by the way GTA handles player stats. To fix this, be sure to set both fat and muscles player stats to 0, when you're changing player skin.<br />
<br />
==== Incorrect drive-by functionality ====<br />
* '''Drivebys arent working as they should'''<br />
<br />
Drivebys are handled by script, and will change depending on the loaded gamemode.<br />
<br />
==== Unsaved settings ====<br />
* '''My MTA setting(s) didn't get saved (...) I crashed.'''<br />
<br />
First, configure the MTA the way you want to, then exit the game and launch it again. Settings should get saved. Alternatively, try removing the coreconfig.xml file, then configure it and quit the game.<br />
<br />
==== Gamepad support ====<br />
* '''MTA doesnt recognise my gamepad'''<br />
<br />
This is a known issue - MTA's keybinds system does not support direct input. As an alternative, [http://xpadder.com/ XPadder] can be used. This emulates joypad buttons as keyboard/mouse so that it can be used in MTA. Please refer to [http://forum.mtasa.com/viewtopic.php?f=87&t=21167 this forum topic] for a brief guide on how to use XPadder.<br />
<br />
==== Sky flickering ====<br />
* '''My screen/sky flickers when weather or sky effects are enabled.<br />
<br />
MTA:SA DM uses a new text rendering system from race, which is much more efficient in terms of FPS. However, this can cause conflicts within the game, particularly with ATI based cards. To fix this, bring up the console with F8, and type the command '''ceguitext 1'''. This reverts the rendering method to that of Race. All glitches should no longer happen, at the cost of lower FPS.<br />
<br />
====Invalid serial number====<br />
This seems to happen randomly to a few people. The best way to fix this is to install without a serial number at all (choose the bottom option on the MTA accounts page of the installer). We'll be looking into fixing this as soon as possible.<br />
<br />
You can also try to login into your account on [http://mtabeta.com/ www.mtabeta.com], there you can read your serial number. Then open "<br />
HKEY_LOCAL_MACHINE/SOFTWARE/Multi Theft Auto: San Andreas/" in your registry. There you have to create the string "Username" with your username as value, and the string "Serial" with your serial number as value.<br />
<br />
==== 'Network module could not be located' ====<br />
*'''I am getting 'Network module could not be located' error message upon launching MTA:SA DM<br />
<br />
Copy the file 'net.dll' from your GTA:SA/mta directory into your GTA:SA directory, overwriting existing files.<br />
<br />
=== Windows Vista®-related ===<br />
<br />
==== Crash on launch ====<br />
* '''I've successfully upgraded from MTA Race to MTASA DM on Vista, but it seems to crash on launch.<br />
<br />
Go to your Program Files\MTA San Andreas\mods\race directory, and rename client.dll to something else. <br />
<br />
==== Crash on connect ====<br />
* '''I seem to crash whenever I connect to a server just before I go in-game on Vista'''<br />
<br />
This seems to be an issue with the Microsoft DirectX April 2006 SDK Redistributable DLL file (d3dx9_30.dll) when running in compatibility mode. Please make sure that compatibility mode is competely turned off for '''both''' your GTA_SA.exe and Multi Theft Auto.exe executables.<br />
<br />
==== Invalid or disabled serial error ====<br />
* '''MTASA DM installer complains about wrong serial provided. I'm running it for the first time.<br />
<br />
You need to run the installer with Administrator privileges. To do so, right click on the installer executable, choose 'Properties', go into 'Compatibility' tab and tick the check box on the last field.<br />
<br />
Some have found that setting compatibility to Windows XP/2000 have fixed the problem.<br />
<br />
If User Account Control is disabled, you might need to enable it and run the installer with admin privileges (like said above) in order to install MTA:SA DM.<br />
<br />
*'''I am getting 'invalid serial' when I try to connect to a server'''<br />
After some research we have found that in most cases this problem occurs if registry data has not been set for some reason. To fix this problem, take the following steps:<br />
<br />
Open regedit (start > run > regedit)<br><br />
Go to HKEY_LOCAL_MACHINE\SOFTWARE\Multi Theft Auto: San Andreas<br><br />
Create a new string key called Username and fill there the username you have on mtabeta.com<br><br />
Create one more string key called Serial and paste there the serial from mtabeta.com<br><br />
<br />
If you have no serial at http://community.mtasa.com (mtabeta.com) to complete the last step, register on our forums and request one [http://forum.mtasa.com/viewtopic.php?f=89&t=21435&p=269057 here]<br />
<br />
*'''I am getting 'disabled serial' when I try to connect to a server'''<br />
If you receive this message, your serial has been banned (most likely for cheating). There is nothing you can do to fix this. Registering a new account does not unban you.<br />
<br />
==== Clock manipulation error ====<br />
* '''I am getting 'Clock manipulation detected!' error message upon launching MTA:SA DM<br />
<br />
Further info coming soon.<br />
<br />
==== Halt on launch ====<br />
* '''When I launch MTA:SA DM, nothing happens (GTA_SA.exe is running but not loading up)<br />
<br />
Run MTA:SA DM with Administrator privileges. To do this, right click on the installer executable, choose 'Properties', go into 'Compatibility' tab and tick the check box on the last field and try again.<br />
<br />
==== General GTA problems ====<br />
* '''I have unexplainable GTA problems or crashes'''<br />
<br />
Make sure your computer as well as your GTA install meet the [[Deathmatch_Client_Manual#System_requirements|minimum requirements]] and that you are not running in any 98/2000/XP/2003 compatibility modes.<br />
<br />
Also try the solutions from these pages:<br />
* http://www.gtaforums.com/index.php?showtopic=273549&view=findpost&p=4537502<br />
* http://pullmonkey.com/2007/4/30/how-i-got-gta-san-andreas-to-work-with-a-crappy-os-vista<br />
<br />
== Server ==<br />
<br />
=== General ===<br />
==== Fatal error 3 ====<br />
* '''I'm getting ''Fatal Error 3'' whenever I connect to my server'''<br />
<br />
This error happens when the server you are trying to connect to is unable to provide you the required downloads, because it does not have http downloading enabled. Be sure to set the '''httpdownload''' configuration tag in your configuration to '''1'''.<br />
==== Download error 9: Error downloading requested files ====<br />
* '''I'm getting ''Download Error 9: Error downloading requested files'' whenever I connect to my server'''<br />
<br />
This error happens when the server you are trying to connect to is unable to provide you with a valid link. This results in a 404 (Not found) HTTP error and an error at your end.<br />
<br />
* If you are running the built-in server ('''httpserver''' is set to '''1''' and '''httpdownloadurl''' is empty), make sure that your HTTP server is accessible (you can try to access it by using a browser) for everyone.<br />
<br />
* If you have configured an external web server ('''httpdownloadurl''' is set to your custom URL), make sure that your HTTP is accessible and make sure you have read the [[Deathmatch_Server_Manual#Configuring_an_external_web_server | Configuring an external web server]] guide.<br />
==== Download error 28 ====<br />
Try closing anti-virus or firewall applications. If it then works, try adding an exception to your firewall to allow your http port through.<br />
<br />
=== Windows-related ===<br />
No known reported issues in the version {{Current Version|full}}.<br />
<br />
=== Linux-related ===<br />
====Default nohup creates infinitely big nohup.out====<br />
<br />
Temporary fix, disable the nohup file: 'nohup ./mta_server > /dev/null &'</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=DxDrawText&diff=16840DxDrawText2008-05-24T17:04:43Z<p>Lil Toady: /* Syntax */</p>
<hr />
<div>__NOTOC__ <br />
{{Client function}} <br />
<br />
Draws a string of text on the screen for one frame. In order for the text to stay visible continuously, you need to call this function with the same parameters on each frame update (see [[onClientRender]]).<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua"><br />
bool dxDrawText ( string text, int left, int top [, int right=left, int bottom=top, int color=white, float scale=1, string font="default", string alignX="left", string alignY="top", bool clip=false, bool wordBreak=false, bool postGUI] )<br />
</syntaxhighlight><br />
<br />
===Required Arguments=== <br />
*'''text:''' the text to draw<br />
*'''left:''' the absolute X coordinate of the top left corner of the text<br />
*'''top:''' the absolute Y coordinate of the top left corner of the text<br />
<br />
===Optional Arguments===<br />
*'''right:''' the absolute X coordinate of the right side of the text bounding box. Used for text aligning, clipping and word breaking.<br />
*'''bottom:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.<br />
*'''color:''' the color of the text, a value produced by [[tocolor]].<br />
*'''scale:''' the size of the text.<br />
*'''font:''' the dx font to use.<br />
{{DxFonts}}<br />
*'''alignX:''' horizontal alignment of the text within the bounding box. Can be '''"left"''', '''"center"''' or '''"right"'''.<br />
*'''alignY:''' vertical alignment of the text within the bounding box. Can be '''"top"''', '''"center"''' or '''"bottom"'''.<br />
*'''clip:''' if set to ''true'', the parts of the text that don't fit within the bounding box will be cut off.<br />
*'''wordBreak:''' if set to ''true'', the text will wrap to a new line whenever it reaches the right side of the bounding box. If ''false'', the text will always be completely on one line.<br />
* '''postGUI:''' A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).<br />
<br />
===Returns===<br />
Returns ''true'' if successful, ''false'' otherwise.<br />
<br />
==Example== <br />
<section name="Client" class="client" show="true"><br />
This example code will add Zone Names in the lower left corner of player's screens.<br />
<syntaxhighlight lang="lua"><br />
local rootElement = getRootElement()<br />
local screenWidth, screenHeight = guiGetScreenSize() -- Get the screen resolution<br />
<br />
<br />
function createText ( )<br />
local playerX, playerY, playerZ = getElementPosition( getLocalPlayer() ) -- Get player's coordinates.<br />
local playerZoneName = getZoneName( playerX, playerY, playerZ ) -- Get name of the player's zone.<br />
<br />
dxDrawText( playerZoneName, 44, screenHeight-41, screenWidth, screenHeight, tocolor ( 0, 0, 0, 255 ), 1.02, "pricedown" ) -- Draw Zone Name text shadow.<br />
dxDrawText( playerZoneName, 44, screenHeight-43, screenWidth, screenHeight, tocolor ( 255, 255, 255, 255 ), 1, "pricedown" ) -- Draw Zone Name text.<br />
end<br />
<br />
<br />
function HandleTheRendering()<br />
addEventHandler("onClientRender",rootElement, createText) -- keep the text visible with onClientRender.<br />
end<br />
addEventHandler("onClientResourceStart",rootElement, HandleTheRendering)<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Drawing_functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=DxDrawText&diff=16839DxDrawText2008-05-24T17:04:18Z<p>Lil Toady: /* Optional Arguments */</p>
<hr />
<div>__NOTOC__ <br />
{{Client function}} <br />
<br />
Draws a string of text on the screen for one frame. In order for the text to stay visible continuously, you need to call this function with the same parameters on each frame update (see [[onClientRender]]).<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua"><br />
bool dxDrawText ( string text, int left, int top [, int right=left, int bottom=top, int color=white, float scale=1, string font="default", string alignX="left", string alignY="top", bool clip=false, bool wordBreak=false] )<br />
</syntaxhighlight><br />
<br />
===Required Arguments=== <br />
*'''text:''' the text to draw<br />
*'''left:''' the absolute X coordinate of the top left corner of the text<br />
*'''top:''' the absolute Y coordinate of the top left corner of the text<br />
<br />
===Optional Arguments===<br />
*'''right:''' the absolute X coordinate of the right side of the text bounding box. Used for text aligning, clipping and word breaking.<br />
*'''bottom:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.<br />
*'''color:''' the color of the text, a value produced by [[tocolor]].<br />
*'''scale:''' the size of the text.<br />
*'''font:''' the dx font to use.<br />
{{DxFonts}}<br />
*'''alignX:''' horizontal alignment of the text within the bounding box. Can be '''"left"''', '''"center"''' or '''"right"'''.<br />
*'''alignY:''' vertical alignment of the text within the bounding box. Can be '''"top"''', '''"center"''' or '''"bottom"'''.<br />
*'''clip:''' if set to ''true'', the parts of the text that don't fit within the bounding box will be cut off.<br />
*'''wordBreak:''' if set to ''true'', the text will wrap to a new line whenever it reaches the right side of the bounding box. If ''false'', the text will always be completely on one line.<br />
* '''postGUI:''' A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).<br />
<br />
===Returns===<br />
Returns ''true'' if successful, ''false'' otherwise.<br />
<br />
==Example== <br />
<section name="Client" class="client" show="true"><br />
This example code will add Zone Names in the lower left corner of player's screens.<br />
<syntaxhighlight lang="lua"><br />
local rootElement = getRootElement()<br />
local screenWidth, screenHeight = guiGetScreenSize() -- Get the screen resolution<br />
<br />
<br />
function createText ( )<br />
local playerX, playerY, playerZ = getElementPosition( getLocalPlayer() ) -- Get player's coordinates.<br />
local playerZoneName = getZoneName( playerX, playerY, playerZ ) -- Get name of the player's zone.<br />
<br />
dxDrawText( playerZoneName, 44, screenHeight-41, screenWidth, screenHeight, tocolor ( 0, 0, 0, 255 ), 1.02, "pricedown" ) -- Draw Zone Name text shadow.<br />
dxDrawText( playerZoneName, 44, screenHeight-43, screenWidth, screenHeight, tocolor ( 255, 255, 255, 255 ), 1, "pricedown" ) -- Draw Zone Name text.<br />
end<br />
<br />
<br />
function HandleTheRendering()<br />
addEventHandler("onClientRender",rootElement, createText) -- keep the text visible with onClientRender.<br />
end<br />
addEventHandler("onClientResourceStart",rootElement, HandleTheRendering)<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Drawing_functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=DxDrawRectangle&diff=16836DxDrawRectangle2008-05-24T13:44:24Z<p>Lil Toady: /* Syntax */</p>
<hr />
<div>__NOTOC__ <br />
{{Client function}} <br />
This function draws a 2D rectangle across the screen - rendered for '''one''' frame. This should be used in conjunction with [[onClientRender]] in order to display continuously. <br />
<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua"><br />
bool dxDrawRectangle ( int startX, startY, float width, float height [, int color = white, bool postGUI = false] )<br />
</syntaxhighlight><br />
<br />
===Required Arguments=== <br />
* '''startX:''' An integer representing the '''absolute''' origin X position of the rectangle, represented by pixels on the screen.<br />
* '''startY:''' An integer representing the '''absolute''' origin Y position of the rectangle, represented by pixels on the screen.<br />
* '''width:''' An float representing the width of the rectangle, drawn in a ''right'' direction from the origin.<br />
* '''height:''' An float representing the height of the rectangle, drawn in a ''downwards'' direction from the origin.<br />
<br />
===Optional Arguments===<br />
*'''color:''' the color of the rectangle.<br />
* '''postGUI:''' A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).<br />
<br />
===Returns===<br />
Returns a true if the operation was successful, false otherwise.<br />
<br />
==Example== <br />
<section name="Client" class="client" show="true"><br />
Example of MOTD (message of the day), made using DxText, Line and Rectangle.<br />
<syntaxhighlight lang="lua"><br />
local rootElement = getRootElement()<br />
local x,y = guiGetScreenSize() -- Get players resolution.<br />
local playerName = getPlayerName ( getLocalPlayer() ) -- Get players name.<br />
local MOTDText = "Welcome to our server, this is a test MOTD script for MTA's Wiki." -- Example of MOTD message.<br />
<br />
<br />
function create2DRectangle ( )<br />
dxDrawRectangle ( x/2/2, y/2/2, x/2+40, y/2+40, tocolor ( 0, 0, 0, 150 ) ) -- Create our black MOTD background Rectangle.<br />
<br />
dxDrawText( "Welcome " .. playerName, x/2/2+41, y/2/2+32, x, y, tocolor ( 0, 0, 0, 255 ), 1.01, "pricedown" ) -- Create Welcome title shadow.<br />
dxDrawText( "Welcome " .. playerName, x/2/2+40, y/2/2+30, x, y, tocolor ( 255, 255, 255, 255 ), 1, "pricedown" ) -- Create Welcome title.<br />
dxDrawLine ( x/2/2+20, y/2/2+57, x/2/2+y/2+332, y/2/2+57, tocolor ( 0, 0, 0, 255 ), 3 ) -- Create underline shadow for title.<br />
dxDrawLine ( x/2/2+20, y/2/2+55, x/2/2+y/2+330, y/2/2+55, tocolor ( 255, 255, 255, 255 ), 2 ) -- Create underline for title.<br />
dxDrawText( MOTDText, x/2/2+40, y/2/2+80, x, y, tocolor ( 255, 255, 255, 255 ), 1, "clear" ) -- Create MOTD text.<br />
end<br />
<br />
<br />
function HandleTheRendering()<br />
addEventHandler("onClientRender",rootElement, create2DRectangle) -- Keep everything visible with onClientRender.<br />
end<br />
addEventHandler("onClientResourceStart",rootElement, HandleTheRendering)<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Drawing_functions}}<br />
[[Category:Needs_Example]]</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=SaveMapData&diff=16833SaveMapData2008-05-24T12:20:18Z<p>Lil Toady: /* Syntax */</p>
<hr />
<div>{{Server function}}<br />
__NOTOC__<br />
This converts a set of elements in the element tree into XML. This is a format that can then be loaded as a map file. Each element represents a single XML node.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua"> bool saveMapData ( xmlnode node, element baseElement [, bool childrenOnly = false ] )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''node''': An existing node that should contain the contents of baseElement<br />
*'''baseElement''': The first element to output to the xml tree. This element and all its children (and their children, etc) will be output.<br />
<br />
===Optional Arguments===<br />
*'''childrenOnly''': Defines if you want to only save children of the specified element.<br />
<br />
===Returns===<br />
<br />
==Example==<br />
Saving your resource's data to an map file (untested)<br />
<syntaxhighlight lang="lua"><br />
local file = xmlCreateFile("saved.map", "map")<br />
if file then<br />
saveMapData ( file, getResourceRootElement(getThisResource()) )<br />
xmlSaveFile ( file )<br />
xmlUnloadFile ( file )<br />
end<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Map functions}}<br />
[[Category:Needs Example]]</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=SaveMapData&diff=16832SaveMapData2008-05-24T12:19:55Z<p>Lil Toady: /* Syntax */</p>
<hr />
<div>{{Server function}}<br />
__NOTOC__<br />
This converts a set of elements in the element tree into XML. This is a format that can then be loaded as a map file. Each element represents a single XML node.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua"> bool saveMapData ( xmlnode node, element baseElement [, bool childrenOnly ] )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''node''': An existing node that should contain the contents of baseElement<br />
*'''baseElement''': The first element to output to the xml tree. This element and all its children (and their children, etc) will be output.<br />
<br />
===Optional Arguments===<br />
*'''childrenOnly''': Defines if you want to only save children of the specified element.<br />
<br />
===Returns===<br />
<br />
==Example==<br />
Saving your resource's data to an map file (untested)<br />
<syntaxhighlight lang="lua"><br />
local file = xmlCreateFile("saved.map", "map")<br />
if file then<br />
saveMapData ( file, getResourceRootElement(getThisResource()) )<br />
xmlSaveFile ( file )<br />
xmlUnloadFile ( file )<br />
end<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Map functions}}<br />
[[Category:Needs Example]]</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=Community_Resources&diff=16570Community Resources2008-04-16T13:46:36Z<p>Lil Toady: /* Example */</p>
<hr />
<div>==Community calls documentation==<br />
using callRemote<br />
<br />
==community.mtasa.com/mta/verify.php==<br />
<br />
'''Calls:'''<br />
<br />
User validation:<br />
<syntaxhighlight lang="lua"><br />
player thePlayer, string Username, string Serial<br />
</syntaxhighlight> <br />
'''Returns:''' an integer, 1 if user is valid, 0 otherwise<br />
<br />
<br />
==community.mtasa.com/mta/groups.php==<br />
<br />
'''Calls:'''<br />
<br />
Info:<br />
<syntaxhighlight lang="lua"><br />
string "info", int groupID<br />
</syntaxhighlight> <br />
'''Returns 5 values:'''<br /><br />
1. Group name<br /><br />
2. Owner username<br /><br />
3. Number of members<br /><br />
4. Public. Integer: 1 if the group is public, 0 otherwise<br /><br />
5. Registration time<br /><br />
<br />
<br />
Members list:<br />
<syntaxhighlight lang="lua"><br />
string "members", int groupID<br />
</syntaxhighlight> <br />
'''Returns:''' a table of usernames in the group<br />
<br />
<br />
==community.mtasa.com/mta/resources.php==<br />
<br />
'''Calls:'''<br />
<br />
Latest resource version:<br />
<syntaxhighlight lang="lua"><br />
string "version", string resourceName<br />
</syntaxhighlight> <br />
'''Returns:''' an integer, resource version. 0 if an error has occured<br />
<br />
<br />
==Example==<br />
<syntaxhighlight lang="lua"><br />
addEventHandler ( "onPlayerJoin", getRootElement(), function()<br />
local username = getPlayerUserName ( source )<br />
local serial = getPlayerSerial ( source )<br />
callRemote ( "http://community.mtasa.com/mta/verify.php", validatePlayer, source, username, serial )<br />
end )<br />
<br />
function validatePlayer ( player, result )<br />
local valid = "invalid"<br />
if ( result == 1 ) then valid = "valid" end<br />
outputChatBox ( getClientName ( player ).."'s username is "..valid )<br />
end<br />
</syntaxhighlight></div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=GetVehicleType&diff=16564GetVehicleType2008-04-14T20:46:30Z<p>Lil Toady: </p>
<hr />
<div>__NOTOC__ <br />
{{Server client function}}<br />
This function retrieves the vehicle type<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
string getVehicleType ( vehicle theVehicle )<br />
string getVehicleType ( integer modelId )<br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''vehicle:''' The vehicle element or id.<br />
<br />
===Returns===<br />
Returns a ''string'' with vehicle type or ''false'' if an invalid modelID has been supplied, or an empty string if the vehicle is blocked internally (some trailers). Works server- and clientside.<br />
<br />
'''types:'''<br />
Automobile<br /> Plane<br /> Bike<br /> Helicopter<br /> Boat<br /> Train<br /> Trailer<br /> BMX<br /> Monster Truck<br /> Quad<br />
<br />
==Example== <br />
<syntaxhighlight lang="lua"><br />
<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Vehicle functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=GetVehicleType&diff=16563GetVehicleType2008-04-14T20:46:00Z<p>Lil Toady: New page: __NOTOC__ {{Server client function}} This function retrieves the vehicle type ==Syntax== <syntaxhighlight lang="lua"> string getVehicleType (vehicle theVehicle) string getVehicleType (integer modelId)...</p>
<hr />
<div>__NOTOC__ <br />
{{Server client function}}<br />
This function retrieves the vehicle type<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
string getVehicleType (vehicle theVehicle)<br />
string getVehicleType (integer modelId)<br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''vehicle:''' The vehicle element or id.<br />
<br />
===Returns===<br />
Returns a ''string'' with vehicle type or ''false'' if an invalid modelID has been supplied, or an empty string if the vehicle is blocked internally (some trailers). Works server- and clientside.<br />
<br />
Automobile<br /> Plane<br /> Bike<br /> Helicopter<br /> Boat<br /> Train<br /> Trailer<br /> BMX<br /> Monster Truck<br /> Quad<br />
<br />
==Example== <br />
<syntaxhighlight lang="lua"><br />
<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Vehicle functions}}</div>Lil Toadyhttps://wiki.multitheftauto.com/index.php?title=Template:Vehicle_functions&diff=16562Template:Vehicle functions2008-04-14T20:44:12Z<p>Lil Toady: </p>
<hr />
<div>*[[blowVehicle]]<br />
*[[createVehicle]]<br />
*[[fixVehicle]]<br />
*[[spawnVehicle]]<br />
<br />
*[[getVehicleColor]] <br />
*[[getVehicleID]]<br />
*[[getVehicleIDFromName]]<br />
*[[getVehicleMaxPassengers]]<br />
*[[getVehicleName]]<br />
*[[getVehicleOccupant]]<br />
*[[getVehicleController]]<br />
*[[getVehicleRotation]]<br />
*[[getVehicleType]] <br />
*[[getVehicleTurnVelocity]]<br />
*[[getVehicleTurretPosition]]<br />
*[[getVehiclesOfType]]<br />
*[[getVehicleUpgradeOnSlot]]<br />
*[[getVehicleUpgrades]]<br />
*[[getVehicleUpgradeSlotName]]<br />
*[[getVehicleCompatibleUpgrades]]<br />
*[[getVehicleDoorState]]<br />
*[[getVehicleWheelStates]]<br />
*[[getVehicleLightState]]<br />
*[[getVehicleOverrideLights]]<br />
*[[getVehiclePanelState]]<br />
*[[getVehicleTowedByVehicle]]<br />
*[[getVehicleTowingVehicle]]<br />
*[[getVehiclePaintjob]]<br />
*[[getVehicleSirensOn]]<br />
*[[getVehicleLandingGearDown]]<br />
<br />
*[[isVehicleFrozen]]<br />
*[[isVehicleLocked]]<br />
*[[isVehicleFuelTankExplodable]]<br />
*[[isVehicleOnGround]]<br />
<br />
*[[resetVehicleIdleTime]]<br />
*[[resetVehicleExplosionTime]]<br />
<br />
*[[setVehicleColor]]<br />
*[[setVehicleFrozen]]<br />
*[[setVehicleLocked]]<br />
*[[setVehicleModel]]<br />
*[[setVehicleDoorsUndamageable]]<br />
*[[setVehicleRotation]]<br />
*[[setVehicleTurnVelocity]]<br />
*[[addVehicleUpgrade]]<br />
*[[removeVehicleUpgrade]]<br />
*[[setVehicleDoorState]]<br />
*[[setVehicleWheelStates]]<br />
*[[setVehicleLightState]]<br />
*[[toggleVehicleRespawn]]<br />
*[[setVehicleOverrideLights]]<br />
*[[attachTrailerToVehicle]]<br />
*[[detachTrailerFromVehicle]]<br />
*[[setVehiclePaintjob]]<br />
*[[setVehiclePanelState]]<br />
*[[setVehicleEngineState]]<br />
*[[setVehicleFuelTankExplodable]]<br />
*[[setVehicleSirensOn]]<br />
*[[setVehicleGunsEnabled]]<br />
*[[setVehicleLandingGearDown]]<br />
*[[setVehicleDamageProof]]<br />
*[[setVehicleRespawnPosition]]<br />
*[[setVehicleRespawnDelay]]<br />
*[[setVehicleIdleRespawnDelay]]</div>Lil Toady