Multi Theft Auto: Wiki - User contributions [en]

IsCharInString

2020-09-08T12:28:37Z

Alfredo:

{{Useful Function}}

This shared function allows you to check if a char specified is in a string value.

==Syntax==
<syntaxhighlight lang="lua">
bool isCharInString ( string char, string text )
</syntaxhighlight>

===Required arguments===
* '''char''': The char to find in a string.
* '''text''': String value where you want to search ''char'' value.

===Return===
Returns true if ''char'' is found in specified string, false otherwise.

==Code==
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
function isCharInString ( char, text )
if char then
if text then
if string.len ( char ) == 1 then
if string.find( text, char ) then
return true
end
end
end
end
return false
end
</syntaxhighlight>
</section>

==Example==
This example checks if char "*" is in a especified string.
<syntaxhighlight lang="lua">
function checkString ( player, cmd, string )
if string then
if isCharInString ( "*", string ) then
outputChatBox ( "String specified contains * char", player, 0, 255, 0, false )
else
outputChatBox ( "String specified does not contain * char.", player, 255, 0, 0, false )
end
else
outputChatBox ( "Enter an string.", player, 255, 0, 0, false )
end
end
addCommandHandler ( "checkstring", checkString )
</syntaxhighlight>
'''Author: AlfredoRP'''

==See Also==
{{Useful_Functions}}

GetPedContactElement

2020-04-11T10:26:18Z

Alfredo: Change in example error... *Before: client side. *After: server side

__NOTOC__
{{Server client function}}
This function detects the element a ped is standing on. This can be a vehicle or an object.

==Syntax==
<syntaxhighlight lang="lua">
element getPedContactElement ( ped thePed )
</syntaxhighlight>
{{OOP||[[ped]]:getContactElement|contactElement}}

===Required Arguments===
*'''thePed:''' The [[ped]] of which you want to get the [[element]] he is standing on.

===Returns===
Returns an [[object]] or a [[vehicle]] if the ped is standing on one, ''false'' if he is touching none or an invalid element was passed.

==Example==
<section name="Server" class="server" show="true">
This function outputs the name of the vehicle the specified player is standing on, or a message saying he isn't on one.
<syntaxhighlight lang="lua">
function outputContactVehicleMessage ( thePlayer )
local elementStandingOn = getPedContactElement ( thePlayer )
if elementStandingOn and getElementType ( elementStandingOn ) == "vehicle" then
local vehicleName = getVehicleName ( elementStandingOn )
outputChatBox( "You're standing on a " .. vehicleName .. "." )
else
outputChatBox( "You're not standing on any vehicle." )
end
end
</syntaxhighlight>
</section>

==See Also==
{{Ped functions}}

[[hu:getPedContactElement]]

User:Alfredo

2020-04-02T16:58:53Z

Alfredo: Created page with "Comunidad RPA Discord: https://discord.gg/bqrkCDJ Perfil foro MTA: https://forum.mtasa.com/profile/68686-alfredo/ Discord Personal: Alfredo#6227 Un saludo."

Comunidad RPA Discord: https://discord.gg/bqrkCDJ
Perfil foro MTA: https://forum.mtasa.com/profile/68686-alfredo/
Discord Personal: Alfredo#6227

Un saludo.

Template:Useful Functions

2020-04-02T16:50:50Z

Alfredo: /* Utility */ add isCharInString

__NOTOC__
=== Table functions ===
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.map]] » This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.
*[[table.merge]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[table.element]] » This function returns a new table with only userdata content.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[isPlayerStaff]] » This function checks if a player is server admin or staff.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.

=== Account functions ===
*[[getAccountByName]] » This function checks if an account already exists.
*[[removeAccountData]] » This function is used to remove data from an account.
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.
*[[isInSlot]] » This function checks your cursor is in slot.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.
*[[dxDrawRombo]] » This function creates a Rhombus.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.

=== Elements functions ===
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].
*[[getClipboard]] » This event returns the contents of the clipboard by pressing ctrl + v / ctrl + V. Event triggered ONLY if cursor is showing.

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[FormatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateString]] » This function generates a random string with any characters.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[getDistance]] » Returns the distance between two elements.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getKeyFromValueInTable]] » This function returns the key of the specified value in a table.
*[[getOffsetFromXYZ]] » This function allows you to take an entity and a position and calculate the relative offset between them accounting for rotations.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonthH]] » This function convert english months to arabic months
*[[getRealMonthM]] » This function gives you the real months name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.
*[[getDistanceBetweenElements]] » Esta funcion sirve para obtener la distancia entre dos elementos.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.
*[[guiComboBoxAddPlayersName]] » This function is add players name in combobox .

=====Gridlists=====
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[guiGridListSetColumnsFixedWidth]] » This function makes a gridlist have all its columns fixed width.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.
*[[convertGridListToText]] » This function converts grid list contents to text.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[reMap]] » Re-maps a number from one range to another.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[setVehicleTurnVelocityCenterOfMass]]» This function sets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[createAdvancedVehicle]]» This function create a vehicle with paintjob,coordinates,colors and plate.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.
*[[getPreviousAndNextWeapon]] » This function returns the next weapon and previous.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getServerIp]] » This function returns the public IP of the server.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCursorOnElement]] » This function checks whether the cursor is in a particular area.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.

<noinclude>[[Category:Useful Functions]]</noinclude>

IsCharInString

2020-04-02T16:48:19Z

Alfredo: Created page with "{{Useful Function}} This shared function allows you to check if a char specified is in a string value. ==Syntax== <syntaxhighlight lang="lua"> bool isCharInString ( string c..."

Template:Useful Functions

2020-04-02T13:19:26Z

Alfredo: /* Account functions */

__NOTOC__
=== Table functions ===
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.empty]] » This function checks whether a table is empty.
*[[table.map]] » This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.
*[[table.merge]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[table.element]] » This function returns a new table with only userdata content.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[isPlayerStaff]] » This function checks if a player is server admin or staff.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.

=== Account functions ===
*[[getAccountByName]] » This function checks if an account already exists.
*[[removeAccountData]] » This function is used to remove data from an account.
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.
*[[isInSlot]] » This function checks your cursor is in slot.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.
*[[dxDrawRombo]] » This function creates a Rhombus.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.

=== Elements functions ===
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if an element is within a collision shape element.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.

=== Events ===
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].
*[[getClipboard]] » This event returns the contents of the clipboard by pressing ctrl + v / ctrl + V. Event triggered ONLY if cursor is showing.

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[FormatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateString]] » This function generates a random string with any characters.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[getDistance]] » Returns the distance between two elements.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getKeyFromValueInTable]] » This function returns the key of the specified value in a table.
*[[getOffsetFromXYZ]] » This function allows you to take an entity and a position and calculate the relative offset between them accounting for rotations.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonthH]] » This function convert english months to arabic months
*[[getRealMonthM]] » This function gives you the real months name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.
*[[getDistanceBetweenElements]] » Esta funcion sirve para obtener la distancia entre dos elementos.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.
*[[guiComboBoxAddPlayersName]] » This function is add players name in combobox .

=====Gridlists=====
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[guiGridListSetColumnsFixedWidth]] » This function makes a gridlist have all its columns fixed width.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.
*[[convertGridListToText]] » This function converts grid list contents to text.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[reMap]] » Re-maps a number from one range to another.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[warpToPlayer]]» This function make player warp to another player.

=== Resource functions ===
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[setVehicleTurnVelocityCenterOfMass]]» This function sets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[createAdvancedVehicle]]» This function create a vehicle with paintjob,coordinates,colors and plate.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.
*[[getPreviousAndNextWeapon]] » This function returns the next weapon and previous.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getServerIp]] » This function returns the public IP of the server.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCursorOnElement]] » This function checks whether the cursor is in a particular area.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.

<noinclude>[[Category:Useful Functions]]</noinclude>

Multi Theft Auto: Wiki:GetAccountByName

2020-03-24T14:04:25Z

Alfredo: Alfredo moved page GetAccountFromName to Multi Theft Auto: Wiki:GetAccountByName: Rename page

{{Useful_Function}}
<lowercasetitle/>
__NOTOC__
This serverside useful function returns an account from its name, returns false if otherwise.

==Syntax==
<syntaxhighlight lang="lua">account getAccountByName ( string accountname )</syntaxhighlight>

===Required Arguments===
* '''accountName''': The name of the account you want to retrieve.

==Code==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getAccountByName ( accountName )
local accounts = getAccounts ()
for i,v in ipairs ( accounts ) do
local aName = getAccountName ( v )
if accountName == aName then
return v
end
end
return false
end
</syntaxhighlight>
</section>
Author: Alfredo

==Example==
This example check if an account is alredy in use.
<syntaxhighlight lang="lua">
function accounExists ( player, cmd, account )
if account then
local checker = getAccountByName (account)
if checker then
outputChatBox ("This account already exists.", player, 0, 255, 0, false)
else
outputChatBox ("This accound does not exists.", player, 255, 0, 0, false)
end
else
outputChatBox ("Enter an account name.", player, 255, 0, 0, false)
end
end
addCommandHandler ("account",accountExists)
</syntaxhighlight>

==See Also==
{{Useful_Functions}}

Multi Theft Auto: Wiki:GetAccountByName

2020-03-24T14:03:26Z

Alfredo: /* Example */

Multi Theft Auto: Wiki:GetAccountByName

2020-03-24T14:03:05Z

Alfredo: /* Code */

{{Useful_Function}}
<lowercasetitle/>
__NOTOC__
This serverside useful function returns an account from its name, returns false if otherwise.

==Syntax==
<syntaxhighlight lang="lua">account getAccountByName ( string accountname )</syntaxhighlight>

===Required Arguments===
* '''accountName''': The name of the account you want to retrieve.

==Code==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getAccountByName ( accountName )
local accounts = getAccounts ()
for i,v in ipairs ( accounts ) do
local aName = getAccountName ( v )
if accountName == aName then
return v
end
end
return false
end
</syntaxhighlight>
</section>
Author: Alfredo

==Example==
This example check if an account is alredy in use.
<syntaxhighlight lang="lua">
function accounExists ( player, cmd, account )
if account then
local checker = getAccountFromName (account)
if checker then
outputChatBox ("This account already exists.", player, 0, 255, 0, false)
else
outputChatBox ("This accound does not exists.", player, 255, 0, 0, false)
end
else
outputChatBox ("Enter an account name.", player, 255, 0, 0, false)
end
end
addCommandHandler ("account",accountExists)
</syntaxhighlight>

==See Also==
{{Useful_Functions}}

Multi Theft Auto: Wiki:GetAccountByName

2020-03-24T14:02:52Z

Alfredo: /* Syntax */

{{Useful_Function}}
<lowercasetitle/>
__NOTOC__
This serverside useful function returns an account from its name, returns false if otherwise.

==Syntax==
<syntaxhighlight lang="lua">account getAccountByName ( string accountname )</syntaxhighlight>

===Required Arguments===
* '''accountName''': The name of the account you want to retrieve.

==Code==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getAccountFromName ( accountName )
local accounts = getAccounts ()
for i,v in ipairs ( accounts ) do
local aName = getAccountName ( v )
if accountName == aName then
return v
end
end
return false
end
</syntaxhighlight>
</section>
Author: Alfredo

==Example==
This example check if an account is alredy in use.
<syntaxhighlight lang="lua">
function accounExists ( player, cmd, account )
if account then
local checker = getAccountFromName (account)
if checker then
outputChatBox ("This account already exists.", player, 0, 255, 0, false)
else
outputChatBox ("This accound does not exists.", player, 255, 0, 0, false)
end
else
outputChatBox ("Enter an account name.", player, 255, 0, 0, false)
end
end
addCommandHandler ("account",accountExists)
</syntaxhighlight>

==See Also==
{{Useful_Functions}}

Multi Theft Auto: Wiki:GetAccountByName

2020-03-24T13:58:29Z

Alfredo: /* Example */

{{Useful_Function}}
<lowercasetitle/>
__NOTOC__
This serverside useful function returns an account from its name, returns false if otherwise.

==Syntax==
<syntaxhighlight lang="lua">account getAccountFromName ( string accountname )</syntaxhighlight>

===Required Arguments===
* '''accountName''': The name of the account you want to retrieve.

==Code==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getAccountFromName ( accountName )
local accounts = getAccounts ()
for i,v in ipairs ( accounts ) do
local aName = getAccountName ( v )
if accountName == aName then
return v
end
end
return false
end
</syntaxhighlight>
</section>
Author: Alfredo

==Example==
This example check if an account is alredy in use.
<syntaxhighlight lang="lua">
function accounExists ( player, cmd, account )
if account then
local checker = getAccountFromName (account)
if checker then
outputChatBox ("This account already exists.", player, 0, 255, 0, false)
else
outputChatBox ("This accound does not exists.", player, 255, 0, 0, false)
end
else
outputChatBox ("Enter an account name.", player, 255, 0, 0, false)
end
end
addCommandHandler ("account",accountExists)
</syntaxhighlight>

==See Also==
{{Useful_Functions}}

Multi Theft Auto: Wiki:GetAccountByName

2020-03-24T13:57:53Z

Alfredo: /* Code */

{{Useful_Function}}
<lowercasetitle/>
__NOTOC__
This serverside useful function returns an account from its name, returns false if otherwise.

==Syntax==
<syntaxhighlight lang="lua">account getAccountFromName ( string accountname )</syntaxhighlight>

===Required Arguments===
* '''accountName''': The name of the account you want to retrieve.

==Code==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getAccountFromName ( accountName )
local accounts = getAccounts ()
for i,v in ipairs ( accounts ) do
local aName = getAccountName ( v )
if accountName == aName then
return v
end
end
return false
end
</syntaxhighlight>
</section>
Author: Alfredo

==Example==
This example check if an account is alredy in use.
<syntaxhighlight lang="lua">
function accounExist ( player, cmd, account )
if account then
local checker = getAccountFromName (account)
if checker then
outputChatBox ("This account already exists.", player, 0, 255, 0, false)
else
outputChatBox ("This accound does not exists.", player, 255, 0, 0, false)
end
else
outputChatBox ("Enter an account name.", player, 255, 0, 0, false)
end
end
addCommandHandler ("account",accountExist)
</syntaxhighlight>

==See Also==
{{Useful_Functions}}

Multi Theft Auto: Wiki:GetAccountByName

2020-03-24T13:36:16Z

Alfredo:

{{Useful_Function}}
<lowercasetitle/>
__NOTOC__
This serverside useful function returns an account from its name, returns false if otherwise.

==Syntax==
<syntaxhighlight lang="lua">account getAccountFromName ( string accountname )</syntaxhighlight>

===Required Arguments===
* '''accountName''': The name of the account you want to retrieve.

==Code==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getAccountFromName ( accountName )
local accounts = getAccounts ()
for i,v in ipairs ( accounts ) do
local accountName = getAccountName ( v )
if name == accountName then
return v
end
end
return false
end
</syntaxhighlight>
</section>
Author: Alfredo

==Example==
This example check if an account is alredy in use.
<syntaxhighlight lang="lua">
function accounExist ( player, cmd, account )
if account then
local checker = getAccountFromName (account)
if checker then
outputChatBox ("This account already exists.", player, 0, 255, 0, false)
else
outputChatBox ("This accound does not exists.", player, 255, 0, 0, false)
end
else
outputChatBox ("Enter an account name.", player, 255, 0, 0, false)
end
end
addCommandHandler ("account",accountExist)
</syntaxhighlight>

==See Also==
{{Useful_Functions}}

Multi Theft Auto: Wiki:GetAccountByName

2020-03-24T13:34:43Z

Alfredo: /* Example */

{{Useful_Function}}
<lowercasetitle/>
__NOTOC__
This serverside useful function returns an account from its name, if it does exist.

==Syntax==
<syntaxhighlight lang="lua">account getAccountFromName ( string accountname )</syntaxhighlight>

===Required Arguments===
* '''accountName''': The name of the account you want to retrieve.

==Code==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getAccountFromName ( accountName )
local accounts = getAccounts ()
for i,v in ipairs ( accounts ) do
local accountName = getAccountName ( v )
if name == accountName then
return v
end
end
return false
end
</syntaxhighlight>
</section>
Author: Alfredo

==Example==
This example check if an account is alredy in use.
<syntaxhighlight lang="lua">
function accounExist ( player, cmd, account )
if account then
local checker = getAccountFromName (account)
if checker then
outputChatBox ("This account already exists.", player, 0, 255, 0, false)
else
outputChatBox ("This accound does not exists.", player, 255, 0, 0, false)
end
else
outputChatBox ("Enter an account name.", player, 255, 0, 0, false)
end
end
addCommandHandler ("account",accountExist)
</syntaxhighlight>

==See Also==
{{Useful_Functions}}

Multi Theft Auto: Wiki:GetAccountByName

2020-03-24T13:29:49Z

Alfredo: /* Code */

{{Useful_Function}}
<lowercasetitle/>
__NOTOC__
This serverside useful function returns an account from its name, if it does exist.

==Syntax==
<syntaxhighlight lang="lua">account getAccountFromName ( string accountname )</syntaxhighlight>

===Required Arguments===
* '''accountName''': The name of the account you want to retrieve.

==Code==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getAccountFromName ( accountName )
local accounts = getAccounts ()
for i,v in ipairs ( accounts ) do
local accountName = getAccountName ( v )
if name == accountName then
return v
end
end
return false
end
</syntaxhighlight>
</section>
Author: Alfredo

==Example==
This example tells any player who uses ''/checkaccountname'' command if their nickname is used by an account or not.
<syntaxhighlight lang="lua">
function outputUsernameAvailability(player)
local nick = getPlayerName(player)
if getAccountFromName(nick) then
outputChatBox("Your nickname is already used by an account.",player,255,0,0)
else
outputChatBox("Your nickname is free to use by a new account.",player,0,255,0)
end
end
addCommandHandler("checkaccountname",outputUsernameAvailability)
</syntaxhighlight>

==See Also==
{{Useful_Functions}}