Multi Theft Auto: Wiki - User contributions [en]

GetAccounts

2011-06-21T12:27:52Z

Rafael Schiedel:

__NOTOC__
{{Server function}}
This function returns a table over all the accounts that exist in the server internal.db file. (Note: accounts.xml is no longer used after version 1.0.4)
==Syntax==
<syntaxhighlight lang="lua">
table getAccounts ()
</syntaxhighlight>

===Returns===
A [[table]] over the accounts that exist in the server internal.db file. This table might be empty.

==Example==
<syntaxhighlight lang="lua">
function printAmountOfAccounts ( thePlayer )
local accountTable = getAccounts () -- return the table over accounts
if #accountTable == 0 then -- if the table is empty
outputChatBox( "There are no accounts. :(", thePlayer )
else -- table isn't empty
outputChatBox( "There are " .. #accountTable .. " accounts in this server!", thePlayer )
end
end
addCommandHandler( "accountcount", printAmountOfAccounts ) -- add a command handler for command 'accountcount'
</syntaxhighlight>

==See Also==
{{Account functions}}

SetAircraftMaxHeight

2011-06-15T09:28:49Z

Rafael Schiedel: Created page with "__NOTOC__ {{Server client function}} This function changes the maximum flying height of aircraft. ==Syntax== <syntaxhighlight lang="lua"> bool setAircraftMaxHeight ( float Height ) </syntaxhighlight> ===R..."

__NOTOC__
{{Server client function}}
This function changes the maximum flying height of aircraft.

==Syntax==
<syntaxhighlight lang="lua">
bool setAircraftMaxHeight ( float Height )
</syntaxhighlight>

===Required Arguments===
*'''Height'''

===Returns===
Returns ''true'' if successful, ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
This example shows you a command to set your maximum aircraft height.
<syntaxhighlight lang="lua">
function setAircraftHeight ( command, ve1 )
local height = tonumber ( ve1 )
if height then
local wert = setAircraftMaxHeight ( height )
if wert == true then
outputChatBox ( "Aircraft heigt seted!", 0, 200, 0 )
else
outputChatBox ( "Error to set Aircraft heigt!", 255, 0, 0 )
end
else
outputChatBox ( "Error to set Aircraft heigt!", 255, 0, 0 )
end
end
addCommandHandler ( "aircraft", setAircraftHeight )
</syntaxhighlight>
</section>

==See Also==
{{Client_world_functions}}

DE/setPedOnFire

2011-02-28T05:59:17Z

Rafael Schiedel:

__NOTOC__
{{Server client function}}
Diese Funktion überprüft das der [[ped]] schiesst.

==Syntax==
<syntaxhighlight lang="lua">bool isPedOnFire ( ped derPed )</syntaxhighlight>

===Required Arguments===
*'''derPed''': Der [[ped]] zu überprüfen.

===Returns===
Returns ''true'' wenn der schiesst, ''false'' wenn nicht.

==Example==
<section class="server" name="Server" show="true">
Disese Funktion nimmt ein zufälligen Spieler und wenn er schiessen sollte bekommt er ne M4
<syntaxhighlight lang="lua">
local player = getRandomPlayer()
if isPedOnFire ( player ) then
giveWeapon ( player, 31, 150, true )
end
</syntaxhighlight>
</section>

==Andere sachen in Englisch==
{{Ped functions}}

DE/setPedOnFire

2011-02-28T05:55:06Z

Rafael Schiedel: Created page with "__NOTOC__ {{Server client function}} Diese Funktion überprüft das der ped schiesst. ==Syntax== <syntaxhighlight lang="lua">bool isPedOnFire ( ped derPed )</syntaxhighlight> ===Required Arguments==..."

OnPlayerConnect

2010-11-19T11:37:38Z

Rafael Schiedel: Added, "Player has connected the Server"

__NOTOC__
{{Server event}}
This event is triggered when a player attempts to connect to the server.

==Parameters==
<syntaxhighlight lang="lua">
string playerNick, string playerIP, string playerUsername, string playerSerial, int playerVersionNumber, string playerVersionString
</syntaxhighlight>

*'''playerNick''': The player's current nickname.
*'''playerIP''': The player's current IP.
*'''playerUsername''': The player's community username.
*'''playerSerial''': The player's serial number.
''Extra parameter from 1.0.2 onwards:''
*'''playerVersionNumber''': The player's MTA version in pure numerical form, e.g. ''''256'''' for 1.0, ''''257'''' for 1.0.1, etc.
''Extra parameter from 1.0.4 onwards:''
*'''playerVersionString''': The player's MTA version in sortable string form. Same as the return value from [[getPlayerVersion]].

==Cancel effect==
If this event is [[Event system#Canceling|canceled]], the player will be disconnected with an error message saying the reason specified in cancelEvent or "Disconnected: server refused the connection" if none was specified.

==Example==
<section name="Server" class="server" show="true">

This example cancels connection attempts of people who use the nick "Player" or outputs some data about the connecting player otherwise.

<syntaxhighlight lang="lua">
--when a player connects
function playerConnect (playerNick, playerIP, playerUsername, playerSerial, playerVersionNumber)
if playerNick == "Player" then --check if his nick is "Player"
cancelEvent(true,"The nick \"Player\" is not allowed, please change it to something else. You can change your nick in Settings menu Multiplayer tab.") --in that case refuse the connection
else
--output some data about the player
outputChatBox (playerNick.." just connected to the server.")
outputChatBox ("IP: "..playerIP.." Username: "..playerUsername.." Serial: "..playerSerial)
end
end

--add the playerConnect function as a handler for onPlayerConnect
addEventHandler ("onPlayerConnect", getRootElement(), playerConnect)
</syntaxhighlight>
</section>

<section name="Server" class="server" show="true">
This example cancels connection if player uses older MTA (older than 1.0.3)
<syntaxhighlight lang="lua">
addEventHandler( "onPlayerConnect", getRootElement(),
function ( _,_,_,_, clientVersion )
if ( clientVersion < 259 ) then
cancelEvent( true, "Update your MTA before you join this server!" );
end
end
)
</syntaxhighlight>
</section>

<section name="Server" class="server" show="true">
This example show the player in the Chatbox if connect the Server
<syntaxhighlight lang="lua">
function playerConnect(playerNick, playerIP, playerUsername, playerSerial, playerVersionNumber)
outputChatBox("* " .. playerNick .. " has connected the Server.", getRootElement(), 255, 100, 100, false)
-- Show the Player Connect the Server, for all Users good
end
addEventHandler("onPlayerConnect", getRootElement(), playerConnect)
</syntaxhighlight>
</section>
{{See also/Server event|Player events}}