Multi Theft Auto: Wiki - User contributions [en]

Template:Element functions

2017-10-29T00:56:07Z

Lars: isElementWaitingForGroundToLoad is a client-only function

*[[clearElementVisibleTo]]
*[[cloneElement]]
*[[createElement]]
*[[destroyElement]]
*[[getAllElementData]]
*[[getAttachedElements]]
*[[getElementAlpha]]
*[[getElementAttachedOffsets]]
*[[getElementCollisionsEnabled]]
*[[getElementAttachedTo]]
*[[getElementByID]]
*[[getElementByIndex]]
*[[getElementChild]]
*[[getElementChildren]]
*[[getElementChildrenCount]]
*[[getElementColShape]]
*[[getElementData]]
*[[getElementDimension]]
*[[getElementHealth]]
*[[getElementID]]
*[[getElementInterior]]
*[[getElementMatrix]]
*[[getElementParent]]
*[[getElementPosition]]
*[[getElementRotation]]
*[[getElementsByType]]
*[[getElementsWithinColShape]]
*[[getElementType]]
*[[getElementVelocity]]
*[[getElementZoneName]]
*[[getRootElement]]
*[[isElement]]
*[[isElementAttached]]
*[[isElementCallPropagationEnabled]]
*[[isElementDoubleSided]]
*[[isElementFrozen]]
*[[isElementVisibleTo]]
*[[isElementWithinColShape]]
*[[removeElementData]]
*[[setElementAlpha]]
*[[setElementCallPropagationEnabled]]
*[[setElementCollisionsEnabled]]
*[[setElementData]]
*[[setElementDoubleSided]]
*[[setElementDimension]]
*[[setElementFrozen]]
*[[setElementHealth]]
*[[setElementID]]
*[[setElementInterior]]
*[[setElementParent]]
*[[setElementPosition]]
*[[setElementSyncer]]
*[[setElementRotation]]
*[[setElementVelocity]]
*[[setElementVisibleTo]]
*[[attachElements]]
*[[detachElements]]
*[[getElementModel]]
*[[getElementSyncer]]
*[[isElementInWater]]
*[[setElementAttachedOffsets]]
*[[setElementModel]]
*[[setLowLODElement]]
*[[getLowLODElement]]
*[[isElementLowLOD]]
<noinclude>[[Category:Functions templates]]</noinclude>

IsElementWaitingForGroundToLoad

2017-10-29T00:54:29Z

Lars: It's not a shared, it's a client-only function

{{Client function}}
__NOTOC__
{{New feature/item|3.0140|1.4.0|6715|This function checks whether MTA has frozen an element because it is above map objects which are still loading or not.}}
{{Note|When vehicles are frozen waiting for collisions to load they '''do not''' overwrite the frozen status set by [[setElementFrozen]].}}

==Syntax==
<syntaxhighlight lang="lua">
bool isElementWaitingForGroundToLoad ( element theElement )
</syntaxhighlight>
{{New feature/item|3.0141|1.4.0|6987|{{OOP||[[element]]:isWaitingForGroundToLoad|waitingForGroundToLoad}}}}

===Required arguments===
* '''theElement:''' the element to check its frozen waiting for custom map objects to load status. It can be a [[vehicle]], [[ped]] or [[player]].

===Returns===
Returns ''true'' if the specified [[element]] is frozen waiting for collisions of custom map objects to load. Returns ''false'' if it's not or if the specified [[element]] is invalid.

==Example==
<section name="Serverside example" class="server" show="true">
The next code snippet outputs a message when a vehicle respawns far away from players, above an [[object]].

<syntaxhighlight lang="lua">
local function notifyFarRespawnOnMap()
if isElementWaitingForGroundToLoad(source) then
outputChatBox("* A " .. getVehicleName(source) .. " respawned above an object which is far away! Find it quick!", root, 128, 255, 0)
end
end
addEventHandler("onClientVehicleRespawn", root, notifyFarRespawnOnMap)
</syntaxhighlight>
</section>

==See also==
{{Element functions}}

Authorized Serial Account Protection

2017-05-08T16:11:01Z

Lars: fixed wrong ending xml-tag

=FAQ=
==Help, I can't login (game)==
To allow the last attempted serial, use the '''authserial''' command in the server console.<br/>
For example, to allow the last attempted serial for account ''MrBob'', enter the following command in the server console:
authserial MrBob
==Help, I can't login (HTTP)==
To login to the HTTP web interface, the IP address has to be authorized.
To authorize an IP address:
* Join the MTA server
* Login to the account
* Disconnect from MTA server (optional)
* Login via HTTP
<br/>
=Main documentation=
==Introduction==
New from 1.5.3, Authorized Serial Account Protection provides a way to prevent password reuse causing damage to your server.
==How to enable==
Open '''mtaserver.conf''' and find ''<auth_serial_groups>'' and change to below.
(If ''<auth_serial_groups>'' does not exist, then add it)
<auth_serial_groups>Admin</auth_serial_groups>
If you wish to protect other ACL groups, then add them separated by commas, e.g.:
<auth_serial_groups>Admin,SuperModerator</auth_serial_groups>
==How to disable==
Open '''mtaserver.conf''' and find ''<auth_serial_groups>'' and change to below
<auth_serial_groups></auth_serial_groups>
'''Note''': Authorized Serial Account Protection helps prevent your server from getting hacked. If there is a chance any of your admins are using the same password on other servers, then do not disable this feature.
==How to use==
To allow the last attempted serial for an account, enter the following command in the server console:
authserial <account_name>
To view authorized serials for an account:
authserial <account_name> list
To remove the newest authorized serial for an account:
authserial <account_name> remove
To enable HTTP login from an unauthorized IP, use the following command to get a 7 digit code which should be appended to the HTTP login password ''(Requires server version 1.5.4-9.11302)''
authserial <account_name> httppass

Template:Client world functions

2017-04-22T14:08:35Z

Lars: added setVehiclesLODDistance, getVehiclesLODDistanceand resetVehiclesLODDistance

* [[areTrafficLightsLocked]]
* [[createSWATRope]]
* [[getAircraftMaxHeight]]
* [[getAircraftMaxVelocity]]
* [[getBirdsEnabled]]
* [[getCloudsEnabled]]
* [[getFarClipDistance]]
* [[getFogDistance]]
* [[getGameSpeed]]
* [[getGarageBoundingBox]]
* [[getGaragePosition]]
* [[getGarageSize]]
* [[getGravity]]
* [[getGroundPosition]]
* [[getHeatHaze]]
* [[getInteriorFurnitureEnabled]]
* [[getInteriorSoundsEnabled]]
* [[getJetpackMaxHeight]]
* [[getMinuteDuration]]
* [[getMoonSize]]
{{New feature/item|3.0141|1.4.1|6948|
* [[getNearClipDistance]]
}}
* [[getOcclusionsEnabled]]
* [[getPlayerBlurLevel]]
* [[getRainLevel]]
* [[getScreenFromWorldPosition]]
* [[getSunColor]]
* [[getSunSize]]
* [[getTime]]
* [[getTrafficLightState]]
* [[getVehiclesLODDistance]]
* [[getWeather]]
* [[getWindVelocity]]
* [[getWorldFromScreenPosition]]
* [[getZoneName]]
* [[isAmbientSoundEnabled]]
* [[isGarageOpen]]
* [[isLineOfSightClear]]
* [[isWorldSoundEnabled]]
* [[isWorldSpecialPropertyEnabled]]
* [[processLineOfSight]]
* [[removeWorldModel]]
* [[resetAmbientSounds]]
* [[resetFarClipDistance]]
* [[resetFogDistance]]
* [[resetHeatHaze]]
* [[resetMoonSize]]
* [[resetRainLevel]]
* [[resetSkyGradient]]
* [[resetSunColor]]
* [[resetSunSize]]
* [[resetVehiclesLODDistance]]
* [[resetWindVelocity]]
* [[resetWorldSounds]]
* [[restoreAllWorldModels]]
* [[restoreWorldModel]]
* [[setAircraftMaxHeight]]
* [[setAircraftMaxVelocity]]
* [[setAmbientSoundEnabled]]
* [[setBirdsEnabled]]
* [[setCloudsEnabled]]
* [[setFarClipDistance]]
* [[setFogDistance]]
* [[setGameSpeed]]
* [[setGarageOpen]]
* [[setGravity]]
* [[setHeatHaze]]
* [[setInteriorFurnitureEnabled]]
* [[setInteriorSoundsEnabled]]
* [[setJetpackMaxHeight]]
* [[setMinuteDuration]]
* [[setMoonSize]]
{{New feature/item|3.0141|1.4.1|6948|
* [[setNearClipDistance]]
}}
* [[setOcclusionsEnabled]]
* [[setPlayerBlurLevel]]
* [[setRainLevel]]
* [[setSkyGradient]]
* [[setSunColor]]
* [[setSunSize]]
* [[setTime]]
* [[setTrafficLightState]]
* [[setTrafficLightsLocked]]
* [[setVehiclesLODDistance]]
* [[setWeather]]
* [[setWeatherBlended]]
* [[setWindVelocity]]
* [[setWorldSoundEnabled]]
* [[setWorldSpecialPropertyEnabled]]
* [[testLineAgainstWater]]
<noinclude>[[Category:Functions templates]]</noinclude>

Changes in 1.5.4

2017-04-22T14:04:41Z

Lars: get/set VehiclesLODDistance insted of get/set VehicleLODDistance, added resetVehiclesLODDistance

{{Changelogs}}
__NOTOC__
* Changelog on Mantis: https://bugs.mtasa.com/changelog_page.php
* Full changelog: https://github.com/multitheftauto/mtasa-blue/commits/master?page=1

== Main Additions / Changes ==
* Security tweaks for both server and client
* Enabled ''Authorized Serial Protection'' by default
* Code refactoring and improvements to our build system (also added Clang support)

== Scripting ==

=== Client ===
* Added "sniper moon", "random foliage" and "extra air resistance" properties to [[setWorldSpecialPropertyEnabled]] (thanks to '''ZReC''')
* Added [[getVehiclesLODDistance]], [[setVehiclesLODDistance]] and [[resetVehiclesLODDistance]] (thanks to '''lopezloo''')
* Added [[setDebugViewActive]]

=== Shared (''Client & Server side'') ===
* Added [[passwordHash]] and [[passwordVerify]]
* Added ''queue'' name parameter to [[fetchRemote]] to support parallel downloads
* [[setElementDimension]] now supports element omnipresence, which means that an element can be in all dimensions at once (thanks to '''zneext''')

== Client ==

=== Client: Additions ===

=== Client: Bugfixes & Changes ===
* Corona markers should now have a correct attach offset position (thanks to '''lopezloo''')
* Fixed very lage radar areas not being visible (thanks to '''ZReC''')
* Disabled CEF sandbox due to problems (might be re-enabled soon)
* Updated CEF and other 3rd party dependencies
* Fixes for some crashes and improvements for error handling for installation and startup issues
* Removed max password length limit for server account passwords (thanks to '''4O4''')
* Improved multi-monitor support in windowed fullscreen mode
* Improved performance of [[dxGetPixelsSize]]
* Tweaked joystick support
* Fixed [[playSound]] not supporting unicode in URLs
* Increased default max streaming memory

== Server ==

=== Server: Additions ===
* Added ''fakelag'' command
* Added option to allow locally modified (gta3.img) vehicles

=== Server: Bugfixes & Changes ===
* Enabled ''Authorized Serial Account Protection'' by default
* Enabled ''Database Credentials Protection'' by default
* Fixes for weapons/fists desync
* SQLite or MySQL no longer makes the server freeze if the connection is lost
* Goggles no longer stay after player was killed (thanks to '''ArranTuna''')
* Fixed console input via pipe on Windows
* Added option "-u" to server command line to disable stdout buffering (useful for screenlog)

== Resources ==
* Added new special detections to ''acpanel''
* Added anti-command spam to ''freeroam'' (thanks to '''dutchman101''')
* Fixed vehicle kills not being displayed properly (thanks to '''ArranTuna''')
* Fixed abusable glitch in /anim command in ''freeroam'' (thanks to '''dutchman101''')
* Added graceful exitting to ''webbrowser''
* Fixed run commands overwritng 'results' global variable in ''runcode''

== Editor ==
* Disabled breathing sounds

== Extra information ==
''More detailed information available on [https://bugs.multitheftauto.com/changelog_page.php Bug tracker Changelog] and GitHub repositories:
:* [https://github.com/multitheftauto/mtasa-blue MTA: SA Blue]
:* [https://github.com/multitheftauto/mtasa-resources MTA: SA Official Resources]

[[Category:Changelog]]
[[Category:Incomplete]]

Template:GUI functions

2017-04-22T13:36:22Z

Lars: Added setDebugViewActive

__NOTOC__
* [[getChatboxLayout]]
* [[guiBringToFront]]
* [[guiCreateFont]]
* [[guiGetAlpha]]
* [[guiGetEnabled]]
* [[guiGetFont]]
* [[guiGetInputEnabled]]
* [[guiGetInputMode]]
* [[guiGetPosition]]
* [[guiGetProperties]]
* [[guiGetProperty]]
* [[guiGetScreenSize]]
* [[guiGetSize]]
* [[guiGetText]]
* [[guiGetVisible]]
* [[guiMoveToBack]]
* [[guiSetAlpha]]
* [[guiSetEnabled]]
* [[guiSetFont]]
* [[guiSetInputEnabled]]
* [[guiSetInputMode]]
* [[guiSetPosition]]
* [[guiSetProperty]]
* [[guiSetSize]]
* [[guiSetText]]
* [[guiSetVisible]]
* [[isChatBoxInputActive]]
* [[isConsoleActive]]
* [[isDebugViewActive]]
* [[isMainMenuActive]]
* [[isMTAWindowActive]]
* [[isTransferBoxActive]]
* [[setDebugViewActive]]

===Browsers=== 
* [[guiCreateBrowser]]
* [[guiGetBrowser]]

===Buttons===
* [[guiCreateButton]]

===Checkboxes===
* [[guiCheckBoxGetSelected]]
* [[guiCheckBoxSetSelected]]
* [[guiCreateCheckBox]]

===Comboboxes===
* [[guiCreateComboBox]]
* [[guiComboBoxAddItem]]
* [[guiComboBoxClear]]
* [[guiComboBoxGetItemText]]
* [[guiComboBoxSetItemText]]
* [[guiComboBoxRemoveItem]]
* [[guiComboBoxGetSelected]]
* [[guiComboBoxSetSelected]]

===Edit Fields===
* [[guiCreateEdit]]
* [[guiEditSetMasked]]
* [[guiEditSetMaxLength]]
* [[guiEditSetReadOnly]]
* [[guiEditSetCaretIndex]]
{{New feature/item|3.0135|1.3.5|6054|
* [[guiEditGetCaretIndex]]
}}
===Gridlists===
* [[guiCreateGridList]]
* [[guiGridListAddColumn]]
* [[guiGridListAddRow]]
* [[guiGridListAutoSizeColumn]]
* [[guiGridListClear]]
* [[guiGridListGetItemData]]
* [[guiGridListGetItemText]]
* [[guiGridListGetRowCount]]
* [[guiGridListGetSelectedItem]]
* [[guiGridListInsertRowAfter]]
* [[guiGridListRemoveColumn]]
* [[guiGridListRemoveRow]]
* [[guiGridListSetItemData]]
* [[guiGridListSetItemText]]
* [[guiGridListSetScrollBars]]
* [[guiGridListSetSelectedItem]]
* [[guiGridListSetSelectionMode]]
* [[guiGridListSetSortingEnabled]]
* [[guiGridListGetSelectedCount]]
* [[guiGridListGetSelectedItems]]
* [[guiGridListSetColumnWidth]]
* [[guiGridListGetColumnCount]]
* [[guiGridListGetItemColor]]
* [[guiGridListSetItemColor]]
* [[guiGridListGetColumnTitle]]
* [[guiGridListSetColumnTitle]]
* [[guiGridListGetHorizontalScrollPosition]]
* [[guiGridListSetHorizontalScrollPosition]]
* [[guiGridListGetVerticalScrollPosition]]
* [[guiGridListSetVerticalScrollPosition]]
{{New feature/item|3.0141|1.4.1|6926|
* [[guiGridListGetColumnWidth]]
}}

===Memos===
* [[guiCreateMemo]]
* [[guiMemoSetReadOnly]]
* [[guiMemoSetCaretIndex]]
{{New feature/item|3.0135|1.3.5|6054|
* [[guiMemoGetCaretIndex]]
}}

===Progressbars===
* [[guiCreateProgressBar]]
* [[guiProgressBarGetProgress]]
* [[guiProgressBarSetProgress]]

===Radio Buttons===
* [[guiCreateRadioButton]]
* [[guiRadioButtonGetSelected]]
* [[guiRadioButtonSetSelected]]

===Scrollbars===
* [[guiCreateScrollBar]]
* [[guiScrollBarGetScrollPosition]]
* [[guiScrollBarSetScrollPosition]]

===Scrollpanes===
* [[guiCreateScrollPane]]
* [[guiScrollPaneGetHorizontalScrollPosition]]
* [[guiScrollPaneGetVerticalScrollPosition]]
* [[guiScrollPaneSetHorizontalScrollPosition]]
* [[guiScrollPaneSetScrollBars]]
* [[guiScrollPaneSetVerticalScrollPosition]]

===Static Images===
* [[guiCreateStaticImage]]
* [[guiStaticImageGetNativeSize]]
* [[guiStaticImageLoadImage]]

===Tab Panels===
* [[guiCreateTabPanel]]
* [[guiGetSelectedTab]]
* [[guiSetSelectedTab]]

===Tabs===
* [[guiCreateTab]]
* [[guiDeleteTab]]

===Text Labels===
* [[guiCreateLabel]]
* [[guiLabelGetFontHeight]]
* [[guiLabelGetTextExtent]]
* [[guiLabelSetColor]]
* [[guiLabelSetHorizontalAlign]]
* [[guiLabelSetVerticalAlign]]
{{New feature/item|3.0132|1.3.1|4670|
* [[guiLabelGetColor]]
}}

===Windows===
* [[guiCreateWindow]]
* [[guiWindowSetMovable]]
* [[guiWindowSetSizable]]

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

SetDebugViewActive

2017-04-22T13:34:44Z

Lars: Created page with "{{Client function}} __NOTOC__ This function enables or disables the debug window. ==Syntax== <syntaxhighlight lang="lua"> bool setDebugViewActive ( bool enabled ) </syntaxhi..."

{{Client function}}
__NOTOC__
This function enables or disables the debug window.

==Syntax==
<syntaxhighlight lang="lua">
bool setDebugViewActive ( bool enabled )
</syntaxhighlight>

===Required Arguments===
* '''enabled:''' true if debug window should be visible, false otherwise.

===Returns===
Returns ''true'', ''false'' if invalid parameters are passed.

==Example==
This example enables or disables the debug window.
<syntaxhighlight lang="lua">
function enableDebug()
local state = not isDebugViewEnabled()
setDebugViewActive(state)
end
addCommandHandler("debug", enableDebug)
</syntaxhighlight>

==See Also==
{{GUI_functions}}

Template:CEF functions

2017-04-09T18:00:47Z

Lars:

{{New items|3.0150|1.5|
*[[createBrowser]]
*[[executeBrowserJavascript]]
*[[focusBrowser]]
{{New items|3.0153|1.5.3-9912|
*[[resizeBrowser]]
}}
*[[isBrowserDomainBlocked]]
*[[isBrowserFocused]]
*[[isBrowserLoading]]
*[[getBrowserProperty]]
*[[getBrowserSettings]]
*[[getBrowserTitle]]
*[[getBrowserURL]]
*[[injectBrowserMouseDown]]
*[[injectBrowserMouseMove]]
*[[injectBrowserMouseUp]]
*[[injectBrowserMouseWheel]]
*[[loadBrowserURL]]
*[[canBrowserNavigateBack]]
*[[canBrowserNavigateForward]]
*[[navigateBrowserBack]]
*[[navigateBrowserForward]]
*[[reloadBrowserPage]]
*[[setBrowserProperty]]
*[[setBrowserRenderingPaused]]
*[[setBrowserVolume]]
*[[requestBrowserDomains]]
|}}
{{New items|3.0151|1.5.1|
*[[setBrowserAjaxHandler]]
*[[getBrowserSource]]
*[[toggleBrowserDevTools]]
|}}
===GUI Functions=== 
*[[guiCreateBrowser]]
*[[guiGetBrowser]]
<noinclude>[[Category:Functions templates]]</noinclude>

ConvertTextToSpeech

2017-04-08T23:24:44Z

Lars:

__NOTOC__
{{Useful Function}}<lowercasetitle/>


This useful shared function converts some text to audible speech using Google's TTS.

==Syntax==
<syntaxhighlight lang="lua">boolean, element, string convertTextToSpeech ( string text [, table/element broadcastTo = root, string language = "en" ] )</syntaxhighlight>

==Required arguments==
* ''text'': the text to convert to speech.

==Optional arguments==
* ''broadcastTo'': if it's a regular indexed table, the speech will be broadcasted to the players contained in it. If it's a element, the speech will be heard by the players which are children of that element. This parameter is '''ONLY''' serverside; if you're using this function clientside this will be considered as the ''language'' argument.
* ''language'': defines the language of the TTS output.

==Returns==
* This function returns ''[[nil]]'' and outputs an error if an argument it's not valid.
* If called serverside and if all arguments are valid, this function returns ''true'' if the client was successully told to play the TTS (althrough this doesn't mean that the client will always play the speech); ''false'' otherwise.
* If called clientside and if all arguments are valid, this function returns ''true'', the corresponding [[sound]] element and its URL if the sound could theorically be played (althrough it may not play); ''[[nil]]'' otherwise.

==Function source==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
addEvent("playTTS", true) -- Add the event

local function playTTS(text, lang)
--local URL = "http://translate.google.com/translate_tts?tl=" .. lang .. "&q=" .. text
local URL = "https://code.responsivevoice.org/getvoice.php?tl=" .. lang .. "&t=" .. text
-- Play the TTS. BASS returns the sound element even if it can not be played.
return true, playSound(URL), URL
end
addEventHandler("playTTS", root, playTTS)
</syntaxhighlight>
</section>
<section name="Shared (server and client)" class="both" show="true">
<syntaxhighlight lang="lua">
function convertTextToSpeech(text, broadcastTo, lang)
-- Ensure first argument is valid
assert(type(text) == "string", "Bad argument 1 @ convertTextToSpeech [ string expected, got " .. type(text) .. "]")
assert(#text <= 100, "Bad argument 1 @ convertTextToSpeech [ too long string; 100 characters maximum ]")
if triggerClientEvent then -- Is this function called serverside?
-- Ensure second and third arguments are valid
assert(broadcastTo == nil or type(broadcastTo) == "table" or isElement(broadcastTo), "Bad argument 2 @ convertTextToSpeech [ table/element expected, got " .. type(broadcastTo) .. "]")
assert(lang == nil or type(lang) == "string", "Bad argument 3 @ convertTextToSpeech [ string expected, got " .. type(lang) .. "]")
-- Tell the client to play the speech
return triggerClientEvent(broadcastTo or root, "playTTS", root, text, lang or "en")
else -- This function is executed clientside
local lang = broadcastTo
-- Ensure second argument is valid
assert(lang == nil or type(lang) == "string", "Bad argument 2 @ convertTextToSpeech [ string expected, got " .. type(lang) .. "]")
return playTTS(text, lang or "en")
end
end
</syntaxhighlight>
</section>
*Original author: ''Has[S]oN''.
*Skype: ''hassan.saad2000''

==Example==
This example disables text chat and converts that text to a speech audible to nearby players. '''NOTE''': this example requires 1.4 in order to work.
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
local function tellClientsToPlayTTS(text, type)
if type == 0 and #text <= 100 then -- We only want to replace normal chat if possible
local x, y, z = getElementPosition(source)
local col = createColSphere(x, y, z, 30) -- We need this to get nearby players
triggerClientEvent(getElementsWithinColShape(col, "player"), "playChatTTS", source, text) -- Tell the nearby clients to play the sound
destroyElement(col)
cancelEvent() -- Replace text chat
end
end
addEventHandler("onPlayerChat", root, tellClientsToPlayTTS)</syntaxhighlight>
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
addEvent("playChatTTS", true) -- Add the event

local function playChatTTS(text)
local lang = (getLocalization().code):sub(1, 2) -- Output the TTS in the local player language, but don't bother about variants
local _, speech, URL = convertTextToSpeech(text, lang)
-- Convert that speech to a 3D sound
destroyElement(speech)
local x, y, z = getElementPosition(source)
local speech = playSound3D(URL, x, y, z)
attachElements(speech, source) -- Make the sound follow the player
setElementDimension(speech, getElementDimension(source))
setSoundMinDistance(speech, 15)
setSoundMaxDistance(speech, 30)
-- Tricky thing ahead: make the player mouth move, but without rendering him unable to move
setPedAnimation(source, "ped", "factalk", 0, true)
setPedAnimation(source, "ped", "factalk", 0, true)
-- Reset the player mouth after the speech has ended
setTimer(function(player)
if isElement(player) then
setPedAnimation(player) -- Clear the animation
end
end, math.max(getSoundLength(speech) * 1000, 50), 1, source)
end
addEventHandler("playChatTTS", root, playChatTTS)
</syntaxhighlight>
</section>

==See also==
{{Useful Functions}}