Multi Theft Auto: Wiki - User contributions [en]

Talk:LoadMapData

2010-08-18T18:05:34Z

JasperNL: Created page with 'I'm wondering if the example is good. because there's the following loadMapData ( node, getRootNode ) getRootNode ? I'm wondering what that is o,o --~~~~ ----'

I'm wondering if the example is good. because there's the following
loadMapData ( node, getRootNode )
getRootNode ? I'm wondering what that is o,o
--[[User:JasperNL|Jasper.]] 18:05, 18 August 2010 (UTC)

----

Talk:OnClientGUIChanged

2010-07-29T09:33:51Z

JasperNL: Created page with 'Whats the difference between the source and the parameter element theElement o_O --~~~~'

Whats the difference between the source and the parameter element theElement o_O
--[[User:JasperNL|Jasper.]] 09:33, 29 July 2010 (UTC)

Talk:SetElementData

2010-07-18T18:39:16Z

JasperNL:

Bug found, i think o,o
setElementData (weaponPickup,"norespawn",true) <<
Weaponpickup is a weapon pickup as the name says, like a AK-47
Debugscript: WARNING: ...: Bad argument @ 'setElementData'
True or False can't be a var in this case i think.
--[[User:JasperNL|Jasper.]] 18:38, 18 July 2010 (UTC)

----

Talk:SetElementData

2010-07-18T18:39:06Z

JasperNL:

Bug found, i think o,o
setElementData (weaponPickup,"norespawn",true) <<
- Weaponpickup is a weapon pickup as the name says, like a AK-47
Debugscript: WARNING: ...: Bad argument @ 'setElementData'
- True or False can't be a var in this case i think.
--[[User:JasperNL|Jasper.]] 18:38, 18 July 2010 (UTC)

----

Talk:SetElementData

2010-07-18T18:38:58Z

JasperNL:

Talk:SetElementData

2010-07-18T18:38:41Z

JasperNL:

Talk:SetElementData

2010-07-18T18:38:01Z

JasperNL: Created page with 'Bug found, i think o,o setElementData (weaponPickup,"norespawn",true) << Weaponpickup is a weapon pickup as the name says, like a AK-47 Debugscript: WARNING: ...: Bad argument …'

Talk:Modules/SebasIRC

2010-07-09T21:20:28Z

JasperNL: Created page with 'THE LINK DIED (PEEEEEEEEEEEEEP) The link isn't exist any more :< --~~~~'

THE LINK DIED (PEEEEEEEEEEEEEP)
The link isn't exist any more :<
--[[User:JasperNL|Jasper.]] 21:20, 9 July 2010 (UTC)

Talk:ClearElementVisibleTo

2010-07-03T19:59:29Z

JasperNL:

The example is wrong o,o
--[[User:JasperNL|Jasper.]] 19:59, 3 July 2010 (UTC)

Talk:ClearElementVisibleTo

2010-07-03T19:59:18Z

JasperNL: Created page with 'The example is wrong o,o'

The example is wrong o,o

SetCameraClip

2010-05-30T10:49:09Z

JasperNL: Example

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

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

==Syntax==
<syntaxhighlight lang="lua">
bool setCameraClip ( bool objects, bool vehicles )
</syntaxhighlight>

===Required Arguments===
*'''objects:''' Sets if you want the camera to clip on objects.
*'''vehicles:''' Sets if you want the camera to clip on vehicles.

===Returns===
Always returns ''true''.

==Example==
<section name="Client" class="client" show="true">
This function enables it to look though cars
<syntaxhighlight lang="lua">
function enableCameraThoughCars ()
setCameraClip (true,false)
outputChatBox ("Your camera can see the vehicle interior now!",255,0,0,false)
end
addEventHandler ("onClientResourceStart",getResourceRootElement(getThisResource()),enableCameraThoughCars)
</syntaxhighlight>
</section>

==See Also==
{{Client camera functions}}
[[Category:Incomplete]]

XmlNodeSetAttribute

2010-05-29T15:55:46Z

JasperNL:

__NOTOC__
{{Server client function}}
This function is used to edit an attribute of a node in a configuration file.

==Syntax==
<syntaxhighlight lang="lua">
bool xmlNodeSetAttribute ( xmlnode node, string name, string/float value )
</syntaxhighlight>

===Required Arguments===
*'''node:''' The node of which you wish to edit an attribute.
*'''name:''' The name of the attribute.
*'''value:''' The value which you wish to change the attribute to.

===Returns===
Returns ''true'' if the attribute was set successfully, ''false'' if the node and/or attribute do not exist, or if they're faulty.

==Example==
<section name="Server" class="server" show="true">
In a gamemode, we want a command to change the marker color in the configuration file.

config.xml:
<syntaxhighlight lang="xml">
<config>
<markers color="255,100,0" />
</config>
</syntaxhighlight>

Lua code:
<syntaxhighlight lang="lua">
config = xmlLoadFile("config.xml")

function changeConfigMarkerColor(thePlayer, command, r, g, b)
local markernode = xmlFindSubNode(config, "markers", 0)
xmlNodeSetAttribute(markernode, "color", r .. "," .. g .. "," .. b)
end
addCommandHandler("markercolor", changeConfigMarkerColor)
</syntaxhighlight>

Note that this example only changes the in-memory XML document. If you want to save the changed document back to the hard drive, use [[xmlSaveFile]].
</section>

==See Also==
{{XML_functions}}

User:JasperNL

2010-05-14T10:57:46Z

JasperNL:

----
[[Image:Coder.gif]] '''This user isn't a MTA-Developper'''
----

<font size="50">o,o</font>

User:JasperNL

2010-05-14T10:56:13Z

JasperNL:

[[Image:Coder.gif]] <font size="0.8">This user isn't a MTA-Developper</font>

<font size="50">o,o</font>

User:JasperNL

2010-05-14T10:56:04Z

JasperNL:

[[Image:Coder.gif]] <font size="5">This user isn't a MTA-Developper</font>

<font size="50">o,o</font>

User:JasperNL

2010-05-14T10:54:47Z

JasperNL:

[[Image:Coder.gif]] This user isn't a MTA-Developper

<font size="50">o,o</font>

User:JasperNL

2010-05-14T10:53:49Z

JasperNL:

[[Image:Coder.gif]] This user isn't a MTA-Developper

<big>o,o</big>

User:JasperNL

2010-05-14T10:53:28Z

JasperNL: Created page with '<pre>Image:Coder.gif This user isn't a MTA-Developper</pre> == o,o =='

<pre>[[Image:Coder.gif]] This user isn't a MTA-Developper</pre>

== o,o ==

AddAccount

2010-05-14T10:47:34Z

JasperNL: Setting back to no-russian crap

{{Server function}}
__NOTOC__
This function adds an account to the list of registered accounts of the current server.

==Syntax==

{{New feature|3|1.0 r848|
<syntaxhighlight lang="lua">
account addAccount ( string name, string pass )
</syntaxhighlight>
}}
{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
bool addAccount ( string name, string pass )
</syntaxhighlight>
}}

===Required Arguments===

*'''name:''' The name of the account you wish to make, this normally is the player's name.
*'''pass:''' The password to set for this account for future logins.

===Returns===

{{New feature|3|1.0 r848|
Returns the ''account'' element if the account was created, ''false'' if the account already exists or an error occured.
}}
{{Deprecated_feature|3|1.0|
Returns ''true'' if the account was created, ''false'' if the account already exists or an error occured.
}}

==Example==
<section name="Server" class="server" show="true">
'''Example 1:''' This enables players to register on your server by using /register <password> in the chat window.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, password )
-- Check if the password field is blank or not (only blank if they didnt enter one)
if ( password ~= "" and password ~= nil ) then
--Attempt to add the account, and save its value in a var
local accountAdded = addAccount( getPlayerName(source), password )
if ( accountAdded ) then
-- Tell the user all is done
outputChatBox ( "Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login", source )
else
-- There was an error making the account, tell the user
outputChatBox ( "Error creating account, contact the server admin", source )
end
else
-- There was an error in the syntax, tell the user the correct syntax.
outputChatBox ( "Error creating account, correct syntax: /register <password>", source )
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''This code differs by allowing the user to change their username that they wish to use.'''

'''Example 2:''' This enables players to register on your server by using /register <username> <password> in the chat window.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''Example 3:''' This code differs again so the user can only register once /register <username> <password>.
<syntaxhighlight lang="lua">
local bRegisteredOnce = false

function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil and bRegisteredOnce == false) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
bRegisteredOnce = true
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
if bRegisteredOnce == true then
outputChatBox("You already registered on this server!",source)
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>
</section>

==See Also==

{{Account_functions}}

IsKeyBound

2010-05-05T15:32:57Z

JasperNL: /* Example */ added

{{Server function}}
__NOTOC__
This function can be used to find out if a key has already been bound.

==Syntax==
<syntaxhighlight lang="lua">bool isKeyBound ( player thePlayer, string key, [ string keyState, function handler ] ) </syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player you're checking.
*'''key:''' The key you're checking. See [[Key names]] for a list of valid key names.

===Optional Arguments===
*'''keyState:''' Is the state of the key when it calls the function, Can be either:
**'''"up":''' when the key is released
**'''"down":''' when the key is pressed
*'''handler:''' The function you're checking against
Note: If you do not specify a ''keyState'' or ''handler'', any instances of ''key'' being bound will cause ''isKeyBound'' to return ''true''.

==Example==
<syntaxhighlight lang="lua">
This function kicks a player when he joins and numpad 9 is binded, and blame anyone random in the server!
function onPlayerJoin () -- BE WARNED! never use the same function for the same event
if (isKeyBound (source,"num_9")) then -- if num pad 9 is binded
outputChatBox (getPlayerName (source) .. " has binded num pad 9! so he will be kicked.",getRootElement(),255,0,0,false) -- let see everybody that he has binded it
kickPlayer (source,getRandomPlayer(),"I don't like you, so go away >_>") -- Take anybody random, make him responsible for his kick, and say he don't likes him.
end
end
addEventHandler ("onPlayerJoin",getRootElement(),onPlayerJoin) -- add event.
</syntaxhighlight>

==See Also==
{{Input functions}}
[[Category:Needs Example]]

Md5

2010-05-05T15:19:03Z

JasperNL: Example added

__NOTOC__
{{Server client function}}

Calculates the MD5 hash of the specified string and returns its hexadecimal representation.

Note: returns an uppercase string, so make sure you string.upper() anything else you are checking against that has been MD5'd elsewhere.

==Syntax==
<syntaxhighlight lang="lua">string md5 ( string str )</syntaxhighlight>

===Required Arguments===
*'''str:''' the string to hash.

===Returns===
Returns the MD5 hash of the input string if successful, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
function md5it (player,command,string) -- open function
if (string) then -- check if the string is exist
md5string = md5 (string) -- get the md5 string
outputChatBox (string .. " -> " .. md5string ,player,255,0,0,false) -- output it
end
end
addCommandHandler ("md5it",md5it) -- create command
</syntaxhighlight>

==See Also==
{{Utility functions}}
[[Category:Needs Example]]

CopyResource

2010-05-05T15:13:08Z

JasperNL: /* Example */ added

__NOTOC__
{{Server function}}
This function copies a specified [[resource]] with a new name.

==Syntax==
<syntaxhighlight lang="lua">
bool copyResource ( resource theResource, string newResourceName )
</syntaxhighlight>

===Required Arguments===
*'''theResource:''' the resource which is going to be copied
*'''newResourceName:''' the name that the copied resource will receive

===Returns===
Returns ''true'' if the resource was copied successfully, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
-- This script can backup your resource with a easy command! /backupresource [resourcename]
function backupResource (player,command,resourcetobackup) -- start the function
if (resourcetobackup) and (getResourceFromName(resourcetobackup)) then -- check if the resource is exist
copyResource (getResourceFromName(resourcetobackup),resourcetobackup .. "_backup") -- copy the resource and give it the name [resource]_backup
outputChatBox ("Resource " .. resourcetobackup .. " succesfully backed up!",player,255,0,0,false) -- say it's OK!
else -- if it isn't exist
outputChatBox ("Resource can't be backed up! (don't forget the parameters!)",player,255,0,0,false) -- say it isn't exist!
end
end
addCommandHandler ("backupresource",backupResouce) -- add command
</syntaxhighlight>

==See Also==
{{Resource_functions}}
[[Category:Needs_Example]]

OnClientPlayerChangeNick

2010-01-10T12:46:10Z

JasperNL: /* Example */

[[Category:Incomplete Event]]
{{Client event}}
__NOTOC__
This event is triggered when a player changes his nickname.

==Parameters==
<syntaxhighlight lang="lua">
string oldNick, string newNick
</syntaxhighlight>
*'''oldNick:''' the nickname the player had before.
*'''newNick:''' the new nickname of the player.

==Source==
The source of this event is the player that changed his nick

==Example==
This disallows changing a nick
<syntaxhighlight lang="lua">
addEventHandler ("onClientPlayerChangeNick", getRootElement(),
function()
cancelEvent()
ouputChatbox ("You can't change your nick!", source, 255, 0, 0, false)
end)
</syntaxhighlight>

==See Also==
===Client player events===
{{Client_player_events}}
===Client event functions===
{{Client_event_functions}}

SpawnPlayer

2009-12-23T14:07:34Z

JasperNL:

__NOTOC__
{{Server function}}
This function spawns the player at an arbitary point on the map.<br>

'''''Note:''' [[setCameraTarget]] must be used to focus on the player. Also, all players have their camera initially faded out after connect. To ensure that the camera is faded in, please do a [[fadeCamera]] after.''

==Syntax==
<syntaxhighlight lang="lua">
bool spawnPlayer ( player thePlayer, float x, float y, float z, [ int rotation = 0, int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil ] )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player you want to spawn
*'''x:''' The x co-ordinate to spawn the player at
*'''y:''' The y co-ordinate to spawn the player at
*'''z:''' The z co-ordinate to spawn the player at

===Optional Arguments===
*'''rotation:''' rotation of the player on spawn
*'''skinID:''' players skin on spawn
*'''interior:''' interior the player will spawn into
*'''dimension:''' The ID of the [[dimension]] that the player should be in
*'''theTeam:''' the team the player will join

===Returns===
Returns ''true'' if the player was spawned successfully, ''false'' otherwise.

==Example==
This example spawns all the players in the middle of the game map.
<syntaxhighlight lang="lua">
-- Get a table of all the players
players = getElementsByType ( "player" )
-- Go through every player
for playerKey, playerValue in ipairs(players) do
-- Spawn them at the desired coordinates
spawnPlayer ( playerValue, 0.0, 0.0, 5.0, 90.0, 0 )
end
</syntaxhighlight>

This example spawns a player when he logs in.
<syntaxhighlight lang="lua">
spawnTeam = createTeam ("Teamname", 255, 0, 0) -- Create team to spawn.
function spawnOnLogin (prevA, curA, autoLogin)
outputChatBox ("Welcome to ...", source, 255, 0, 0, false)
spawnPlayer (source, 0, 0, 5, 0, math.random (0,288), 0, 0, spawnTeam) -- spawns player with random skin
fadeCamera (source, true)
setCameraTarget (source, source)
end
addEventHandler("onPlayerLogin", getRootElement(), spawnOnLogin)
</syntaxhighlight>

==See Also==
{{Player_functions}}

SpawnPlayer

2009-12-23T14:06:13Z

JasperNL:

__NOTOC__
{{Server function}}
This function spawns the player at an arbitary point on the map.<br>

'''''Note:''' [[setCameraTarget]] must be used to focus on the player. Also, all players have their camera initially faded out after connect. To ensure that the camera is faded in, please do a [[fadeCamera]] after.''

==Syntax==
<syntaxhighlight lang="lua">
bool spawnPlayer ( player thePlayer, float x, float y, float z, [ int rotation = 0, int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil ] )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player you want to spawn
*'''x:''' The x co-ordinate to spawn the player at
*'''y:''' The y co-ordinate to spawn the player at
*'''z:''' The z co-ordinate to spawn the player at

===Optional Arguments===
*'''rotation:''' rotation of the player on spawn
*'''skinID:''' players skin on spawn
*'''interior:''' interior the player will spawn into
*'''dimension:''' The ID of the [[dimension]] that the player should be in
*'''theTeam:''' the team the player will join

===Returns===
Returns ''true'' if the player was spawned successfully, ''false'' otherwise.

==Example==
This example spawns all the players in the middle of the game map.
<syntaxhighlight lang="lua">
-- Get a table of all the players
players = getElementsByType ( "player" )
-- Go through every player
for playerKey, playerValue in ipairs(players) do
-- Spawn them at the desired coordinates
spawnPlayer ( playerValue, 0.0, 0.0, 5.0, 90.0, 0 )
end
</syntaxhighlight>

This example spawns a player when he logs in.
<syntaxhighlight lang="lua">
spawnTeam = createTeam ("Teamname", 255, 0, 0) -- Create team to spawn.
function spawnOnLogin (prevA, curA, autoLogin)
spawnPlayer (source, 0, 0, 5, 0, math.random (0,288), 0, 0, spawnTeam) -- spawns player with random skin
end
addEventHandler("onPlayerLogin", getRootElement(), spawnOnLogin)
</syntaxhighlight>

==See Also==
{{Player_functions}}

SpawnVehicle

2009-12-06T16:14:23Z

JasperNL: at example spellingbug >.<

{{Server function}}
__NOTOC__
Spawns a vehicle at any given position and rotation

==Syntax==
<syntaxhighlight lang="lua">
bool spawnVehicle ( vehicle theVehicle, float x, float y, float z, float rx, float ry, float rz )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle:''' The vehicle you wish to spawn
*'''x:''' The x position you wish to spawn the vehicle at
*'''y:''' The x position you wish to spawn the vehicle at
*'''z:''' The x position you wish to spawn the vehicle at
*'''rx:''' The x rotation you wish to spawn the vehicle at
*'''ry:''' The y rotation you wish to spawn the vehicle at
*'''rz:''' The z rotation you wish to spawn the vehicle at

===Returns===
Returns ''true'' if the vehicle spawned successfully, ''false'' if the passed argument does not exist or is not a vehicle.

==Example==
There is no example.

==Related scripting functions==
{{Vehicle functions}}
[[Category:Element Types]]