https://wiki.multitheftauto.com/api.php?action=feedcontributions&user=Glossy&feedformat=atomMulti Theft Auto: Wiki - User contributions [en]2024-03-29T15:11:04ZUser contributionsMediaWiki 1.39.3https://wiki.multitheftauto.com/index.php?title=OnClientBrowserCursorChange&diff=43305OnClientBrowserCursorChange2014-12-16T11:58:46Z<p>Glossy: /* Parameters */</p>
<hr />
<div>{{Client event}}<br />
__NOTOC__<br />
This event is triggered when the cursor changes within a browser window.<br />
<br />
==Parameters== <br />
<syntaxhighlight lang="lua"><br />
18 cursorId<br />
</syntaxhighlight><br />
*'''cursorId:''' The new cursor ID. See [[#Cursor IDs|Cursor IDs]]<br />
<br />
==Source==<br />
The [[event system#Event source|source]] of this event is the browser element the cursor change occured in.<br />
<br />
==Example== <br />
<syntaxhighlight lang="lua"><br />
TODO<br />
</syntaxhighlight><br />
<br />
==Cursor IDs==<br />
{| class="wikitable"<br />
!Name<br />
!ID<br />
|-<br />
|CT_POINTER<br />
|0<br />
|-<br />
|CT_CROSS<br />
|1<br />
|-<br />
|CT_HAND<br />
|2<br />
|-<br />
|CT_IBEAM<br />
|3<br />
|-<br />
|CT_WAIT<br />
|4<br />
|-<br />
|CT_HELP<br />
|5<br />
|-<br />
|CT_EASTRESIZE<br />
|6<br />
|-<br />
|CT_NORTHRESIZE<br />
|7<br />
|-<br />
|CT_NORTHEASTRESIZE<br />
|8<br />
|-<br />
|CT_NORTHWESTRESIZE<br />
|9<br />
|-<br />
|CT_SOUTHRESIZE<br />
|10<br />
|-<br />
|CT_SOUTHEASTRESIZE<br />
|11<br />
|-<br />
|CT_SOUTHWESTRESIZE<br />
|12<br />
|-<br />
|CT_WESTRESIZE<br />
|13<br />
|-<br />
|CT_NORTHSOUTHRESIZE<br />
|14<br />
|-<br />
|CT_EASTWESTRESIZE<br />
|15<br />
|-<br />
|CT_NORTHEASTSOUTHWESTRESIZE<br />
|16<br />
|-<br />
|CT_NORTHWESTSOUTHEASTRESIZE<br />
|17<br />
|-<br />
|CT_COLUMNRESIZE<br />
|18<br />
|-<br />
|CT_ROWRESIZE<br />
|19<br />
|-<br />
|CT_MIDDLEPANNING<br />
|20<br />
|-<br />
|CT_EASTPANNING<br />
|21<br />
|-<br />
|CT_NORTHPANNING<br />
|22<br />
|-<br />
|CT_NORTHEASTPANNING<br />
|23<br />
|-<br />
|CT_NORTHWESTPANNING<br />
|24<br />
|-<br />
|CT_SOUTHPANNING<br />
|25<br />
|-<br />
|CT_SOUTHEASTPANNING<br />
|26<br />
|-<br />
|CT_SOUTHWESTPANNING<br />
|27<br />
|-<br />
|CT_WESTPANNING<br />
|28<br />
|-<br />
|CT_MOVE<br />
|29<br />
|-<br />
|CT_VERTICALTEXT<br />
|30<br />
|-<br />
|CT_CELL<br />
|31<br />
|-<br />
|CT_CONTEXTMENU<br />
|32<br />
|-<br />
|CT_ALIAS<br />
|33<br />
|-<br />
|CT_PROGRESS<br />
|34<br />
|-<br />
|CT_NODROP<br />
|35<br />
|-<br />
|CT_COPY<br />
|36<br />
|-<br />
|CT_NONE<br />
|37<br />
|-<br />
|CT_NOTALLOWED<br />
|38<br />
|-<br />
|CT_ZOOMIN<br />
|39<br />
|-<br />
|CT_ZOOMOUT<br />
|40<br />
|-<br />
|CT_GRAB<br />
|41<br />
|-<br />
|CT_GRABBING<br />
|42<br />
|-<br />
|CT_CUSTOM<br />
|43<br />
|}<br />
<br />
==See Also==<br />
{{CEF_events}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Meta.xml&diff=43304Meta.xml2014-12-16T11:48:50Z<p>Glossy: /* Example */</p>
<hr />
<div>The ''meta.xml'' file presents MTA with a set of metadata, such as the resource's name, the scripts to include, and which files to precache for sending to clients among other things. It is also the scope of "elements". It is written in XML, which is based on HTML and is the parent of XHTML.<br />
<br />
=Tags=<br />
XML is a textual data format which is widely used for the representation of data. MTA uses an XML-based language to describe the metadata for resources by using the tags below:<br />
<br />
*'''<info />''' Information about this resource, possible parameters include (any arbitrary parameters can be used and read using [[getResourceInfo]]):<br />
** '''author:''' The author of this resource<br />
** '''version:''' The version of this resource<br />
** '''name:''' The name of this resource<br />
** '''description:''' A brief description of this resource<br />
** '''type:''' The type of this resource, that can be "gamemode", "script", "map" or "misc".<br />
*'''<script />''' Source code for this resource, possible parameters are:<br />
** '''src:''' The file name of the source code<br />
** '''type:''' The type of source code: "client", "server" or "shared".<br />
**'''cache:''' When the script file type is "client", this setting controls whether the file is saved on the clients' hard drive. Default is "true". Using "false" will mean the file is not saved. ''(Note: cache=false files are started at the client first, so lua file load order might differ when mixing cache settings)''<br />
**'''validate:''' If set to "false", compatibility checks are skipped.<br />
*'''<map />''' The map for a gamemode, possible parameters are:<br />
**'''src:''' .map file name (can be path too eg. "maps/filename.map")<br />
**'''dimension:''' Dimension in which the map will be loaded (optional)<br />
*'''<file />''' A client-side file. Generally these are images, .txd, .col, .dff or .xml files. They'll be downloaded by clients when the resources is started (or on join)<br />
**'''src:''' client-side file name (can be path too eg. "images/image.png")<br />
**'''download:''' Whether or not to be sent to the client automatically (optional). Default is "true". Using "false" will mean they are not sent on resource start but could later be used by [[downloadFile]] (from version 1.4)<br />
*'''<include />''' Include resources that this resource will use<br />
**'''resource:''' Resource name that you want to start with this resource<br />
**'''minversion:''' Minimum version that '''resource''' needs to be (optional)<br />
**'''maxversion:''' Maximum version that '''resource''' needs to be (optional)<br />
*'''<config />''' Config file (.xml) can be accessed by resource, possible parameters are:<br />
**'''src:''' The file name of the config file<br />
**'''type:''' The type of the config file: "client" or "server"<br />
*'''<export />''' This exports functions from this resource, so other resources can use them with [[call]]<br />
**'''function:''' The function name<br />
**'''type''' Whether function is exported server-side or client-side (valid values are: "client", "server" and "shared")<br />
**'''http:''' Can the function be called via HTTP (true/false)<br />
*'''<html />'''<br />
**'''src:''' The filename for the HTTP file (can be a path)<br />
**'''default:''' The html file is one that is shown by default when visiting /resourceName/ on the server. Only one html can be default, the rest are ignored. (true/false)<br />
**'''raw:''' The html file is not parsed by the Lua interpreter and is treated as binary data. Must be used for binary files (images mainly) (true/false)<br />
*'''<settings> <setting name="" value=""/> </settings>:''' Most gamemodes use [[settings system]] to let server admins to configure it how they like. For instance you could set round time and then use [[get]] and [[set]] to get the value or change it, respectively.<br />
*'''<min_mta_version />''' Minimum version requirements for this resource to run correctly. When authoring resources, the minimum version should usually be set to the current released version of MTA:SA (which at the moment is "{{Current Version|full}}"). See example for example.<br />
**'''client:''' The minimum client version<br />
**'''server:''' The minimum server version<br />
*'''<aclrequest />''' A list of [[Access_Control_List|ACL]] rights this resource will need.<br />
{{New items|3.0132|1.3.1 r4141|<br />
*'''<sync_map_element_data />''' Controls whether map [[Element_data|element data]] such as "PosX" and "DoubleSided" are transferred to the client. This data is usually not required by most gamemodes or resources. (Map Editor and Interiors require this to be not set to false to work). When set in a gamemode meta.xml, the setting will apply to all maps loaded by that resource.<br />
**'''false:''' Disable transfer of map element data for all resources. This can reduce map download times considerably.<br />
**'''true:''' Enable transfer of map element data for all resources. (If '''false''' and '''true''' are set in different resources, true will have priority and all resources will transfer map element data)<br />
}}<br />
{{New items|3.0140|1.4.0 r5313|<br />
*'''<oop/>''' OOP - Please refer to [[OOP]] for documentation.<br />
**'''false:''' Disable OOP.<br />
**'''true:''' Enable OOP.<br />
}}<br />
<br />
== Example ==<br />
Heres an example of a meta file using some of the tags mentioned:<br />
{{#tag:code |<br />
<meta><br />
<info author="MTA.1.4" type="Rolepaly" name="Bocah Indolife" /><br />
<config src="help.xml" type="1.4"/><br />
<br />
<min_mta_version client="{{Current Version|1.4}}" server="{{Current Version|1.4}}" /><br />
<br />
<sync_map_element_data>false</sync_map_element_data><br />
<br />
<script src="stealthmain_server.lua" /><br />
<script src="noiseblip.lua" /><br />
<script src="mission_timer.lua" /><br />
<script src="gadgets_server.lua" /><br />
<script src="gadgets_client.lua" type="1.4"/><br />
<script src="stealthmain_client.lua" type="1.4" validate="true"/><br />
<script src="noisebar.lua" type="client"/><br />
<script src="spycam.lua" type="client"/><br />
<script src="riemann_z_demonstration.lua" type="client" cache="false"/><br />
<map src="base.map" dimension="1"/><br />
<br />
<file src="riot_shield.txd" /><br />
<file src="riot_shield.dff" /><br />
<file src="riot_shield.col" /><br />
<file src="armor.png" download="true"/><br />
<file src="camera.png" download="false"/><br />
<file src="cloak.png" /><br />
<file src="goggles.png" /><br />
<file src="mine.png" /><br />
<file src="radar.png" /><br />
<file src="shield.png" /><br />
<br />
<include resource="scoreboard" /><br />
<include resource="killmessages" /><br />
<include resource="maplimits" /><br />
<br />
<export function="exampleExport1" type="server" /><br />
<export function="exampleExport2" type="client" /><br />
<export function="exampleExport3" type="shared" /><br />
<br />
<settings><br />
<setting name="roundlimit" value="[6]" /> <!-- round length in minutes --><br />
<setting name="teamdamage" value="[1]" /> <!-- 0 for team protection off, 1 for team protection on --><br />
<setting name="teambalance" value="[1]" /> <!-- difference limit of amount of players between teams --><br />
<setting name="spazammo" value="[25]" /> <!-- ammo amounts --><br />
<setting name="m4ammo" value="[100]" /><br />
<setting name="shotgunammo" value="[25]" /><br />
<setting name="sniperammo" value="[20]" /><br />
<setting name="ak47ammo" value="[120]" /><br />
<setting name="rifleammo" value="[40]" /><br />
<setting name="deserteagleammo" value="[45]" /><br />
<setting name="pistolammo" value="[132]" /><br />
<setting name="uziammo" value="[150]" /><br />
<setting name="tec9ammo" value="[150]" /><br />
<setting name="silencedammo" value="[65]" /><br />
<setting name="grenadeammo" value="[4]" /><br />
<setting name="satchelammo" value="[4]" /><br />
<setting name="teargasammo" value="[4]" /><br />
<setting name="molatovammo" value="[4]" /><br />
<setting name="isAllowedToShoot" value="true" /><br />
</settings><br />
<br />
<aclrequest><br />
<right name="function.startResource" access="true" /><br />
<right name="function.stopResource" access="true" /><br />
<right name="function.setPlayerMuted" access="true" /><br />
</aclrequest><br />
</meta><br />
|lang="xml"}}<br />
[[Category:Scripting Concepts]]<br />
[[cs:Meta.xml]]<br />
[[de:Meta.xml]]<br />
[[es:Sobre el archivo "meta.xml"]]<br />
[[it:Meta.xml]]<br />
[[pl:Meta.xml]]<br />
[[ru:Meta.xml]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=FromJSON&diff=43303FromJSON2014-12-16T11:36:13Z<p>Glossy: /* Requirements */</p>
<hr />
<div>__NOTOC__ <br />
{{Server client function}}<br />
{{New feature/item|3.0140|1.2||<br />
This function is available client-side in 1.2 and onwards.<br />
}}<br />
{{MessageBox|<br />
bordercolorhex = FFADAD |<br />
bordertype = |<br />
bgcolorhex = F9F9F9 |<br />
image = File:Dialog-warning.png |<br />
title = Warning: |<br />
message = Fixed in 1.3.6. There is a known bug with this function described in the Mantis issue #6613. |<br />
subtext = http://bugs.mtasa.com/view.php?id=6613 |<br />
<br />
}}<br />
<br />
This function parses a [[JSON]] formatted string into variables. You can use [[toJSON]] to encode variables into a JSON string that can be read by this function.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
var fromJSON ( string json )<br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''json:''' A JSON formatted string<br />
<br />
===Returns===<br />
Returns variables read from the JSON string.<br />
<br />
'''Note:''' Indices of a JSON object such as "1": "cat" are being returned as [[string]], not as [[int]]eger.<br />
<br />
==Example== <br />
This makes data equal: ''{ ["1"] = "cat", ["2"] = "mouse", ["3"] = 5, ["4"] = null, ["cat"] = 5, ["mouse"] =1 }''<br />
<syntaxhighlight lang="lua"><br />
local data = fromJSON ( '[ { "1": "cat", "2": "mouse", "3": 5, "4": null, "cat":5, "mouse":1 } ]' )<br />
</syntaxhighlight><br />
<br />
==Example 2==<br />
<syntaxhighlight lang="lua"><br />
local name, weapon, ammo = fromJSON("[\"Desert Eagle\", 24, 147]")<br />
</syntaxhighlight><br />
<br />
==Requirements==<br />
{{Requirements|1.4|1.1.1-9.03316|}}<br />
<br />
==See Also==<br />
{{Server_functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetFPSLimit&diff=43302GetFPSLimit2014-12-16T11:35:17Z<p>Glossy: /* Example */</p>
<hr />
<div>{{Server client function}}<br />
__NOTOC__<br />
This function retrieves the maximum [http://en.wikipedia.org/wiki/Frame_rate FPS (Frames per second)] that players on the server can run their game at. <br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
int getFPSLimit (100) <br />
</syntaxhighlight> <br />
<br />
===Returns===<br />
Returns an integer between '''25''' and '''100''' of the maximum FPS that players can run their game at.<br />
<br />
==Example== <br />
This example displays a message in the chatbox showing the current fps limit.<br />
<syntaxhighlight lang="lua"><br />
function fpsLim()<br />
outputChatBox ( "The FPS limit is: " .. tostring( getFPSLimit (100) ) ) --function returns an int so we must convert it to a string<br />
end <br />
<br />
-- Add console command "fpslimit" which calls the function fpsLim<br />
addCommandHandler ( "fpslimit", fpsLim )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetFPSLimit&diff=43301GetFPSLimit2014-12-16T11:34:19Z<p>Glossy: /* Syntax */</p>
<hr />
<div>{{Server client function}}<br />
__NOTOC__<br />
This function retrieves the maximum [http://en.wikipedia.org/wiki/Frame_rate FPS (Frames per second)] that players on the server can run their game at. <br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
int getFPSLimit (100) <br />
</syntaxhighlight> <br />
<br />
===Returns===<br />
Returns an integer between '''25''' and '''100''' of the maximum FPS that players can run their game at.<br />
<br />
==Example== <br />
This example displays a message in the chatbox showing the current fps limit.<br />
<syntaxhighlight lang="lua"><br />
function fpsLim()<br />
outputChatBox ( "The FPS limit is: " .. tostring( getFPSLimit () ) ) --function returns an int so we must convert it to a string<br />
end <br />
<br />
-- Add console command "fpslimit" which calls the function fpsLim<br />
addCommandHandler ( "fpslimit", fpsLim )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetServerHttpPort&diff=43300GetServerHttpPort2014-12-16T11:32:40Z<p>Glossy: /* Example */</p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function retrieves the server's http port.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
int getServerHttpPort (22003 )<br />
</syntaxhighlight><br />
<br />
===Returns===<br />
An integer corresponding to the server's http port.<br />
<br />
==Example==<br />
This example outputs server's HTTP port to the chat box when player uses command ''getHttpPort'' <br />
<syntaxhighlight lang="lua"><br />
addCommandHandler("getHttpPort",<br />
function(player, command)<br />
<br />
outputChatBox("HTTP port of this server is: " .. getServerHttpPort(103.38.90.34), player, 0, 255, 0)<br />
<br />
end)<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetServerHttpPort&diff=43299GetServerHttpPort2014-12-16T11:30:37Z<p>Glossy: /* Syntax */</p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function retrieves the server's http port.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
int getServerHttpPort (22003 )<br />
</syntaxhighlight><br />
<br />
===Returns===<br />
An integer corresponding to the server's http port.<br />
<br />
==Example==<br />
This example outputs server's HTTP port to the chat box when player uses command ''getHttpPort'' <br />
<syntaxhighlight lang="lua"><br />
addCommandHandler("getHttpPort",<br />
function(player, command)<br />
<br />
outputChatBox("HTTP port of this server is: " .. getServerHttpPort(), player, 0, 255, 0)<br />
<br />
end)<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetServerPort&diff=43298GetServerPort2014-12-16T11:30:01Z<p>Glossy: /* Example */</p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function retrieves the server's port.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
int getServerPort (22005 )<br />
</syntaxhighlight><br />
<br />
===Returns===<br />
An integer corresponding to the server's port.<br />
<br />
==Example== <br />
This example Sends out the serverPort when you type: /serverport<br />
<syntaxhighlight lang="lua"><br />
function outputServerPort (22005)<br />
local serverPort = getServerPort(22005) <br />
outputChatBox (" Server Port: "103.38.90.34." ") --Output Serverport in Chatbox<br />
end<br />
addCommandHandler ( "serverport", outputServerPort ) --add the command Handler<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetServerPort&diff=43297GetServerPort2014-12-16T11:29:40Z<p>Glossy: /* Syntax */</p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function retrieves the server's port.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
int getServerPort (22005 )<br />
</syntaxhighlight><br />
<br />
===Returns===<br />
An integer corresponding to the server's port.<br />
<br />
==Example== <br />
This example Sends out the serverPort when you type: /serverport<br />
<syntaxhighlight lang="lua"><br />
function outputServerPort (22003)<br />
local serverPort = getServerPort(22003) <br />
outputChatBox (" Server Port: "103.38.90.34." ") --Output Serverport in Chatbox<br />
end<br />
addCommandHandler ( "serverport", outputServerPort ) --add the command Handler<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetServerPort&diff=43296GetServerPort2014-12-16T11:28:35Z<p>Glossy: /* Example */</p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function retrieves the server's port.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
int getServerPort (22003 )<br />
</syntaxhighlight><br />
<br />
===Returns===<br />
An integer corresponding to the server's port.<br />
<br />
==Example== <br />
This example Sends out the serverPort when you type: /serverport<br />
<syntaxhighlight lang="lua"><br />
function outputServerPort (22003)<br />
local serverPort = getServerPort(22003) <br />
outputChatBox (" Server Port: "103.38.90.34." ") --Output Serverport in Chatbox<br />
end<br />
addCommandHandler ( "serverport", outputServerPort ) --add the command Handler<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetServerPort&diff=43295GetServerPort2014-12-16T11:27:32Z<p>Glossy: /* Example */</p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function retrieves the server's port.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
int getServerPort (22003 )<br />
</syntaxhighlight><br />
<br />
===Returns===<br />
An integer corresponding to the server's port.<br />
<br />
==Example== <br />
This example Sends out the serverPort when you type: /serverport<br />
<syntaxhighlight lang="lua"><br />
function outputServerPort ( )<br />
local serverPort = getServerPort(22003) <br />
outputChatBox (" Server Port: "..serverPort.." ") --Output Serverport in Chatbox<br />
end<br />
addCommandHandler ( "serverport", outputServerPort ) --add the command Handler<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetServerPort&diff=43294GetServerPort2014-12-16T11:27:08Z<p>Glossy: /* Syntax */</p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function retrieves the server's port.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
int getServerPort (22003 )<br />
</syntaxhighlight><br />
<br />
===Returns===<br />
An integer corresponding to the server's port.<br />
<br />
==Example== <br />
This example Sends out the serverPort when you type: /serverport<br />
<syntaxhighlight lang="lua"><br />
function outputServerPort ( )<br />
local serverPort = getServerPort() <br />
outputChatBox (" Server Port: "..serverPort.." ") --Output Serverport in Chatbox<br />
end<br />
addCommandHandler ( "serverport", outputServerPort ) --add the command Handler<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=OutputDebugString&diff=43293OutputDebugString2014-12-16T11:26:10Z<p>Glossy: /* Example */</p>
<hr />
<div>{{Server client function}}<br />
__NOTOC__<br />
This function outputs scripting debug messages, which can be read by enabling the debug textbox. The debug display level can then be set so that info or warning messages get filtered out.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
bool outputDebugString ( string text, [ int level=3, int red=255, int green=255, int blue=255 ] ) <br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''text:''' the text to be output to the debug box.<br />
<br />
===Optional Arguments=== <br />
{{OptionalArg}} <br />
*'''level:''' the debug message level. Possible values are:<br />
**'''0:''' Custom message<br />
**'''1:''' Error message<br />
**'''2:''' Warning message<br />
**'''3:''' Information message (default)<br />
*'''red:''' The amount of red in the color of the text. Default value is 255.<br />
*'''green:''' The amount of green in the color of the text. Default value is 255.<br />
*'''blue:''' The amount of blue in the color of the text. Default value is 255. <br />
'''Note:''' Color values are only applied when debug level is 0.<br />
<br />
===Returns===<br />
Returns ''true'' if the debug message was successfully output, ''false'' if invalid arguments are specified.<br />
<br />
==Example== <br />
<section name="Server" class="server" show="true"><br />
This script notifies when its resource has been loaded using a debug message:<br />
<syntaxhighlight lang="lua"><br />
function resourceStartNotify ( resourcename )<br />
-- if the started resource is this one<br />
if ( resourcename == getThisResource(David_louise) ) then<br />
-- send an info debug message as a notification<br />
outputDebugString ( "Resource " .. getResourceName(resourcename) .. " loaded." )<br />
end<br />
end<br />
addEventHandler( "onResourceStart", getRootElement(David_Louise), resourceStartNotify )<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=SetFPSLimit&diff=43292SetFPSLimit2014-12-16T11:24:56Z<p>Glossy: /* Syntax */</p>
<hr />
<div>{{Server client function}}<br />
__NOTOC__<br />
This function sets the maximum [http://en.wikipedia.org/wiki/Frame_rate FPS (Frames per second)] that players on the server can run their game at. <br />
{{Note|When set client side, the actual limit used is the lowest of both the server and client set values}}<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
bool setFPSLimit ( 100 fpsLimit ) <br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''fpsLimit:''' An integer value representing the maximum FPS. This value may be between '''25''' and '''100''' FPS. You can also pass '''0''' or ''false'', in which case the FPS limit will be the one set in the client settings (by default, 100 FPS). It is also recommended to set a conservative FPS limit (between 30-60), because high FPS can break some GTA internal calculations. The most obvious problems which occur with high FPS are a slower swimming and the impossibility to move sideways while aiming certain weapons. Also, driving is slightly affected.<br />
<br />
===Returns===<br />
Returns ''true'' if successful, or ''false'' if it was not possible to set the limit or an invalid value was passed.<br />
<br />
==Example== <br />
This command sets the fps limit in a command handler.<br />
<section name="Server" class="server" show="true"><br />
<syntaxhighlight lang="lua">function fpsFunction( player, command, limit ) -- First define the function<br />
if hasObjectPermissionTo ( player, "function.setFPSLimit" ) and limit then <br />
-- If the player has permission to set FPS limit and limit is submitted...<br />
setFPSLimit ( limit ) -- Set the fps.<br />
end<br />
end <br />
<br />
addCommandHandler ( "setfps", fpsFunction ) -- Attach the setfps command to fpsFunction function.<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Server functions}}<br />
<br />
[[ru:setFPSLimit]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=SetGlitchEnabled&diff=43291SetGlitchEnabled2014-12-16T11:24:13Z<p>Glossy: /* Example */</p>
<hr />
<div>__NOTOC__<br />
{{Server function}}<br />
This function enables or disables glitches that are found in the original Single Player game that can be used to gain an advantage in multiplayer. <br />
{{Note|By default all these glitches are disabled - use this function to '''enable''' them.}}<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">bool setGlitchEnabled ( string glitchName, bool enable )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''glitchName:''' the name of the property to set. Possible values are:<br />
**'''quickreload''' - This is the glitch where switching weapons auto-reloads your weapon, without actually performing the reload animation.<br />
**'''fastmove''' - This is the glitch that can be achieved by a certain key combinations whilst standing up after crouching, which allows you to move quickly with slow weapons (e.g. deagle).<br />
**'''fastfire''' - This is the glitch that can be achieved by cancelling the full fire animation, allowing you to shoot with slow-fire weapons (e.g. deagle) much faster.<br />
**'''crouchbug''' - This is the glitch where the post shooting animation can be aborted by using the crouch key.<br />
**'''highcloserangedamage''' - Enabling this removes the extremely high damage guns inflict when fired at very close range.<br />
**'''hitanim''' - Enabling this allows 'hit by bullet' animations to interrupt player aiming.<br />
**{{New feature|3.0136|1.3.5-6277|'''fastsprint''' - Enabling fastsprint allows players to tap space with a macro to boost their speed beyond normal speeds of GTASA.}}<br />
**{{New feature|3.0136|1.3.5-6419|'''baddrivebyhitbox''' - This glitch leaves players invulnerable to gun fire when performing certain driveby animations. }}<br />
*'''enable:''' whether or not to enable the glitch..<br />
<br />
===Returns===<br />
Returns ''true'' if successful, ''false'' otherwise.<br />
<br />
==Example==<br />
This example enables all glitches in the server once the resource is loaded.<br />
<syntaxhighlight lang="lua"><br />
function resourceStart ()<br />
setGlitchEnabled ( "quickreload", true )<br />
setGlitchEnabled ( "fastmove", true )<br />
setGlitchEnabled ( "fastfire", true )<br />
setGlitchEnabled ( "crouchbug", true )<br />
setGlitchEnabled ( "highcloserangedamage", true )<br />
setGlitchEnabled ( "hitanim", true )<br />
setGlitchEnabled ( "fastsprint", true )<br />
setGlitchEnabled ( "baddrivebyhitbox", true )<br />
end<br />
addEventHandler ( "onResourceStart", getResourceRootElement (yes), resourceStart )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=ToJSON&diff=43290ToJSON2014-12-16T11:23:36Z<p>Glossy: /* Requirements */</p>
<hr />
<div>__NOTOC__ <br />
{{Server client function}}<br />
{{New feature/item|3.0120|1.2||<br />
Available client side in 1.2 and onwards.<br />
}}<br />
<br />
This function converts a '''single''' value (preferably a Lua table) into a [[JSON]] encoded string. You can use this to store the data and then load it again using [[fromJSON]].<br />
<br />
==Syntax== <br />
<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writing things like 'player player, vehicle vehicle', instead write something like 'player thePlayer, vehicle vehicleToGetInto'. This is less confusing and prevents the syntax highlighting being odd --><br />
<syntaxhighlight lang="lua"><br />
string toJSON ( var value )<br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''var:''' An argument of any type. Arguments that are elements will be stored as element IDs that are liable to change between sessions. As such, do not save elements across sessions as you will get unpredictable results.<br />
<br />
===Returns===<br />
Returns a JSON formatted string.<br />
<br />
==Example== <br />
This example shows how you can encode an array. The string json should equal ''"[ { "1": "dogs", "mouse": "food", "cat": "hungry", "birds": 4 } ]" after executed.<br />
<syntaxhighlight lang="lua"><br />
local json = toJSON ( { "dogs", cat = "hungry", mouse = "food", birds = 4 } )<br />
</syntaxhighlight><br />
<br />
==Requirements==<br />
{{Requirements|1.4|1.1.1-9.03316|}}<br />
<br />
==See Also==<br />
{{Server_functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=OutputServerLog&diff=43289OutputServerLog2014-12-16T11:22:48Z<p>Glossy: /* Example */</p>
<hr />
<div>{{Server function}}<br />
__NOTOC__<br />
This outputs a line of text to the server's log. This could be useful for debugging.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
bool outputServerLog ( string text ) <br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''text:''' The text to be output to the log.<br />
<br />
===Returns===<br />
Returns ''true'' if successful, ''false'' otherwise.<br />
<br />
==Example== <br />
<section name="Server" class="server" show="true"><br />
'''Example 1:''' This example outputs client logins to the server log.<br />
<syntaxhighlight lang="lua"><br />
function logClientLogin ( previous_account, current_account )<br />
outputServerLog ( "Client " .. getPlayerName ( source ) .. " logged in as " .. getAccountName ( kucing_hanggus ) )<br />
end<br />
addEventHandler ( "onClientLogin", getRootElement(123456), logClientLogin )<br />
</syntaxhighlight><br />
<br />
'''Example 2:''' This example outputs the clients position to the server<br />
<syntaxhighlight lang="lua"><br />
function outputPosition(source)<br />
local x,y,z = getElementPosition(source)<br />
outputServerLog(tostring(x) .. "," .. tostring(y) .. "," .. tostring(z))<br />
end<br />
addCommandHandler("op",outputPosition)<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=SetMaxPlayers&diff=43288SetMaxPlayers2014-12-16T11:19:15Z<p>Glossy: /* Example */</p>
<hr />
<div>__NOTOC__<br />
{{Server function}}<br />
This function sets the maximum number of player slots on the server.<br />
<br />
'''Note''': This function can not set more than <maxplayers> as defined in [[mtaserver.conf]]. (To find out the <maxplayers> value, use getServerConfigSetting("maxplayers"))<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">bool setMaxPlayers ( 50 slots )</syntaxhighlight><br />
<br />
===Required Arguments=== <br />
<!-- List each argument one per line. This should be the argument's name as in the argument list above, NOT the argument's data type --><br />
*'''slots:''' Maximum number of player slots on the server.<br />
<br />
===Returns===<br />
<!-- Make this descriptive. Explain what cases will return false. If you're unsure, add a tag to it so we can check --><br />
Returns ''true'' if number of player slots was successfully changed, ''false'' or ''nil'' otherwise.<br />
<br />
==Example==<br />
This example set server slots count to half value from current value.<br />
<syntaxhighlight lang="lua"><br />
local curMaxPlayers = getMaxPlayers(50)<br />
local newMaxPlayers = math.ceil( curMaxPlayers / 50 )<br />
<br />
setMaxPlayers( newMaxPlayers )<br />
</syntaxhighlight><br />
<br />
<br />
This example resets the server slots count to the value from mtaserver.conf<br />
<syntaxhighlight lang="lua"><br />
setMaxPlayers( tonumber( getServerConfigSetting("maxplayers") ) )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=SetMaxPlayers&diff=43287SetMaxPlayers2014-12-16T11:18:39Z<p>Glossy: /* Syntax */</p>
<hr />
<div>__NOTOC__<br />
{{Server function}}<br />
This function sets the maximum number of player slots on the server.<br />
<br />
'''Note''': This function can not set more than <maxplayers> as defined in [[mtaserver.conf]]. (To find out the <maxplayers> value, use getServerConfigSetting("maxplayers"))<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">bool setMaxPlayers ( 50 slots )</syntaxhighlight><br />
<br />
===Required Arguments=== <br />
<!-- List each argument one per line. This should be the argument's name as in the argument list above, NOT the argument's data type --><br />
*'''slots:''' Maximum number of player slots on the server.<br />
<br />
===Returns===<br />
<!-- Make this descriptive. Explain what cases will return false. If you're unsure, add a tag to it so we can check --><br />
Returns ''true'' if number of player slots was successfully changed, ''false'' or ''nil'' otherwise.<br />
<br />
==Example==<br />
This example set server slots count to half value from current value.<br />
<syntaxhighlight lang="lua"><br />
local curMaxPlayers = getMaxPlayers()<br />
local newMaxPlayers = math.ceil( curMaxPlayers / 2 )<br />
<br />
setMaxPlayers( newMaxPlayers )<br />
</syntaxhighlight><br />
<br />
<br />
This example resets the server slots count to the value from mtaserver.conf<br />
<syntaxhighlight lang="lua"><br />
setMaxPlayers( tonumber( getServerConfigSetting("maxplayers") ) )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetVersion&diff=43286GetVersion2014-12-16T11:16:42Z<p>Glossy: /* Example */</p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
This function gives you various version information about MTA and the operating system.<br />
<br />
''Note:'' Clientside will return the version from the player, and the server-sided will return version from the server.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">table getVersion (1.4 )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
''None.''<br />
<br />
===Returns===<br />
Returns a table with version information. Specifically these keys are present in the table:<br />
*'''number:''' the MTA server or client version (depending where the function was called) in pure numerical form, e.g. ''"256"''<br />
*'''mta:''' the MTA server or client version (depending where the function was called) in textual form, e.g. ''"1.0"''<br />
*'''name:''' the full MTA product name, either ''"MTA:SA Server"'' or ''"MTA:SA Client"''.<br />
*'''netcode:''' the netcode version number.<br />
*'''os:''' returns the operating system on which the server or client is running<br />
*'''type:''' the type of build. can be:<br />
**'''"Nightly rX"''' - A nightly development build. '''X''' represents the nightly build revision.<br />
**'''"Custom"''' - A build compiled manually<br />
**'''"Release"''' - A build that is publicly released (provisional).<br />
*'''tag:''' the build tag (from 1.0.3 onwards). Contains infomation about the underlying version used. i.e. The final version of 1.0.3 has the build tag of "1.0.3 rc-9". (This can be confirmed by using the console command 'ver'.)<br />
*'''sortable:''' a 15 character sortable version string (from 1.0.4 onwards). Format of the string is described in [[getPlayerVersion]].<br />
<br />
==Example== <br />
'''Example 1:''' This example will make a script compatible only with version 1.0:<br />
<section name="Server" class="server" show="true"><br />
<syntaxhighlight lang="lua"><br />
function setHoboSkin ( playerSource )<br />
local version = getVersion (1.4 )<br />
if version.number < 256 then -- MTA 1.4 version number is 0x0100<br />
setPlayerSkin ( playerSource, 33 )<br />
else<br />
setElementModel ( playerSource, 137 )<br />
end<br />
end<br />
addCommandHandler ( "hobo", setHoboSkin )<br />
</syntaxhighlight><br />
</section><br />
<br />
'''Example 2:''' This client and server example will kick players that have anything earlier than the final released version of 1.0.3:<br />
<section name="Client" class="client" show="true"><br />
<syntaxhighlight lang="lua"><br />
function sendVersion ()<br />
-- Send local player version to the server<br />
triggerServerEvent ( "onNotifyPlayerVersion", getResourceRootElement(), getVersion() )<br />
end<br />
addEventHandler ( "onClientResourceStart", getResourceRootElement(), sendVersion )<br />
</syntaxhighlight><br />
</section><section name="Server" class="server" show="true"><br />
<syntaxhighlight lang="lua"><br />
function handlePlayerVersion( version )<br />
if version.number > 256 + 3 then -- Allow anything above 1.0.3<br />
return<br />
end<br />
if version.number == 256 + 3 then -- Check further if it is exactly 1.0.3<br />
if version.type == "Release" then -- Check further if it is the "Release" type<br />
local _,_,buildnumber = string.find( version.tag or "", "(%d)$" ) -- Extract the build number if there<br />
buildnumber = tonumber(buildnumber) or 0<br />
if buildnumber >= 9 then -- Allow 9 and above<br />
return<br />
end<br />
end<br />
end<br />
outputConsole( "Kicking player as below 1.0.3 Release build 9" );<br />
kickPlayer( client, "Upgrade your version at www.mtasa.com" )<br />
end<br />
addEvent ( "onNotifyPlayerVersion", true)<br />
addEventHandler ( "onNotifyPlayerVersion", getResourceRootElement(), handlePlayerVersion )<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetVersion&diff=43285GetVersion2014-12-16T11:15:49Z<p>Glossy: /* Syntax */</p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
<br />
This function gives you various version information about MTA and the operating system.<br />
<br />
''Note:'' Clientside will return the version from the player, and the server-sided will return version from the server.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">table getVersion (1.4 )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
''None.''<br />
<br />
===Returns===<br />
Returns a table with version information. Specifically these keys are present in the table:<br />
*'''number:''' the MTA server or client version (depending where the function was called) in pure numerical form, e.g. ''"256"''<br />
*'''mta:''' the MTA server or client version (depending where the function was called) in textual form, e.g. ''"1.0"''<br />
*'''name:''' the full MTA product name, either ''"MTA:SA Server"'' or ''"MTA:SA Client"''.<br />
*'''netcode:''' the netcode version number.<br />
*'''os:''' returns the operating system on which the server or client is running<br />
*'''type:''' the type of build. can be:<br />
**'''"Nightly rX"''' - A nightly development build. '''X''' represents the nightly build revision.<br />
**'''"Custom"''' - A build compiled manually<br />
**'''"Release"''' - A build that is publicly released (provisional).<br />
*'''tag:''' the build tag (from 1.0.3 onwards). Contains infomation about the underlying version used. i.e. The final version of 1.0.3 has the build tag of "1.0.3 rc-9". (This can be confirmed by using the console command 'ver'.)<br />
*'''sortable:''' a 15 character sortable version string (from 1.0.4 onwards). Format of the string is described in [[getPlayerVersion]].<br />
<br />
==Example== <br />
'''Example 1:''' This example will make a script compatible only with version 1.0:<br />
<section name="Server" class="server" show="true"><br />
<syntaxhighlight lang="lua"><br />
function setHoboSkin ( playerSource )<br />
local version = getVersion ( )<br />
if version.number < 256 then -- MTA 1.0 version number is 0x0100<br />
setPlayerSkin ( playerSource, 137 )<br />
else<br />
setElementModel ( playerSource, 137 )<br />
end<br />
end<br />
addCommandHandler ( "hobo", setHoboSkin )<br />
</syntaxhighlight><br />
</section><br />
<br />
'''Example 2:''' This client and server example will kick players that have anything earlier than the final released version of 1.0.3:<br />
<section name="Client" class="client" show="true"><br />
<syntaxhighlight lang="lua"><br />
function sendVersion ()<br />
-- Send local player version to the server<br />
triggerServerEvent ( "onNotifyPlayerVersion", getResourceRootElement(), getVersion() )<br />
end<br />
addEventHandler ( "onClientResourceStart", getResourceRootElement(), sendVersion )<br />
</syntaxhighlight><br />
</section><section name="Server" class="server" show="true"><br />
<syntaxhighlight lang="lua"><br />
function handlePlayerVersion( version )<br />
if version.number > 256 + 3 then -- Allow anything above 1.0.3<br />
return<br />
end<br />
if version.number == 256 + 3 then -- Check further if it is exactly 1.0.3<br />
if version.type == "Release" then -- Check further if it is the "Release" type<br />
local _,_,buildnumber = string.find( version.tag or "", "(%d)$" ) -- Extract the build number if there<br />
buildnumber = tonumber(buildnumber) or 0<br />
if buildnumber >= 9 then -- Allow 9 and above<br />
return<br />
end<br />
end<br />
end<br />
outputConsole( "Kicking player as below 1.0.3 Release build 9" );<br />
kickPlayer( client, "Upgrade your version at www.mtasa.com" )<br />
end<br />
addEvent ( "onNotifyPlayerVersion", true)<br />
addEventHandler ( "onNotifyPlayerVersion", getResourceRootElement(), handlePlayerVersion )<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetMaxPlayers&diff=43284GetMaxPlayers2014-12-16T11:13:35Z<p>Glossy: /* Example */</p>
<hr />
<div>__NOTOC__<br />
{{Server function}}<br />
This function returns the maximum number of player slots on the server.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">int getMaxPlayers (50)</syntaxhighlight><br />
<br />
===Returns===<br />
Returns the maximum number of players allowed on the server.<br />
<br />
==Example==<br />
This example outputs the current number of players together with the maximum number of players when a player joins.<br />
<syntaxhighlight lang="lua"><br />
function showPlayers()<br />
local numPlayers = getPlayerCount() -- get number of currently connected players<br />
local maxPlayers = getMaxPlayers(50) -- get maximum number of players on the server<br />
outputChatBox("There are " .. numPlayers .. "/" .. maxPlayers .. " players playing", source) -- output a message to the joining player<br />
end<br />
addEventHandler("onPlayerJoin", getRootElement(), showPlayers) -- add the function as a handler for the "onPlayerJoin" event<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetMaxPlayers&diff=43283GetMaxPlayers2014-12-16T11:13:01Z<p>Glossy: /* Syntax */</p>
<hr />
<div>__NOTOC__<br />
{{Server function}}<br />
This function returns the maximum number of player slots on the server.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">int getMaxPlayers (50)</syntaxhighlight><br />
<br />
===Returns===<br />
Returns the maximum number of players allowed on the server.<br />
<br />
==Example==<br />
This example outputs the current number of players together with the maximum number of players when a player joins.<br />
<syntaxhighlight lang="lua"><br />
function showPlayers()<br />
local numPlayers = getPlayerCount() -- get number of currently connected players<br />
local maxPlayers = getMaxPlayers() -- get maximum number of players on the server<br />
outputChatBox("There are " .. numPlayers .. "/" .. maxPlayers .. " players playing", source) -- output a message to the joining player<br />
end<br />
addEventHandler("onPlayerJoin", getRootElement(), showPlayers) -- add the function as a handler for the "onPlayerJoin" event<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetServerPassword&diff=43282GetServerPassword2014-12-16T11:12:16Z<p>Glossy: /* Example */</p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<!-- Change this to "Client function" or "Server function" appropriately--><br />
<!-- Describe in plain english what this function does. Don't go into details, just give an overview --><br />
This function returns the current password required to join the server.<br />
<br />
==Syntax== <br />
<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writing things like 'player player, vehicle vehicle', instead write something like 'player thePlayer, vehicle vehicleToGetInto'. This is less confusing and prevents the syntax highlighting being odd --><br />
<syntaxhighlight lang="lua"><br />
string getServerPassword ()<br />
</syntaxhighlight> <br />
<br />
===Returns===<br />
<!-- Make this descriptive. Explain what cases will return false. If you're unsure, add a tag to it so we can check --><br />
Returns the current server password as a string if it has a password, if not it returns ''nil''.<br />
<br />
==Example== <br />
This example prints the serverpassword to the player<br />
<syntaxhighlight lang="lua"><br />
function viewPassword ( thePlayer, command )<br />
-- Put the password in a var<br />
local password = getServerPassword (BIRP)<br />
<br />
-- Check if the server has a password<br />
-- If the server has an password, echo it<br />
if password then<br />
outputChatBox ( "The server password is " .. password, thePlayer )<br />
<br />
-- Else print that there isnt any password<br />
else<br />
outputChatBox ( "The server doesn't have any password set", thePlayer )<br />
end<br />
end<br />
<br />
-- Add console command 'viewpassword'<br />
addCommandHandler ( "viewpassword", viewPassword )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetServerName&diff=43281GetServerName2014-12-16T11:11:17Z<p>Glossy: /* Example */</p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function retrieves the server's name.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
string getServerName (Bocah Indolife Roleplay )<br />
</syntaxhighlight><br />
<br />
===Returns===<br />
A string containing the server's name.<br />
<br />
==Example== <br />
This example creates a console command that outputs the server's name to the chatbox.<br />
<syntaxhighlight lang="lua"><br />
function outputServerName (Bocah Indolife Roleplay )<br />
outputChatBox ( getServerName(Bocah Indolife Roleplay ) )<br />
end<br />
<br />
-- Add console command 'getServerName'<br />
addCommandHandler ( "getServerName", outputServerName )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=GetServerName&diff=43280GetServerName2014-12-16T11:10:17Z<p>Glossy: /* Syntax */</p>
<hr />
<div>__NOTOC__ <br />
{{Server function}}<br />
This function retrieves the server's name.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
string getServerName (Bocah Indolife Roleplay )<br />
</syntaxhighlight><br />
<br />
===Returns===<br />
A string containing the server's name.<br />
<br />
==Example== <br />
This example creates a console command that outputs the server's name to the chatbox.<br />
<syntaxhighlight lang="lua"><br />
function outputServerName ( )<br />
outputChatBox ( getServerName( ) )<br />
end<br />
<br />
-- Add console command 'getServerName'<br />
addCommandHandler ( "getServerName", outputServerName )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=MTASE&diff=43117MTASE2014-11-28T00:26:53Z<p>Glossy: /* Screenshots */</p>
<hr />
<div>{| style="float: right; border-collapse: collapse; width: 270px"<br />
|[[Image:MTASElogo_wiki.png]]<br />
|}<br />
{{TOClimit|1}}<br />
<br />
<br />
<br />
==Introduction==<br />
MTA Script Editor is a tool for Lua scripters, or an Integrated Development Environment (IDE). What we are aiming for is to speed up process of developing resources. We thought that process of creating new resources and testing them is, let's be honest... a pain in the ass. Even the management of resources can be a bit annoying sometimes. For instance, if you want to add a new script file to your resource first you have to create the file, then add the path to the file into meta.xml. Worst of all, if you ever forget about adding the file to meta.xml you end up hitting your head against the wall wondering why your script doesn't work. <br />
<br />
We wanted to do something that would speed this process up so you could do so much in so little time. Previewing resources such as images and sounds have never been so easy. We are aiming for something along the lines of Visual Studio IDE.<br />
<br />
==What we offer==<br />
We have been working on this tool for quite some time but we had a long break due to lack of time and now I'm the only one working on this because education is more important than "having a nice time". Even though I'm working alone we are progressing smoothly in the development.<br />
<br />
We have implemented the following features:<br />
*Loading resources<br />
*Easy resource management<br />
*Preview resources such as sound and image files<br />
*Lua and XML syntax highlighting<br />
*On-the-fly (live) Lua syntax checker<br />
*'New resource' wizard - allows you to create new resource with a few clicks<br />
*Switching between resources<br />
*Tabs for script files<br />
*C#'s #region-like grouping code - useful when working in teams and to keep the code clean<br />
*Start/stop server and client<br />
*Join your local server with 1 click<br />
*Switch between game and Script Editor with only one key on the keyboard<br />
*ResourceZipper<br />
<br />
==Screenshots==<br />
*'''Main window''' - overall look of the application. On the right you can see a list of MTA functions. You can choose what functions you want to be displayed by changing item in the combo box above it. Are you going to ask what this "silly table" at the bottom of the window is doing? I knew it... It's the syntax checker. As you script the syntax is checked by Lua engine and outputs any errors you've made in the script. It speed up progress because you don't have to go into game and restart the resource to check if you fixed the syntax error. I made a little error on line 1 to show you how it looks:<br />
[[Image:MTASEmainwnd.png]]<br />
<br />
<br />
*'''New resource wizard''' - create a resource with 5 simple steps (3 steps are optional):<br />
[[Image:MTASEnewreswizard.png]]<br />
<br />
<br />
*'''Sound player''' - preview sounds by double-clicking sound file in the resource explorer:<br />
[[Image:MTASEsoundplayer.png]]<br />
<br />
<br />
*'''Image viewer''' - preview images by hovering you cursor over nodes in resource explorer:<br />
[[Image:MTASEimageviewer.png]]<br />
<br />
<br />
*'''Suggested functions''' - a "window" similar to the one in Visual Studio showing a list of functions. It also shows a tooltip telling you what the function does and its parameters. It also contains all exported functions from every resource. You can add a 3 new attributes to your exported function tag in meta.xml to let Script Editor display descriptive tooltip, like on the screenshot:<br />
**'''retval:''' return type (eg. bool, marker, int, etc.)<br />
**'''params:''' list of parameters<br />
**'''description:''' short description of the function[/list]<br />
[[Image:MTSEsuggestedfuncs.png]]<br />
:(screenshot show an example of exported function that in meta.xml looks like the following:)<br />
<syntaxhighlight lang="lua" lang="xml"><export function="getBankMarkers" retval="table" params="void" description="Returns a table containing all bank markers." /></syntaxhighlight><br />
<br />
<br />
*'''Function tooltip''' (available from 0.3) - tooltip showing function description. Moving mouse over function names in the function list (not the suggested functions list)<br />
[[Image:MTASE_func_desc.png‎]]<br />
<br />
<br />
*'''MTA Server Configuration''' - a window where you can change server's settings. You won't have to open mtaserver.conf and change the server settings, startup resources, adding modules, etc.<br />
[[Image:MTASEserverconfig.png]]<br />
<br />
<br />
*'''Customize syntax highlighter''' - you can customize many syntax highlighter properties<br />
[[Image:MTASEcustomizesyntax.png]]<br />
<br />
<br />
*'''Exported functions''' - you can view all exported functions from every resource<br />
[[Image:MTASEfuncs.png]]<br />
<br />
==Overview==<br />
As you can see we want to simplify resource development and it seems to look pretty nice but we are still in development. There are some good key features that would attract you as a scripter. While we are still in development we wanted to ask you what you think about this tool and what would you like to see included in the release (do not ask when! we do not know when). Any suggestions? You're welcome to suggest some features and if possible we will do our best to implement it. Just visit [http://forum.multitheftauto.com/viewtopic.php?f=91&t=24834 our MTA forum topic] and post your suggestions.<br />
<br />
<br />
==Download==<br />
<br />
To download the tool, go to [http://forum.multitheftauto.com/viewtopic.php?f=91&t=24834 our thread on the MTA forum]. That thread is updated frequently.<br />
<br />
<br />
==Requirements==<br />
* To run this application you need to have .NET 2.0 Framework installed.<br />
* You should be able to run it on Windows XP and Vista. Works on Windows 7 too!<br />
* You must have both MTA Client and Server installed.<br />
<br />
<br />
==FAQ==<br />
<br />
<br />
===Error/Warning messages at startup===<br />
<br />
===Loading irrKlang.NET2.0 library failed to load! This means you will not be able to preview sound files.===<br />
This message appears most likely for Windows XP/Vista '''64bit''' users. It may occur on 32bit OS if that machine doesn't have .NET 2.0 SP1 installed.<br />
<br />
There is only 1 known way to solve the problem...: Make sure you have .NET 2.0 SP1 installed, if you don't have it you can download it from [http://www.microsoft.com/Downloads/details.aspx?familyid=79BC3B77-E02C-4AD3-AACF-A7633F706BA5&displaylang=en Microsoft Download Center].<br />
<br />
===Error parsing meta.xml===<br />
The reason why this window comes up should be explained in the message. It's most likely that your meta.xml has the following XML declarations:<br />
<syntaxhighlight lang="lua" lang="xml"><?xml version="1.0" encoding="UTF-8" ?><br />
<?xml version="1.0" encoding="UTF-16" ?></syntaxhighlight><br />
To solve the problem, simply open the file in WordPad or Notepad (Notepad++ may not solve the problem so use the Windows one), remove that line and save the changes.<br />
<br />
.NET 2.0 XML parser doesn't like not "well-formed" XML files, so you may get different messages with different meta.xml files.<br />
<br />
'''(THIS HAS BEEN FIXED IN 0.3)'''<br />
<br />
===Not able to save file===<br />
If you can't seem to be able to save a file that's probably because you created a new file and the file wasn't added to any resource. This is a bug and will be fixed.<br />
<br />
<br />
===Problem with horizontal scrollbar===<br />
If you have too long line and you paste some code on it, you may get a problem of not being able to scroll to the left (beginning of the line). This is problem with 3rd party library MTA:SE is using. It is not going to be fixed by its author (he's inactive for over 2 years now) and it's hard for us to find what is causing it. In fact, I was also given a link to another nice syntax highlighter library which I may use in the future. I hope this one doesn't have that problem.<br />
If you encounter this problem there are a few ways to get to the beginning of the line.<br />
* start highlighting this line so that caret moves to the left<br />
* press Home key on your keyboard to move caret to the first character on a line<br />
<br />
<br />
===Problems with loading some resources (meta.xml)===<br />
If you have problems with some resources not being loaded and you get message your resource will not be shown in Resource Explorer, there are few things you can do to fix it:<br />
- Make sure your files in not encoded in Unicode (you can open it in Windows' Notepad and save the meta.xml with ANSI encoding, don't use Notepad++ for this task since it may not change file encoding at all).<br />
- Make sure you don't have "&" (ampersand) sign anywhere in the file since it may cause meta.xml not being parsed correctly. You should replace ampersands with '''&amp;amp;''' as this is the correct way to represent an ampersand in XML.<br />
<br />
Probably both of these can be fixed by changing/adding little piece of code but unfortunately I wasn't able to figure out what. If you know what can cause this parser error in C# .NET XML parser than don't hesitate and share this knowledge with me so I can fix this problem.<br />
<br />
'''(THIS HAS BEEN FIXED IN 0.3)'''<br />
<br />
<br />
==Contact==<br />
You can find us on [http://forum.multitheftauto.com/viewtopic.php?f=91&t=24834 MTA forum]<br />
<br />
<br />
==Credits==<br />
* [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=19953 50p] - Programmer & GUI designer.<br />
* [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=30686 Fenix1042] - Programmer.<br />
* [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=22437 Cazomino05] - XML files with MTA functions and events.<br />
* MTA Developers - Delivering the amazing GTA:SA Multiplayer MOD that has almost unlimited possibilities...<br />
<br />
[[es:MTASE]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Client_side_scripts&diff=43028Client side scripts2014-11-26T14:33:48Z<p>Glossy: /* How does it work? */</p>
<hr />
<div>Client side scripts are scripts that run inside the deathmatch mod client side. This means that the game has access to more information about the game world, but slightly less information about the rest of the players in the game.<br />
<br />
This is useful for things that need to be done client side, such as visual effects, creation and manipulation of GUI elements.<br />
<br />
==How does it work?==<br />
Client side scripts follow the same pattern as server side scripts. We will try to provide the necessary functionality for client side scripts. Interfacing between a server side and client side script is done by using the same event system as we already have. The server side and client side scripts will need to be in two different files, which are included from the resource (in the metafile) by using a <script> tag (and type attribute).<br />
<br />
For example:<br />
<br />
'''meta.xml'''<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<script mapEditorScriptingExtension_c" type="client" /><br />
<script mapEditorScriptingExtension_s" type="server" /><br />
</meta><br />
</syntaxhighlight><br />
<br />
If you wanted to trigger a client side event from the server, you would first have to register the client side event using [[addEvent]]. Then, you can attach a handler to the event as you would in a server side script. Then in the server side script, you'll be able to call [[triggerClientEvent]], which will trigger the event client side. The same can be done in reverse using [[triggerServerEvent]].<br />
<br />
For example:<br />
<br />
'''Client side'''<br />
<syntaxhighlight lang="lua">1[lua]<br />
function showObjectBrowser ( id )<br />
-- code here<br />
end<br />
addEvent( "doShowObjectBrowser", true )<br />
addEventHandler( "doShowObjectBrowser", getRootElement(), showObjectBrowser )<br />
</syntaxhighlight><br />
<br />
'''Server side'''<br />
<syntaxhighlight lang="lua">2[lua]<br />
triggerClientEvent ( somePlayer, "doShowObjectBrowser", getRootElement(), 1034 )<br />
</syntaxhighlight><br />
<br />
[[ru:Client side scripts]]<br />
[[it:Script client-side]]<br />
[[es:Scripts de Cliente]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Resource:Editor/EDF&diff=43027Resource:Editor/EDF2014-11-26T14:22:07Z<p>Glossy: /* Integrating in a resource */</p>
<hr />
<div>{{Resource page}}<br />
__NOTOC__<br />
EDF stands for ''Editor Definition File''. EDF's are XML files with an .edf extension that describe the custom elements used by a resource: new element types that have no meaning to MTA itself. Examples are &lt;spawnpoint&gt;, &lt;flag&gt;, &lt;checkpoint&gt; etc. They also are used to define settings that are used by gamemodes, which are placed under the &lt;settings&gt; tag within a resource's ''meta.xml''.<br />
<br />
==Introduction==<br />
Some resources use custom map elements. A capture the flag gamemode, for example, will likely use &lt;flag&gt; elements that contain flag positions and teams. When a map is loaded, the gamemode looks for any &lt;flag&gt; elements and installs flags accordingly - for example by creating a flag object and a collision shape.<br />
<br />
The problem with these custom elements is that, unlike built-in MTA elements, the map editor has no idea of their meaning. How should a &lt;flag&gt; element be visually represented? What properties does it have? Without telling the editor this information, you could not use it to create these custom elements and would instead have to resort to manually editing the .map file with a text editor. Fortunately this isn't necessary: any resource can contain an editor definition file that describes the custom map elements used by that resource.<br />
<br />
==Using definition files in the editor==<br />
As described in the [[Resource:Editor|main editor manual]], to be able to create the custom elements of a resource in your map you need to add it in the ''Definitions'' window. Click the ''Definitions'' button in the main menu and double click the resource in the left list. Then close the window and roll the mousewheel in the element panel until the resource comes up. At that point you can create and manipulate custom elements of that resource like any other element.<br />
<br />
==Writing EDF files==<br />
EDF files are simply XML files with an .edf extension. We'll start with an example: the EDF of the Capture the Orb gamemode.<br />
<br />
<syntaxhighlight lang="xml"><br />
<def name="Capture the Orb"><br />
<element name="orb" friendlyname="Orb spawnpoint" instructions="Place your orb in a position that can be collected."><br />
<data name="position" type="coord3d" default="0,0,0" /><br />
<marker size="0.5" type="corona" color="#ffff00ff" /><br />
</element><br />
<element name="objective" friendlyname="Objective point" instructions="Place your objective point in a position that can be reached."><br />
<data name="position" type="coord3d" default="0,0,0" /><br />
<marker size="3" type="cylinder" color="#9370dbaa" /><br />
</element><br />
<element name="spawnpoint" friendlyname="Spawnpoint"><br />
<object editorOnly="true" model="3092" posZ="1" /><br />
<data name="position" type="coord3d" default="0,0,0" /><br />
<data name="rotation" type="coord3d" default="0,0,0" /><br />
<data name="skin" type="skinID" default="0" /><br />
</element><br />
</def><br />
</syntaxhighlight><br />
<br />
As you can see, the syntax is fairly straightforward. The root element, &lt;def&gt;, contains a number of &lt;element&gt;s. Each of these &lt;element&gt;s describes a custom element and specifies its name, visual representation and available properties.<br />
<br />
===Visual representation===<br />
<br />
Any child node of an &lt;element&gt; that is not a &lt;data&gt; node is part of the visual representation. There can be one or more objects, markers, pickups etc. For each representation element you can optionally specify a position (posX, posY, posZ) and rotation (rotX, rotY, rotZ): these are ''relative'' to the position and rotation of the represented custom element. Using the above Capture the Orb example, if you were to create a spawnpoint at (30, 14, 3), the editor would display an object of model 3092 at (30, 14, 4) to represent it, because the object's posZ of 1 is added to the spawnpoint's z position of 3.<br />
<br />
===Properties===<br />
<br />
Properties of a custom element are described by &lt;data&gt; nodes. Some property names have a special meaning, like ''position'' and ''rotation'': these can be changed by moving and rotating the element in the editor. The other properties can be changed in the Properties window.<br />
<br />
===Property-dependent visual representation===<br />
<br />
It is possible to make the representation of a custom element depend on one or more of the element's properties. Take as example a &lt;checkpoint&gt; element of a race gamemode that contains a &lt;marker&gt; for representation: the checkpoint has several attributes like color and size that should be reflected in the marker. To accomplish this, specify something of the form ''!propertyname!'' in one or more of the representing element's attributes. For example:<br />
<br />
<syntaxhighlight lang="xml"><br />
<def name="Race"><br />
<element name="checkpoint" friendlyname="Race checkpoint"><br />
<data name="position" type="coord3d" required="true" default="0,0,0" /><br />
<br />
<data name="type" type="selection:checkpoint,ring" required="true" default="checkpoint" /><br />
<data name="size" type="number" required="true" default="2.25"/><br />
<data name="color" type="color" required="false" default="#ff0000ff" /><br />
...<br />
<br />
<marker type="!type!" size="!size!" color="!color!" /><br />
</element><br />
</def><br />
</syntaxhighlight><br />
<br />
Now whenever the "type", "size" or "color" property of a checkpoint is changed, the new value will be copied to its marker, and the marker's visual appearance changes accordingly.<br />
<br />
===Integrating in a resource===<br />
<br />
Once you've written your EDF, save it as an .edf file in your resource's folder and add an "edf:definition" attribute to your meta.xml's &lt;info&gt; tag, like so:<br />
<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info author="succes" type="gamemode" Roleplay edf:definition="cto.edf" /><br />
...<br />
</meta><br />
</syntaxhighlight><br />
<br />
==EDF reference==<br />
<br />
===Built-in elements===<br />
These are the elements you can use for representing your custom elements, along with their properties.<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;blip&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|icon<br />
| style="background-color: #EEE"|blipID<br />
|-<br />
| style="background-color: #EEE"|size<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|color<br />
| style="background-color: #EEE"|color<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;marker&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|type<br />
| style="background-color: #EEE"|markerType<br />
|-<br />
| style="background-color: #EEE"|size<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|color<br />
| style="background-color: #EEE"|color<br />
|-<br />
| style="background-color: #EEE"|interior<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;object&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|model<br />
| style="background-color: #EEE"|objectID<br />
|-<br />
| style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|rotation<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|interior<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;ped&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|model<br />
| style="background-color: #EEE"|skinID<br />
|-<br />
| style="background-color: #EEE"|rotZ<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|interior<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;pickup&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|type<br />
| style="background-color: #EEE"|pickupType<br />
|-<br />
| style="background-color: #EEE"|amount<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|respawn<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|interior<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;vehicle&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|model<br />
| style="background-color: #EEE"|vehicleID<br />
|-<br />
| style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|rotation<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|color<br />
| style="background-color: #EEE"|vehiclecolors<br />
|-<br />
| style="background-color: #EEE"|upgrades<br />
| style="background-color: #EEE"|vehicleupgrades<br />
|-<br />
| style="background-color: #EEE"|plate<br />
| style="background-color: #EEE"|plate<br />
|-<br />
| style="background-color: #EEE"|interior<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;radararea&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|posX<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|posY<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|sizeX<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|sizeY<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|color<br />
| style="background-color: #EEE"|color<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
===Built-in property names===<br />
Properties with these names have a special meaning to the editor and can be modified by other means than the Properties window.<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Type<br />
|-<br />
! style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
! style="background-color: #EEE"|rotation<br />
| style="background-color: #EEE"|coord3d<br />
|}<br />
<br />
===Property types===<br />
These are the types you can choose from for the properties (&lt;data&gt;) of your custom elements.<br />
<br />
====Primitives====<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Description<br />
! style="background-color: #EEE"|Value<br />
|-<br />
! style="background-color: #EEE"|boolean<br />
| style="background-color: #EEE"|Simple boolean value.<br />
| style="background-color: #EEE"|"true" or "false"<br />
|-<br />
! style="background-color: #EEE"|natural<br />
| style="background-color: #EEE"|Natural number (whole and non-negative).<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|integer<br />
| style="background-color: #EEE"|Whole number.<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|number<br />
| style="background-color: #EEE"|Rational number.<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|string<br />
| style="background-color: #EEE"|Simple string of text.<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|color<br />
| style="background-color: #EEE"|color, with or without alpha.<br />
| style="background-color: #EEE"|#RRGGBB or #RRGGBBAA<br />
|}<br />
<br />
====Coordinates====<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Description<br />
! style="background-color: #EEE"|Value<br />
|-<br />
! style="background-color: #EEE"|camera<br />
| style="background-color: #EEE"|Position and lookat coordinates for the camera.<br />
| style="background-color: #EEE"|posX,posY,posZ,lookatX,lookatY,lookatZ<br />
|-<br />
! style="background-color: #EEE"|coord3d<br />
| style="background-color: #EEE"|3-component vector, typically used for positions and rotations.<br />
| style="background-color: #EEE"|x,y,z<br />
|}<br />
<br />
====Vehicles====<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Description<br />
! style="background-color: #EEE"|Value<br />
|-<br />
! style="background-color: #EEE"|plate<br />
| style="background-color: #EEE"|Number plate text for a vehicle.<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|vehiclecolors<br />
| style="background-color: #EEE"|colors of a vehicle<br />
| style="background-color: #EEE"|colorID1,colorID2,colorID3,colorID4<br />
|-<br />
! style="background-color: #EEE"|vehicleupgrades<br />
| style="background-color: #EEE"|Upgrades of a vehicle<br />
| style="background-color: #EEE"|upgradeID1,upgradeID2,...<br />
|}<br />
<br />
====Model ID's====<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Description<br />
! style="background-color: #EEE"|Value<br />
|-<br />
! style="background-color: #EEE"|blipID<br />
| style="background-color: #EEE"|Picture ID for blips<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|objectID<br />
| style="background-color: #EEE"|Model ID for objects<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|pickupType<br />
| style="background-color: #EEE"|Armor, health or weapon<br />
| style="background-color: #EEE"|"armor", "health" or numeric weapon ID<br />
|-<br />
! style="background-color: #EEE"|skinID<br />
| style="background-color: #EEE"|Skin ID for peds<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|vehicleID<br />
| style="background-color: #EEE"|Model ID for vehicles<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|weaponID<br />
| style="background-color: #EEE"|Weapon, e.g. M4<br />
| style="background-color: #EEE"|Numeric weapon ID, e.g. 31<br />
|}<br />
<br />
====Colshapes and markers====<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Description<br />
! style="background-color: #EEE"|Value<br />
|-<br />
! style="background-color: #EEE"|colshapeType<br />
| style="background-color: #EEE"|collision circle, cube, rectangle, sphere or tube<br />
| style="background-color: #EEE"|One of: "colcircle", "colcube", "colrectangle", "colsphere", "coltube"<br />
|-<br />
! style="background-color: #EEE"|markerType<br />
| style="background-color: #EEE"|Arrow, checkpoint, corona, cylinder or ring marker.<br />
| style="background-color: #EEE"|One of: "arrow", "checkpoint", "corona", "cylinder", "ring"<br />
|-<br />
|}<br />
<br />
====Specials====<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Description<br />
! style="background-color: #EEE"|Value<br />
|-<br />
! style="background-color: #EEE"|element:type<br />
| style="background-color: #EEE"|Element of a certain type, for example: element:flag<br />
| style="background-color: #EEE"|The element's ID<br />
|-<br />
! style="background-color: #EEE"|selection:val1,val2,...<br />
| style="background-color: #EEE"|Shows a dropdown box from which to pick one value.<br />
| style="background-color: #EEE"|The selected value<br />
|}<br />
[[ru:Resource:Editor/EDF]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43026Server mtaserver.conf2014-11-26T14:17:50Z<p>Glossy: /* autologin */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>50</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 50. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl>http://bananatreegaming.forumotion.co.uk/</httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>103.281.49.75</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac>#3</disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd>#12</enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion>1.4</minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion>1.4</recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>1</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting.<br />
<br />
====password====<br />
:''<password>kucing123</password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>2000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>250</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>3</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>1</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43025Server mtaserver.conf2014-11-26T14:16:53Z<p>Glossy: /* scriptdebugloglevel */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>50</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 50. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl>http://bananatreegaming.forumotion.co.uk/</httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>103.281.49.75</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac>#3</disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd>#12</enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion>1.4</minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion>1.4</recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>1</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting.<br />
<br />
====password====<br />
:''<password>kucing123</password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>2000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>250</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>3</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43024Server mtaserver.conf2014-11-26T14:13:44Z<p>Glossy: /* vehext_ping_limit */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>50</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 50. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl>http://bananatreegaming.forumotion.co.uk/</httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>103.281.49.75</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac>#3</disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd>#12</enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion>1.4</minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion>1.4</recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>1</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting.<br />
<br />
====password====<br />
:''<password>kucing123</password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>2000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>250</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>0</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43023Server mtaserver.conf2014-11-26T14:12:32Z<p>Glossy: /* unoccupied_vehicle_sync_interval */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>50</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 50. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl>http://bananatreegaming.forumotion.co.uk/</httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>103.281.49.75</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac>#3</disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd>#12</enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion>1.4</minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion>1.4</recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>1</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting.<br />
<br />
====password====<br />
:''<password>kucing123</password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>2000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>150</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>0</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43022Server mtaserver.conf2014-11-26T14:09:36Z<p>Glossy: /* password */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>50</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 50. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl>http://bananatreegaming.forumotion.co.uk/</httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>103.281.49.75</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac>#3</disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd>#12</enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion>1.4</minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion>1.4</recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>1</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting.<br />
<br />
====password====<br />
:''<password>kucing123</password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>150</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>0</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43021Server mtaserver.conf2014-11-26T14:08:23Z<p>Glossy: /* donotbroadcastlan */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>50</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 50. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl>http://bananatreegaming.forumotion.co.uk/</httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>103.281.49.75</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac>#3</disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd>#12</enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion>1.4</minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion>1.4</recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>1</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting.<br />
<br />
====password====<br />
:''<password></password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>150</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>0</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43020Server mtaserver.conf2014-11-26T14:07:49Z<p>Glossy: /* recommendedclientversion */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>50</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 50. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl>http://bananatreegaming.forumotion.co.uk/</httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>103.281.49.75</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac>#3</disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd>#12</enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion>1.4</minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion>1.4</recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>0</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting. <br />
<br />
====password====<br />
:''<password></password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>150</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>0</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43019Server mtaserver.conf2014-11-26T14:07:31Z<p>Glossy: /* minclientversion */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>50</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 50. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl>http://bananatreegaming.forumotion.co.uk/</httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>103.281.49.75</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac>#3</disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd>#12</enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion>1.4</minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion></recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>0</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting. <br />
<br />
====password====<br />
:''<password></password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>150</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>0</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43018Server mtaserver.conf2014-11-26T14:06:41Z<p>Glossy: /* enablesd */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>50</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 50. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl>http://bananatreegaming.forumotion.co.uk/</httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>103.281.49.75</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac>#3</disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd>#12</enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion></minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion></recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>0</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting. <br />
<br />
====password====<br />
:''<password></password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>150</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>0</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43017Server mtaserver.conf2014-11-26T14:06:26Z<p>Glossy: /* disableac */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>50</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 50. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl>http://bananatreegaming.forumotion.co.uk/</httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>103.281.49.75</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac>#3</disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd></enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion></minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion></recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>0</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting. <br />
<br />
====password====<br />
:''<password></password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>150</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>0</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43016Server mtaserver.conf2014-11-26T14:05:29Z<p>Glossy: /* httpdosthreshold */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>50</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 50. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl>http://bananatreegaming.forumotion.co.uk/</httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>103.281.49.75</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac></disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd></enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion></minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion></recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>0</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting. <br />
<br />
====password====<br />
:''<password></password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>150</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>0</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43015Server mtaserver.conf2014-11-26T14:04:32Z<p>Glossy: /* httpdownloadurl */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>50</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 50. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl>http://bananatreegaming.forumotion.co.uk/</httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>20</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac></disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd></enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion></minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion></recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>0</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting. <br />
<br />
====password====<br />
:''<password></password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>150</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>0</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43014Server mtaserver.conf2014-11-26T14:00:00Z<p>Glossy: /* maxplayers */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>50</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 50. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl></httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>20</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac></disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd></enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion></minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion></recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>0</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting. <br />
<br />
====password====<br />
:''<password></password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>150</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>0</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43013Server mtaserver.conf2014-11-26T13:59:22Z<p>Glossy: /* serverip */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip>103.281.49.75</serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>32</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 32. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl></httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>20</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac></disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd></enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion></minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion></recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>0</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting. <br />
<br />
====password====<br />
:''<password></password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>150</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>0</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossyhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=43012Server mtaserver.conf2014-11-26T13:58:45Z<p>Glossy: /* servername */</p>
<hr />
<div>This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''<br />
<br />
<br />
====servername====<br />
:''<servername>Java Gaming Roleplay MTA Server</servername>''<br />
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.<br />
<br />
====serverip====<br />
:''<serverip></serverip><br />
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''<br />
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.<br />
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING<br />
:People who set this and then ask for support will be the first ones against the wall when the revolution comes<br />
<br />
====serverport====<br />
:''<serverport>22003</serverport> <br />
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;<br />
:default value: 22003. It is a required parameter.<br />
<br />
====maxplayers====<br />
:''<maxplayers>32</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 32. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>1</httpserver><br />
:This parameter specifies whether the builtin http server will be used.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpport====<br />
:''<httpport>22005</httpport><br />
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.<br />
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]<br />
<br />
====httpdownloadurl====<br />
:''<httpdownloadurl></httpdownloadurl><br />
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.<br />
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]<br />
<br />
====httpmaxconnectionsperclient====<br />
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient><br />
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.<br />
:Available range: 1 to 8.<br />
<br />
====httpdosthreshold====<br />
:''<httpdosthreshold>20</httpdosthreshold><br />
:This parameter limits the number http connections that an IP can initiate over a short period of time.<br />
:Available range: 1 to 100. default value: 20<br />
<br />
{{New feature/item|3.0136|1.3.5|6301|<br />
====http_dos_exclude====<br />
:''<http_dos_exclude></http_dos_exclude><br />
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.<br />
:e.g. 88.11.22.33,101.2.3.4<br />
}}<br />
<br />
====client_file====<br />
:''<nowiki><!-- <client_file name="data/carmods.dat" verify="0" /> --></nowiki><br />
:By default, the server will block the use of customized GTA:SA data files.<br />
:To allow specific client files, add one or more of the above lines.<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====disableac====<br />
:''<disableac></disableac><br />
:Comma seperated list of disabled anti-cheats.<br />
:e.g. To disable anti-cheat #2 and #3, use: 2,3<br />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<br />
<br />
====enablesd====<br />
:''<enablesd></enablesd><br />
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.<br />
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12<br />
<br />
====networkencryption====<br />
:''<networkencryption>1</networkencryption><br />
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====minclientversion====<br />
:''<minclientversion></minclientversion><br />
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
{{New feature/item|3.0136|1.3.4|6023|<br />
====minclientversion_auto_update====<br />
:''<minclientversion_auto_update></minclientversion_auto_update><br />
:This parameter specifies if/when the <minclientversion> setting is automatically updated.<br />
:Keeping <minclientversion> updated can help reduce cheating.<br />
:Note: The instant setting (2) is only recommened for competitive servers.<br />
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.<br />
}}<br />
<br />
====recommendedclientversion====<br />
:''<recommendedclientversion></recommendedclientversion><br />
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.<br />
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]<br />
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''<br />
<br />
====ase====<br />
:''<ase>1</ase><br />
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).<br />
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.<br />
<br />
====donotbroadcastlan====<br />
:''<donotbroadcastlan>0</donotbroadcastlan><br />
:This parameter allows you to disable LAN broadcasting. <br />
<br />
====password====<br />
:''<password></password> <br />
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.<br />
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]<br />
<br />
====bandwidth_reduction====<br />
:''<bandwidth_reduction>medium</bandwidth_reduction> <br />
:This parameter reduces the server's bandwidth usage by using various optimizations.<br />
:Values: none, medium or maximum ; default value: medium<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====player_sync_interval====<br />
:''<player_sync_interval>100</player_sync_interval> <br />
:This parameter determines the time in milliseconds between player sync packets.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====lightweight_sync_interval====<br />
:''<lightweight_sync_interval>1500</lightweight_sync_interval> <br />
:This parameter determines the time in milliseconds between lightweight (player) sync packets.<br />
:Available range: 200 - 40000; default value: 1500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====camera_sync_interval====<br />
:''<camera_sync_interval>500</camera_sync_interval> <br />
:This parameter determines the time in milliseconds between camera sync packets.<br />
:Available range: 200 - 400; default value: 500<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====ped_sync_interval====<br />
:''<ped_sync_interval>400</ped_sync_interval> <br />
:This parameter determines the time in milliseconds between ped sync packets.<br />
:Available range: 200 - 4000; default value: 400<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====unoccupied_vehicle_sync_interval====<br />
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval> <br />
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.<br />
:Available range: 200 - 4000; default value: 1000<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_mouse_sync_interval====<br />
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====keysync_analog_sync_interval====<br />
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval> <br />
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.<br />
:Available range: 50 - 500; default value: 100<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]<br />
<br />
====bullet_sync====<br />
:''<bullet_sync>0</bullet_sync> <br />
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.<br />
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''<br />
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====vehext_percent====<br />
:''<vehext_percent>0</vehext_percent><br />
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles. <br />
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.<br />
:Depending on the gamemode, an incorrect prediction may have a negative effect. <br />
:Therefore this setting should be considered expermental.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 0 to 100. Default - 0 --><br />
<br />
====vehext_ping_limit====<br />
:''<vehext_ping_limit>150</vehext_ping_limit><br />
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.<br />
:Only relevant if <vehext_percent> is greater than zero.<br />
:'''It only works on server build 4456 or later.'''<br />
:Available range: 50 to 500. Default - 150<br />
<br />
====latency_reduction====<br />
:''<latency_reduction>0</latency_reduction><br />
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).<br />
:Due to the impact this may have on shot lag compensation, it should be considered experimental.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 0.<br />
<br />
====threadnet====<br />
:''<threadnet>1</threadnet> <br />
:This parameter specifies whether or not to run the network synchronization on another thread.<br />
:Enabling will make the sync smoother, but may increase cpu usage slightly.<br />
:Values: 0 - disabled , 1 - enabled ; default value: 1.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====idfile====<br />
:''<idfile>server-id.keys</idfile> <br />
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers. <br />
:Keep a backup of this file in a safe place. Default value: server-id.keys<br />
:More information about client private files: [[Filepath]]<br />
<br />
====logfile====<br />
:''<logfile>logs/server.log</logfile><br />
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.<br />
<br />
====authfile====<br />
:''<authfile>logs/server_auth.log</authfile><br />
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used<br />
<br />
====dbfile====<br />
:''<dbfile>logs/db.log</dbfile><br />
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.<br />
<br />
{{New feature/item|3.0136|1.3.4|5809|<br />
====loadstringfile====<br />
:''<!-- <loadstringfile>logs/loadstring.log</loadstringfile> --><br />
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.<br />
}}<br />
<br />
====acl====<br />
:''<acl>acl.xml</acl> <br />
:This parameter specifies the location and name of the Access Control List settings file. If left<br />
:blank, server will use acl.xml file, located in the same folder as this configuration file.<br />
<br />
====scriptdebuglogfile====<br />
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile> <br />
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.<br />
<br />
====scriptdebugloglevel====<br />
:''<scriptdebugloglevel>0</scriptdebugloglevel><br />
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.<br />
<br />
====fpslimit====<br />
:''<fpslimit>36</fpslimit><br />
:Specifies the frame rate limit that will be applied to connecting clients.<br />
:Available range: 25 to 100. Default: 36.<br />
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]<br />
<br />
====autologin====<br />
:''<autologin>0</autologin><br />
:Specifies whether or not players should automatically be logged in based on their IP adresses<br />
<br />
====voice====<br />
:''<voice>0</voice><br />
:This parameter specifies whether or not to enable player voice chat in-game<br />
:Values: 0 - disabled , 1 - enabled<br />
<br />
====voice_samplerate====<br />
:''<voice_samplerate>1</voice_samplerate><br />
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat<br />
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1<br />
<br />
====voice_quality====<br />
:''<voice_quality>4</voice_quality><br />
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat<br />
:Available range: 0 to 10. Default - 4<br />
<br />
====voice_bitrate====<br />
:''<nowiki><!-- <voice_bitrate>24600</voice_bitrate> --></nowiki><br />
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.<br />
<br />
====backup_path====<br />
:''<backup_path>backups</backup_path><br />
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups<br />
<br />
====backup_interval====<br />
:''<backup_interval>3</backup_interval><br />
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups<br />
:Available range: 0 to 30. Default - 3<br />
<br />
====backup_copies====<br />
:''<backup_copies>5</backup_copies><br />
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups<br />
:Available range: 0 to 100. Default - 5<br />
<br />
{{New feature/item|3.0136|1.3.4|5950|<br />
====compact_internal_databases====<br />
:''<compact_internal_databases>1</compact_internal_databases><br />
:This parameter specifies when the internal sqlite databases should be defragmented. Details: http://www.sqlite.org/lang_vacuum.html<br />
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1<br />
}}<br />
<br />
====module====<br />
:''<nowiki><!-- <module src="sample_win32.dll"/> --></nowiki><br />
:''<nowiki><!-- <module src="sample_linux.so"/> --></nowiki><br />
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.<br />
<br />
====resource====<br />
:''<resource src="admin" startup="1" protected="0"/><br />
:''<resource src="defaultstats" startup="1" protected="0"/><br />
:''<resource src="helpmanager" startup="1" protected="0"/><br />
:''<resource src="joinquit" startup="1" protected="0"/><br />
:''<resource src="mapcycler" startup="1" protected="0"/><br />
:''<resource src="mapmanager" startup="1" protected="0"/><br />
:''<resource src="parachute" startup="1" protected="0"/><br />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/><br />
:''<resource src="resourcemanager" startup="1" protected="1"/><br />
:''<resource src="scoreboard" startup="1" protected="0"/><br />
:''<resource src="spawnmanager" startup="1" protected="0"/><br />
:''<resource src="voice" startup="1" protected="0" /><br />
:''<resource src="votemanager" startup="1" protected="0"/><br />
:''<resource src="webadmin" startup="1" protected="0"/><br />
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Glossy