Multi Theft Auto: Wiki - User contributions [en]

IsResourceArchived

2017-07-05T19:12:49Z

Gothemsh: Fixed build number and added example.

__NOTOC__
{{Server function}}
{{New feature/item|3.0155|1.5.5|11550|
Checks whether a resource is currently archived (running from within a ZIP file).
}}

==Syntax==
<syntaxhighlight lang="lua">bool isResourceArchived ( resource resourceElement )</syntaxhighlight>
{{OOP||[[resource]]:isArchived|archived|}}
===Required Arguments===
*'''resource:''' the resource to check

===Returns===
Returns ''true'' if a resource is archived, ''false'' if it is not archived, or ''nil'' if there is problem with resource.

==Example==

This example stops the resource from loading if it's archived
<syntaxhighlight lang="lua">
function resourceLoading( res )
if res.archived then
cancelEvent()
end

end
addEventHandler('onResourcePreStart',root,resourceLoading,true,'high+10')
</syntaxhighlight>
==See Also==
{{Resource functions}}

GuiComboBoxGetSelected

2015-12-29T23:03:33Z

Gothemsh: Added OOP Syntax

{{Client function}}
__NOTOC__
This function returns the index of the selected combobox item.

==Syntax==
<syntaxhighlight lang="lua">
int guiComboBoxGetSelected ( element comboBox )
</syntaxhighlight>
{{OOP||[[Element/GUI/Combobox|GuiComboBox]]:getSelected|selected|guiComboBoxSetSelected}}

===Required Arguments===
*'''comboBox:''' the combobox you want to know the selected item index of

===Returns===
Returns the index of the selected item if the specified combobox is valid and has a selected item, ''-1'' if no item is selected, ''false'' or ''nil'' otherwise.

==Example==
This example outputs selected item's text and ID to the chat.
<syntaxhighlight lang="lua">
addCommandHandler("getSelected",
function (command)

local item = guiComboBoxGetSelected(comboBox)
local text = guiComboBoxGetItemText(comboBox, item)

outputChatBox("Currently selected item with ID: " .. tostring(item) .. " and with text: " .. text)

end)
</syntaxhighlight>

==See Also==
{{GUI functions}}

GuiGetText

2015-12-29T22:55:57Z

Gothemsh: Added OOP Syntax

{{Client function}}
__NOTOC__

This function is used to get the text of GUI elements like edit boxes, labels, buttons etc.

==Syntax==

<syntaxhighlight lang="lua">
string guiGetText ( element guiElement )
</syntaxhighlight>
{{OOP||[[Element|guiElement]]:getText|text|guiSetText}}

===Required Arguments===

*'''guiElement:''' element you wish to get text of.

===Returns===

Returns a string containing the requested element's text, or false if the gui element passed to the function is invalid.

==Example==

This example gets the text of a pre-made gui element and outputs it to chat box.

<syntaxhighlight lang="lua">
-- We create a dummy gui label to get text of
local dummyGUIElement = guiCreateLabel ( 0.45, 0.48, 0.10, 0.04, "Hello world", true )
-- Output the text of the label to chat box
outputChatBox ( "Text in the GUI label: " .. guiGetText ( dummyGUIElement ) )
</syntaxhighlight>

==See Also==

{{GUI_functions}}

GuiGetSelectedTab

2015-12-29T22:45:07Z

Gothemsh: Added OOP Syntax

{{Client function}}
__NOTOC__
This function returns the currently selected tab in the specified [[Element/GUI/Tab panel|tab panel]].

==Syntax==
<syntaxhighlight lang="lua">
element guiGetSelectedTab ( element tabPanel )
</syntaxhighlight>
{{OOP||[[Element/GUI/Tab panel|GuiTabPanel]]:getSelectedTab|selectedTab|guiSetSelectedTab}}

===Required Arguments===
*'''tabPanel:''' The [[Element/GUI/Tab panel|tab panel]] which current tab you want to retrieve.

===Returns===
Returns an [[element]] of the [[Element/GUI/Tab|tab]] if a tab was selected or [[nil]] if no tab was selected. If passed arguments were invalid or something went wrong, the function will return ''false''.

==Example==
This example gets the current selected tab and sets the selected tab to the next available tab.
<syntaxhighlight lang="lua">
local tabPanel = guiCreateTabPanel ( 0, 0.1, 1, 1, true) --create a tab panel which fills the whole window
local tab1 = guiCreateTab("Welcome",tabPanel) --create a tab for the tab panel above
local tab2 = guiCreateTab("Info",tabPanel)--create another tab for the tab panel at the top

function check()
if(guiGetSelectedTab(tabPanel)==tab1)then --Check what tab is currently shown
guiSetSelectedTab(tabPanel,tab2) --if the "Welcome" tab is selected, change it to tab2("Info" tab)
else
guiSetSelectedTab(tabPanel,tab1) --if the "Info" tab is selected, change it to tab1("Welcome" tab)
end
end
</syntaxhighlight>

==See Also==
{{GUI functions}}

GetPedWeapon

2014-09-18T15:59:20Z

Gothemsh:

__NOTOC__
{{Server client function}}
This function tells you which weapon type is in a certain weapon slot of a ped. See [[weapon|Weapon Info]]

==Syntax==
<syntaxhighlight lang="lua">
int getPedWeapon ( ped thePed, [ int weaponSlot = current ] )
</syntaxhighlight>
{{OOP|This function is also a static function underneath the Ped class.|[[Ped]]:getWeapon|}}

===Required Arguments===
*'''thePed''': the [[ped]] you want to get the weapon type from.

===Optional Arguments===
*'''weaponSlot''': an integer representing the weapon slot (set to the ped's current slot if not given).

===Returns===
Returns an [[int]] indicating the type of the weapon the ped has in the specified slot. If the slot is empty, it returns 0.

It should be noted that if a ped runs out of ammo for a weapon, it will still return the ID of that weapon in the slot (even if it appears as if the ped does not have a weapon at all), though [[getPedTotalAmmo]] will return '''0'''. Therefore, [[getPedTotalAmmo]] should be used in conjunction with [[getPedWeapon]] in order to check if a ped has a weapon.

==Example==
This example will display a player's current weapon type. In this case,a random player.
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
-- Find a player called someguy and find his current weapon id.
local weaponType = getPedWeapon ( getRandomPlayer() )
-- If a weapon type was returned then
if ( weaponType ) then
outputChatBox ( "someguy's current Weapon-type: " .. weaponType .. "." ) -- Display the weapon type in the chat box
end
</syntaxhighlight>
</section>

==See Also==
{{Client_ped_functions}}

GetPedOccupiedVehicle

2014-09-18T15:09:42Z

Gothemsh:

__NOTOC__
{{Server client function}}
This function gets the [[vehicle]] that the ped is currently in or is trying to enter, if any.

==Syntax==
<syntaxhighlight lang="lua">vehicle getPedOccupiedVehicle ( ped thePed )</syntaxhighlight>
{{OOP|This function is also a static function underneath the Ped class.|[[Ped]]:getOccupiedVehicle|vehicle|}}

===Required Arguments===
*'''thePed''': The [[ped]] whose vehicle you're looking up.

===Returns===
Returns the vehicle that the specified ped is in, or ''false'' if the ped is not in a vehicle or is an invalid ped.

==Example==
When a ped enters the 'getcarname' command and is currently in a vehicle, this example outputs the name of the vehicle.
<syntaxhighlight lang="lua">
function showVehicleName ( thePlayer )
local theVehicle = getPedOccupiedVehicle ( thePlayer )
if theVehicle then
outputChatBox ( "Name of the Vehicle: " .. getVehicleName ( theVehicle ), thePlayer )
else
outputChatBox ( "You do not have a Vehicle!", thePlayer, 255, 0, 0, true )
end
end
addCommandHandler ( "getcarname", showVehicleName )
</syntaxhighlight>

==See Also==
{{Client_ped_functions}}

GetAllElementsStartingAt

2012-12-22T21:40:06Z

Gothemsh: Created page with "{{Useful Function}} __NOTOC__ This function can be used to itinerate through a whole tree without having an element type. useful to get all the elements of a custom map.<br> * ''..."

{{Useful Function}}
__NOTOC__
This function can be used to itinerate through a whole tree without having an element type. useful to get all the elements of a custom map.<br>
* '''NOTE:''' This need more testing specially in deeps trees.

==Syntax==
<syntaxhighlight lang="lua">table getAllElementsStartingAt(element theStartingElement )</syntaxhighlight>

===Required Arguments===
* '''theStartingElement''': The element where the itineration will start, searching through all the childrens

==Code==
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
function getAllElementsStartingAt(startElement)
local tabla = {}
for k,v in ipairs(getElementChildren(startElement)) do
table.insert(tabla,v)
local childs = getElementChildren(startElement)
if #childs > 0 then
for q,w in ipairs(getAllElementsStartingAt(v)) do
table.insert(tabla,w)
end
end
end
return tabla
end
</syntaxhighlight>
</section>

==Example==
This example change all the elements of a whole map to the fifth dimension
<syntaxhighlight lang="lua">
for k,v in ipairs(getAllElementsStartingAt(mapRoot)) do
setElementDimension(v,5)
end
</syntaxhighlight>

Author: Gothem

==See Also==
{{Useful_Functions}}

Interior IDs

2012-01-18T05:28:53Z

Gothemsh:

San Andreas Interior ID list.
<br>
<br>
*'''ID 0:'''
{| class="prettytable" style="width:50%;"
|-
| '''Normal world''' ||
|-
|}
<br>
*'''ID 1:'''
{| class="prettytable" style="width:50%;"
|-
| '''Ammu-nation 1''' || 289.7870 || -35.7190 || 1003.5160
|-
| '''Burglary House 1''' || 224.6351 || 1289.012 || 1082.141
|-
| '''The Wellcome Pump (Catalina?)''' || 681.65 || -452.86 || -25.62
|-
| '''Restaurant 1''' || 446.6941 || -9.7977 || 1000.7340
|-
| '''Caligulas Casino''' || 2235.2524 || 1708.5146 || 1010.6129
|-
| '''Denise's Place''' || 244.0892 || 304.8456 || 999.1484
|-
| '''Shamal cabin''' || 1.6127 || 34.7411 || 1199.0
|-
| '''Liberty City''' || -750.80 || 491.00 || 1371.70
|-
| '''Sweet's House''' || 2525.0420 || -1679.1150 || 1015.4990
|-
| '''Transfender''' || 621.7850 || -12.5417 || 1000.9220
|-
| '''Safe House 4''' || 2216.5400 || -1076.2900 || 1050.4840
|-
| '''Trials(Hyman Memorial?) Stadium''' || -1401.13 || 106.110 || 1032.273
|-
| '''Warehouse 1''' || 1405.3120 || -8.2928 || 1000.9130
|-
| '''Doherty Garage''' || -2042.42 || 178.59 || 28.84 ||
|-
| '''Sindacco Abatoir''' || 963.6078 || 2108.3970 || 1011.0300
|-
| '''Sub Urban''' || 203.8173 || -46.5385 || 1001.8050
|-
| '''Wu Zi Mu's Betting place''' || -2159.9260 || 641.4587 || 1052.3820
|-
|}
<br>
*'''ID 2:'''
{| class="prettytable" style="width:50%;"
|-
| '''Ryder's House''' || 2464.2110 || -1697.9520 || 1013.5080
|-
| '''Angel Pine Trailer''' || 0.3440 || -0.5140 || 1000.5490¨
|-
| '''The Pig Pen''' || 1213.4330 ||-6.6830 || 1000.9220
|-
| '''BDups Crack Palace''' || 1523.7510 || -46.0458 || 1002.1310
|-
| '''Big Smoke's Crack Palace''' || 2543.6610 || -1303.9320 || 1025.0700
|-
| '''Burglary House 2''' || 225.756 || 1240.000 || 1082.149
|-
| '''Burglary House 3''' || 447.470 || 1398.348 || 1084.305
|-
| '''Burglary House 4''' || 491.740 || 1400.541 || 1080.265
|-
| '''Katie's Place''' || 267.2290 || 304.7100 || 999.1480
|-
| '''Loco Low Co.''' || 612.5910 || -75.6370 || 997.9920
|-
| '''Reece's Barbershop''' || 612.5910 || -75.6370 || 997.9920
|-
|}

<br>
*'''ID 3:'''
{| class="prettytable" style="width:50%;"
|-
| '''Jizzy's Pleasure Domes''' || -2636.7190 || 1402.9170 || 906.4609
|-
| '''Brothel''' || 940.6520 || -18.4860 || 1000.9300
|-
| '''Brothel 2''' || 967.5334 || -53.0245 || 1001.1250
|-
| '''BDups Apartment''' || 1527.38 || -11.02 || 1002.10
|-
| '''Bike School''' || 1494.3350 || 1305.6510 || 1093.2890
|-
| '''Big Spread Ranch''' || 1210.2570 || -29.2986 || 1000.8790
|-
| '''LV Tattoo Parlour''' || -204.4390 || -43.6520 || 1002.2990
|-
| '''LVPD HQ''' || 289.7703 || 171.7460 || 1007.1790
|-
| '''OG Loc's House''' || 516.8890 || -18.4120 || 1001.5650
|-
| '''Pro-Laps''' || 207.3560 || -138.0029 || 1003.3130
|-
| '''Las Venturas Planning Dep.''' || 374.6708 || 173.8050 || 1008.3893
|-
| '''Record Label Hallway''' || 1038.2190 || 6.9905 || 1001.2840
|-
| '''Driving School''' || -2027.9200 || -105.1830 || 1035.1720
|-
| '''Johnson House''' || 2496.0500 || -1693.9260 || 1014.7420
|-
| '''Budget Inn Motel Room''' ||
|-
| '''Burglary House 5''' || 234.733 || 1190.391 || 1080.258
|-
| '''Gay Gordo's Barbershop''' || 418.6530 || -82.6390 || 1001.8050
|-
| '''Helena's Place''' || 292.4459 || 308.7790 || 999.1484
|-
| '''Inside Track Betting''' || 826.8863 || 5.5091 || 1004.4830
|-
| '''Sex Shop''' || -106.7268 || -19.6444 || 1000.7190
|-
| '''Wheel Arch Angels''' || 614.3889 || -124.0991 || 997.9950
|-
|}

<br>
*'''ID 4:'''
{| class="prettytable" style="width:50%;"
|-
| '''24/7 shop 1''' || -27.3769 || -27.6416 || 1003.5570
|-
| '''Ammu-Nation 2''' || 285.8000 || -84.5470 || 1001.5390
|-
| '''Burglary House 6''' || -262.91 || 1454.966 || 1084.367
|-
| '''Burglary House 7''' || 221.4296 || 1142.423 || 1082.609
|-
| '''Burglary House 8''' || 261.1168 || 1286.519 || 1080.258
|-
| '''Diner 2''' || 460.0 || -88.43 || 999.62
|-
| '''Dirtbike Stadium''' || -1435.8690 || -662.2505 || 1052.4650
|-
| '''Michelle's Place''' || 302.6404 || 304.8048 || 999.1484
|-
|}

<br>
*'''ID 5:'''
{| class="prettytable" style="width:50%;"
|-
| '''Madd Dogg's Mansion''' || 1272.9116 || -768.9028 || 1090.5097
|-
| '''Well Stacked Pizza Co.''' || 377.7758 || -126.2766 || 1001.4920
|-
| '''Victim''' || 221.3310 || -6.6169 || 1005.1977
|-
| '''Burning Desire House''' || 2351.1540 || -1180.5770 || 1027.9770
|-
| '''Barbara's Place''' || (Police Station??)
|-
| '''Burglary House 9''' || 22.79996 || 1404.642 || 1084.43
|-
| '''Burglary House 10''' || 228.9003 || 1114.477 || 1080.992
|-
| '''Burglary House 11''' || 140.5631 || 1369.051 || 1083.864
|-
| '''The Crack Den''' || 322.1117 || 1119.3270 || 1083.8830
|-
| '''Police Station (Barbara's)''' || 322.72 || 306.43 || 999.15
|-
| '''Diner 1''' || 448.7435 || -110.0457 || 1000.0772
|-
| '''Ganton Gym''' || 768.0793 || 5.8606 || 1000.7160
|-
| '''Vank Hoff Hotel ''' || 2232.8210 || -1110.0180 || 1050.8830
|-
|}

<br>
*'''ID 6:'''
{| class="prettytable" style="width:50%;"
|-
| '''Ammu-Nation 3''' || 297.4460 || -109.9680 || 1001.5160
|-
| '''Ammu-Nation 4''' || 317.2380 || -168.0520 || 999.5930
|-
| '''LSPD HQ ''' || 246.4510 || 65.5860 ||1003.6410
|-
| '''Safe House 3''' || 2333.0330 || -1073.9600 || 1049.0230
|-
| '''Safe House 5''' || 2194.2910 || -1204.0150 || 1049.0230
|-
| '''Safe House 6''' || 2308.8710 || -1210.7170 || 1049.0230
|-
| '''Cobra Marital Arts Gym''' || 774.0870 ||-47.9830 || 1000.5860
|-
| '''24/7 shop 2''' || -26.7180 || -55.9860 || 1003.5470
|-
| '''Millie's Bedroom''' || 344.5200 || 304.8210 || 999.1480
|-
| '''Fanny Batter's Brothel''' || 744.2710 || 1437.2530 || 1102.7030
|-
| '''Restaurant 2''' || 443.9810 || -65.2190 || 1050.0000
|-
| '''Burglary House 15''' || 234.319 || 1066.455 || 1084.208
|-
| '''Burglary House 16''' || -69.049 || 1354.056 || 1080.211
|-
|}

<br>
*'''ID 7:'''
{| class="prettytable" style="width:50%;"
|-
| '''Ammu-Nation 5 (2 Floors)''' || 315.3850 || -142.2420 || 999.6010
|-
| '''8-Track Stadium''' || -1417.8720 || -276.4260 || 1051.1910
|-
| '''Below the Belt Gym''' || 774.2430 || -76.0090 || 1000.6540
|-
|}

<br>
*'''ID 8:'''
{| class="prettytable" style="width:50%;"
|-
| '''Safe house 2''' ||
|-
| '''Colonel Fuhrberger's House''' || 2807.8990 || -1172.9210 || 1025.5700
|-
| '''Burglary House 22''' || -42.490 || 1407.644 || 1084.43
|-
|}

<br>
*'''ID 9:'''
{| class="prettytable" style="width:50%;"
|-
| '''Unknown safe house''' || 2253.1740 || -1139.0100 || 1050.6330
|-
| '''Andromada Cargo hold''' || 315.48 || 984.13 || 1959.11
|-
| '''Burglary House 12''' || 85.32596 || 1323.585 || 1083.859
|-
| '''Burglary House 13''' || 260.3189 || 1239.663 || 1084.258
|-
| '''Cluckin' Bell''' || 365.67 || -11.61 || 1000.87
|-
|}

<br>
*'''ID 10:'''
{| class="prettytable" style="width:50%;"
|-
| '''Four Dragons Casino''' || 2009.4140 || 1017.8990 || 994.4680
|-
| '''RC Zero's Battlefield''' || -975.5766 || 1061.1312 || 1345.6719
|-
| '''Burger Shot''' || 366.4220 || -73.4700 || 1001.5080
|-
| '''Burglary House 14''' || 21.241 || 1342.153 || 1084.375
|-
| '''Janitor room(Four Dragons Maintenance)''' || 1891.3960 ||1018.1260 || 31.8820
|-
| '''Safe House 1''' ||
|-
| '''Hashbury safe house''' || 2264.5231 || -1210.5229 || 1049.0234
|-
| '''24/7 shop 3''' || 6.0780 || -28.6330 || 1003.5490
|-
| '''Abandoned AC Tower''' || 419.6140 || 2536.6030 || 10.0000
|-
| '''SFPD HQ''' || 246.4410 || 112.1640 || 1003.2190
|-
|}

<br>
*'''ID 11:'''
{| class="prettytable" style="width:50%;"
|-
| '''The Four Dragons Office''' || 2011.6030 || 1017.0230 || 39.0910
|-
| '''Los Santos safe house''' ||
|-
| '''Ten Green Bottles Bar''' || 502.3310 || -70.6820 || 998.7570
|-
|}

<br>
*'''ID 12:'''
{| class="prettytable" style="width:50%;"
|-
| '''Budget Inn Motel Room''' ||
|-
| '''The Casino''' || 1132.9450 || -8.6750 || 1000.6800
|-
| '''Macisla's Barbershop''' || 411.6410 || -51.8460 || 1001.8980
|-
| '''Safe house 7''' || 2237.2970 || -1077.9250 || 1049.0230
|-
| '''Modern safe house''' || 2324.4990 || -1147.0710 || 1050.7100
|-
|}

<br>
*'''ID 13:'''
{| class="prettytable" style="width:50%;"
|-
|'''LS Atrium''' || 1724.33 || -1625.784 || 20.211
|-
|'''CJ's Garage''' || -2043.966 || 172.932 || 28.835
|-
|}

<br>
*'''ID 14:'''
{| class="prettytable" style="width:50%;"
|-
| '''Kickstart Stadium''' || -1464.5360 || 1557.6900 || 1052.5310
|-
| '''Didier Sachs''' || 204.1789 || -165.8740 || 1000.5230
|-
| '''Francis Int. Airport (Front ext.)''' || -1827.1473 || 7.2074 || 1061.1435
|-
| '''Francis Int. Airport (Baggage Claim/Ticket Sales)''' || -1855.5687 || 41.2631 || 1061.1435
|-
| '''Wardrobe''' || 255.7190 || -41.1370 || 1002.0230
|-
|}

<br>
*'''ID 15:'''
{| class="prettytable" style="width:50%;"
|-
| '''Binco''' || 207.5430 || -109.0040 || 1005.1330
|-
| '''Blood Bowl Stadium''' || -1394.20 || 987.62 || 1023.96
|-
| '''Jefferson Motel''' || 2217.6250 || -1150.6580 || 1025.7970
|-
| '''Burglary House 17''' || -285.711 || 1470.697 || 1084.375
|-
| '''Burglary House 18''' || 327.808 || 1479.74 || 1084.438
|-
| '''Burglary House 19''' || 375.572 || 1417.439 || 1081.328
|-
| '''Burglary House 20''' || 384.644 || 1471.479 || 1080.195
|-
| '''Burglary House 21''' || 295.467 || 1474.697 || 1080.258
|-
|}

<br>
*'''ID 16:'''
{| class="prettytable" style="width:50%;"
|-
| '''24/7 shop 4''' || -25.3730 || -139.6540 || 1003.5470
|-
| '''LS Tattoo Parlour''' || -204.5580 || -25.6970 || 1002.2730
|-
| '''Sumoring? stadium''' || -1400 || 1250 || 1040
|-
|}

<br>
*'''ID 17:'''
{| class="prettytable" style="width:50%;"
|-
| '''24/7 shop 5''' || -25.3930 || -185.9110 || 1003.5470
|-
| '''Club''' || 493.4687 || -23.0080 || 1000.6796
|-
| '''Rusty Brown's - Ring Donuts''' || 377.0030 || -192.5070 || 1000.6330
|-
| '''The Sherman's Dam Generator Hall''' || -942.1320 || 1849.1420 || 5.0050
|-
| '''Hemlock Tattoo''' || 377.0030 || -192.5070 || 1000.6330
|-
|}

<br>
*'''ID 18:'''
{| class="prettytable" style="width:50%;"
|-
| '''Lil Probe Inn''' || -227.0280 || 1401.2290 || 27.7690
|-
| '''24/7 shop 6''' || -30.9460 || -89.6090 || 1003.5490
|-
| '''Atrium''' || 1726.1370 || -1645.2300 || 20.2260
|-
| '''Warehouse 2''' || 1296.6310 || 0.5920 || 1001.0230
|-
| '''Zip''' || 161.4620 || -91.3940 || 1001.8050
|-
|}

<br>
==See Also==
[[id|ID Lists]]
[[Category:Scripting Concepts]]
[[Category:ID Lists]]

SetFarClipDistance

2011-12-29T12:36:09Z

Gothemsh:

__NOTOC__
{{Server client function}}
This function is used to set the distance of render.

'''NOTE: Setting this less than 5 may cause problems to the client'''

==Syntax==
<syntaxhighlight lang="lua">
bool setFarClipDistance ( float distance )
</syntaxhighlight>

===Required Arguments===
*'''distance:''' A float specifying the distance of render.

===Returns===
Returns ''true'' if the distance was set correctly, ''false'' if invalid arguments were passed.

==Example==
<syntaxhighlight lang="lua">
-- Add example
</syntaxhighlight>

==See Also==
{{World functions}}

[[Category:Needs_Example]]

SetFarClipDistance

2011-12-29T12:35:50Z

Gothemsh:

SetFarClipDistance

2011-12-29T12:33:37Z

Gothemsh:

Introduction to Scripting the GUI

2011-11-10T00:53:44Z

Gothemsh:

One important feature in MTA:SA is the ability to script customized GUI (Graphic User Interface). The GUI consists of windows, button, edit boxes, check boxes... Almost every standard form components in graphical environments. They can be displayed while the user is in game, and used for inputs and outputs in place of traditional commands.

[[Image:AdminGUI.png|thumb|Admin Console GUI]]

==A tutorial to make a login window==
In this tutorial we'll make a simple login window, with two input boxes and a button. The window appears when the player joins the game, and once the button is clicked, the player is spawned. The tutorial will continue the gamemode we made in [[Scripting Introduction|Introduction to Scripting]] ''(If you have used the [[Scripting Introduction|Introduction to Scripting]], you will need to remove or comment the [[spawnPlayer]] line in the "joinHandler" function in your code, as we will be replacing it with a gui alternative in this tutorial)''. We'll also take a look at client-side scripting.

===Draw the window===
All the GUI must be made client side. It is also a good practice to keep all the client scripts in a separate folder.

Browse to /Your MTA Server/mods/deathmatch/resources/myserver/ directory, and create a folder named "client". Under /client/ directory, create a text file and name it "gui.lua".

In this file we will write a funtion that draws the window. To create a window we will use [[guiCreateWindow]]:
<syntaxhighlight lang="lua">
function createLoginWindow()
-- define the X and Y positions of the window
local X = 0.375
local Y = 0.375
-- define the width and height of the window
local Width = 0.25
local Height = 0.25
-- create the window and save its element value into the variable 'wdwLogin'
-- click on the function's name to read its documentation
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Please Log In", true)
end
</syntaxhighlight>

===Relative and Absolute===
Note that the final argument passed to guiCreateWindow in the above example is ''true''. This indicates that the coordinates and dimensions of the window are '''relative''', meaning they are a ''percentage'' of the total screen size. This means that if the far left side of the screen is 0, and the far right is 1, an X position of 0.5 would represent the centre point of the screen. Similarly, if the top of the screen is 0 and the bottom is 1, a Y position of 0.2 would be 20% of the way down the screen. The same principles apply to both Width and Height as well (with a Width value of 0.5 meaning the window will be half as wide as the screen).

The alternative to using relative values is using '''absolute''' (by passing ''false'' instead of true to guiCreateWindow). Absolute values are calculated as the total number of pixels from the top-left corner of the parent (if no gui element parent is specified, the parent is the screen itself). If we assume a screen resolution of 1920x1200, the far left side of the screen being 0 pixels and the far right being 1920 pixels, an X position of 960 will represent the centre point of the screen. Similarly, if the top of the screen is 0 pixels and the bottom is 1200, a Y position of 20 would be 20 pixels down from the top of the screen. The same principles apple to both Width and Height as well (with a Width value of 50 meaning the window will be 50 pixels wide). ''You can use [[guiGetScreenSize]] and a little maths to calculate certain absolute positions.''

The differences between using relative and absolute values is quite simple; gui created using absolute values will always remain exactly the same pixel size and position, while gui created using relative values will always be a percentage of its parent's size.

Absolute is generally easier to maintain when editing code by hand, however your choice of type depends on the situation you are using it for.

For the purposes of this introduction we will be using relative values.

===Adding the components===
Next, we'll add the text labels (saying "username:" and "password:"), edit boxes (for entering your data) and a button to log in.

To create buttons we use [[guiCreateButton]] and to create edit boxes use [[guiCreateEdit]]:

'''Note that we are now writing more code for our existing 'createLoginWindow' function. This is not a new function and is meant to replace what you already have.'''
<syntaxhighlight lang="lua">
function createLoginWindow()
local X = 0.375
local Y = 0.375
local Width = 0.25
local Height = 0.25
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Please Log In", true)

-- define new X and Y positions for the first label
X = 0.0825
Y = 0.2
-- define new Width and Height values for the first label
Width = 0.25
Height = 0.25
-- create the first label, note the final argument passed is 'wdwLogin' meaning the window
-- we created above is the parent of this label (so all the position and size values are now relative to the position of that window)
guiCreateLabel(X, Y, Width, Height, "Username", true, wdwLogin)
-- alter the Y value, so the second label is slightly below the first
Y = 0.5
guiCreateLabel(X, Y, Width, Height, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Width = 0.5
Height = 0.15
edtUser = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
Y = 0.5
edtPass = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
-- set the maximum character length for the username and password fields to 50
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Width = 0.25
Height = 0.2
btnLogin = guiCreateButton(X, Y, Width, Height, "Log In", true, wdwLogin)

-- make the window invisible
guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Note that every GUI component created is a child of the window, this is done by specifying the parent element (wdwLogin, in this case) when creating the component.

This is very useful because not only does it mean that all the components are attached to the window and will move with it, but also that any changes done to the parent window will be applied down the tree to these child components. For example, we can now hide all of the GUI we just created by simply hiding the window:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --hides all the GUI we made so we can show them to the player at the appropriate moment.
</syntaxhighlight>

===Using the function we wrote===
The createLoginWindow function is now complete, but it won't do anything until we call it. It is recommended to create all GUI when the client resource starts, hide them, and show them to the player later when needed. Therefore, we'll write an event handler for "[[onClientResourceStart]]" to create the window:
<syntaxhighlight lang="lua">
-- attach the event handler to the root element of the resource
-- this means it will only trigger when its own resource is started
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
createLoginWindow()
end
)
</syntaxhighlight>

As this is a log in window, we now need to show the window when the player joins the game.
This can be done using the same event, "[[onClientResourceStart]]", so we can modify the above code to include showing the window:

'''Note that we are now writing more code for our existing 'onClientResourceStart' handler. This is not a new event handler and is meant to replace what you already have.'''
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
-- create the log in window and its components
createLoginWindow()

-- output a brief welcome message to the player
outputChatBox("Welcome to My MTA:SA Server, please log in.")

-- if the GUI was successfully created, then show the GUI to the player
if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
else
-- if the GUI hasnt been properly created, tell the player
outputChatBox("An unexpected error has occurred and the log in GUI has not been created.")
end

-- enable the players cursor (so they can select and click on the components)
showCursor(true)
-- set the input focus onto the GUI, allowing players (for example) to press 'T' without the chatbox opening
guiSetInputEnabled(true)
end
)
</syntaxhighlight>

Note that we have a simple security check before making the window visible, so in the unlikely event that the window has not been created, meaning wdwLogin is not a valid element, we don't get an error and just inform the player what has happened.
In the next step, we will create the button functionality for the log in button.

==Scripting the button==
Now that we have created our GUI and shown it to the player, we need to make it work.

===Detecting the click===
When the player clicks on any part of the GUI, the event "[[onClientGUIClick]]" will be triggered for the GUI component you clicked on. This allows us to easily detect any clicks on the GUI elements we want to use.
For example, we can attach the event to the btnLogin button to catch any clicks on it:
<syntaxhighlight lang="lua">
-- attach the event onClientGUIClick to btnLogin and set it to trigger the 'clientSubmitLogin' function
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>
'''Note the final argument passed is "false". This indicates that the event will only trigger directly on btnLogin, not if the event has propagated up or down the tree. Setting this to "true" while attaching to gui elements will mean that clicking on any element in the same branch will trigger this event.'''

This line of code can now be added inside the createLoginWindow function. It is a common mistake to try and attach events to non-existant GUI elements, so make sure you always attach your events '''after''' the gui element (in this case, the button) has been created:

'''Note that we are now writing more code for our existing 'createLoginWindow' function.'''
<syntaxhighlight lang="lua">
function createLoginWindow()
-- create all our GUI elements
...

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

===Managing the click===
Now that we can detect when the player clicks on the button, we need to write code to manage what happens when they do.
In our [[onClientGUIClick]] event handle, we told it to call the function clientSubmitLogin whenever btnLogin is clicked.
Therefore, we can now use the function clientSubmitLogin to control what happens when the button is clicked:
<syntaxhighlight lang="lua">
-- create the function and define the 'button' and 'state' parameters
-- (these are passed automatically by onClientGUIClick)
function clientSubmitLogin(button,state)
-- if our login button was clicked with the left mouse button, and the state of the mouse button is up
if button == "left" and state == "up" then
-- move the input focus back onto the game (allowing players to move around, open the chatbox, etc)
guiSetInputEnabled(false)
-- hide the window and all the components
guiSetVisible(wdwLogin, false)
-- hide the mouse cursor
showCursor(false)
end
end
</syntaxhighlight>
Now, when the button is clicked, the window will be hidden and all controls will be returned to the player. Next, we will tell the server to allow the player to spawn.

===Triggering the server===
Triggering the server can be done using [[triggerServerEvent]]. This allows you to trigger a specified event on the server from the client. The same can be done in reverse using [[triggerClientEvent]].
Here, we use the [[triggerServerEvent]] function to call our own custom event on the server, named "submitLogin", which will then control the spawning of the player serverside.

'''Note that we are now writing more code for our existing 'clientSubmitLogin' function. This is not a new function and is meant to replace what you already have.'''
<syntaxhighlight lang="lua">
function clientSubmitLogin(button,state)
if button == "left" and state == "up" then
-- get the text entered in the 'username' field
local username = guiGetText(edtUser)
-- get the text entered in the 'password' field
local password = guiGetText(edtPass)

-- if the username and password both exist
if username and password then
-- trigger the server event 'submitLogin' and pass the username and password to it
triggerServerEvent("submitLogin", getRootElement(), username, password)

-- hide the gui, hide the cursor and return control to the player
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
else
-- otherwise, output a message to the player, do not trigger the server
-- and do not hide the gui
outputChatBox("Please enter a username and password.")
end
end
end
</syntaxhighlight>

===Creating the serverside event===
At this point we now have all the code needed on the client side, so open up your serverside 'script.lua' file (from the [[Scripting Introduction|Introduction to Scripting]]) or another suitable serverside file to work with.

On the server side, recall that we are spawning the player as soon as they login.
So, first of all, we will need to define the custom event that we used before on the client. This can be done using [[addEvent]] and [[addEventHandler]].
<syntaxhighlight lang="lua">
-- create our loginHandler function, with username and password parameters (passed from the client gui)
function loginHandler(username,password)

end

-- define our custom event, and allow it to be triggered from the client ('true')
addEvent("submitLogin",true)
-- add an event handler so that when submitLogin is triggered, the function loginHandler is called
addEventHandler("submitLogin",root,loginHandler)
</syntaxhighlight>

===Logging in===
Now we have a function that is called through the custom event 'submitLogin', we can start to work on logging in and spawning the player, using our 'loginHandler' function:
<syntaxhighlight lang="lua">
function loginHandler(username,password)
-- check that the username and password are correct
if username == "user" and password == "apple" then
-- the player has successfully logged in, so spawn them
if (client) then
spawnPlayer(client, 1959.55, -1714.46, 10)
fadeCamera(client, true)
setCameraTarget(client, client)
outputChatBox("Welcome to My Server.", client)
end
else
-- if the username or password are not correct, output a message to the player
outputChatBox("Invalid username and password. Please re-connect and try again.",client)
end
end

addEvent("submitLogin",true)
addEventHandler("submitLogin",root,loginHandler)
</syntaxhighlight>
'''For the purposes of this tutorial, a very basic username and password system is shown. For a more comprehensive alternative, you can use the Account System or a MySQL database.'''

Also note the use of the variable "client", it's an internal variable used by MTA to identify the player who triggered the event.

Finally, do not forget to include the new gui.lua file in the meta.xml of the main resource, and label it as a client script:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

At this point, we now have a basic login window that checks the player's username and password when the login button is clicked. If they are correct, the player is automatically spawned.

For further help with GUI, see the [[:Category:GUI_Tutorials|GUI tutorials]].

[[Category:GUI_Tutorials]]
[[it:Introduzione_allo_scripting_della_GUI]]
[[ru:Introduction to Scripting the GUI]]
[[es:Introducción a la Programación de GUI]]

ES/Página Principal

2011-11-10T00:53:05Z

Gothemsh:

__NOTOC__
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Bienvenido al wiki de Multi Theft Auto: San Andreas en Español. En este wiki encontrarás información sobre el desarrollo de mapas y modos de juego para Multi Theft Auto.

Hay muchas [[ES/Cómo puedes ayudar|cosas que puedes hacer]] para ayudarnos a mejorar MTA.

Si tienes preguntas, dudas o consultas acerca de alguna función, o script, no dudes en consultarnos por el [[IRC Channel|Canal de IRC ]][[Image:flag_us.png|En Inglés]] o en la [http://forum.mtasa.com/viewforum.php?f=122 Sección en Español del Foro MTA].

'''Para aportar en el wiki nececitas tener una cuenta. Si borras contenido que no es propio o haces SPAM, serás penalizado con el banneo de la cuenta en el wiki.'''

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">La última versión estable de '''Multi Theft Auto: San Andreas''' es '''{{Current Version|full}}'''. Visita la [http://mtasa.com/ página oficial] para obtenerla. También puedes elegir una versión "nightly" (sólo para desarrolladores o gente que quiera ayudar reportando bugs) en la sección de [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 versiones "nightly"], recuerda que estas versión se actualizan casi a diario, y son poco estables en lo que a errores se refiere (además son incompatibles con la mayoría de los servidores).</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Cómo empezar====

* [[ES/Manual_Cliente_Deathmatch| Manual del Cliente]] [[Image:flag_es.png|En Español]]
* [[ES/Manual Servidor Deathmatch| Manual del Servidor]] [[Image:flag_es.png|En Español]] (Traducción: 55%)
* [[ES/Problemas_Conocidos_-_FAQ| Problemas Conocidos]] [[Image:flag_es.png|En Español]] (Traducción: 10%)
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Scripting====
* [[ES/Resources| Introducción a los Resources]] [[Image:flag_es.png|En Español]]
** [[Resource Web Access| Acceso Web con Resources]] [[Image:flag_us.png|En Inglés]]
** [[Meta.xml| Sobre el archivo "meta.xml"]] [[Image:flag_us.png|En Inglés]]
* [[ES/Introducción a Lua| Introducción a Lua]] [[Image:flag_es.png|En Español]] (Traducción: 70%)
* [[ES/Introducción a la Programación de GUI| Introducción a la Programación del GUI]] [[Image:flag_es.png|En Español]] (En traducción...)
* [[Debugging| Tutorial de Depuración]] [[Image:flag_us.png|En Inglés]] - Encontrar errores en scripts.

* [[Map_manager| El Resource "Map Manager"]] [[Image:flag_us.png|En Inglés]]
* [[Writing_Gamemodes| Escribiendo Modos de Juego]] [[Image:flag_us.png|En Inglés]]
* [[Useful_Functions| Funciones útiles]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Base de Datos====
Esta sección provee de todas las capacidades de Lua y recursos importantes.
* [[:Category:Resource| Catálogo de Resources]] [[Image:flag_us.png|En Inglés]]
* [[ES/Scripts de Cliente| Scripts de Cliente]] [[Image:flag_es.png|En Español]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Ayuda General de LUA====
Éstas páginas te pueden ayudar a manejar mejor Lua.
*[http://www.lua.org/manual/5.1/es/manual.html "Manual de Referencia de LUA 5.1"] [[Image:flag_es.png|En Español]]
*[http://www.lua.org/pil/index.html Manual "Programando en LUA"] [[Image:flag_us.png|En Inglés]]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki] [[Image:flag_us.png|En Inglés]]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Guía general de LUA de Nixstaller] [[Image:flag_us.png|En Inglés]]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Editor de Mapas====
*[[ES/Resource:Editor| Manual]] [[Image:flag_es.png|En Traducción]]
*[[Resource:Editor/EDF| EDF: Formato de Definiciones del Editor]] [[Image:flag_us.png|En Inglés]]
*[[Resource:Editor/Plugins| Plugins]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Referencias====
* [[Client Scripting Functions|Funciones de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[Client Scripting Events|Eventos de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[ES/Funciones de Servidor|Funciones de Servidor]] [[Image:flag_es.png|En Español]]
* [[Server Scripting Events|Eventos de Servidor]] [[Image:flag_us.png|En Inglés]]

* [[ES/Clases MTA| Clases de MTA]] [[Image:flag_es.png|En Español]]
** [[ES/Elemento| Definición de Elemento]] [[Image:flag_es.png|En Español]]
**[[Element tree| Árbol de Elementos]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|Lista de IDs]]====
*[[Animations|Animaciones]]
*[[ES/Skins de Personajes|Skins]]
*[[CJ_Clothes|Ropa]]
*[[Garage|Garajes]]
*[[Interior IDs|Interiores]]
*[[Projectiles|Proyectiles]]
*[[Radar Blips|Iconos de Radar]]
*[[Sounds|Sonidos]]
*[[Vehicle IDs|ID's de Vehículos]]
*[[Vehicle Colors|Colores de Vehículos]]
*[[Vehicle Upgrades|Mejoras de Vehículos]]
*[[Weapons|Armas]]
*[[ES/Climas|Climas]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Equipo de Traducción====
* [mailto:zorrigas@gtagamingchile.com zorrigas@gtagamingchile.com]<br>
* [mailto:Brijido_XD@hotmail.com Brijido_XD@hotmail.com]<br>
* Benxamix2/The Kid
* [mailto:matiuno@gmail.com matiuno@gmail.com]<br>
* [mailto:cesarcastillo4@gmail.com cesarcastillo4@gmail.com]<br>
* [mailto:alex_firexx@hotmail.com alex_firexx@hotmail.com]<br>
* [mailto:carlos_olivo@msn.com carlos_olivo@msn.com]<br>
<br>
'''¡NO ELIMINES CONTENIDO SIN AUTORIZACIÓN!'''<br> Tampoco uses modismos, usa el Castellano (Internacional), y trata de que al traducir todo quede tan claro como puedas, y la ortografía sea la mejor posible.
</div>
|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]

ES/Introducción a la Programación de GUI

2011-11-10T00:52:01Z

Gothemsh: Created page with " Una importante caracteristica de MTA:SA es la posibilidad de programar GUIs propias (Graphics User Interface que traducido seria, Interfaz Grafica del Usuar..."

Una importante caracteristica de MTA:SA es la posibilidad de programar GUIs propias (Graphics User Interface que traducido seria, Interfaz Grafica del Usuario). Una GUI consiste en ventanas, botones, cajas de edición, entre otras cosas.... Estos pueden ser mostrados mientras el jugador esta en el juego, y es usado para tener interacción con el usuario en lugar de los típicos comandos.

[[Image:AdminGUI.png|thumb|Consola de Administración]]

==Un tutorial para hacer una ventana de ingreso==
En este tutorial nosotros haremos una simple ventana de ingreso, con dos cajas de edición y un botón. La ventana aparecerá cuando el jugador ingrese al juego, y cuando el botón sea apretado, el jugador aparecerá. El tutorial continuara el modo que hicimos en [[ES/Introducción_a_Lua|Introducción a LUA]] ''(Si tu continuaste de la pagina anterior, tendrás que remover o comentar la linea donde se encuentra la función [[spawnPlayer]], porque estaremos reemplazando eso con una GUI alternativa en este tutorial)''. También daremos una mirada a lo que es la programación en el cliente.

===Dibujando la ventana===
Toda GUI se debe hacer en el cliente. Esto tambien es una buena practica para tener todos los archivos de cliente en carpetas separadas.

Busca el directorio /Tu servidor MTA/mods/deathmatch/resources/myserver/, y crea una carpeta llamada "cliente". En la carpeta cliente, crea un archivo de texto y llamalo "gui.lua".

En este archivo escribiremos una función que dibuje la ventana. Para crear la ventana usaremos [[guiCreateWindow]]:
<syntaxhighlight lang="lua">
function createLoginWindow()
-- definimos las coordenadas X,Y donde se creara la ventana
local X = 0.375
local Y = 0.375
-- definimos el tamaño de la ventana (El ancho y el alto)
local Width = 0.25
local Height = 0.25
-- Creamos la ventana y la grabamos su valor de elemento en la variable 'wdwLogin'
-- Apreta en el nombre de la función para leer su definición
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Porfavor ingrese", true)
end
</syntaxhighlight>

===Relativo y absoluto===
Notese que el argumento final pasado a la función [[guiCreateWindow]] en el ejemplo de arriba es ''true''. Esto indica que las coordenadas y las dimensiones de la ventana son '''relativas''', queriendo decir que son un ''porcentaje'' del tamaño total de la pantalla. Queriendo decir que el lado izquierdo de la pantalla es 0 y el lado derecho es 1. Una posición X de 0.5, representaría el centro de la pantalla. Similarmente, si la parte de arriba de la pantalla es 0 y la de abajo es 1, entonces una posición en Y de 0.2 seria un 20% abajo de la pantalla. Este mismo principio se aplica al ancho y alto también. (Con un ancho de 0.5, quiere decir que la ventana tendrá un ancho de la mitad de la pantalla)

La alternativa a usar valores relativos es usar '''absolutos''' (Pasando ''false'' en vez de true a [[guiCreateWindow]])). Los valores absolutos son calculados como el numero total de pixeles de la esquina superior-izquierda de su padre (Si no se especifica un elemento padre, entonces el padre seria la pantalla en si). Si asumimos una resolución de 1920x1200, El lado izquierdo empezaría con 0 pixeles y el lado derecho tendría 1920 pixeles, una posición X de 960 representaría el centro de la pantalla. Similarmente, si el lado superior de la pantalla empieza 0 pixeles y el lado inferior termina con 1920 pixeles, una posición Y de 20 seria 20 pixeles bajo el lado superior de la pantalla. El mismo principio se aplica al ancho y al alto. ''Tu puedes usar [[guiGetScreenSize]] y un poco de matemáticas para calcular algunas posiciones absolutas.''

Las diferencias entre usar valores relativos y absolutos es un poco simple; Una GUI creada con valores absolutos siempre tendrá el mismo tamaño y posición, mientras que una GUI creada usando valores relativos siempre sera un porcentaje del tamaño de su padre.

El valor absoluto es generalmente mas fácil de mantener cuando se edita un código a mano, aunque tu opción del tipo depende de la situación para que lo estas usando.

Para propósitos de esta introducción usaremos valores relativos. (Aunque recomiendo usar absolutos)

===Añadiendo los componentes===
Ahora agregaremos las etiquetas de texto (Diciendo "Usuario:" y "Contraseña:", Cajas de edición (Para ingresar los datos) y un botón para ingresar.

Para crear el botón usaremos [[guiCreateButton]], y para crear las cajas de edición usaremos [[guiCreateEdit]]:

'''Nota que estamos escribiendo mas codigo de nuestra existente función 'createLoginWindow'. Esto no es una nueva función y esta pensada a reemplazar la que tu ya tenias.'''
<syntaxhighlight lang="lua">
function createLoginWindow()
local X = 0.375
local Y = 0.375
local Width = 0.25
local Height = 0.25
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Porfavor Ingrese", true)

-- definimos las coordenadas X,Y de nuestra primera etiqueta
X = 0.0825
Y = 0.2
-- definimos el ancho y el alto de nuestra primera etiqueta
Width = 0.25
Height = 0.25
-- Creamos la primera etiqueta, nota que el argumento final es 'wdwLogin' significando la ventana que creamos arriba es el padre de
-- esta etiqueta (asique todos los valores de posición y tamaño son relativos a la posición de esa ventana)
guiCreateLabel(X, Y, Width, Height, "Usuario", true, wdwLogin)
-- alteramos el valor Y, para que la segunda etiqueta este un poco mas abajo de la primera
Y = 0.5
guiCreateLabel(X, Y, Width, Height, "Contraseña", true, wdwLogin)

X = 0.415
Y = 0.2
Width = 0.5
Height = 0.15
edtUser = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
Y = 0.5
edtPass = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
-- Ponemos el maximo de caracteres que se pueden escribir en las cajas a 50
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Width = 0.25
Height = 0.2
btnLogin = guiCreateButton(X, Y, Width, Height, "Ingresar", true, wdwLogin)

-- Hacer la ventana invisible
guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Nota que todo componente GUI creado es un hijo de la ventana, esto se hace espeficicando el elemento padre (wdwLogin, en este caso) cuando se crea el componente.

Esto es muy util porque no solo hace pensar que todos sus componentes estan unidos a la ventana y que se van a mover con ella, sino que ademas todo cambio hecho a la ventana padre seran aplicados arbol abajo a todos sus elementos hijos. Por ejemplo, ahora podemos esconder todos los elementos GUI que creamos con solo esconder la ventana:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --esconde todos los elementos GUI que hicimos para poderlos mostrar al jugador en el momento apropiado
</syntaxhighlight>

===Using the function we wrote===
The createLoginWindow function is now complete, but it won't do anything until we call it. It is recommended to create all GUI when the client resource starts, hide them, and show them to the player later when needed. Therefore, we'll write an event handler for "[[onClientResourceStart]]" to create the window:
<syntaxhighlight lang="lua">
-- attach the event handler to the root element of the resource
-- this means it will only trigger when its own resource is started
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
createLoginWindow()
end
)
</syntaxhighlight>

As this is a log in window, we now need to show the window when the player joins the game.
This can be done using the same event, "[[onClientResourceStart]]", so we can modify the above code to include showing the window:

'''Note that we are now writing more code for our existing 'onClientResourceStart' handler. This is not a new event handler and is meant to replace what you already have.'''
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
-- create the log in window and its components
createLoginWindow()

-- output a brief welcome message to the player
outputChatBox("Welcome to My MTA:SA Server, please log in.")

-- if the GUI was successfully created, then show the GUI to the player
if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
else
-- if the GUI hasnt been properly created, tell the player
outputChatBox("An unexpected error has occurred and the log in GUI has not been created.")
end

-- enable the players cursor (so they can select and click on the components)
showCursor(true)
-- set the input focus onto the GUI, allowing players (for example) to press 'T' without the chatbox opening
guiSetInputEnabled(true)
end
)
</syntaxhighlight>

Note that we have a simple security check before making the window visible, so in the unlikely event that the window has not been created, meaning wdwLogin is not a valid element, we don't get an error and just inform the player what has happened.
In the next step, we will create the button functionality for the log in button.

==Scripting the button==
Now that we have created our GUI and shown it to the player, we need to make it work.

===Detecting the click===
When the player clicks on any part of the GUI, the event "[[onClientGUIClick]]" will be triggered for the GUI component you clicked on. This allows us to easily detect any clicks on the GUI elements we want to use.
For example, we can attach the event to the btnLogin button to catch any clicks on it:
<syntaxhighlight lang="lua">
-- attach the event onClientGUIClick to btnLogin and set it to trigger the 'clientSubmitLogin' function
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>
'''Note the final argument passed is "false". This indicates that the event will only trigger directly on btnLogin, not if the event has propagated up or down the tree. Setting this to "true" while attaching to gui elements will mean that clicking on any element in the same branch will trigger this event.'''

This line of code can now be added inside the createLoginWindow function. It is a common mistake to try and attach events to non-existant GUI elements, so make sure you always attach your events '''after''' the gui element (in this case, the button) has been created:

'''Note that we are now writing more code for our existing 'createLoginWindow' function.'''
<syntaxhighlight lang="lua">
function createLoginWindow()
-- create all our GUI elements
...

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

===Managing the click===
Now that we can detect when the player clicks on the button, we need to write code to manage what happens when they do.
In our [[onClientGUIClick]] event handle, we told it to call the function clientSubmitLogin whenever btnLogin is clicked.
Therefore, we can now use the function clientSubmitLogin to control what happens when the button is clicked:
<syntaxhighlight lang="lua">
-- create the function and define the 'button' and 'state' parameters
-- (these are passed automatically by onClientGUIClick)
function clientSubmitLogin(button,state)
-- if our login button was clicked with the left mouse button, and the state of the mouse button is up
if button == "left" and state == "up" then
-- move the input focus back onto the game (allowing players to move around, open the chatbox, etc)
guiSetInputEnabled(false)
-- hide the window and all the components
guiSetVisible(wdwLogin, false)
-- hide the mouse cursor
showCursor(false)
end
end
</syntaxhighlight>
Now, when the button is clicked, the window will be hidden and all controls will be returned to the player. Next, we will tell the server to allow the player to spawn.

===Triggering the server===
Triggering the server can be done using [[triggerServerEvent]]. This allows you to trigger a specified event on the server from the client. The same can be done in reverse using [[triggerClientEvent]].
Here, we use the [[triggerServerEvent]] function to call our own custom event on the server, named "submitLogin", which will then control the spawning of the player serverside.

'''Note that we are now writing more code for our existing 'clientSubmitLogin' function. This is not a new function and is meant to replace what you already have.'''
<syntaxhighlight lang="lua">
function clientSubmitLogin(button,state)
if button == "left" and state == "up" then
-- get the text entered in the 'username' field
local username = guiGetText(edtUser)
-- get the text entered in the 'password' field
local password = guiGetText(edtPass)

-- if the username and password both exist
if username and password then
-- trigger the server event 'submitLogin' and pass the username and password to it
triggerServerEvent("submitLogin", getRootElement(), username, password)

-- hide the gui, hide the cursor and return control to the player
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
else
-- otherwise, output a message to the player, do not trigger the server
-- and do not hide the gui
outputChatBox("Please enter a username and password.")
end
end
end
</syntaxhighlight>

===Creating the serverside event===
At this point we now have all the code needed on the client side, so open up your serverside 'script.lua' file (from the [[Scripting Introduction|Introduction to Scripting]]) or another suitable serverside file to work with.

On the server side, recall that we are spawning the player as soon as they login.
So, first of all, we will need to define the custom event that we used before on the client. This can be done using [[addEvent]] and [[addEventHandler]].
<syntaxhighlight lang="lua">
-- create our loginHandler function, with username and password parameters (passed from the client gui)
function loginHandler(username,password)

end

-- define our custom event, and allow it to be triggered from the client ('true')
addEvent("submitLogin",true)
-- add an event handler so that when submitLogin is triggered, the function loginHandler is called
addEventHandler("submitLogin",root,loginHandler)
</syntaxhighlight>

===Logging in===
Now we have a function that is called through the custom event 'submitLogin', we can start to work on logging in and spawning the player, using our 'loginHandler' function:
<syntaxhighlight lang="lua">
function loginHandler(username,password)
-- check that the username and password are correct
if username == "user" and password == "apple" then
-- the player has successfully logged in, so spawn them
if (client) then
spawnPlayer(client, 1959.55, -1714.46, 10)
fadeCamera(client, true)
setCameraTarget(client, client)
outputChatBox("Welcome to My Server.", client)
end
else
-- if the username or password are not correct, output a message to the player
outputChatBox("Invalid username and password. Please re-connect and try again.",client)
end
end

addEvent("submitLogin",true)
addEventHandler("submitLogin",root,loginHandler)
</syntaxhighlight>
'''For the purposes of this tutorial, a very basic username and password system is shown. For a more comprehensive alternative, you can use the Account System or a MySQL database.'''

Also note the use of the variable "client", it's an internal variable used by MTA to identify the player who triggered the event.

Finally, do not forget to include the new gui.lua file in the meta.xml of the main resource, and label it as a client script:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

At this point, we now have a basic login window that checks the player's username and password when the login button is clicked. If they are correct, the player is automatically spawned.

For further help with GUI, see the [[:Category:GUI_Tutorials|GUI tutorials]].

[[Category:GUI_Tutorials]]
[[it:Introduzione_allo_scripting_della_GUI]]
[[ru:Introduction to Scripting the GUI]]
[[en:Introduction to Scripting the GUI]]

ES/Página Principal

2011-11-05T01:11:29Z

Gothemsh:

__NOTOC__
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Bienvenido al wiki de Multi Theft Auto: San Andreas en Español. En este wiki encontrarás una gran cantidad de información sobre el desarrollo de mapas y modos de juego para Multi Theft Auto.

Hay muchas [[ES/Cómo puedes ayudar|cosas que puedes hacer]] para ayudarnos a mejorar MTA.

Si tienes preguntas, dudas o consultas acerca de alguna función, o script, no dudes en consultarnos por el [[IRC Channel|Canal de IRC ]][[Image:flag_us.png|En Inglés]] o en la [http://forum.mtasa.com/viewforum.php?f=122 Sección en Español del Foro MTA].

'''Para aportar en el wiki nececitas tener una cuenta. Si borras contenido que no es propio o haces SPAM, serás penalizado con el banneo de la cuenta en el wiki.'''

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">La última versión estable de '''Multi Theft Auto: San Andreas''' es '''{{Current Version|full}}'''. Visita la [http://mtasa.com/ página oficial] para obtenerla. También puedes elegir una versión "nightly" (sólo para desarrolladores o gente que quiera ayudar reportando bugs) en la sección de [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 versiones "nightly"], recuerda que estas versión se actualizan casi a diario, y son poco estables en lo que a errores se refiere (además son incompatibles con la mayoría de los servidores).</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Cómo empezar====

* [[ES/Manual_Cliente_Deathmatch| Manual del Cliente]] [[Image:flag_es.png|En Español]]
* [[ES/Manual Servidor Deathmatch| Manual del Servidor]] [[Image:flag_es.png|En Español]] (Traducción: 50%)
* [[ES/Problemas_Conocidos_-_FAQ| Problemas Conocidos]] [[Image:flag_es.png|En Español]] (Traducción: 10%)
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Scripting====
* [[ES/Resources| Introducción a los Resources]] [[Image:flag_es.png|En Español]]
** [[Resource Web Access| Acceso Web con Resources]] [[Image:flag_us.png|En Inglés]]
** [[Meta.xml| Sobre el archivo "meta.xml"]] [[Image:flag_us.png|En Inglés]]
* [[ES/Introducción a Lua| Introducción a Lua]] [[Image:flag_es.png|En Español]] (Traducción: 70%)
* [[Introduction to Scripting the GUI| Introducción a la Programación del GUI]] [[Image:flag_us.png|En Inglés]]
* [[Debugging| Tutorial de Depuración]] [[Image:flag_us.png|En Inglés]] - Encontrar errores en scripts.

* [[Map_manager| El Resource "Map Manager"]] [[Image:flag_us.png|En Inglés]]
* [[Writing_Gamemodes| Escribiendo Modos de Juego]] [[Image:flag_us.png|En Inglés]]
* [[Useful_Functions| Funciones útiles]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Base de Datos====
Esta sección provee de todas las capacidades de Lua y recursos importantes.
* [[:Category:Resource| Catálogo de Resources]] [[Image:flag_us.png|En Inglés]]
* [[ES/Scripts de Cliente| Scripts de Cliente]] [[Image:flag_es.png|En Español]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Ayuda General de LUA====
Éstas páginas te pueden ayudar a manejar mejor Lua.
*[http://www.lua.org/manual/5.1/es/manual.html "Manual de Referencia de LUA 5.1"] [[Image:flag_es.png|En Español]]
*[http://www.lua.org/pil/index.html Manual "Programando en LUA"] [[Image:flag_us.png|En Inglés]]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki] [[Image:flag_us.png|En Inglés]]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Guía general de LUA de Nixstaller] [[Image:flag_us.png|En Inglés]]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Editor de Mapas====
*[[ES/Resource:Editor| Manual]] [[Image:flag_es.png|En Traducción]]
*[[Resource:Editor/EDF| EDF: Formato de Definiciones del Editor]] [[Image:flag_us.png|En Inglés]]
*[[Resource:Editor/Plugins| Plugins]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Referencias====
* [[Client Scripting Functions|Funciones de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[Client Scripting Events|Eventos de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[ES/Funciones de Servidor|Funciones de Servidor]] [[Image:flag_es.png|En Español]]
* [[Server Scripting Events|Eventos de Servidor]] [[Image:flag_us.png|En Inglés]]

* [[ES/Clases MTA| Clases de MTA]] [[Image:flag_es.png|En Español]]
** [[ES/Elemento| Definición de Elemento]] [[Image:flag_es.png|En Español]]
**[[Element tree| Árbol de Elementos]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|Lista de IDs]]====
*[[Animations|Animaciones]]
*[[ES/Skins de Personajes|Skins]]
*[[CJ_Clothes|Ropa]]
*[[Garage|Garajes]]
*[[Interior IDs|Interiores]]
*[[Projectiles|Proyectiles]]
*[[Radar Blips|Iconos de Radar]]
*[[Sounds|Sonidos]]
*[[Vehicle IDs|ID's de Vehículos]]
*[[Vehicle Colors|Colores de Vehículos]]
*[[Vehicle Upgrades|Mejoras de Vehículos]]
*[[Weapons|Armas]]
*[[Weather|Climas]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Equipo de Traducción====
* [mailto:zorrigas@gtagamingchile.com zorrigas@gtagamingchile.com]<br>
* [mailto:Brijido_XD@hotmail.com Brijido_XD@hotmail.com]<br>
* Benxamix2/The Kid
* [mailto:matiuno@gmail.com matiuno@gmail.com]<br>
* [mailto:cesarcastillo4@gmail.com cesarcastillo4@gmail.com]<br>
* [mailto:alex_firexx@hotmail.com alex_firexx@hotmail.com]<br>
* [mailto:carlos_olivo@msn.com carlos_olivo@msn.com]<br>
<br>
'''¡NO ELIMINES CONTENIDO SIN AUTORIZACIÓN!'''<br> Tampoco uses modismos, usa el Castellano (Internacional), y trata de que al traducir todo quede tan claro como puedas, y la ortografía sea la mejor posible.
</div>
|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]

ES/Scripts de Cliente

2011-11-05T01:01:13Z

Gothemsh:

==¿Qué son?==

Los scripts de cliente son los que corren directamente en el computador del jugador. Esto implica poder realizar mas funciones que desde el servidor no se podrían hacer (Por ejemplo poner imágenes o alguna ventana).

==¿Cómo funcionan?==
La parte cliente trabaja de forma parecida y a la vez diferente, a la parte servidor. Se pueden sincronizar ambas partes usando el sistema de eventos.

Por ejemplo, para el archivo cliente:

<syntaxhighlight lang="xml">
<meta>
<script src="guitest.lua" type="client" /> 
<info author="IJs" />
</meta>
</syntaxhighlight>

Si queremos iniciar un evento del cliente desde el servidor, entonces primero hay que agregar el evento en el cliente con [[addEvent]]. Luego, se debe arreglar un manejador de este evento. Y en el lado servidor, se debe usar [[triggerClientEvent]] ( jugador, "nombreDeEvento", jugador, argumentos ... ) para iniciar el evento. Este proceso de sincronía se puede hacer al revés también, con [[triggerServerEvent]].

Por ejemplo:

'''Script de cliente:'''

<syntaxhighlight lang="lua">
function showObjectBrowser(id)
-- El código aquí...
end

addEvent("doShowObjectBrowser", true) -- Agregamos el evento...
addEventHandler("doShowObjectBrowser", getRootElement(), showObjectBrowser) -- Y el manejador, que indica que al iniciarse el evento, llame a la función "showObjectBrowser"...
</syntaxhighlight>

'''Script de servidor:'''

<syntaxhighlight lang="lua">
triggerClientEvent ( unJugador, "doShowObjectBrowser", getRootElement(), 1034 )
</syntaxhighlight>

==Traductores==

*Benxamix2/The Kid

[[ru:Client side scripts]]
[[it:Script client-side]]
[[en:Client side scripts]]

ES/Resource:Editor

2011-11-05T00:50:43Z

Gothemsh:

{{Resource page}}
El editor de mapas de MTA:SA te permite crear mapas para los modos de juego.
Para iniciarlo, simplemente presiona "Map Editor" en el menú principal de MTA

==Menus==
Una vez que el editor haya comenzado, se te mostrarán dos menús de barras: la principal (arriba), y la de elementos (esquina inferior izquierda).

===Menú principal===
Estos son los botones en el menú principal:
* [[Image:Editor_New.png]] Crear un nuevo mapa.
* [[Image:Editor_Open.png]] Abrir un mapa existente.
* [[Image:Editor_Save.png]] Grabar el mapa en que estás trabajando.
* [[Image:Editor_Save_as.png]] Grabar el mapa bajo un nombre diferente.
* [[Image:Editor_Options.png]] Modificar las opciones generales del editor.
* [[Image:Editor_Undo.png]] Deshacer la última acción.
* [[Image:Editor_Redo.png]] Restaurar la última acción deshecha.
* [[Image:Editor_Locations.png]] Lista de lugares "marcados" (como los Favoritos).
* [[Image:Editor_Current_elements.png]] Lista de todos los elementos contenidos en el mapa (vehículos, objetos, marcadores, pickups, etc).
* [[Image:Editor_Map_settings.png]] Propiedades del mapa, como el tiempo o la gravedad. Aquí también puedes especificar los modos de juego que son compatibles con tu mapa.
* [[Image:Editor_Definitions.png]] Cargar las [[Resource:Editor/EDF| Definiciones del Editor (EDF)]].
* [[Image:Editor_Test.png]] Probar el mapa.

===Menú de elementos===
El menú de elementos es usado para agregar nuevos elementos al mapa.
* [[Image:Editor_Vehicle.png]] Crear un vehículo.
* [[Image:Editor_Object.png]] Crear un objeto (edificios, caminos, basura, árboles, rocas, decoración exterior, etc).
* [[Image:Editor_Pickup.png]] Crear un pickup (sólo se puede crear de vida, armadura o de un arma).
* [[Image:Editor_Marker.png]] Crear un marcador.

Adicionalmente, si tienes una [[Resource:Editor/EDF| Definición de Editor (EDF)]] cargada, girando la rueda del ratón (con el cursor sobre el menú) puedes cargar los elementos derivados de esa definición.

==Usando el editor==
Esta sección te explicará cómo crear y modificar mapas.

===Moviéndose alrededor del mapa===
Al iniciarse el editor, inicias en el ''modo de cámara''. Puedes usar las teclas '''WSAD''' para mover la cámara, y el ratón para girarla. Cuando te muevas, puedes mantener la tecla '''ALT''' para moverte más lento, o la tecla '''SHIFT''' para ir más rápido.

Para acceder a la interfaz del editor y al panel de control, necesitas cambiar al ''modo de cursor''. Puedes cambiar entre el modo de cursor y el modo de cámara con la tecla '''F'''. Cuando estés en modo de cursor, tu vista estará congelada, y solo podrás usar el cursor del ratón para manipular elementos y usar la interfaz gráfica.

El modo de cámara puede ser reconocido por una mira en medio de la pantalla. Puedes usarla para seleccionar y mover elementos como en el modo de cursor. Esta mira luce así:

[[Image:Editor_Crosshair.png|center]]

===Empezando un nuevo mapa===
* Inicia el editor, o si ya está iniciado, apreta el boton ''Nuevo'' del menú.
* Apreta el botón ''Opciones de mapa''. En la pestaña ''Meta'', llena los campos de "Name" y "Author" con el nombre de tu mapa y tu nick en MTA, respectivamente. También abre la pestaña ''Gamemodes'' y agrega los modos de juego para los cuales tu mapa está hecho (éstos se van a mover a la lista de ''Added Gamemodes''). Puedes hacer esto seleccionándolos y apretando en ''Add'', o haciendo doble click sobre ellos. Apreta OK cuando estés listo.
[[Image:Editor_Mapsettings.png|center]]
* Apreta en la ventana de ''Definiciones'' y agrega los recursos en donde uses los elementos alternativos. Estos debieran consistir de los modos que tu seleccionaste en la ventana de ''Map settings'', ademas de eventuales recursos adicionales. Para mas informacion acerca de las definiciones del editor, ve [[Resource:Editor/EDF|EDF (En Inglés)]]. Apreta OK cuando estes listo.

===Creando nuevos elementos===
* Si tu estas en el modo de camara, cambia al modo de cursor primero apretando '''F'''.
* Apreta un boton en el menu de elementos que represente lo que tu quieres. Ej: Apreta el boton con un auto en el para agregar un vehiculo.
* Un nuevo elemento del tipo seleccionado sera creado y pegado a tu cursor. Muevelo a la posicion que quieras y apreta el '''botón izquierdo''' para dejarlo.

[[Image:Editor_Addelem.png|center]]

Para crear un elemento alternativo que es especifico a un recurso, mueve tu cursor sobre el menu de elementos y gira la rueda del ratón hasta el recurso esperado. Ten en cuenta que para este trabajo, primero necesitas haber agregado el archivo de [[Resource:Editor/EDF|Definición de editor]] del recurso en la ventana ''Definitions''.

[[Image:Editor_Selectedf.png|center]]

===Seleccionando===
* '''Click izquierdo''' sobre un elemento para seleccionarlo en ''modo de teclado''.
* '''Click derecho''' sobre este elemento para seleccionarlo en ''modo de ratón''.
* Apreta la '''Barra espaciadora''' o apreta sobre un area vacia para sacar la selección.

El elemento elegido, si lo hay, es representado por un marcador de cono amarillo. Elementos (particularmente objetos) con pesima colision se peuden detectar facilmente activando el ''modo de alta sensibilidad'', apretando la tecla '''E'''. Esto incrementara la detección.

El dialogo ''Current elements'' puede ser usado tambien para seleccionar elementos. Has doble-click sobre un item de la lista para seleccionarlo en ''modo de teclado''

===Moviendo===
El movimiento de los elementos se puede hacer de muchas maneras:

'''Con el ratón'''
* Simplemente selecciónalo y déjalo con el '''boton izquierdo'''
O bien:
* Selecciona el elemento en el modo de ratón ('''boton derecho'''), muévelo hacia la posición que quieras, y haz clic izquierdo para dejarlo.

También puedes ajustar la ''distancia'' de un elemento acercándolo o alejándolo de la cámara mediante el cambio al modo de cámara. Haz ''''clic derecho''' en un elemento, y gira la '''rueda del ratón'''.

'''Con el teclado'''
* Selecciona el elemento en el modo de teclado ('''clic izquierdo''').
* Luego, usa las '''teclas de dirección''' para mover el elemento en un plano horizontal (ejes ''X'' y ''Z''), y '''RePág'''/'''AvPág''' para moverlo verticalmente (eje Z). Mantén presionado '''ALT''' para disminuir la velocidad de movimiento, y '''SHIFT''' para incrementarla.

Por defecto, los elementos se mueven relativamente a la cámara y no están limitadas a sus ejes. Esto se puede desactivar en el menú de '''Opciones'''.

===Rotando===

'''Con el ratón'''
Puedes rotar un elemento selecionado en el eje Z, con la rueda del ratón.
* Seleciona el elemento con un clic (derecho o izquierdo) y ruédala mantiendo apretado '''CTRL'''.

'''Con el teclado'''
* Selecciona el elemento ('''clic izquierdo''').
* Mientras se presiona '''CTRL''' (la marca de selección se volverá verde), y usa las '''teclas de dirección''' o '''RePág'''/'''AvPág''' para rotar el elemento en los 3 ejes.

En ambos métodos, puedes presionar '''ALT''' para reducir la velocidad de rotación del elemento, y '''SHIFT''' para incrementarla.

[[Image:Editor_Rotateelem.png|center]]

===Cambio de modelo y otras propiedades===
La mayoría de los elementos tiene una variedad de opciones que pueden ser alteradas para cambiar su apariencia. Ejemplos son los modelos, color y las actualizaciones visuales de un auto.

* Abre la ventana de propiedades de un elemento, presionando dos veces en el o seleccionándolo y apretando '''F3'''.
* Hace las modificaciones que tu quieras. Por ejemplo, para cambiar el modelo de un auto o objeto, presiona en el botón '''Browse''' al lado de "model" para abrir el buscador de modelos.
* presiona OK cuando estés listo

[[Image:Editor_Props.png|center]]

===Clonando===
Puedes clonar un elemento seleccionándolo y presionando '''C'''.

* En el modo de cursor, este elemento clonado será "adjuntado" a tu cursor. Para posicionarlo haz click con el botón izquierdo.
* En el modo de teclado, el elemento será puesto en la misma posición del elemento original.

Si presionas '''CTRL''' mientras haces click, el elemento será clonado otra vez.

También puedes usar el botón ''Pullout'' de la esquina inferior derecha de la ventana de propiedades del elemento.

===Borrando===
Simplemente selecciona el elemento y pulsa ''SUPR''' ''(Borrar o Suprimir)''.

También puedes usar el botón ''Pullout'' de la esquina inferior derecha de la ventana de propiedades del elemento.

==Creando mapas para modos de juego específicos==
Para lograr esto, tienes que hacer 2 cosas.
* Clickea '''Map Settings''' en la barra superior del editor, busca la sección '''Gamemodes'''. De ahí seleccionas los modos de juego en los que tu mapa se puede usar.
* También necesitarás usar [[Resource:Editor/EDF|Archivos de Definición del Editor]] (EDF, o sea Editor Definition Files). Estos te permiten poner elementos de un modo de juego en específico, ya sean puntos de Spawn, las banderas de CTF, etc... Los EDF se cargan desde la sección "Definitions", en "Map Settings".

==Controles==
Aquí tienes la lista de los controles por defecto. Para editarlos, debes ir a la sección "Binds", en "Settings", en el menú de MTA, mientras el editor está abierto.

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

===Clonación===
{|
|-
| clone_selected_element
| '''c'''
|-
| clone_drop_modifier
| '''lctrl''' || ''(Left CTRL)''
|}

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

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

==Multijugador==
El editor de mapas está hecho para que se pueda usar por más de un jugador a la vez. Esto se hace copiando los "resources" que usa el editor, a tu servidor. Luego tienes que iniciarlo y ya puedes hacer mapas con otros jugadores.

Nota: no hay sistema de restricciones en el editor; todos los jugadores tienen los mismos permisos para editar el mapa.

==Plugins y Recursos externos==
{{Main|Resource:Editor/Plugins}}

El editor permite una importación básica de recursos externos. Esto es útil para "resources" que manipulan o crean objetos que el editor no puede, como vehículos con modelos modificados.

Usando el comando '''import <nombreDeResource>''' en la consola, los elementos del resource pueden ser importados al editor.

==Preguntas Frecuentes==
==== No veo nada (pantalla negra) al usar el editor ====

Generalmente esto ocurre debido a una mala instalación del editor de mapas. Si usas una versión estable de MTA, prueba a instalarlo de nuevo, y asegúrate de que las opciones "Client" y "Server" del instalador estén marcadas.

En cambio, si usas una versión "nightly", debes bajar la última versión de los[http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 "resources" (paso 3)], descomprimir el archivo y colocar su contenido en:
''MTA San Andreas\server\mods\deathmatch\resources'', donde ''MTA San Andreas'' es la carpeta donde instalaste MTA San Andreas (por defecto es: C:\Archivos de Programa\MTA San Andreas).

'''Poner los archivos en: MTA San Andreas\mods\deathmatch\resources es un error común''' - no funcionarán ahí. Asegúrate de que dentro de la ruta donde colocas los archivos encuentres la palabra "server".

Si este problema persiste aún después de haber hecho los pasos mencionados y revisada la versión actual, puede ser porque tienes una versión obsoleta del archivo ''acl.xml''. Puedes descargarlo [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml aquí]. Una vez descargado, colócalo en la carpeta '''MTA San Andreas/server/mods/deathmatch/'''.

==== Me sale un mensaje que dice "Could not start the local server. See console for details" al iniciar el editor ====
Esto pasa porque tu archivo ''mtaserver.conf'' está dañado o está mal editado. Puedes descargarlo [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf aquí]. Debes colocarlo en '''MTA San Andreas/server/mods/deathmatch/'''.

==== Guardé un mapa con el editor, pero no lo encuentro en la carpeta resources. Sin embargo el editor lo carga en la lista ====
Esto se debe a que Windows Vista/7 tiene cietos límites de escritura para procesos no administrativos del directorio Archivos de Programa. Los archivos se guardan en el directorio "VirtualStore" en vez de en Archivos de Programa. Deberías poder encontrar tu mapa en el directorio:
C:\Usuarios\<NOMBRE>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\

Si inicias el servidor o el cliente de MTA con derechos administrativos, tu mapa debería ser guardado en el lugar correcto.

==== Encontré un error o tengo una sugerencia ====
Visita el [http://bugs.mtasa.com sistema de seguimiento de errores] oficial. También puedes ingresar al [http://www.multitheftauto.com/irc.html canal de IRC].

==Traductores==

*Gothem
*F4ST3R
*Benxamix2/The Kid

[[ru:Resource:Editor]]
[[en:Resource:Editor]]
[[Category:Incomplete]]

OnClientGUITabSwitched

2011-05-08T22:13:20Z

Gothemsh:

{{Client event}}
__NOTOC__
This event is triggered each time the user switch from GUI tab.

==Parameters==
<syntaxhighlight lang="lua">
element theElement
</syntaxhighlight>
* '''theElement''': The tab which was selected.

==Source==
The [[event system#Event source|source]] of this event is the tabpanel.

==Example==
This example creates a window with a tabpanel with two tabs. Every time a user changes tabpage a notification will be shown.

First we'll create the window. Then add a tabpanel and couple tabs with some labels in them. Qoute: [[GuiCreateWindow#Example]]
<syntaxhighlight lang="lua">
local myWindow = guiCreateWindow ( 0, 0, 0.5, 0.4, "Information", true ) -- create a window which has "Information" in the title bar.
local tabPanel = guiCreateTabPanel ( 0, 0.1, 1, 1, true, myWindow ) -- create a tab panel which fills the whole window
local tabMap = guiCreateTab( "Map Information", tabPanel ) -- create a tab named "Map Information" on 'tabPanel'
local tabHelp = guiCreateTab( "Help", tabPanel ) -- create another tab named "Help" on 'tabPanel'

-- adds a label (text) to each tab
guiCreateLabel( 0.02, 0.04, 0.94, 0.2, "This is information about the current map", true, tabMap )
guiCreateLabel( 0.02, 0.04, 0.94, 0.92, "This is help text.", true, tabHelp )
</syntaxhighlight>

Now let's add the event handler.
<syntaxhighlight lang="lua">

function OnChange( selectedTab )

-- If there is a selected tab.
if selectedTab ~= nil then

outputChatBox( "You've changed your active tab." )

end

end

addEventHandler("onClientGUITabSwitched", getRootElement( ), OnChange)
</syntaxhighlight>

==See Also==
===GUI events===
{{GUI_events}}
===Client event functions===
{{Client_event_functions}}

OnClientGUITabSwitched

2011-05-08T22:11:02Z

Gothemsh:

{{Client event}}
__NOTOC__
This event is triggered each time the user switch from GUI tab.

==Parameters==
<syntaxhighlight lang="lua">
element theElement
</syntaxhighlight>
* '''theElement''': The element which was selected.

==Source==
The [[event system#Event source|source]] of this event is the tab selected.

==Example==
This example creates a window with a tabpanel with two tabs. Every time a user changes tabpage a notification will be shown.

First we'll create the window. Then add a tabpanel and couple tabs with some labels in them. Qoute: [[GuiCreateWindow#Example]]
<syntaxhighlight lang="lua">
local myWindow = guiCreateWindow ( 0, 0, 0.5, 0.4, "Information", true ) -- create a window which has "Information" in the title bar.
local tabPanel = guiCreateTabPanel ( 0, 0.1, 1, 1, true, myWindow ) -- create a tab panel which fills the whole window
local tabMap = guiCreateTab( "Map Information", tabPanel ) -- create a tab named "Map Information" on 'tabPanel'
local tabHelp = guiCreateTab( "Help", tabPanel ) -- create another tab named "Help" on 'tabPanel'

-- adds a label (text) to each tab
guiCreateLabel( 0.02, 0.04, 0.94, 0.2, "This is information about the current map", true, tabMap )
guiCreateLabel( 0.02, 0.04, 0.94, 0.92, "This is help text.", true, tabHelp )
</syntaxhighlight>

Now let's add the event handler.
<syntaxhighlight lang="lua">

function OnChange( selectedTab )

-- If there is a selected tab.
if selectedTab ~= nil then

outputChatBox( "You've changed your active tab." )

end

end

addEventHandler("onClientGUITabSwitched", getRootElement( ), OnChange)
</syntaxhighlight>

==See Also==
===GUI events===
{{GUI_events}}
===Client event functions===
{{Client_event_functions}}

Funciones de servidor

2011-01-15T23:06:51Z

Gothemsh: Redirected page to ES/Server Scripting Functions

#REDIRECT [[ES/Server_Scripting_Functions]]

ES/Página Principal

2011-01-15T23:04:08Z

Gothemsh: /* Referencias */

__NOTOC__
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Bienvenido al wiki de Multi Theft Auto: San Andreas en Español. En este wiki encontrarás una gran cantidad de información sobre el desarrollo de mapas y modos de juego para Multi Theft Auto.

Hay muchas [[How you can help|cosas que puedes hacer para ayudarnos]] a mejorar MTA - crear mapas, modos de juego, ayudar con scripts y comandos, escribir un código de ejemplo, traducir páginas del wiki, escribir tutoriales, o tan sólo jugar MTA, y reportar los errores que encuentres, en el [http://forum.multitheftauto.com| Foro de MTA].

Si tienes preguntas, dudas o consultas acerca de alguna función, o script, no dudes en consultarnos por el [[IRC Channel|Canal de IRC ]][[Image:flag_us.png|En Inglés]] o en la [http://forum.mtasa.com/viewforum.php?f=122 Sección en Español del Foro MTA].

'''Para aportar en el wiki nececitas tener una cuenta OpenID. Si borras contenido que no es propio o haces SPAM, serás penalizado con el banneo de la cuenta en el wiki.'''

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">La última versión estable de '''Multi Theft Auto: San Andreas''' es '''{{Current Version|full}}'''. Visita la [http://mtasa.com/ página oficial] para obtenerla. También puedes elegir una versión "nightly" (sólo para desarrolladores o gente que quiera ayudar reportando bugs) en la sección de [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 versiones "nightly"], recuerda que estas versión se actualizan casi a diario, y son poco estables en lo que a errores se refiere (además son incompatibles con la mayoría de los servidores).</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Cómo empezar====

* [[ES/Manual_Cliente_Deathmatch| Manual del Cliente]] [[Image:flag_es.png|En Español]]
* [[ES/Manual Servidor Deathmatch| Manual del Servidor]] [[Image:flag_es.png|En Español]]
* [[ES/Problemas_Conocidos_-_FAQ| Problemas Conocidos]] [[Image:flag_es.png|En Español]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Programación====
* [[ES/Introducción a la Programación| Introducción a la Programación en LUA]] (en construcción) [[Image:flag_es.png|En Español]]
* [[Introduction to Scripting the GUI| Introducción a la Programación del GUI]] [[Image:flag_us.png|En Inglés]]
* [[Debugging| Tutorial de Depuración]] [[Image:flag_us.png|En Inglés]] - Cómo encontrar errores en tus scripts.

* [[Resources| Introducción a los Resources]] [[Image:flag_us.png|En Inglés]]
** [[Resource Web Access| Acceso de Web con Resources]] [[Image:flag_us.png|En Inglés]] - Cómo escribir páginas web.
** [[:Category:Resource| Catálogo de Resources]] [[Image:flag_us.png|En Inglés]]
** [[Meta.xml| Sobre el archivo "meta.xml"]] [[Image:flag_us.png|En Inglés]]
* [[Map_manager| El Resource "Map Manager"]] [[Image:flag_us.png|En Inglés]]
* [[Writing_Gamemodes| Escribiendo Modos de Juego]] [[Image:flag_us.png|En Inglés]]
* [[Useful_Functions| Funciones útiles]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Base de Datos====
Esta sección provee de todas las capacidades de LUA y también algunos resources importantes.
* [[:Category:Resource| Catálogo de Resources]] [[Image:flag_us.png|En Inglés]] - Debes aprender a manejarlos para hacer buenos scripts.
* [[ES/Scripts de Cliente| Scripts de Cliente]] [[Image:flag_es.png|En Español]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Ayuda General de LUA====
Éstas páginas te pueden ayudar a manejar mejor LUA.
*[http://www.lua.org/manual/5.1/es/manual.html "Manual de Referencia de LUA 5.1"] [[Image:flag_es.png|En Español]]
*[http://www.lua.org/pil/index.html Manual "Programando en LUA"] [[Image:flag_us.png|En Inglés]]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki LUA Wiki] [[Image:flag_us.png|En Inglés]]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Guía general de LUA de Nixstaller] [[Image:flag_us.png|En Inglés]]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Editor de Mapas====
*[[ES/Resource:Editor| Manual]] [[Image:flag_es.png|En Traducción]] (EN TRADUCCION)
*[[Resource:Editor/EDF| EDF: Formato de Definiciones del Editor]] [[Image:flag_us.png|En Inglés]]
*[[Resource:Editor/Plugins| Plugins]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Referencias====
* [[Client Scripting Functions|Funciones de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[Client Scripting Events|Eventos de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[ES/Server Scripting Functions|Funciones de Servidor]] [[Image:flag_es.png|En Español]]
* [[Server Scripting Events|Eventos de Servidor]] [[Image:flag_us.png|En Inglés]]

* [[ES/Clases MTA| Clases de MTA]] [[Image:flag_es.png|En Español]] - Descripción de cada uno de los "tipos" personalizados de MTA.
** [[ES/Elemento| Definición de Elemento]] [[Image:flag_es.png|En Español]]
**[[Element tree| Árbol de Elementos]] [[Image:flag_us.png|En Inglés]]
* [[ES/Tipos de Valores| Tipos de valores]] [[Image:flag_es.png|En Español]] - Descripción de los tipos de valores usados en LUA.
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|Lista de IDs]]====
*[[Animations|Animaciones]]
*[[ES/Skins de Personajes|Skins]]
*[[CJ_Clothes|Ropa]]
*[[Garage|Garajes]]
*[[Interior IDs|Interiores]]
*[[Projectiles|Proyectiles]]
*[[Radar Blips|Iconos de Radar]]
*[[Sounds|Sonidos]]
*[[Vehicle IDs|ID's de Vehículos]]
*[[Vehicle Colors|Colores de Vehículos]]
*[[Vehicle Upgrades|Mejoras de Vehículos]]
*[[Weapons|Armas]]
*[[Weather|Climas]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Traducción====
* ¿Quieres ayudar a traducir el wiki? ¡Qué esperas! Deja tu e-mail (si quieres) aquí y empieza a hacerlo.
Traductores:<br>
* [mailto:zorrigas@gtagamingchile.com zorrigas@gtagamingchile.com]<br>
* [mailto:Brijido_XD@hotmail.com Brijido_XD@hotmail.com]<br>
* [mailto:benxamix2@hotmail.com benxamix2@hotmail.com]<br>
* [mailto:matiuno@gmail.com matiuno@gmail.com]<br>
<br>
'''¡NO ELIMINES CONTENIDO SIN AUTORIZACIÓN!'''<br> Tampoco uses modismos, usa el Castellano (Internacional), y trata de que al traducir todo quede tan claro como puedas, así nos ayudas más.
</div>
|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]

ES/Funciones de Servidor

2011-01-15T22:59:06Z

Gothemsh:

<pageclass class="server"></pageclass>
Esta pagina muestra todas las funciones del '''servidor''' que han sido implementadas y disponibles como funciones nativas. Para pedir una función o un evento, usa [[Requested Functions and Events|pedido de funciones y eventos]] o http://bugs.mtasa.com.

Por favor ten en cuenta que las funciones se pueden también extender cargando un modulo dinámico que entregue una nueva funcionalidad, como el MySQL database access. Estas funciones no son nativas y requieren que el modulo este cargado para funcionar.

Vea [[Modules|Modulos]] para una lista de funciones de servidor no-nativas y módulos que están disponibles.

Para mas funciones, vea la pagina de [[Useful_Functions|funciones útiles]].

'''Las funciones de cliente se pueden encontrar aqui: [[Client Scripting Functions|Funciones de cliente]].'''

'''Tenga en cuenta que casi todas las funciones presentes no presentan una traducción en su definición'''

==Funciones de cuenta==
{{Account_functions}}

==Funciones de ACL==
{{ACL_functions}}

==Funciones Administrativas==
{{Admin_functions}}

==Funciones de audio==
{{Audio_functions}}

==Funciones de anuncio==
{{Announce_functions}}

==Funciones de blip==
{{Blip_functions}}

==Funciones de cámara==
{{Camera functions}}

==Funciones de colisión==
{{Collision shape functions}}

==Funciones de ropa y cuerpo==
{{Clothes and body functions}}

==Funciones de cursor==
{{Cursor_functions}}

==Funciones de elemento==
{{Element functions}}

==Funciones de evento==
{{Event_functions}}

==Funciones explosivas==
{{Explosion_functions}}

==Funciones de archivos==
{{File_functions}}

==Funciones de HTTP==
{{HTTP_functions}}

==Funciones de Input==
{{Input_functions}}

==Funciones de mapa==
{{Map_functions}}

==Funciones de marcadores==
{{Marker functions}}

==Funciones de modulos==
{{Module functions}}

==Funciones de objetos==
{{Object functions}}

==Funciones de peds==
{{Ped_functions}}

==Funciones de pickup==
{{Pickup functions}}

==Funciones de jugadores==
{{Player functions}}

==Funciones de area de radar==
{{Radar area functions}}

==Funciones de recursos==
{{Resource functions}}

==Funciones de serial==
{{Serial functions}}

==Funciones de servidor==
{{Server functions}}

==Funciones de registro de propiedades==
{{Settings registry functions}}

==Funciones de SQL==
{{SQL_functions}}

==Funciones de equipo==
{{Team functions}}

==Funciones de texto==
{{Text functions}}

==Funciones de utilidad==
{{Utility functions}}

==Funciones de vehiculos==
{{Vehicle functions}}

==Funciones de agua==
{{Water functions}}

==Funciones de arma==
{{Weapon functions}}

==Funciones del mundo==
{{World functions}}

==Funciones de XML==
{{XML functions}}

[[ru:Server Scripting Functions]]
[[en:Server Scripting Functions]]

ES/Página Principal

2011-01-15T22:58:04Z

Gothemsh: /* Referencias */

__NOTOC__
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Bienvenido al wiki de Multi Theft Auto: San Andreas en Español. En este wiki encontrarás una gran cantidad de información sobre el desarrollo de mapas y modos de juego para Multi Theft Auto.

Hay muchas [[How you can help|cosas que puedes hacer para ayudarnos]] a mejorar MTA - crear mapas, modos de juego, ayudar con scripts y comandos, escribir un código de ejemplo, traducir páginas del wiki, escribir tutoriales, o tan sólo jugar MTA, y reportar los errores que encuentres, en el [http://forum.multitheftauto.com| Foro de MTA].

Si tienes preguntas, dudas o consultas acerca de alguna función, o script, no dudes en consultarnos por el [[IRC Channel|Canal de IRC ]][[Image:flag_us.png|En Inglés]] o en la [http://forum.mtasa.com/viewforum.php?f=122 Sección en Español del Foro MTA].

'''Para aportar en el wiki nececitas tener una cuenta OpenID. Si borras contenido que no es propio o haces SPAM, serás penalizado con el banneo de la cuenta en el wiki.'''

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">La última versión estable de '''Multi Theft Auto: San Andreas''' es '''{{Current Version|full}}'''. Visita la [http://mtasa.com/ página oficial] para obtenerla. También puedes elegir una versión "nightly" (sólo para desarrolladores o gente que quiera ayudar reportando bugs) en la sección de [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 versiones "nightly"], recuerda que estas versión se actualizan casi a diario, y son poco estables en lo que a errores se refiere (además son incompatibles con la mayoría de los servidores).</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Cómo empezar====

* [[ES/Manual_Cliente_Deathmatch| Manual del Cliente]] [[Image:flag_es.png|En Español]]
* [[ES/Manual Servidor Deathmatch| Manual del Servidor]] [[Image:flag_es.png|En Español]]
* [[ES/Problemas_Conocidos_-_FAQ| Problemas Conocidos]] [[Image:flag_es.png|En Español]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Programación====
* [[ES/Introducción a la Programación| Introducción a la Programación en LUA]] (en construcción) [[Image:flag_es.png|En Español]]
* [[Introduction to Scripting the GUI| Introducción a la Programación del GUI]] [[Image:flag_us.png|En Inglés]]
* [[Debugging| Tutorial de Depuración]] [[Image:flag_us.png|En Inglés]] - Cómo encontrar errores en tus scripts.

* [[Resources| Introducción a los Resources]] [[Image:flag_us.png|En Inglés]]
** [[Resource Web Access| Acceso de Web con Resources]] [[Image:flag_us.png|En Inglés]] - Cómo escribir páginas web.
** [[:Category:Resource| Catálogo de Resources]] [[Image:flag_us.png|En Inglés]]
** [[Meta.xml| Sobre el archivo "meta.xml"]] [[Image:flag_us.png|En Inglés]]
* [[Map_manager| El Resource "Map Manager"]] [[Image:flag_us.png|En Inglés]]
* [[Writing_Gamemodes| Escribiendo Modos de Juego]] [[Image:flag_us.png|En Inglés]]
* [[Useful_Functions| Funciones útiles]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Base de Datos====
Esta sección provee de todas las capacidades de LUA y también algunos resources importantes.
* [[:Category:Resource| Catálogo de Resources]] [[Image:flag_us.png|En Inglés]] - Debes aprender a manejarlos para hacer buenos scripts.
* [[ES/Scripts de Cliente| Scripts de Cliente]] [[Image:flag_es.png|En Español]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Ayuda General de LUA====
Éstas páginas te pueden ayudar a manejar mejor LUA.
*[http://www.lua.org/manual/5.1/es/manual.html "Manual de Referencia de LUA 5.1"] [[Image:flag_es.png|En Español]]
*[http://www.lua.org/pil/index.html Manual "Programando en LUA"] [[Image:flag_us.png|En Inglés]]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki LUA Wiki] [[Image:flag_us.png|En Inglés]]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Guía general de LUA de Nixstaller] [[Image:flag_us.png|En Inglés]]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Editor de Mapas====
*[[ES/Resource:Editor| Manual]] [[Image:flag_es.png|En Traducción]] (EN TRADUCCION)
*[[Resource:Editor/EDF| EDF: Formato de Definiciones del Editor]] [[Image:flag_us.png|En Inglés]]
*[[Resource:Editor/Plugins| Plugins]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Referencias====
* [[Client Scripting Functions|Funciones de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[Client Scripting Events|Eventos de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[ES/Server Scripting Functions|Funciones de Servidor]] [[Image:flag_es.png|En Español]]
* [[Server Scripting Events|Eventos de Servidor]] [[Image:flag_us.png|En Inglés]]

* [[ES/Clases MTA| Clases de MTA]] [[Image:flag_es.png|En Español]] - Descripción de cada uno de los "tipos" personalizados de MTA.
** [[Element| Definición de Elemento]] [[Image:flag_es.png|En Español]]
**[[Element tree| Árbol de Elementos]] [[Image:flag_us.png|En Inglés]]
* [[ES/Tipos de Valores| Tipos de valores]] [[Image:flag_es.png|En Español]] - Descripción de los tipos de valores usados en LUA.
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|Lista de IDs]]====
*[[Animations|Animaciones]]
*[[ES/Skins de Personajes|Skins]]
*[[CJ_Clothes|Ropa]]
*[[Garage|Garajes]]
*[[Interior IDs|Interiores]]
*[[Projectiles|Proyectiles]]
*[[Radar Blips|Iconos de Radar]]
*[[Sounds|Sonidos]]
*[[Vehicle IDs|ID's de Vehículos]]
*[[Vehicle Colors|Colores de Vehículos]]
*[[Vehicle Upgrades|Mejoras de Vehículos]]
*[[Weapons|Armas]]
*[[Weather|Climas]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Traducción====
* ¿Quieres ayudar a traducir el wiki? ¡Qué esperas! Deja tu e-mail (si quieres) aquí y empieza a hacerlo.
Traductores:<br>
* [mailto:zorrigas@gtagamingchile.com zorrigas@gtagamingchile.com]<br>
* [mailto:Brijido_XD@hotmail.com Brijido_XD@hotmail.com]<br>
* [mailto:benxamix2@hotmail.com benxamix2@hotmail.com]<br>
* [mailto:matiuno@gmail.com matiuno@gmail.com]<br>
<br>
'''¡NO ELIMINES CONTENIDO SIN AUTORIZACIÓN!'''<br> Tampoco uses modismos, usa el Castellano (Internacional), y trata de que al traducir todo quede tan claro como puedas, así nos ayudas más.
</div>
|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]

ES/Página Principal

2011-01-15T22:57:14Z

Gothemsh: /* Referencias */

__NOTOC__
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Bienvenido al wiki de Multi Theft Auto: San Andreas en Español. En este wiki encontrarás una gran cantidad de información sobre el desarrollo de mapas y modos de juego para Multi Theft Auto.

Hay muchas [[How you can help|cosas que puedes hacer para ayudarnos]] a mejorar MTA - crear mapas, modos de juego, ayudar con scripts y comandos, escribir un código de ejemplo, traducir páginas del wiki, escribir tutoriales, o tan sólo jugar MTA, y reportar los errores que encuentres, en el [http://forum.multitheftauto.com| Foro de MTA].

Si tienes preguntas, dudas o consultas acerca de alguna función, o script, no dudes en consultarnos por el [[IRC Channel|Canal de IRC ]][[Image:flag_us.png|En Inglés]] o en la [http://forum.mtasa.com/viewforum.php?f=122 Sección en Español del Foro MTA].

'''Para aportar en el wiki nececitas tener una cuenta OpenID. Si borras contenido que no es propio o haces SPAM, serás penalizado con el banneo de la cuenta en el wiki.'''

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">La última versión estable de '''Multi Theft Auto: San Andreas''' es '''{{Current Version|full}}'''. Visita la [http://mtasa.com/ página oficial] para obtenerla. También puedes elegir una versión "nightly" (sólo para desarrolladores o gente que quiera ayudar reportando bugs) en la sección de [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 versiones "nightly"], recuerda que estas versión se actualizan casi a diario, y son poco estables en lo que a errores se refiere (además son incompatibles con la mayoría de los servidores).</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Cómo empezar====

* [[ES/Manual_Cliente_Deathmatch| Manual del Cliente]] [[Image:flag_es.png|En Español]]
* [[ES/Manual Servidor Deathmatch| Manual del Servidor]] [[Image:flag_es.png|En Español]]
* [[ES/Problemas_Conocidos_-_FAQ| Problemas Conocidos]] [[Image:flag_es.png|En Español]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Programación====
* [[ES/Introducción a la Programación| Introducción a la Programación en LUA]] (en construcción) [[Image:flag_es.png|En Español]]
* [[Introduction to Scripting the GUI| Introducción a la Programación del GUI]] [[Image:flag_us.png|En Inglés]]
* [[Debugging| Tutorial de Depuración]] [[Image:flag_us.png|En Inglés]] - Cómo encontrar errores en tus scripts.

* [[Resources| Introducción a los Resources]] [[Image:flag_us.png|En Inglés]]
** [[Resource Web Access| Acceso de Web con Resources]] [[Image:flag_us.png|En Inglés]] - Cómo escribir páginas web.
** [[:Category:Resource| Catálogo de Resources]] [[Image:flag_us.png|En Inglés]]
** [[Meta.xml| Sobre el archivo "meta.xml"]] [[Image:flag_us.png|En Inglés]]
* [[Map_manager| El Resource "Map Manager"]] [[Image:flag_us.png|En Inglés]]
* [[Writing_Gamemodes| Escribiendo Modos de Juego]] [[Image:flag_us.png|En Inglés]]
* [[Useful_Functions| Funciones útiles]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Base de Datos====
Esta sección provee de todas las capacidades de LUA y también algunos resources importantes.
* [[:Category:Resource| Catálogo de Resources]] [[Image:flag_us.png|En Inglés]] - Debes aprender a manejarlos para hacer buenos scripts.
* [[ES/Scripts de Cliente| Scripts de Cliente]] [[Image:flag_es.png|En Español]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Ayuda General de LUA====
Éstas páginas te pueden ayudar a manejar mejor LUA.
*[http://www.lua.org/manual/5.1/es/manual.html "Manual de Referencia de LUA 5.1"] [[Image:flag_es.png|En Español]]
*[http://www.lua.org/pil/index.html Manual "Programando en LUA"] [[Image:flag_us.png|En Inglés]]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki LUA Wiki] [[Image:flag_us.png|En Inglés]]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Guía general de LUA de Nixstaller] [[Image:flag_us.png|En Inglés]]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Editor de Mapas====
*[[ES/Resource:Editor| Manual]] [[Image:flag_es.png|En Traducción]] (EN TRADUCCION)
*[[Resource:Editor/EDF| EDF: Formato de Definiciones del Editor]] [[Image:flag_us.png|En Inglés]]
*[[Resource:Editor/Plugins| Plugins]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Referencias====
* [[Client Scripting Functions|Funciones de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[Client Scripting Events|Eventos de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[Server Scripting Functions|Funciones de Servidor]] [[Image:flag_es.png|En Español]]
* [[Server Scripting Events|Eventos de Servidor]] [[Image:flag_us.png|En Inglés]]

* [[ES/Clases MTA| Clases de MTA]] [[Image:flag_es.png|En Español]] - Descripción de cada uno de los "tipos" personalizados de MTA.
** [[Element| Definición de Elemento]] [[Image:flag_es.png|En Español]]
**[[Element tree| Árbol de Elementos]] [[Image:flag_us.png|En Inglés]]
* [[ES/Tipos de Valores| Tipos de valores]] [[Image:flag_es.png|En Español]] - Descripción de los tipos de valores usados en LUA.
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|Lista de IDs]]====
*[[Animations|Animaciones]]
*[[ES/Skins de Personajes|Skins]]
*[[CJ_Clothes|Ropa]]
*[[Garage|Garajes]]
*[[Interior IDs|Interiores]]
*[[Projectiles|Proyectiles]]
*[[Radar Blips|Iconos de Radar]]
*[[Sounds|Sonidos]]
*[[Vehicle IDs|ID's de Vehículos]]
*[[Vehicle Colors|Colores de Vehículos]]
*[[Vehicle Upgrades|Mejoras de Vehículos]]
*[[Weapons|Armas]]
*[[Weather|Climas]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Traducción====
* ¿Quieres ayudar a traducir el wiki? ¡Qué esperas! Deja tu e-mail (si quieres) aquí y empieza a hacerlo.
Traductores:<br>
* [mailto:zorrigas@gtagamingchile.com zorrigas@gtagamingchile.com]<br>
* [mailto:Brijido_XD@hotmail.com Brijido_XD@hotmail.com]<br>
* [mailto:benxamix2@hotmail.com benxamix2@hotmail.com]<br>
* [mailto:matiuno@gmail.com matiuno@gmail.com]<br>
<br>
'''¡NO ELIMINES CONTENIDO SIN AUTORIZACIÓN!'''<br> Tampoco uses modismos, usa el Castellano (Internacional), y trata de que al traducir todo quede tan claro como puedas, así nos ayudas más.
</div>
|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]

Server Scripting Functions

2011-01-15T22:56:50Z

Gothemsh:

<pageclass class="server"></pageclass>
This page lists all the '''server-side''' scripting functions that have been implemented and are available as native functions. To request a function or event, use [[Requested Functions and Events]] or http://bugs.mtasa.com.

Please note that the scripting functions can also be extended by loading in dynamic modules that provide new functionality, such as MySQL database access. These scripting functions are non-native and require the module to be loaded in order to work.

Head over to [[Modules]] for a list of non-native serverside functions and modules that are available.

For more functions, check the [[Useful_Functions|useful functions page]].

'''Client-side scripting functions can be found here: [[Client Scripting Functions]].'''

==Account functions==
{{Account_functions}}

==ACL functions==
{{ACL_functions}}

==Admin functions==
{{Admin_functions}}

==Audio functions==
{{Audio_functions}}

==Announcement functions==
{{Announce_functions}}

==Blip functions==
{{Blip_functions}}

==Camera functions==
{{Camera functions}}

==Collision shape functions==
{{Collision shape functions}}

==Clothes and body functions==
{{Clothes and body functions}}

==Cursor functions==
{{Cursor_functions}}

==Element functions==
{{Element functions}}

==Event functions==
{{Event_functions}}

==Explosion functions==
{{Explosion_functions}}

==File functions==
{{File_functions}}

==HTTP functions==
{{HTTP_functions}}

==Input functions==
{{Input_functions}}

==Map functions==
{{Map_functions}}

==Marker functions==
{{Marker functions}}

==Module functions==
{{Module functions}}

==Object functions==
{{Object functions}}

==Ped functions==
{{Ped_functions}}

==Pickup functions==
{{Pickup functions}}

==Player functions==
{{Player functions}}

==Radar area functions==
{{Radar area functions}}

==Resource functions==
{{Resource functions}}

==Serial functions==
{{Serial functions}}

==Server functions==
{{Server functions}}

==Settings registry functions==
{{Settings registry functions}}

==SQL functions==
{{SQL_functions}}

==Team functions==
{{Team functions}}

==Text functions==
{{Text functions}}

==Utility functions==
{{Utility functions}}

==Vehicle functions==
{{Vehicle functions}}

==Water functions==
{{Water functions}}

==Weapon functions==
{{Weapon functions}}

==World functions==
{{World functions}}

==XML functions==
{{XML functions}}

[[ru:Server Scripting Functions]]
[[es:Server Scripting Functions]]

ES/Funciones de Servidor

2011-01-15T22:56:20Z

Gothemsh: Created page with "<pageclass class="server"></pageclass> Esta pagina muestra todas las funciones del '''servidor''' que han sido implementadas y disponibles como funciones nativas. Para pedir una ..."

<pageclass class="server"></pageclass>
Esta pagina muestra todas las funciones del '''servidor''' que han sido implementadas y disponibles como funciones nativas. Para pedir una función o un evento, usa [[Requested Functions and Events|funciones y eventos pedidos]] o http://bugs.mtasa.com.

Por favor ten en cuenta que las funciones se pueden también extender cargando un modulo dinámico que entregue una nueva funcionalidad, como el MySQL database access. Estas funciones no son nativas y requieren que el modulo este cargado para funcionar.

Vea [[Modules|Modulos]] para una lista de funciones de servidor no-nativas y módulos que están disponibles.

Para mas funciones, vea la pagina de [[Useful_Functions|funciones útiles]].

'''Las funciones de cliente se pueden encontrar aqui: [[Client Scripting Functions|Funciones de cliente]].'''

'''Tenga en cuenta que casi todas las funciones presentes no presentan una traducción en su definición'''

==Funciones de cuenta==
{{Account_functions}}

==Funciones de ACL==
{{ACL_functions}}

==Funciones Administrativas==
{{Admin_functions}}

==Funciones de audio==
{{Audio_functions}}

==Funciones de anuncio==
{{Announce_functions}}

==Funciones de blip==
{{Blip_functions}}

==Funciones de cámara==
{{Camera functions}}

==Funciones de colisión==
{{Collision shape functions}}

==Funciones de ropa y cuerpo==
{{Clothes and body functions}}

==Funciones de cursor==
{{Cursor_functions}}

==Funciones de elemento==
{{Element functions}}

==Funciones de evento==
{{Event_functions}}

==Funciones explosivas==
{{Explosion_functions}}

==Funciones de archivos==
{{File_functions}}

==Funciones de HTTP==
{{HTTP_functions}}

==Funciones de Input==
{{Input_functions}}

==Funciones de mapa==
{{Map_functions}}

==Funciones de marcadores==
{{Marker functions}}

==Funciones de modulos==
{{Module functions}}

==Funciones de objetos==
{{Object functions}}

==Funciones de peds==
{{Ped_functions}}

==Funciones de pickup==
{{Pickup functions}}

==Funciones de jugadores==
{{Player functions}}

==Funciones de area de radar==
{{Radar area functions}}

==Funciones de recursos==
{{Resource functions}}

==Funciones de serial==
{{Serial functions}}

==Funciones de servidor==
{{Server functions}}

==Funciones de registro de propiedades==
{{Settings registry functions}}

==Funciones de SQL==
{{SQL_functions}}

==Funciones de equipo==
{{Team functions}}

==Funciones de texto==
{{Text functions}}

==Funciones de utilidad==
{{Utility functions}}

==Funciones de vehiculos==
{{Vehicle functions}}

==Funciones de agua==
{{Water functions}}

==Funciones de arma==
{{Weapon functions}}

==Funciones del mundo==
{{World functions}}

==Funciones de XML==
{{XML functions}}

[[ru:Server Scripting Functions]]
[[en:Server Scripting Functions]]

ES/Página Principal

2011-01-15T22:43:13Z

Gothemsh: /* Traducción */

__NOTOC__
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Bienvenido al wiki de Multi Theft Auto: San Andreas en Español. En este wiki encontrarás una gran cantidad de información sobre el desarrollo de mapas y modos de juego para Multi Theft Auto.

Hay muchas [[How you can help|cosas que puedes hacer para ayudarnos]] a mejorar MTA - crear mapas, modos de juego, ayudar con scripts y comandos, escribir un código de ejemplo, traducir páginas del wiki, escribir tutoriales, o tan sólo jugar MTA, y reportar los errores que encuentres, en el [http://forum.multitheftauto.com| Foro de MTA].

Si tienes preguntas, dudas o consultas acerca de alguna función, o script, no dudes en consultarnos por el [[IRC Channel|Canal de IRC ]][[Image:flag_us.png|En Inglés]] o en la [http://forum.mtasa.com/viewforum.php?f=122 Sección en Español del Foro MTA].

'''Para aportar en el wiki nececitas tener una cuenta OpenID. Si borras contenido que no es propio o haces SPAM, serás penalizado con el banneo de la cuenta en el wiki.'''

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">La última versión estable de '''Multi Theft Auto: San Andreas''' es '''{{Current Version|full}}'''. Visita la [http://mtasa.com/ página oficial] para obtenerla. También puedes elegir una versión "nightly" (sólo para desarrolladores o gente que quiera ayudar reportando bugs) en la sección de [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 versiones "nightly"], recuerda que estas versión se actualizan casi a diario, y son poco estables en lo que a errores se refiere (además son incompatibles con la mayoría de los servidores).</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Cómo empezar====

* [[ES/Manual_Cliente_Deathmatch| Manual del Cliente]] [[Image:flag_es.png|En Español]]
* [[ES/Manual Servidor Deathmatch| Manual del Servidor]] [[Image:flag_es.png|En Español]]
* [[ES/Problemas_Conocidos_-_FAQ| Problemas Conocidos]] [[Image:flag_es.png|En Español]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Programación====
* [[ES/Introducción a la Programación| Introducción a la Programación en LUA]] (en construcción) [[Image:flag_es.png|En Español]]
* [[Introduction to Scripting the GUI| Introducción a la Programación del GUI]] [[Image:flag_us.png|En Inglés]]
* [[Debugging| Tutorial de Depuración]] [[Image:flag_us.png|En Inglés]] - Cómo encontrar errores en tus scripts.

* [[Resources| Introducción a los Resources]] [[Image:flag_us.png|En Inglés]]
** [[Resource Web Access| Acceso de Web con Resources]] [[Image:flag_us.png|En Inglés]] - Cómo escribir páginas web.
** [[:Category:Resource| Catálogo de Resources]] [[Image:flag_us.png|En Inglés]]
** [[Meta.xml| Sobre el archivo "meta.xml"]] [[Image:flag_us.png|En Inglés]]
* [[Map_manager| El Resource "Map Manager"]] [[Image:flag_us.png|En Inglés]]
* [[Writing_Gamemodes| Escribiendo Modos de Juego]] [[Image:flag_us.png|En Inglés]]
* [[Useful_Functions| Funciones útiles]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Base de Datos====
Esta sección provee de todas las capacidades de LUA y también algunos resources importantes.
* [[:Category:Resource| Catálogo de Resources]] [[Image:flag_us.png|En Inglés]] - Debes aprender a manejarlos para hacer buenos scripts.
* [[ES/Scripts de Cliente| Scripts de Cliente]] [[Image:flag_es.png|En Español]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Ayuda General de LUA====
Éstas páginas te pueden ayudar a manejar mejor LUA.
*[http://www.lua.org/manual/5.1/es/manual.html "Manual de Referencia de LUA 5.1"] [[Image:flag_es.png|En Español]]
*[http://www.lua.org/pil/index.html Manual "Programando en LUA"] [[Image:flag_us.png|En Inglés]]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki LUA Wiki] [[Image:flag_us.png|En Inglés]]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Guía general de LUA de Nixstaller] [[Image:flag_us.png|En Inglés]]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Editor de Mapas====
*[[ES/Resource:Editor| Manual]] [[Image:flag_es.png|En Traducción]] (EN TRADUCCION)
*[[Resource:Editor/EDF| EDF: Formato de Definiciones del Editor]] [[Image:flag_us.png|En Inglés]]
*[[Resource:Editor/Plugins| Plugins]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Referencias====
* [[Client Scripting Functions|Funciones de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[Client Scripting Events|Eventos de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[Server Scripting Functions|Funciones de Servidor]] [[Image:flag_us.png|En Inglés]]
* [[Server Scripting Events|Eventos de Servidor]] [[Image:flag_us.png|En Inglés]]

* [[ES/Clases MTA| Clases de MTA]] [[Image:flag_es.png|En Español]] - Descripción de cada uno de los "tipos" personalizados de MTA.
** [[Element| Definición de Elemento]] [[Image:flag_es.png|En Español]]
**[[Element tree| Árbol de Elementos]] [[Image:flag_us.png|En Inglés]]
* [[ES/Tipos de Valores| Tipos de valores]] [[Image:flag_es.png|En Español]] - Descripción de los tipos de valores usados en LUA.
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|Lista de IDs]]====
*[[Animations|Animaciones]]
*[[ES/Skins de Personajes|Skins]]
*[[CJ_Clothes|Ropa]]
*[[Garage|Garajes]]
*[[Interior IDs|Interiores]]
*[[Projectiles|Proyectiles]]
*[[Radar Blips|Iconos de Radar]]
*[[Sounds|Sonidos]]
*[[Vehicle IDs|ID's de Vehículos]]
*[[Vehicle Colors|Colores de Vehículos]]
*[[Vehicle Upgrades|Mejoras de Vehículos]]
*[[Weapons|Armas]]
*[[Weather|Climas]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Traducción====
* ¿Quieres ayudar a traducir el wiki? ¡Qué esperas! Deja tu e-mail (si quieres) aquí y empieza a hacerlo.
Traductores:<br>
* [mailto:zorrigas@gtagamingchile.com zorrigas@gtagamingchile.com]<br>
* [mailto:Brijido_XD@hotmail.com Brijido_XD@hotmail.com]<br>
* [mailto:benxamix2@hotmail.com benxamix2@hotmail.com]<br>
* [mailto:matiuno@gmail.com matiuno@gmail.com]<br>
<br>
'''¡NO ELIMINES CONTENIDO SIN AUTORIZACIÓN!'''<br> Tampoco uses modismos, usa el Castellano (Internacional), y trata de que al traducir todo quede tan claro como puedas, así nos ayudas más.
</div>
|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]

ES/Tipos de Valores

2011-01-15T22:41:23Z

Gothemsh:

Los valores que una función regresa deben ser conocidos por el programador, para que éste comprenda mejor cómo funciona LUA y entienda las diferencias. Si no aprende los tipos de valores es posible que se pierda dentro de una confusión acerca de porqué no puede realizar una función determinada debido al tipo de valor entrado.

Así como los elementos diferentes en la vida real, dos tipos de valores distintos no pueden compararse entre sí. Un valor "boolean" no puede compararse con un número porque no tiene un valor numérico que le permita hacer tal cosa, en vez de eso tiene un valor "verdadero" o "falso". Las tablas no pueden ser usadas para una operación matemática, pero sus valores interiores sí pueden, si es que son números.

== Los Valores ==

* '''Boolean / Lógico''' - Sólo tiene 2 valores posibles: "true" y "false" ("verdadero" y "falso").
* '''Integer: Int / Número Entero''' - Varía desde el infinito negativo hasta el infinito positivo. No puede contener decimales.
* '''Floating Point Number: Float / Número de Punto Flotante''' - Es igual al número entero con la diferencia de que éste sí puede contener decimales.
* '''Table / Tabla''' - Es un conjunto organizado de datos, generalmente usado para procesarlos más fácilmente y en forma común.
* '''Nil''' - Nada.
* '''String / Arreglo''' - Es un texto contenido entre comillas o dos pares de parentesis cuadrados.

ES/Resource:Editor

2011-01-15T22:38:42Z

Gothemsh:

{{Resource page}}
El editor de mapas de MTA:SA te permite crear mapas para los modos de juegos.

==Empezando==
Para empezar el editor, simplemente presiona "Map editor" en el menú principal de MTA

==Menus==
Una vez que el editor haya comenzado, se te mostrarán dos menús de barras: La principal arriba, y la de elementos a la esquina inferior izquierda.

===Menú principal===
Estos son los botones en el menú principal:
* [[Image:Editor_New.png]] Crear un nuevo mapa.
* [[Image:Editor_Open.png]] Abrir un mapa existente.
* [[Image:Editor_Save.png]] Grabar el mapa en que estás trabajando.
* [[Image:Editor_Save_as.png]] Grabar el mapa bajo un nombre diferente.
* [[Image:Editor_Options.png]] Modificar las opciones generales del editor.
* [[Image:Editor_Undo.png]] Deshacer la ultima acción.
* [[Image:Editor_Redo.png]] Restaurar la ultima acción deshecha.
* [[Image:Editor_Locations.png]] Lista de lugares "favoritos" de GTA.
* [[Image:Editor_Current_elements.png]] Lista de todos los elementos contenidos en el mapa (Autos, Objetos, Marcadores, Pickups, etc).
* [[Image:Editor_Map_settings.png]] Propiedades del mapa, como el tiempo, la gravedad, etc. Aquí también puedes especificar los modos de juego que son compatibles con tu mapa.
* [[Image:Editor_Definitions.png]] Cargar [[Resource:Editor/EDF| definiciones del editor (EDF)]] que tú quieras usar
* [[Image:Editor_Test.png]] Ir al modo play para probar el mapa, O puede cargar el modo al que el mapa esta hecho.

===Menú de elementos===
El menú de elementos es usado para agregar nuevos elementos al mapa.
* [[Image:Editor_Vehicle.png]] Crear un nuevo vehículo
* [[Image:Editor_Object.png]] Crear un nuevo objeto (edificios, caminos, basura, árboles, rocas, decoración exterior, etc).
* [[Image:Editor_Pickup.png]] Crear un nuevo pickup (sólo se puede crear de vida, armadura o armas).
* [[Image:Editor_Marker.png]] Crear un nuevo marcador.

Adicionalmente, si tu tienes una [[Resource:Editor/EDF| definición de editor]] cargada, girando la rueda del ratón (con el cursor sobre el menú) puedes cargar esos elementos propios.

==Usando el editor==
Esta sección te explicará cómo crear y modificar mapas.

===Moviéndose alrededor del mapa===
Cuando inicias el editor, inicias en el ''modo de cámara''. Puedes usar las teclas '''W, S, A y D''' para mover la cámara y el ratón para girar la cámara. Cuando te muevas, puedes mantener la tecla '''ALT''' para moverte más lento, o la tecla '''SHIFT''' para ir más rápido.

Para acceder a la interfaz del editor y al panel de control necesitas cambiar al ''modo de cursor''. Puedes cambiar entre el modo de cursor y el modo de cámara con la tecla '''F'''. Cuando estés en modo de cursor, tu vista estará congelada, y solo podrás usar el cursor del ratón para manipular elementos y usar la interfaz gráfica.

El modo de cámara puede ser reconocido por una mira en medio de la pantalla. Puedes usarla para seleccionar y mover elementos como en el modo de cursor. Esta mira tiene el diseño siguiente:

[[Image:Editor_Crosshair.png|center]]

===Empezando un nuevo mapa===
* Inicia el editor, o si ya está iniciado, apreta el boton ''Nuevo'' del menú.
* Apreta el botón ''Opciones de mapa''. En la pestaña ''Meta'', llena los campos de "Name" y "Author" con el nombre de tu mapa y tu nick en MTA, respectivamente. También abre la pestaña ''Gamemodes'' y agrega los modos de juego para los cuales tu mapa está hecho (éstos se van a mover a la lista de ''Added Gamemodes''). Puedes hacer esto seleccionándolos y apretando en ''Add'', o haciendo doble click sobre ellos. Apreta OK cuando estés listo.
[[Image:Editor_Mapsettings.png|center]]
* Apreta en la ventana de ''Definiciones'' y agrega los recursos en donde uses los elementos alternativos. Estos debieran consistir de los modos que tu seleccionaste en la ventana de ''Map settings'', ademas de eventuales recursos adicionales. Para mas informacion acerca de las definiciones del editor, ve [[Resource:Editor/EDF|EDF (En Inglés)]]. Apreta OK cuando estes listo.

===Creando nuevos elementos===
* Si tu estas en el modo de camara, cambia al modo de cursor primero apretando '''F'''.
* Apreta un boton en el menu de elementos que represente lo que tu quieres. Ej: Apreta el boton con un auto en el para agregar un vehiculo.
* Un nuevo elemento del tipo seleccionado sera creado y pegado a tu cursor. Muevelo a la posicion que quieras y apreta el '''botón izquierdo''' para dejarlo.

[[Image:Editor_Addelem.png|center]]

Para crear un elemento alternativo que es especifico a un recurso, mueve tu cursor sobre el menu de elementos y gira la rueda del ratón hasta el recurso esperado. Ten en cuenta que para este trabajo, primero necesitas haber agregado el archivo de [[Resource:Editor/EDF|Definición de editor]] del recurso en la ventana ''Definitions''.

[[Image:Editor_Selectedf.png|center]]

===Seleccionando===
* '''Click izquierdo''' sobre un elemento para seleccionarlo en ''modo de teclado''.
* '''Click derecho''' sobre este elemento para seleccionarlo en ''modo de ratón''.
* Apreta la '''Barra espaciadora''' o apreta sobre un area vacia para sacar la selección.

El elemento elegido, si lo hay, es representado por un marcador de cono amarillo. Elementos (particularmente objetos) con pesima colision se peuden detectar facilmente activando el ''modo de alta sensibilidad'', apretando la tecla '''E'''. Esto incrementara la detección.

El dialogo ''Current elements'' puede ser usado tambien para seleccionar elementos. Has doble-click sobre un item de la lista para seleccionarlo en ''modo de teclado''

===Moviendo===
Mover elementos se puede hacer de muchas formas.

'''Con el ratón'''
* Simplemente pesca y deja con el '''boton izquierdo'''
O:
* Selecciona el elemento en el modo de ratón ('''boton derecho'''), muevelo hacia la posición que quieras, y apreta para dejarlo.

Tu tambien puedes ajustar la ''distancia'' de un elemento acercandolo o alejandolo de la camara mediante el cambio al modo de camara, ''''click derecho''' en un elemento girando la '''rueda del ratón'''.

'''Con el teclado'''
* Selecciona el elemento en el modo de teclado ('''boton izquierdo'''),
* Usa las '''flechas del teclado''' para mover el elemento en un plano horizontal, y '''repág'''/'''avpág''' para moverlo verticalmente. Mantén '''ALT''' para disminuir la velocidad de movimiento, o '''SHIFT''' para incrementarla.

Por defecto, los elementos se mueven relativamente a la cámara y no están limitadas a sus ejes. Esto se puede desactivar en el menu de '''Opciones'''

===Rotating===
'''With the mouse'''

You can rotate selected elements around the Z axis with the mouse wheel.
* Select the element in keyboard mode ('''left click''') and roll the mouse wheel while holding '''Left CTRL'''.
Or:
* Select the element in mouse mode ('''right click'''), hold '''CTRL''', and roll the mouse wheel.

'''With the keyboard'''
* Select the element in keyboard mode ('''left click''').
* While holding '''CTRL''' (the selection marker will turn green), use the '''arrow keys''' and '''PgUp'''/'''PgDn''' to rotate the element around the different axes.

With both methods you can additionally hold '''ALT''' to decrease the rotation speed or '''SHIFT''' to increase it.

[[Image:Editor_Rotateelem.png|center]]

===Cambio de modelo y otras propiedades===
La mayoría de los elementos tiene una variedad de opciones que pueden ser alteradas para cambiar su apariencia. Ejemplos son los modelos, color y las actualizaciones visuales de un auto.

* Abre la ventana de propiedades de un elemento, presionando dos veces en el o seleccionándolo y apretando '''F3'''.
* Hace las modificaciones que tu quieras. Por ejemplo, para cambiar el modelo de un auto o objeto, presiona en el botón '''Browse''' al lado de "model" para abrir el buscador de modelos.
* presiona OK cuando estés listo

[[Image:Editor_Props.png|center]]

===Cloning===
You can clone an element by selecting it and pressing '''C'''.

* In mouse mode the cloned element will be attached to your cursor. '''Left click''' to place it in the map.
* In keyboard mode the cloned element will be cloned in the identical position.

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.

Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to clone an element.

===Deleting===
Simply select the element and press '''DEL''' ''(Delete)''.

Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to delete an element.

==Creating maps for specific gamemodes==
To make a map for a specific gamemode, you have to do two things:
* Click the '''Map Settings''' button in the top menu, go to the '''Gamemodes''' tab and add any gamemodes that your map is to be used with.
* You will likely also need to add one or more [[Resource:Editor/EDF|Editor Definition Files]]. These will allow you to place gamemode specific elements in the map, like spawnpoints, race checkpoints, or CTF flags. You can add EDF's by clicking the '''Definitions''' menu button and adding the relevant gamemodes.

==Controls==
Here is a list of all default controls. To change them please go to the MTA Settings menu while the Editor is started.

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

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

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

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

==Multiplayer==
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.

Please note that currently the editor lacks any permissions system, ao all users have access to every function.

==Plugins & External resources==
{{Main|Resource:Editor/Plugins}}

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.

By using the '''import <resourceName>''' command in console the resource's elements can be imported within the editor.

==FAQ==
==== I get a black screen when launching the Map Editor ====

Usually this is caused due to incorrect installation of Map Editor resources. If you are using a stable MTASA client, please install it again and make sure that you use Client and Server install option.

If you are using a nightly build, to get it working right you need to download latest [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 resources (step 3)], unpack the archive and put its contents in:
''MTA San Andreas\server\mods\deathmatch\resources'' , where ''MTA San Andreas'' is a folder where you've installed MTA San Andreas (default location: C:\Program Files\MTA San Andreas).

Putting them in this path: MTA San Andreas\mods\deathmatch\resources '''is a common mistake''' - it won't work if you put them there. So make sure to put them in the ''italic'' path above.

If this issue still occurs, even when you've checked the note above and verified that you've installed it correctly, it might be because you've got an outdated '''acl.xml''' file. You can download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.

==== I get an "Could not start the local server. See console for details" when using the "Map Editor" button ====
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.

==== I have saved a map but cannot find it in my server's resources directory, despite the Editor itself being able to see it ====
This is due to the fact that Vista/7 limits write-access for non-admin processes in Program Files directory. Files get written in the "VirtualStore" directory instead of real Program Files folder. You should be able to locate your map resource in a similar directory to:
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\

Running the Server/MTA San Andreas with Administrative rights will allow the map to be saved to the proper location.

==== I have found a bug or have a suggestion/feedback for the map editor ====
Please use the official [http://bugs.mtasa.com bugtracker] for reporting bugs. Feel free to also join us on [http://www.multitheftauto.com/irc.html IRC].

[[ru:Resource:Editor]]
[[en:Resource:Editor]]
[[Category:Incomplete]]

ES/Página Principal

2011-01-14T16:06:22Z

Gothemsh: /* Editor de Mapas */

__NOTOC__
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Bienvenido al wiki de Multi Theft Auto: San Andreas en Español. En este wiki encontrarás una gran cantidad de información sobre el desarrollo de mapas y modos de juego para Multi Theft Auto.

Hay muchas [[How you can help|cosas que puedes hacer para ayudarnos]] a mejorar MTA - crear mapas, modos de juego, ayudar con scripts y comandos, escribir un código de ejemplo, traducir páginas del wiki, escribir tutoriales, o tan sólo jugar MTA, y reportar los errores que encuentres, en el [http://forum.multitheftauto.com| Foro de MTA].

Si tienes preguntas, dudas o consultas acerca de alguna función, o script, no dudes en consultarnos por el [[IRC Channel|Canal de IRC ]][[Image:flag_us.png|En Inglés]] o en la [http://forum.mtasa.com/viewforum.php?f=122 Sección en Español del Foro MTA].

'''Para aportar en el wiki nececitas tener una cuenta OpenID. Si borras contenido que no es propio o haces SPAM, serás penalizado con el banneo de la cuenta en el wiki.'''

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">La última versión estable de '''Multi Theft Auto: San Andreas''' es '''{{Current Version|full}}'''. Visita la [http://mtasa.com/ página oficial] para obtenerla. También puedes elegir una versión "nightly" (sólo para desarrolladores o gente que quiera ayudar reportando bugs) en la sección de [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 versiones "nightly"], recuerda que estas versión se actualizan casi a diario, y son poco estables en lo que a errores se refiere (además son incompatibles con la mayoría de los servidores).</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Cómo empezar====

* [[ES/Manual_Cliente_Deathmatch| Manual del Cliente]] [[Image:flag_es.png|En Español]]
* [[ES/Manual Servidor Deathmatch| Manual del Servidor]] [[Image:flag_es.png|En Español]]
* [[ES/Problemas_Conocidos_-_FAQ| Problemas Conocidos]] [[Image:flag_es.png|En Español]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Programación====
* [[ES/Introducción a la Programación| Introducción a la Programación en LUA]] (en construcción) [[Image:flag_es.png|En Español]]
* [[Introduction to Scripting the GUI| Introducción a la Programación del GUI]] [[Image:flag_us.png|En Inglés]]
* [[Debugging| Tutorial de Depuración]] [[Image:flag_us.png|En Inglés]] - Cómo encontrar errores en tus scripts.

* [[Resources| Introducción a los Resources]] [[Image:flag_us.png|En Inglés]]
** [[Resource Web Access| Acceso de Web con Resources]] [[Image:flag_us.png|En Inglés]] - Cómo escribir páginas web.
** [[:Category:Resource| Catálogo de Resources]] [[Image:flag_us.png|En Inglés]]
** [[Meta.xml| Sobre el archivo "meta.xml"]] [[Image:flag_us.png|En Inglés]]
* [[Map_manager| El Resource "Map Manager"]] [[Image:flag_us.png|En Inglés]]
* [[Writing_Gamemodes| Escribiendo Modos de Juego]] [[Image:flag_us.png|En Inglés]]
* [[Useful_Functions| Funciones útiles]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Base de Datos====
Esta sección provee de todas las capacidades de LUA y también algunos resources importantes.
* [[:Category:Resource| Catálogo de Resources]] [[Image:flag_us.png|En Inglés]] - Debes aprender a manejarlos para hacer buenos scripts.
* [[ES/Scripts de Cliente| Scripts de Cliente]] [[Image:flag_es.png|En Español]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Ayuda General de LUA====
Éstas páginas te pueden ayudar a manejar mejor LUA.
*[http://www.lua.org/manual/5.1/es/manual.html "Manual de Referencia de LUA 5.1"] [[Image:flag_es.png|En Español]]
*[http://www.lua.org/pil/index.html Manual "Programando en LUA"] [[Image:flag_us.png|En Inglés]]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki LUA Wiki] [[Image:flag_us.png|En Inglés]]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Guía general de LUA de Nixstaller] [[Image:flag_us.png|En Inglés]]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Editor de Mapas====
*[[ES/Resource:Editor| Manual]] [[Image:flag_es.png|En Traducción]] (EN TRADUCCION)
*[[Resource:Editor/EDF| EDF: Formato de Definiciones del Editor]] [[Image:flag_us.png|En Inglés]]
*[[Resource:Editor/Plugins| Plugins]] [[Image:flag_us.png|En Inglés]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Referencias====
* [[Client Scripting Functions|Funciones de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[Client Scripting Events|Eventos de Cliente]] [[Image:flag_us.png|En Inglés]]
* [[Server Scripting Functions|Funciones de Servidor]] [[Image:flag_us.png|En Inglés]]
* [[Server Scripting Events|Eventos de Servidor]] [[Image:flag_us.png|En Inglés]]

* [[ES/Clases MTA| Clases de MTA]] [[Image:flag_es.png|En Español]] - Descripción de cada uno de los "tipos" personalizados de MTA.
** [[Element| Definición de Elemento]] [[Image:flag_es.png|En Español]]
**[[Element tree| Árbol de Elementos]] [[Image:flag_us.png|En Inglés]]
* [[ES/Tipos de Valores| Tipos de valores]] [[Image:flag_es.png|En Español]] - Descripción de los tipos de valores usados en LUA.
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|Lista de IDs]]====
*[[Animations|Animaciones]]
*[[ES/Skins de Personajes|Skins]]
*[[CJ_Clothes|Ropa]]
*[[Garage|Garajes]]
*[[Interior IDs|Interiores]]
*[[Projectiles|Proyectiles]]
*[[Radar Blips|Iconos de Radar]]
*[[Sounds|Sonidos]]
*[[Vehicle IDs|ID's de Vehículos]]
*[[Vehicle Colors|Colores de Vehículos]]
*[[Vehicle Upgrades|Mejoras de Vehículos]]
*[[Weapons|Armas]]
*[[Weather|Climas]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Traducción====
* ¿Quieres ayudar a traducir el wiki? ¡Qué esperas! Deja tu e-mail aquí y empieza a hacerlo.
Traductores:<br>
* [mailto:zorrigas@gtagamingchile.com zorrigas@gtagamingchile.com]<br>
* [mailto:Brijido_XD@hotmail.com Brijido_XD@hotmail.com]<br>
* [mailto:benxamix2@hotmail.com benxamix2@hotmail.com]<br>
* [mailto:matiuno@gmail.com matiuno@gmail.com]<br>
<br>
'''¡NO ELIMINES CONTENIDO SIN AUTORIZACIÓN!'''<br> Tampoco uses modismos, usa el Castellano, y trata de que al traducir todo quede tan claro como puedas, así nos ayudas más.
</div>
|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]

Resource:Editor

2011-01-14T16:03:09Z

Gothemsh:

{{Resource page}}
The MTA:SA map editor allows you to create maps for gamemodes.

==Starting==
To start the editor, simply click the "Map editor" menu item in the main MTA menu.

==Menus==
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.

===Main menu===
These are the buttons in the main menu:
* [[Image:Editor_New.png]] Create a new map.
* [[Image:Editor_Open.png]] Open an existing map.
* [[Image:Editor_Save.png]] Save the map you're working on.
* [[Image:Editor_Save_as.png]] Save your map under a different name.
* [[Image:Editor_Options.png]] Alter general map editor settings.
* [[Image:Editor_Undo.png]] Undo the last action.
* [[Image:Editor_Redo.png]] Restore the last undone action.
* [[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.
* [[Image:Editor_Current_elements.png]] List all the elements the map contains (objects, vehicles, markers, pickups etc.)
* [[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.
* [[Image:Editor_Definitions.png]] Load [[Resource:Editor/EDF|editor definition files (EDF)]] that you want to use.
* [[Image:Editor_Test.png]] Go into play mode to try out the map. This will load up the gamemode the map is made for.

===Element menu===
The element menu is used to add new elements to the map.
* [[Image:Editor_Vehicle.png]] Create a new vehicle.
* [[Image:Editor_Object.png]] TCreate a new object (buildings, roads and other scenery).
* [[Image:Editor_Pickup.png]] Create a new pickup (health, armor, weapons).
* [[Image:Editor_Marker.png]] Create a new marker.

Additionally, if you have [[Resource:Editor/EDF|editor definitions loaded]], you can roll the mousewheel in this menu to bring up custom elements.

==Using the editor==
This section explains how to create and modify maps.

===Moving around the map===
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.

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.

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.

[[Image:Editor_Crosshair.png|center]]

===Starting a new map===
* Start the editor, or if it is already started, click the ''New'' menu button.
* 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.
[[Image:Editor_Mapsettings.png|center]]
* 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.

===Creating new elements===
Adding elements to your map, such as vehicles and objects, is very straightforward.
* If you are in camera mode, switch to cursor mode first by pressing '''F'''.
* 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.
* 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.

[[Image:Editor_Addelem.png|center]]

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.

[[Image:Editor_Selectedf.png|center]]

===Selecting===
* '''Left click''' an element to select it in ''keyboard mode''.
* '''Right click''' it to select it in ''mouse mode''.
* Press the '''Spacebar''' or click in an empty area to deselect.

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.

The ''Current elements'' dialog can also be used to select elements. Double-clicking an item within the list will select it in ''Keyboard mode''.

===Moving===
Moving elements can be done in several ways.

'''With the mouse'''
* Simply drag and drop with the '''left mouse button'''.
Or:
* Select the element in mouse mode ('''right click'''), move it to where you want it, and click to drop it off.

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'''.

'''With the keyboard'''
* Select the element in keyboard mode ('''left click''').
* 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.

By default, elements move relative to the camera and are not locked to any axes. This can be disabled in the ''Options'' menu.

===Rotating===
'''With the mouse'''

You can rotate selected elements around the Z axis with the mouse wheel.
* Select the element in keyboard mode ('''left click''') and roll the mouse wheel while holding '''Left CTRL'''.
Or:
* Select the element in mouse mode ('''right click'''), hold '''CTRL''', and roll the mouse wheel.

'''With the keyboard'''
* Select the element in keyboard mode ('''left click''').
* While holding '''CTRL''' (the selection marker will turn green), use the '''arrow keys''' and '''PgUp'''/'''PgDn''' to rotate the element around the different axes.

With both methods you can additionally hold '''ALT''' to decrease the rotation speed or '''SHIFT''' to increase it.

[[Image:Editor_Rotateelem.png|center]]

===Changing model and other properties===
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.

* Open the properties window of an element by either double clicking it or by selecting it and pressing '''F3'''.
* 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.
* Click OK when you're done.

[[Image:Editor_Props.png|center]]

===Cloning===
You can clone an element by selecting it and pressing '''C'''.

* In mouse mode the cloned element will be attached to your cursor. '''Left click''' to place it in the map.
* In keyboard mode the cloned element will be cloned in the identical position.

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.

Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to clone an element.

===Deleting===
Simply select the element and press '''DEL''' ''(Delete)''.

Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to delete an element.

==Creating maps for specific gamemodes==
To make a map for a specific gamemode, you have to do two things:
* Click the '''Map Settings''' button in the top menu, go to the '''Gamemodes''' tab and add any gamemodes that your map is to be used with.
* You will likely also need to add one or more [[Resource:Editor/EDF|Editor Definition Files]]. These will allow you to place gamemode specific elements in the map, like spawnpoints, race checkpoints, or CTF flags. You can add EDF's by clicking the '''Definitions''' menu button and adding the relevant gamemodes.

==Controls==
Here is a list of all default controls. To change them please go to the MTA Settings menu while the Editor is started.

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

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

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

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

==Multiplayer==
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.

Please note that currently the editor lacks any permissions system, ao all users have access to every function.

==Plugins & External resources==
{{Main|Resource:Editor/Plugins}}

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.

By using the '''import <resourceName>''' command in console the resource's elements can be imported within the editor.

==FAQ==
==== I get a black screen when launching the Map Editor ====

Usually this is caused due to incorrect installation of Map Editor resources. If you are using a stable MTASA client, please install it again and make sure that you use Client and Server install option.

If you are using a nightly build, to get it working right you need to download latest [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 resources (step 3)], unpack the archive and put its contents in:
''MTA San Andreas\server\mods\deathmatch\resources'' , where ''MTA San Andreas'' is a folder where you've installed MTA San Andreas (default location: C:\Program Files\MTA San Andreas).

Putting them in this path: MTA San Andreas\mods\deathmatch\resources '''is a common mistake''' - it won't work if you put them there. So make sure to put them in the ''italic'' path above.

If this issue still occurs, even when you've checked the note above and verified that you've installed it correctly, it might be because you've got an outdated '''acl.xml''' file. You can download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.

==== I get an "Could not start the local server. See console for details" when using the "Map Editor" button ====
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.

==== I have saved a map but cannot find it in my server's resources directory, despite the Editor itself being able to see it ====
This is due to the fact that Vista/7 limits write-access for non-admin processes in Program Files directory. Files get written in the "VirtualStore" directory instead of real Program Files folder. You should be able to locate your map resource in a similar directory to:
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\

Running the Server/MTA San Andreas with Administrative rights will allow the map to be saved to the proper location.

==== I have found a bug or have a suggestion/feedback for the map editor ====
Please use the official [http://bugs.mtasa.com bugtracker] for reporting bugs. Feel free to also join us on [http://www.multitheftauto.com/irc.html IRC].

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

ES/Resource:Editor

2011-01-14T16:02:04Z

Gothemsh: Created page with "{{Resource page}} El editor de mapas de MTA:SA te permite crear mapas para los modos de juegos. ==Empezando== Para empezar el editor, simplemente has presiona "Map editor" en el..."

{{Resource page}}
El editor de mapas de MTA:SA te permite crear mapas para los modos de juegos.

==Empezando==
Para empezar el editor, simplemente has presiona "Map editor" en el menu principal de MTA

==Menus==
Una vez que el editor haya comenzado, se te mostraran dos menus de barras: La principal arriba, y la de elementos a la esquina inferior izquierda.

===Menu principal===
Estos son los botones en el menu principal:
* [[Image:Editor_New.png]] Crear un nuevo mapa.
* [[Image:Editor_Open.png]] Abrir un mapa existente.
* [[Image:Editor_Save.png]] Grabar el mapa en que estas trabajando.
* [[Image:Editor_Save_as.png]] Grabar el mapa bajo un nombre diferente.
* [[Image:Editor_Options.png]] Modificar las opciones generales del editor.
* [[Image:Editor_Undo.png]] Deshacer la ultima acción.
* [[Image:Editor_Redo.png]] Restaurar la ultima acción deshecha.
* [[Image:Editor_Locations.png]] Lista de lugares del GTA.
* [[Image:Editor_Current_elements.png]] Lista de todos los elementos contenidos en el mapa (Autos,Objetos,Marcadores,Peds,etc.)
* [[Image:Editor_Map_settings.png]] Propiedades del mapa, como el tiempo, la gravedad, etc. Aqui tambien puedes especificar los modos que son compatibles con tu mapa.
* [[Image:Editor_Definitions.png]] Cargar [[Resource:Editor/EDF|definiciones del editor (EDF)]] que tu quieras usar
* [[Image:Editor_Test.png]] Ir al modo play para probar el mapa. O puede cargar el modo al que el mapa esta hecho.

===Menu de elementos===
El menu de elementos es usado para agregar nuevos elementos al mapa.
* [[Image:Editor_Vehicle.png]] Crear un nuevo vehiculo
* [[Image:Editor_Object.png]] Crear un nuevo objeto (Edificios, Caminos y otros objetos).
* [[Image:Editor_Pickup.png]] Crear un nuevo pickup (vida, armadura, armas).
* [[Image:Editor_Marker.png]] Crear un nuevo marcador.

Adicionalmente, si tu tienes una [[Resource:Editor/EDF|definición de editor]] cargada, tu puedes girar la rueda del ratón en el menu para traer los elementos cargados por el archivo de definición

==Usando el editor==
Esta sección te explicara como crear y modificar mapas.

===Moviendose alrededor del mapa===
Cuando tu inicias el editor, tu estas en el ''modo de camara''. Tu puedes usar las teclas '''WSAD''' para mover la camara y el ratón para girar la camara. Cuando te muevas, puedes mantener la tecla '''ALT''' para moverte mas lento o la tecla '''SHIFT''' para ir mas rapido.

Para accender a la interfaz del editor y al panel de control necesitas cambiar al ''modo de cursor''. Tu puedes cambiar entre el modo de cursor y el modo de camara con la tecla '''F'''. Cuando estes en modo de cursor, tu vista estara congelada, y solo podras usar el cursor del ratón para manipular elementos y usar la interfaz grafica.

El modo de camara puede ser reconocido por una mira en medio de la pantalla. Tu puedes usarla para seleccionar y mover elementos como en el modo de cursor.

[[Image:Editor_Crosshair.png|center]]

===Empezando un nuevo mapa===
* Inicia el editor, o si ya esta iniciado, apreta en el boton ''Nuevo'' del menu.
* Apreta en el boton ''Opciones de mapa''. En la pestaña ''Meta'', llena los campos de Name y Author con el nombre de tu mapa y tu nombre respectivamente. Tambien abre la pestaña ''Gamemodes'' y agrega los modos para los cuales tu mapa esta hecho (Estos se van a mover a la lista de ''Added Gamemodes''). Tu puedes hacer esto seleccionandolos y apretando en ''Add'', o haciendole doble click. Apreta OK cuando estes listo.
[[Image:Editor_Mapsettings.png|center]]
* Apreta en la ventana de ''Definiciones'' y agrega los recursos en donde uses los elementos alternativos. Estos debieran consistir de los modos que tu seleccionaste en la ventana de ''Map settings'', ademas de eventuales recursos adicionales. Para mas informacion acerca de las definiciones del editor, ve [[Resource:Editor/EDF|EDF (En Inglés)]]. Apreta OK cuando estes listo.

===Creando nuevos elementos===
* Si tu estas en el modo de camara, cambia al modo de cursor primero apretando '''F'''.
* Apreta un boton en el menu de elementos que represente lo que tu quieres. Ej: Apreta el boton con un auto en el para agregar un vehiculo.
* Un nuevo elemento del tipo seleccionado sera creado y pegado a tu cursor. Muevelo a la posicion que quieras y apreta el '''botón izquierdo''' para dejarlo.

[[Image:Editor_Addelem.png|center]]

Para crear un elemento alternativo que es especifico a un recurso, mueve tu cursor sobre el menu de elementos y gira la rueda del ratón hasta el recurso esperado. Ten en cuenta que para este trabajo, primero necesitas haber agregado el archivo de [[Resource:Editor/EDF|Definición de editor]] del recurso en la ventana ''Definitions''.

[[Image:Editor_Selectedf.png|center]]

===Seleccionando===
* '''Click izquierdo''' sobre un elemento para seleccionarlo en ''modo de teclado''.
* '''Click derecho''' sobre este elemento para seleccionarlo en ''modo de ratón''.
* Apreta la '''Barra espaciadora''' o apreta sobre un area vacia para sacar la selección.

El elemento elegido, si lo hay, es representado por un marcador de cono amarillo. Elementos (particularmente objetos) con pesima colision se peuden detectar facilmente activando el ''modo de alta sensibilidad'', apretando la tecla '''E'''. Esto incrementara la detección.

El dialogo ''Current elements'' puede ser usado tambien para seleccionar elementos. Has doble-click sobre un item de la lista para seleccionarlo en ''modo de teclado''

===Moviendo===
Mover elementos se puede hacer de muchas formas.

'''Con el ratón'''
* Simplemente pesca y deja con el '''boton izquierdo'''
O:
* Selecciona el elemento en el modo de ratón ('''boton derecho'''), muevelo hacia la posición que quieras, y apreta para dejarlo.

Tu tambien puedes ajustar la ''distancia'' de un elemento acercandolo o alejandolo de la camara mediante el cambio al modo de camara, ''''click derecho''' en un elemento girando la '''rueda del ratón'''.

'''Con el teclado'''
* Select the element in keyboard mode ('''left click''').
* 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.

By default, elements move relative to the camera and are not locked to any axes. This can be disabled in the ''Options'' menu.

===Rotating===
'''With the mouse'''

You can rotate selected elements around the Z axis with the mouse wheel.
* Select the element in keyboard mode ('''left click''') and roll the mouse wheel while holding '''Left CTRL'''.
Or:
* Select the element in mouse mode ('''right click'''), hold '''CTRL''', and roll the mouse wheel.

'''With the keyboard'''
* Select the element in keyboard mode ('''left click''').
* While holding '''CTRL''' (the selection marker will turn green), use the '''arrow keys''' and '''PgUp'''/'''PgDn''' to rotate the element around the different axes.

With both methods you can additionally hold '''ALT''' to decrease the rotation speed or '''SHIFT''' to increase it.

[[Image:Editor_Rotateelem.png|center]]

===Changing model and other properties===
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.

* Open the properties window of an element by either double clicking it or by selecting it and pressing '''F3'''.
* 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.
* Click OK when you're done.

[[Image:Editor_Props.png|center]]

===Cloning===
You can clone an element by selecting it and pressing '''C'''.

* In mouse mode the cloned element will be attached to your cursor. '''Left click''' to place it in the map.
* In keyboard mode the cloned element will be cloned in the identical position.

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.

Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to clone an element.

===Deleting===
Simply select the element and press '''DEL''' ''(Delete)''.

Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to delete an element.

==Creating maps for specific gamemodes==
To make a map for a specific gamemode, you have to do two things:
* Click the '''Map Settings''' button in the top menu, go to the '''Gamemodes''' tab and add any gamemodes that your map is to be used with.
* You will likely also need to add one or more [[Resource:Editor/EDF|Editor Definition Files]]. These will allow you to place gamemode specific elements in the map, like spawnpoints, race checkpoints, or CTF flags. You can add EDF's by clicking the '''Definitions''' menu button and adding the relevant gamemodes.

==Controls==
Here is a list of all default controls. To change them please go to the MTA Settings menu while the Editor is started.

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

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

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

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

==Multiplayer==
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.

Please note that currently the editor lacks any permissions system, ao all users have access to every function.

==Plugins & External resources==
{{Main|Resource:Editor/Plugins}}

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.

By using the '''import <resourceName>''' command in console the resource's elements can be imported within the editor.

==FAQ==
==== I get a black screen when launching the Map Editor ====

Usually this is caused due to incorrect installation of Map Editor resources. If you are using a stable MTASA client, please install it again and make sure that you use Client and Server install option.

If you are using a nightly build, to get it working right you need to download latest [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 resources (step 3)], unpack the archive and put its contents in:
''MTA San Andreas\server\mods\deathmatch\resources'' , where ''MTA San Andreas'' is a folder where you've installed MTA San Andreas (default location: C:\Program Files\MTA San Andreas).

Putting them in this path: MTA San Andreas\mods\deathmatch\resources '''is a common mistake''' - it won't work if you put them there. So make sure to put them in the ''italic'' path above.

If this issue still occurs, even when you've checked the note above and verified that you've installed it correctly, it might be because you've got an outdated '''acl.xml''' file. You can download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.

==== I get an "Could not start the local server. See console for details" when using the "Map Editor" button ====
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.

==== I have saved a map but cannot find it in my server's resources directory, despite the Editor itself being able to see it ====
This is due to the fact that Vista/7 limits write-access for non-admin processes in Program Files directory. Files get written in the "VirtualStore" directory instead of real Program Files folder. You should be able to locate your map resource in a similar directory to:
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\

Running the Server/MTA San Andreas with Administrative rights will allow the map to be saved to the proper location.

==== I have found a bug or have a suggestion/feedback for the map editor ====
Please use the official [http://bugs.mtasa.com bugtracker] for reporting bugs. Feel free to also join us on [http://www.multitheftauto.com/irc.html IRC].

[[ru:Resource:Editor]]
[[Category:Incomplete]]

RemoveElementData

2011-01-14T15:13:13Z

Gothemsh: /* Example */

{{Server function}}
__NOTOC__
This function removes the [[element data]] with the given key for that element. The element data removal is synced with all the clients.

==Syntax==
<syntaxhighlight lang="lua">
bool removeElementData ( element theElement, string key )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' The [[element]] you wish to remove the data from.
*'''key:''' The key string you wish to remove.

===Returns===
Returns ''true'' if the data was removed succesfully, ''false'' if the given key does not exist in the element or the element is invalid.

==Example==
<section class="server" name="Example" show="true">
This will create an element data for know if a player has spawned.
<syntaxhighlight lang="lua">
function spawn()
setElementData(source,"spawned",true)
end
addEventHandler ( "onPlayerSpawn", getRootElement(), spawn )
function wasted()
removeElementData(source,"spawned")
end
addEventHandler ( "onPlayerWasted", getRootElement(), wasted )</syntaxhighlight>
</section>

==See Also==
{{Element_functions}}
[[Category:Needs Example]]

DxGetTextWidth

2011-01-14T15:07:55Z

Gothemsh:

__NOTOC__
{{Client function}}
This function retrieves the theoretical width of a certain piece of text, if it were to be drawn using [[dxDrawText]].

==Syntax==
<syntaxhighlight lang="lua">
float dxGetTextWidth ( string text, [float scale=1, string font="default"] )
</syntaxhighlight>

===Required Arguments===
* '''text:''' A string representing the text for which you wish to retrieve with width for.

==Optional Arguments==
{{OptionalArg}}
* '''scale:''' The size of the text.
* '''font:''' The dx font for the text.
{{DxFonts}}

===Returns===
Returns the float of the width of the text.

==Example==
<section name="Example" class="client" show="true">
This will show you the width of a message in a normal chatbox sent by a player
<syntaxhighlight lang="lua">
function dxwidth(msg)
chatbox = getChatboxLayout()
local length = dxGetTextWidth(msg,chatbox["chat_scale"][1])
outputChatBox(tostring(length))
end
addEventHandler("onPlayerChat",getRootElement(),dxwidth)
</syntaxhighlight>
</section>

==See Also==
{{Drawing_functions}}

DxGetTextWidth

2011-01-14T15:07:23Z

Gothemsh: