https://wiki.multitheftauto.com/api.php?action=feedcontributions&user=Gerry&feedformat=atomMulti Theft Auto: Wiki - User contributions [en]2024-03-29T10:40:06ZUser contributionsMediaWiki 1.39.3https://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=49747Server mtaserver.conf2016-11-02T06:25:52Z<p>Gerry: /* 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>[INDONESIA]Green life gaming roleplay</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>128.199.82.12</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>100</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 100. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>Emv Net</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 />
====allow_gta3_img_mods====<br />
:''<allow_gta3_img_mods>none</allow_gta3_img_mods><br />
:By default, the server will block the use of locally customized gta3.img player skins. <br />
:This setting can be used to allow such mods. Not recommended for competitive servers.<br />
:Values: none or peds ; default value: none<br />
:'''From server version 1.4.1-9.07268<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>Gerry</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 />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<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>100</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 />
:Bugs caused by enabling latency_reduction: http://bugs.mtasa.com/view.php?id=8191 + http://bugs.mtasa.com/view.php?id=8226<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 />
====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 persistent resources which are loaded when the server starts. Persistent resources are not stopped even if all the other resources that depend on them stop; that is, the only way to stop them is by explicitly using the ''stop'' server command or [[stopResource]] scripting function. To load several resources, add more <resource> parameters.<br />
<br />
:In addition, there are several flags which control how the server deals with each resource:<br />
<br />
:* '''src''': the resource name. This is the only mandatory flag.<br />
:* '''startup''': controls whether the resource will be started with the server or not. If "1", "true" or "yes", the resource will be started. If not specified, defaults to not starting the resource.<br />
:* '''protected''': if "1", "true" or "yes", the resource will not be able to be stopped when started. Otherwise, even if not specified, it will default to the normal behaviour.<br />
:* '''default''': if given a "1", "true" or "yes" value, this resource will be the one who populates the built-in HTTP server main page, which is seen when no resource is given in the web address. It is not possible to have more than one default resource.<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Gerryhttps://wiki.multitheftauto.com/index.php?title=Scripting_Introduction&diff=49746Scripting Introduction2016-11-02T05:53:48Z<p>Gerry: /* Identifying your resource */</p>
<hr />
<div>Resources are a key part of MTA. A resource is essentially a folder or zip file that contains a collection of files, plus a meta file that describes to the server how the resource should be loaded and what files it does contain. A resource can be seen as being partly equivalent to a program running in an operating system - it can be started and stopped, and multiple resources can run at once.<br />
<br />
Everything that has to do with scripting happens in resources, what a resource does defines if it is a gamemode, a map or anything else. MTA comes with resources that you can optionally use in your gamemodes, such as maplimits to keep playings within a playing area or deathpickups to create weapon pickups.<br />
{{tip|Your first step to begin Lua scripting should be using an Lua editor. This makes scripting much easier. We recommend [http://www.sublimetext.com/ Sublime Text], [http://notepad-plus.sourceforge.net/uk/site.htm Notepad++] or [http://luaedit.sourceforge.net/ LuaEdit]. There is also an unofficial [[MTASE|MTA Script Editor]] (in work-in-progress state) that you can test out.}}<br />
<br />
==Creating a working script==<br />
We will first learn how to make a basic script that lets the player walk around in the city, step by step.<br />
===Where are all the scripts?===<br />
Let's take a look at the script's file structure. Go to your MTA Server folder, and follow the path below:<br />
<br />
server/mods/deathmatch/resources/<br />
<br />
You will see a lot of .zip files, which are the packaged sample scripts shipped with MTA. Each file is a "resource", and they will all be unzipped and loaded by the server when it starts. To create your own resource, simply make a folder with your preferred name. We'll use "myserver" for this tutorial.<br />
<br />
Now you should be under this directory: <br />
<br />
server/mods/deathmatch/resources/myserver/<br />
<br />
===Identifying your resource===<br />
In order to let the server know what's in the resource, a ''meta.xml'' file must be created to list the resource's content. It must be located in the resource's root directory, which is the "myserver" folder in our case. So create a text file and name it "meta.xml", and open it with notepad.<br />
<br />
Enter the following codes in the ''meta.xml'' file:<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info author="gerry" type="MTA sa" name="[INDONESIA]Independent Of Strong" description="My first MTA server" /><br />
<script src="script.lua" /><br />
</meta><br />
</syntaxhighlight><br />
In the ''<info />'' tag, there's a "type" field which indicates that the resource is a ''gamemode'' instead of a regular include or a ''map'', which will be explained later. A gamemode is what you need to make a stand-alone server. <br />
<br />
The ''<script />'' tag indicates the script files contained in the resource, which we will create next.<br />
<br />
===Creating a simple script===<br />
Note that in the ''<script />'' tag above, the .lua file is not under another directory. Therefore we'll create the file in the same folder as meta.xml. Now you can copy and paste the following code into script.lua:<br />
<syntaxhighlight lang="lua"><br />
local spawnX, spawnY, spawnZ = 1959.55, -1714.46, 10<br />
function joinHandler()<br />
spawnPlayer(source, spawnX, spawnY, spawnZ)<br />
fadeCamera(source, true)<br />
setCameraTarget(source, source)<br />
outputChatBox("Welcome to My Server", source)<br />
end<br />
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)<br />
</syntaxhighlight><br />
The script will spawn you at the coordinate (x, y, z) specified above, when you join the game. Note that the ''fadeCamera'' function must be used or the screen will be black. Also, in releases after DP2, you need to set the camera target (otherwise all the player will see is blue sky).<br />
<br />
The '''source''' variable indicates who triggered the event. Since a player has joined when the code is triggered, you use this variable to look which has joined. So it'll spawn that player instead of everyone or a random person.<br />
<br />
If we have a closer look on [[addEventHandler]], you can see 3 things: 'onPlayerJoin', which indicates when it's triggered. getRootElement(), which shows by what/who it can be triggered. (getRootElement() is everything/everyone) And joinHandler, which indicates the function that has to be triggered after the event is triggered. Other details will be explained later in another example, now let's just run the server and try it out!<br />
<br />
===Running the script===<br />
To get the server started, simply run the executable under the server/ directory. A list of server stats will be shown first; note the port number, which you'll need when joining the game. Then the server loads all the resources under the mods/deathmatch/resources/ directory, and then "ready to accept connections!"<br />
<br />
Before you connect to the server, you must run the gamemode. Type "start myserver" and press Enter. The server will start the gamemode you just created, and will also show any errors and warnings from this point on. Now you can start the MTA client, and "Quick Connect" using the IP address of your server and the port number you saw earlier. If all goes well, after a few seconds your character will be walking on the streets of Los Santos.<br />
<br />
Next we'll add a command to your script that players can use to spawn a vehicle beside their position. You may skip it and check out more advanced scripting with the [[Map manager|Map Manager]], which continues this tutorial. Another branch from this tutorial is [[Introduction to Scripting GUI]], you may follow it to see how Graphical User Interface in MTA is drawn and scripted.<br />
<br />
==Creating a simple command==<br />
Let's go back to the content of the ''script.lua'' file. As mentioned above, we want to provide a command to create a vehicle beside your current position in the game. Firstly we need to create a function we want to call and a command handler that creates the command the player will be able to enter in the console.<br />
<br />
<syntaxhighlight lang="lua"><br />
-- create the function the command handler calls, with the arguments: thePlayer, command, vehicleModel<br />
function createVehicleForPlayer(thePlayer, command, vehicleModel)<br />
-- create a vehicle and stuff<br />
end<br />
<br />
-- create a command handler<br />
addCommandHandler("createvehicle", createVehicleForPlayer)<br />
</syntaxhighlight><br />
''Note: Function names are clickable in code examples on the wiki and linked to the functions' documentation.''<br />
<br />
====About command handlers====<br />
The first argument of [[addCommandHandler]] is the name of the command the player will be able to enter, the second argument is the function this will call, in this case ''createVehicleForPlayer''.<br />
<br />
If you have already experience in scripting, you will know that you call a function like this:<br />
<syntaxhighlight lang="lua"><br />
functionName(argument1, argument2, argument3, ..)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="lua"><br />
functionName(thePlayer, commandName, argument3, ..)<br />
</syntaxhighlight><br />
If we have a closer look on the lower example above, we can see argument1 is thePlayer and argument2 the commandName. thePlayer is simply the one who typed the command, so whatever you call it, the variable will contain the player who activated the command. commandName is simply the command they typed. So if they typed "/greet", this argument will contain "greet". Argument 3 is something extra the player typed, you'll learn it a little bit further in the tutorial. Never forget that the first 2 arguments are standard arguments, but you can name them to anything you want.<br />
<br />
We called the [[addCommandHandler]] function this way already and since ''createVehicleForPlayer'' is a function too, it can be called that way as well. But we are using a command handler for that, which calls it in a similiar manner, internally.<br />
<br />
For example: Someone types "createvehicle 468" ingame in the console to spawn a Sanchez, the command handler calls the createVehicleForPlayer function, as '''if''' we would have this line of code in the script:<br />
<syntaxhighlight lang="lua"><br />
createVehicleForPlayer(thePlayer,"createvehicle","468") -- thePlayer is the player element of the player who entered the command<br />
</syntaxhighlight><br />
As we can see, it provides several parameters: the player who called the command, the command he entered and whatever text he had after that, in this case "468" as vehicle id for the Sanchez. The first two parameters are the same with all command handlers, which you can read on the [[addEventHandler]] page. For this fact, you always have to define at least those two parameters to use any after that (for example to process text that was entered after the command, like in our example the vehicle model id).<br />
<br />
''Note: You have to add the command handler AFTER you defined the handler function, else it can't find it. The order of execution matters.''<br />
<br />
====Writing the function====<br />
In order to fill the function we created, we need to think about what we have to do:<br />
* Get the players position, so we know where to spawn the vehicle (we want it to appear right beside the player)<br />
* Calculate the position we want to spawn the vehicle at (we don't want it to appear in the player)<br />
* Spawn the vehicle<br />
* Check if it has been spawned successfully, or output a message<br />
<br />
In order to achieve our goals, we have to use several functions. To find function we need to use, we should visit the [[Scripting Functions|Server Functions List]]. First we need a function to get the players position. Since players are Elements, we first jump to the '''Element functions''' where we find the [[getElementPosition]] function. By clicking on the function name in the list, you get to the function description. There we can see the syntax, what it returns and usually an example. The syntax shows us what arguments we can or have to submit.<br />
<br />
For [[getElementPosition]], the syntax is:<br />
<syntaxhighlight lang="lua"><br />
float, float, float getElementPosition ( element theElement )<br />
</syntaxhighlight><br />
<br />
The three ''float'' in front of the function name are the return type. In this case it means the function returns three floating point numbers. (x, y and z) Within the parentheses, you can see what arguments you have to submit. In this case only the element whose position you want to get, which is the player in our example.<br />
<br />
<syntaxhighlight lang="lua"><br />
function createVehicleForPlayer(thePlayer, command, vehicleModel)<br />
-- get the position and put it in the x,y,z variables<br />
-- (local means, the variables only exist in the current scope, in this case, the function)<br />
local x,y,z = getElementPosition(thePlayer)<br />
end<br />
</syntaxhighlight><br />
<br />
Next we want to ensure that the vehicle won't spawn directly in the player, so we add a few units to the ''x'' variable, which will make it spawn east from the player.<br />
<br />
<syntaxhighlight lang="lua"><br />
function createVehicleForPlayer(thePlayer, command, vehicleModel)<br />
local x,y,z = getElementPosition(thePlayer) -- get the position of the player<br />
x = x + 5 -- add 5 units to the x position<br />
end<br />
</syntaxhighlight><br />
<br />
Now we need another function, one to spawn a vehicle. We once again search for it on the [[Scripting Functions|Server Functions List]], this time - since we are talking about vehicles - in the '''Vehicle functions''' section, where we will choose [[createVehicle]]. In this function's syntax, we only have one return type (which is more common), a vehicle element that points to the vehicle we just created. Also, we see that some arguments are enclosed within [ ] which means that those are optional.<br />
<br />
We already have all arguments we need for [[createVehicle]] in our function: The position we just calculated in the ''x,y,z'' variables and the model id that we provided through the command ("createvehicle 468") and can access in the function as ''vehicleModel'' variable.<br />
<br />
<syntaxhighlight lang="lua"><br />
function createVehicleForPlayer(thePlayer, command, vehicleModel)<br />
local x,y,z = getElementPosition(thePlayer) -- get the position of the player<br />
x = x + 5 -- add 5 units to the x position<br />
-- create the vehicle and store the returned vehicle element in the ''createdVehicle'' variable<br />
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)<br />
end<br />
</syntaxhighlight><br />
<br />
Of course this code can be improved in many ways, but at least we want to add a check whether the vehicle was created successfully or not. As we can read on the [[createVehicle]] page under '''Returns''', the function returns ''false'' when it was unable to create the vehicle. Thus, we check the value of the ''createVehicle'' variable.<br />
<br />
Now we have our complete script:<br />
<syntaxhighlight lang="lua"><br />
function createVehicleForPlayer(thePlayer, command, vehicleModel)<br />
local x,y,z = getElementPosition(thePlayer) -- get the position of the player<br />
x = x + 5 -- add 5 units to the x position<br />
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)<br />
-- check if the return value was ''false''<br />
if (createdVehicle == false) then<br />
-- if so, output a message to the chatbox, but only to this player.<br />
outputChatBox("Failed to create vehicle.",thePlayer)<br />
end<br />
end<br />
addCommandHandler("createvehicle", createVehicleForPlayer)<br />
</syntaxhighlight><br />
<br />
As you can see, we introduced another function with [[outputChatBox]]. By now, you should be able to explore the function's documentation page yourself. For more advanced scripting, please check out the [[Map manager|Map Manager]].<br />
<br />
==What you need to know==<br />
You already read some things about resources, command handlers and finding functions in the documentation in the first paragraph, but there is much more to learn. This section will give you a rather short overview over some of these things, while linking to related pages if possible.<br />
===Clientside and Serverside scripts===<br />
You may have already noticed these or similiar terms (Server/Client) somewhere on this wiki, mostly in conjunction with functions. MTA not only supports scripts that run on the server and provide commands (like the one we wrote above) or other features, but also scripts that run on the MTA client the players use to connect to the server. The reason for this is, that some features MTA provides have to be clientside (like a GUI - Graphical User Interface), others should be because they work better and still others are better off to be serverside or just don't work clientside.<br />
<br />
Most scripts you will make (gamemodes, maps) will probably be serverside, like the one we wrote in the first section. If you run into something that can't be solved serverside, you will probably have to make it clientside. For a clientside script for example, you would create a ordinary script file (for example called ''client.lua'') and specify it in the meta.xml, like this:<br />
<syntaxhighlight lang="xml"><br />
<script src="client.lua" type="client" /><br />
</syntaxhighlight><br />
The ''type'' attribute defaults to 'server', so you only need to specify it for clientside scripts. When you do this, the clientside script will be downloaded to the player's computer once he connects to the server. Read more about [[Client side scripts]].<br />
<br />
===More complex resources===<br />
The previous section showed briefly how to add clientside scripts to the resource, but there is also much more possible. As mentioned at the very top of this page, resources can be pretty much everything. Their purpose is defined by what they do. Let's have some theoretical resources, by looking at the files it contains, the ''meta.xml'' and what they might do:<br />
<br />
====First example - A utility script====<br />
<syntaxhighlight lang="xml"><br />
/admin_commands<br />
/meta.xml<br />
/commands.lua<br />
/client.lua<br />
</syntaxhighlight><br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info author="Someguy" description="admin commands" /><br />
<script src="commands.lua" /><br />
<script src="client.lua" type="client" /><br />
</meta><br />
</syntaxhighlight><br />
<br />
* The ''commands.lua'' provides some admin commands, like banning a player, muting or something else that can be used to admin the server<br />
* The ''client.lua'' provides a GUI to be able to perform the mentioned actions easily<br />
<br />
This example might be running all the time (maybe even auto-started when the server starts) as it's useful during the whole gaming experience and also wont interfere with the gameplay, unless an admin decides to take some action of course.<br />
<br />
====Second example - A gamemode====<br />
<syntaxhighlight lang="xml"><br />
/counterstrike<br />
/meta.xml<br />
/counterstrike.lua<br />
/buymenu.lua<br />
</syntaxhighlight><br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info author="Someguy" description="Counterstrike remake" type="gamemode" /><br />
<script src="counterstrike.lua" /><br />
<script src="buymenu.lua" type="client" /><br />
</meta><br />
</syntaxhighlight><br />
<br />
* The ''counterstrike.lua'' contains similiar to the following features:<br />
** Let players choose their team and spawn them<br />
** Provide them with weapons, targets and instructions (maybe read from a Map, see below)<br />
** Define the game's rules, e.g. when does the round end, what happens when a player dies<br />
** .. and maybe some more<br />
* The ''buymenu.lua'' is a clientside script and creates a menu to buy weapons<br />
<br />
This example can be called a gamemode, since it not only intereferes with the gameplay, but actually defines the rules of it. The ''type'' attribute indicates that this example works with the [[Map manager]], yet another resource that was written by the QA Team to manage gamemodes and map loading. It is highly recommended that you base your gamemodes on the techniques it provides.<br />
<br />
This also means that the gamemode probably won't run without a map. Gamemodes should always be as generic as possible. An example for a map is stated in the next example.<br />
<br />
====Third example - A Map====<br />
<syntaxhighlight lang="xml"><br />
/cs-airport<br />
/meta.xml<br />
/airport.map<br />
/airport.lua<br />
</syntaxhighlight><br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info author="Someguy" description="Counterstrike airport map" type="map" gamemodes="counterstrike" /><br />
<map src="airport.map" /><br />
<script src="airport.lua" /><br />
</meta><br />
</syntaxhighlight><br />
<br />
* The ''airport.map'' in a XML file that provides information about the map to the gamemode, these may include:<br />
** Where the players should spawn, with what weapons, what teams there are<br />
** What the targets are<br />
** Weather, World Time, Timelimit<br />
** Provide vehicles<br />
* The ''airport.lua'' might contain map-specific features, that may include:<br />
** Opening some door/make something explode when something specific happens<br />
** Create or move some custom objects, or manipulate objects that are created through the .map file<br />
** .. anything else map-specific you can think of<br />
<br />
As you can see, the ''type'' attribute changed to 'map', telling the [[Map manager]] that this resource is a map, while the ''gamemodes'' attribute tells it for which gamemodes this map is valid, in this case the gamemode from the above example.<br />
What may come as a surprise is that there is also a script in the Map resource. Of course this is not necessarily needed in a map, but opens a wide range of possibilities for map makers to create their own world within the rules of the gamemode they create it for.<br />
<br />
The ''airport.map'' file might look similiar to this:<br />
<syntaxhighlight lang="xml"><br />
<map mode="deathmatch" version="1.0"><br />
<terrorists><br />
<spawnpoint posX="2332.23" posY="-12232.33" posZ="4.42223" skins="23-40" /><br />
</terrorists><br />
<counterterrorists><br />
<spawnpoint posX="2334.23443" posY="-12300.233" posZ="10.2344" skins="40-50" /><br />
</counterterrorists><br />
<br />
<bomb posX="23342.23" posY="" posZ="" /><br />
<br />
<vehicle posX="" posY="" posZ="" model="602" /> <br />
<vehicle posX="" posY="" posZ="" model="603" /> <br />
</map><br />
</syntaxhighlight><br />
<br />
When a gamemode is started with a map, the map resources is automatically started by the mapmanager and the information it contains can be read by the gamemode resource. When the map changes, the current map resource is stopped and the next map resource is started. For a more in-depth explanation and examples of how map resources are utilized in the main script, please visit the [[Writing Gamemodes]] page.<br />
<br />
===Events===<br />
[[Event|Events]] are the way MTA tells scripts about things that happen. For example when a player dies, the [[onPlayerWasted]] event is triggered. In order to perform any actions when a player dies, you have to prepare yourself similiar to adding a command handler, as shown in [[#Writing_the_script|the first chapter]].<br />
<br />
This example will output a message with the name of the player who died:<br />
<syntaxhighlight lang="lua"><br />
function playerDied(totalAmmo, killer, killerWeapon, bodypart)<br />
outputChatBox(getPlayerName(source).." died!")<br />
end<br />
addEventHandler("onPlayerWasted",getRootElement(),playerDied)<br />
</syntaxhighlight><br />
<br />
Instead of showing what arguments are needed, the documentation page for Events shows what parameters are passed to the handler function, similiar to the way a [[#About_command_handlers|command handler]] does, just that it is different from event to event. Another important point is the ''source'' variable, that exists in handler functions. It doesn't have to be added to the parameter list of the function, but it still exists. It has a different value from event to event, for player events (as in the example above) it is the player element. As another example, you can take a look at the basic spawning player script in the first section to get an idea how ''source'' is used.<br />
<br />
==Where to go from here==<br />
You should now be familiar with the most basic aspects of MTA scripting and also a bit with the documentation. The [[Main Page]] provides you with links to more information, Tutorials and References that allow a deeper look into the topics you desire to learn about.<br />
{{note|From here we recommend reading the [[debugging]] tutorial. Good debugging skills are an absolute necessity when you are making scripts. We also recommend you to use the [[predefined variables list]] to help you with certain tasks and make scripting easier and faster.}}<br />
'''See also:'''<br />
* [[OOP_Introduction|OOP Scripting Introduction]]<br />
* [[Advanced Topics]]<br />
* [[Script_security|Script security]]<br />
* [[Scripting Introduction Urdu]]<br />
[[es:Introducción a la Programación]]<br />
[[it:Introduzione allo scripting]]<br />
[[nl:Scripting_introductie]]<br />
[[pt-br:Introdução ao Scripting]]<br />
[[ru:Scripting Introduction]]<br />
[[ar:مقدمه_في_البرمجه]]<br />
[[zh-cn:脚本编写介绍]]<br />
[[Category:Tutorials]]</div>Gerryhttps://wiki.multitheftauto.com/index.php?title=Server_Commands&diff=49745Server Commands2016-11-02T05:45:17Z<p>Gerry: /* login */</p>
<hr />
<div>This page lists all built in commands that the server can process. All these commands can be entered via the server console or the client console depending upon permissions unless otherwise stated.<br />
<br />
<br />
==Resource commands==<br />
====check====<br />
:<ins>Server console only</ins><br />
:Usage: check [ ''all'' | ''<resource-name>'' ]<br><br />
:Checks which files would be changed with [[Server_Commands#upgrade|upgrade]] command. Does not modify anything.<br />
====info====<br />
:<ins>Server console only</ins><br />
:Usage: info ''<resource-name>''<br><br />
:Get info for a resource eg: info admin<br />
====list====<br />
:<ins>Server console only</ins><br />
:Shows a list of resources<br />
<br />
====refresh====<br />
:Refresh resource list to find new resources<br />
====refreshall====<br />
:Refresh resources and restart any changed resources<br />
====restart====<br />
:Usage: info ''<resource-name>''<br><br />
:Restarts a running resource eg: restart admin<br />
====start====<br />
:Usage: start ''<resource-name>''<br><br />
:Start a loaded resource eg: start admin<br />
====stop====<br />
:Usage: stop ''<resource-name>''<br><br />
:Stop a resource eg: stop admin<br />
====stopall====<br />
:Stop all running resources<br />
====upgrade====<br />
:<ins>Server console only</ins><br />
:Usage: upgrade [ ''all'' | ''<resource-name>'' ]<br><br />
:Perform a basic upgrade of all resources. The [[Server_Commands#checkall|check]] command shows the list of changes this command will make.<br />
<br />
====aclrequest====<br />
:Usage: aclrequest [ ''list'' | ''allow'' | ''deny'' ] ''<resource-name>'' [ ''<right>'' | ''all'' ]<br><br />
:Manage ACL requests from resources implementing <aclrequest> in their [[meta.xml]]<br />
<br />
<br />
==Account commands==<br />
====aexec====<br />
:Usage: aexec ''<nick>''gerry123''<command>''<br><br />
:Force a player to execute a command eg: aexec playername say hello<br />
<br />
====addaccount====<br />
:Usage: addaccount ''<gerryalamsyah123>'' ''<rafli2004>''<br><br />
:Add an account eg: addaccount accountname password<br />
<br />
====chgpass====<br />
:Usage: chgpass ''<accountname>'' ''<password>''<br><br />
:Change an accounts password eg: chgpass account newpw<br />
====delaccount====<br />
:Usage: delaccount ''<accountname>''<br><br />
:Delete an account eg: delaccount accountname<br />
<br />
<br />
==Server commands==<br />
====ase====<br />
:<ins>Server console only</ins><br />
:See the amount of master server list queries<br />
====debugdb====<br />
:Usage: debugdb ''<''0-2''>''<br><br />
:<ins>Server console only</ins><br />
:Set logging level for database functions. [0-Off &nbsp;1-Errors only &nbsp;2-All]<br />
:By default, logging output is written to the file '''logs/db.log''' unless another file is declared in the [[Mtaserver.conf#dbfile|<dbfile> section of mtaserver.conf]]<br />
====help====<br />
:<ins>Server console only</ins><br />
:Displays these list of commands<br />
====loadmodule====<br />
:<ins>Server console only</ins><br />
:Usage: loadmodule ''<module-filename>''<br><br />
:Load a module eg: loadmodule ml_sockets.dll<br />
====unloadmodule====<br />
:<ins>Server console only</ins><br />
:Usage: unloadmodule ''<module-filename>''<br><br />
:Unload a module eg: unloadmodule ml_sockets.dll<br />
====reloadmodule====<br />
:<ins>Server console only</ins><br />
:Usage: reloadmodule ''<module-filename>''<br><br />
:Reload a module eg: reloadmodule ml_sockets.dll<br />
====openports====<br />
:<ins>Server console only</ins><br />
:Test if server ports are open<br />
====shutdown====<br />
:Usage: shutdown ''<reason>''<br><br />
:Shutdown the server eg: shutdown put reason here<br />
====sver====<br />
:Get the server MTA version<br />
<br />
<br />
==Other commands==<br />
====say====<br />
:Usage: say ''<text>''<br><br />
:Show a message to all players on the server eg: say hello<br />
====whois====<br />
:Usage: whois ''<nick>''<br><br />
:Get the IP of a player currently connected (use whowas for IP/serial/version)<br />
====whowas====<br />
:Usage: whowas ''<nick>''<br><br />
:Get IP/Serial/username of a player that was previously connected to the server<br />
====ver====<br />
:Get the MTA version<br />
<br />
<br />
==Client relevant only==<br />
====chgmypass====<br />
:<ins>Client only</ins><br />
:Usage: chgmypass ''<oldpass>'' ''<newpass>''<br><br />
:Change your password eg: chgmypass oldpw newpw<br />
====debugscript====<br />
:<ins>Client only</ins><br />
:Usage: debugscript ''<''0-3''>''<br><br />
:Remove (This does not work "Incorrect client type for this command")<br />
====login====<br />
:<ins>Client only</ins><br />
:Usage: login ''<gerryalamsyah123>'' ''<rafli2004>''<br><br />
:Login to an account eg: login accountname password<br />
<br />
====logout====<br />
:<ins>Client only</ins><br />
:Log out of the current account<br />
====me====<br />
:<ins>Client only</ins><br />
:Usage: me ''<text>''<br><br />
:Show a message to all players on the server, with your nick prepended<br />
====msg====<br />
:<ins>Client only</ins><br />
:Usage: msg ''<nick>'' ''<text>''<br><br />
:Send a message to a player eg: msg playername hello<br />
====nick====<br />
:<ins>Client only</ins><br />
:Usage: nick ''<old-nick>'' ''<new-nick>''<br><br />
:Change your ingame nickname<br />
====teamsay====<br />
:<ins>Client only</ins><br />
:Usage: teamsay ''<t>''<br><br />
:Send a message to all players on the same team<br />
<br />
[[Category: Support]]<br />
[[ru:Server Commands]]</div>Gerryhttps://wiki.multitheftauto.com/index.php?title=Server_Commands&diff=49744Server Commands2016-11-02T05:42:18Z<p>Gerry: /* teamsay */</p>
<hr />
<div>This page lists all built in commands that the server can process. All these commands can be entered via the server console or the client console depending upon permissions unless otherwise stated.<br />
<br />
<br />
==Resource commands==<br />
====check====<br />
:<ins>Server console only</ins><br />
:Usage: check [ ''all'' | ''<resource-name>'' ]<br><br />
:Checks which files would be changed with [[Server_Commands#upgrade|upgrade]] command. Does not modify anything.<br />
====info====<br />
:<ins>Server console only</ins><br />
:Usage: info ''<resource-name>''<br><br />
:Get info for a resource eg: info admin<br />
====list====<br />
:<ins>Server console only</ins><br />
:Shows a list of resources<br />
<br />
====refresh====<br />
:Refresh resource list to find new resources<br />
====refreshall====<br />
:Refresh resources and restart any changed resources<br />
====restart====<br />
:Usage: info ''<resource-name>''<br><br />
:Restarts a running resource eg: restart admin<br />
====start====<br />
:Usage: start ''<resource-name>''<br><br />
:Start a loaded resource eg: start admin<br />
====stop====<br />
:Usage: stop ''<resource-name>''<br><br />
:Stop a resource eg: stop admin<br />
====stopall====<br />
:Stop all running resources<br />
====upgrade====<br />
:<ins>Server console only</ins><br />
:Usage: upgrade [ ''all'' | ''<resource-name>'' ]<br><br />
:Perform a basic upgrade of all resources. The [[Server_Commands#checkall|check]] command shows the list of changes this command will make.<br />
<br />
====aclrequest====<br />
:Usage: aclrequest [ ''list'' | ''allow'' | ''deny'' ] ''<resource-name>'' [ ''<right>'' | ''all'' ]<br><br />
:Manage ACL requests from resources implementing <aclrequest> in their [[meta.xml]]<br />
<br />
<br />
==Account commands==<br />
====aexec====<br />
:Usage: aexec ''<nick>''gerry123''<command>''<br><br />
:Force a player to execute a command eg: aexec playername say hello<br />
<br />
====addaccount====<br />
:Usage: addaccount ''<gerryalamsyah123>'' ''<rafli2004>''<br><br />
:Add an account eg: addaccount accountname password<br />
<br />
====chgpass====<br />
:Usage: chgpass ''<accountname>'' ''<password>''<br><br />
:Change an accounts password eg: chgpass account newpw<br />
====delaccount====<br />
:Usage: delaccount ''<accountname>''<br><br />
:Delete an account eg: delaccount accountname<br />
<br />
<br />
==Server commands==<br />
====ase====<br />
:<ins>Server console only</ins><br />
:See the amount of master server list queries<br />
====debugdb====<br />
:Usage: debugdb ''<''0-2''>''<br><br />
:<ins>Server console only</ins><br />
:Set logging level for database functions. [0-Off &nbsp;1-Errors only &nbsp;2-All]<br />
:By default, logging output is written to the file '''logs/db.log''' unless another file is declared in the [[Mtaserver.conf#dbfile|<dbfile> section of mtaserver.conf]]<br />
====help====<br />
:<ins>Server console only</ins><br />
:Displays these list of commands<br />
====loadmodule====<br />
:<ins>Server console only</ins><br />
:Usage: loadmodule ''<module-filename>''<br><br />
:Load a module eg: loadmodule ml_sockets.dll<br />
====unloadmodule====<br />
:<ins>Server console only</ins><br />
:Usage: unloadmodule ''<module-filename>''<br><br />
:Unload a module eg: unloadmodule ml_sockets.dll<br />
====reloadmodule====<br />
:<ins>Server console only</ins><br />
:Usage: reloadmodule ''<module-filename>''<br><br />
:Reload a module eg: reloadmodule ml_sockets.dll<br />
====openports====<br />
:<ins>Server console only</ins><br />
:Test if server ports are open<br />
====shutdown====<br />
:Usage: shutdown ''<reason>''<br><br />
:Shutdown the server eg: shutdown put reason here<br />
====sver====<br />
:Get the server MTA version<br />
<br />
<br />
==Other commands==<br />
====say====<br />
:Usage: say ''<text>''<br><br />
:Show a message to all players on the server eg: say hello<br />
====whois====<br />
:Usage: whois ''<nick>''<br><br />
:Get the IP of a player currently connected (use whowas for IP/serial/version)<br />
====whowas====<br />
:Usage: whowas ''<nick>''<br><br />
:Get IP/Serial/username of a player that was previously connected to the server<br />
====ver====<br />
:Get the MTA version<br />
<br />
<br />
==Client relevant only==<br />
====chgmypass====<br />
:<ins>Client only</ins><br />
:Usage: chgmypass ''<oldpass>'' ''<newpass>''<br><br />
:Change your password eg: chgmypass oldpw newpw<br />
====debugscript====<br />
:<ins>Client only</ins><br />
:Usage: debugscript ''<''0-3''>''<br><br />
:Remove (This does not work "Incorrect client type for this command")<br />
====login====<br />
:<ins>Client only</ins><br />
:Usage: login ''<accountname>'' ''<password>''<br><br />
:Login to an account eg: login accountname password<br />
====logout====<br />
:<ins>Client only</ins><br />
:Log out of the current account<br />
====me====<br />
:<ins>Client only</ins><br />
:Usage: me ''<text>''<br><br />
:Show a message to all players on the server, with your nick prepended<br />
====msg====<br />
:<ins>Client only</ins><br />
:Usage: msg ''<nick>'' ''<text>''<br><br />
:Send a message to a player eg: msg playername hello<br />
====nick====<br />
:<ins>Client only</ins><br />
:Usage: nick ''<old-nick>'' ''<new-nick>''<br><br />
:Change your ingame nickname<br />
====teamsay====<br />
:<ins>Client only</ins><br />
:Usage: teamsay ''<t>''<br><br />
:Send a message to all players on the same team<br />
<br />
[[Category: Support]]<br />
[[ru:Server Commands]]</div>Gerryhttps://wiki.multitheftauto.com/index.php?title=Server_Commands&diff=49743Server Commands2016-11-02T05:40:42Z<p>Gerry: /* addaccount */</p>
<hr />
<div>This page lists all built in commands that the server can process. All these commands can be entered via the server console or the client console depending upon permissions unless otherwise stated.<br />
<br />
<br />
==Resource commands==<br />
====check====<br />
:<ins>Server console only</ins><br />
:Usage: check [ ''all'' | ''<resource-name>'' ]<br><br />
:Checks which files would be changed with [[Server_Commands#upgrade|upgrade]] command. Does not modify anything.<br />
====info====<br />
:<ins>Server console only</ins><br />
:Usage: info ''<resource-name>''<br><br />
:Get info for a resource eg: info admin<br />
====list====<br />
:<ins>Server console only</ins><br />
:Shows a list of resources<br />
<br />
====refresh====<br />
:Refresh resource list to find new resources<br />
====refreshall====<br />
:Refresh resources and restart any changed resources<br />
====restart====<br />
:Usage: info ''<resource-name>''<br><br />
:Restarts a running resource eg: restart admin<br />
====start====<br />
:Usage: start ''<resource-name>''<br><br />
:Start a loaded resource eg: start admin<br />
====stop====<br />
:Usage: stop ''<resource-name>''<br><br />
:Stop a resource eg: stop admin<br />
====stopall====<br />
:Stop all running resources<br />
====upgrade====<br />
:<ins>Server console only</ins><br />
:Usage: upgrade [ ''all'' | ''<resource-name>'' ]<br><br />
:Perform a basic upgrade of all resources. The [[Server_Commands#checkall|check]] command shows the list of changes this command will make.<br />
<br />
====aclrequest====<br />
:Usage: aclrequest [ ''list'' | ''allow'' | ''deny'' ] ''<resource-name>'' [ ''<right>'' | ''all'' ]<br><br />
:Manage ACL requests from resources implementing <aclrequest> in their [[meta.xml]]<br />
<br />
<br />
==Account commands==<br />
====aexec====<br />
:Usage: aexec ''<nick>''gerry123''<command>''<br><br />
:Force a player to execute a command eg: aexec playername say hello<br />
<br />
====addaccount====<br />
:Usage: addaccount ''<gerryalamsyah123>'' ''<rafli2004>''<br><br />
:Add an account eg: addaccount accountname password<br />
<br />
====chgpass====<br />
:Usage: chgpass ''<accountname>'' ''<password>''<br><br />
:Change an accounts password eg: chgpass account newpw<br />
====delaccount====<br />
:Usage: delaccount ''<accountname>''<br><br />
:Delete an account eg: delaccount accountname<br />
<br />
<br />
==Server commands==<br />
====ase====<br />
:<ins>Server console only</ins><br />
:See the amount of master server list queries<br />
====debugdb====<br />
:Usage: debugdb ''<''0-2''>''<br><br />
:<ins>Server console only</ins><br />
:Set logging level for database functions. [0-Off &nbsp;1-Errors only &nbsp;2-All]<br />
:By default, logging output is written to the file '''logs/db.log''' unless another file is declared in the [[Mtaserver.conf#dbfile|<dbfile> section of mtaserver.conf]]<br />
====help====<br />
:<ins>Server console only</ins><br />
:Displays these list of commands<br />
====loadmodule====<br />
:<ins>Server console only</ins><br />
:Usage: loadmodule ''<module-filename>''<br><br />
:Load a module eg: loadmodule ml_sockets.dll<br />
====unloadmodule====<br />
:<ins>Server console only</ins><br />
:Usage: unloadmodule ''<module-filename>''<br><br />
:Unload a module eg: unloadmodule ml_sockets.dll<br />
====reloadmodule====<br />
:<ins>Server console only</ins><br />
:Usage: reloadmodule ''<module-filename>''<br><br />
:Reload a module eg: reloadmodule ml_sockets.dll<br />
====openports====<br />
:<ins>Server console only</ins><br />
:Test if server ports are open<br />
====shutdown====<br />
:Usage: shutdown ''<reason>''<br><br />
:Shutdown the server eg: shutdown put reason here<br />
====sver====<br />
:Get the server MTA version<br />
<br />
<br />
==Other commands==<br />
====say====<br />
:Usage: say ''<text>''<br><br />
:Show a message to all players on the server eg: say hello<br />
====whois====<br />
:Usage: whois ''<nick>''<br><br />
:Get the IP of a player currently connected (use whowas for IP/serial/version)<br />
====whowas====<br />
:Usage: whowas ''<nick>''<br><br />
:Get IP/Serial/username of a player that was previously connected to the server<br />
====ver====<br />
:Get the MTA version<br />
<br />
<br />
==Client relevant only==<br />
====chgmypass====<br />
:<ins>Client only</ins><br />
:Usage: chgmypass ''<oldpass>'' ''<newpass>''<br><br />
:Change your password eg: chgmypass oldpw newpw<br />
====debugscript====<br />
:<ins>Client only</ins><br />
:Usage: debugscript ''<''0-3''>''<br><br />
:Remove (This does not work "Incorrect client type for this command")<br />
====login====<br />
:<ins>Client only</ins><br />
:Usage: login ''<accountname>'' ''<password>''<br><br />
:Login to an account eg: login accountname password<br />
====logout====<br />
:<ins>Client only</ins><br />
:Log out of the current account<br />
====me====<br />
:<ins>Client only</ins><br />
:Usage: me ''<text>''<br><br />
:Show a message to all players on the server, with your nick prepended<br />
====msg====<br />
:<ins>Client only</ins><br />
:Usage: msg ''<nick>'' ''<text>''<br><br />
:Send a message to a player eg: msg playername hello<br />
====nick====<br />
:<ins>Client only</ins><br />
:Usage: nick ''<old-nick>'' ''<new-nick>''<br><br />
:Change your ingame nickname<br />
====teamsay====<br />
:<ins>Client only</ins><br />
:Usage: teamsay ''<test>''<br><br />
:Send a message to all players on the same team<br />
<br />
[[Category: Support]]<br />
[[ru:Server Commands]]</div>Gerryhttps://wiki.multitheftauto.com/index.php?title=Server_Commands&diff=49742Server Commands2016-11-02T05:39:28Z<p>Gerry: /* aexec */</p>
<hr />
<div>This page lists all built in commands that the server can process. All these commands can be entered via the server console or the client console depending upon permissions unless otherwise stated.<br />
<br />
<br />
==Resource commands==<br />
====check====<br />
:<ins>Server console only</ins><br />
:Usage: check [ ''all'' | ''<resource-name>'' ]<br><br />
:Checks which files would be changed with [[Server_Commands#upgrade|upgrade]] command. Does not modify anything.<br />
====info====<br />
:<ins>Server console only</ins><br />
:Usage: info ''<resource-name>''<br><br />
:Get info for a resource eg: info admin<br />
====list====<br />
:<ins>Server console only</ins><br />
:Shows a list of resources<br />
<br />
====refresh====<br />
:Refresh resource list to find new resources<br />
====refreshall====<br />
:Refresh resources and restart any changed resources<br />
====restart====<br />
:Usage: info ''<resource-name>''<br><br />
:Restarts a running resource eg: restart admin<br />
====start====<br />
:Usage: start ''<resource-name>''<br><br />
:Start a loaded resource eg: start admin<br />
====stop====<br />
:Usage: stop ''<resource-name>''<br><br />
:Stop a resource eg: stop admin<br />
====stopall====<br />
:Stop all running resources<br />
====upgrade====<br />
:<ins>Server console only</ins><br />
:Usage: upgrade [ ''all'' | ''<resource-name>'' ]<br><br />
:Perform a basic upgrade of all resources. The [[Server_Commands#checkall|check]] command shows the list of changes this command will make.<br />
<br />
====aclrequest====<br />
:Usage: aclrequest [ ''list'' | ''allow'' | ''deny'' ] ''<resource-name>'' [ ''<right>'' | ''all'' ]<br><br />
:Manage ACL requests from resources implementing <aclrequest> in their [[meta.xml]]<br />
<br />
<br />
==Account commands==<br />
====aexec====<br />
:Usage: aexec ''<nick>''gerry123''<command>''<br><br />
:Force a player to execute a command eg: aexec playername say hello<br />
<br />
====addaccount====<br />
:Usage: addaccount ''<accountname>'' ''<password>''<br><br />
:Add an account eg: addaccount accountname password<br />
====chgpass====<br />
:Usage: chgpass ''<accountname>'' ''<password>''<br><br />
:Change an accounts password eg: chgpass account newpw<br />
====delaccount====<br />
:Usage: delaccount ''<accountname>''<br><br />
:Delete an account eg: delaccount accountname<br />
<br />
<br />
==Server commands==<br />
====ase====<br />
:<ins>Server console only</ins><br />
:See the amount of master server list queries<br />
====debugdb====<br />
:Usage: debugdb ''<''0-2''>''<br><br />
:<ins>Server console only</ins><br />
:Set logging level for database functions. [0-Off &nbsp;1-Errors only &nbsp;2-All]<br />
:By default, logging output is written to the file '''logs/db.log''' unless another file is declared in the [[Mtaserver.conf#dbfile|<dbfile> section of mtaserver.conf]]<br />
====help====<br />
:<ins>Server console only</ins><br />
:Displays these list of commands<br />
====loadmodule====<br />
:<ins>Server console only</ins><br />
:Usage: loadmodule ''<module-filename>''<br><br />
:Load a module eg: loadmodule ml_sockets.dll<br />
====unloadmodule====<br />
:<ins>Server console only</ins><br />
:Usage: unloadmodule ''<module-filename>''<br><br />
:Unload a module eg: unloadmodule ml_sockets.dll<br />
====reloadmodule====<br />
:<ins>Server console only</ins><br />
:Usage: reloadmodule ''<module-filename>''<br><br />
:Reload a module eg: reloadmodule ml_sockets.dll<br />
====openports====<br />
:<ins>Server console only</ins><br />
:Test if server ports are open<br />
====shutdown====<br />
:Usage: shutdown ''<reason>''<br><br />
:Shutdown the server eg: shutdown put reason here<br />
====sver====<br />
:Get the server MTA version<br />
<br />
<br />
==Other commands==<br />
====say====<br />
:Usage: say ''<text>''<br><br />
:Show a message to all players on the server eg: say hello<br />
====whois====<br />
:Usage: whois ''<nick>''<br><br />
:Get the IP of a player currently connected (use whowas for IP/serial/version)<br />
====whowas====<br />
:Usage: whowas ''<nick>''<br><br />
:Get IP/Serial/username of a player that was previously connected to the server<br />
====ver====<br />
:Get the MTA version<br />
<br />
<br />
==Client relevant only==<br />
====chgmypass====<br />
:<ins>Client only</ins><br />
:Usage: chgmypass ''<oldpass>'' ''<newpass>''<br><br />
:Change your password eg: chgmypass oldpw newpw<br />
====debugscript====<br />
:<ins>Client only</ins><br />
:Usage: debugscript ''<''0-3''>''<br><br />
:Remove (This does not work "Incorrect client type for this command")<br />
====login====<br />
:<ins>Client only</ins><br />
:Usage: login ''<accountname>'' ''<password>''<br><br />
:Login to an account eg: login accountname password<br />
====logout====<br />
:<ins>Client only</ins><br />
:Log out of the current account<br />
====me====<br />
:<ins>Client only</ins><br />
:Usage: me ''<text>''<br><br />
:Show a message to all players on the server, with your nick prepended<br />
====msg====<br />
:<ins>Client only</ins><br />
:Usage: msg ''<nick>'' ''<text>''<br><br />
:Send a message to a player eg: msg playername hello<br />
====nick====<br />
:<ins>Client only</ins><br />
:Usage: nick ''<old-nick>'' ''<new-nick>''<br><br />
:Change your ingame nickname<br />
====teamsay====<br />
:<ins>Client only</ins><br />
:Usage: teamsay ''<test>''<br><br />
:Send a message to all players on the same team<br />
<br />
[[Category: Support]]<br />
[[ru:Server Commands]]</div>Gerryhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=49741Server mtaserver.conf2016-11-02T05:09:34Z<p>Gerry: /* bullet_sync */</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>[INDONESIA]Independent Of Strong</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>128.199.82.12</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>100</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 100. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>Emv Net</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 />
====allow_gta3_img_mods====<br />
:''<allow_gta3_img_mods>none</allow_gta3_img_mods><br />
:By default, the server will block the use of locally customized gta3.img player skins. <br />
:This setting can be used to allow such mods. Not recommended for competitive servers.<br />
:Values: none or peds ; default value: none<br />
:'''From server version 1.4.1-9.07268<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>Gerry</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 />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<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>100</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 />
:Bugs caused by enabling latency_reduction: http://bugs.mtasa.com/view.php?id=8191 + http://bugs.mtasa.com/view.php?id=8226<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 />
====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 persistent resources which are loaded when the server starts. Persistent resources are not stopped even if all the other resources that depend on them stop; that is, the only way to stop them is by explicitly using the ''stop'' server command or [[stopResource]] scripting function. To load several resources, add more <resource> parameters.<br />
<br />
:In addition, there are several flags which control how the server deals with each resource:<br />
<br />
:* '''src''': the resource name. This is the only mandatory flag.<br />
:* '''startup''': controls whether the resource will be started with the server or not. If "1", "true" or "yes", the resource will be started. If not specified, defaults to not starting the resource.<br />
:* '''protected''': if "1", "true" or "yes", the resource will not be able to be stopped when started. Otherwise, even if not specified, it will default to the normal behaviour.<br />
:* '''default''': if given a "1", "true" or "yes" value, this resource will be the one who populates the built-in HTTP server main page, which is seen when no resource is given in the web address. It is not possible to have more than one default resource.<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Gerryhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=49740Server mtaserver.conf2016-11-02T05:07:13Z<p>Gerry: /* 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>[INDONESIA]Independent Of Strong</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>128.199.82.12</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>100</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 100. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>Emv Net</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 />
====allow_gta3_img_mods====<br />
:''<allow_gta3_img_mods>none</allow_gta3_img_mods><br />
:By default, the server will block the use of locally customized gta3.img player skins. <br />
:This setting can be used to allow such mods. Not recommended for competitive servers.<br />
:Values: none or peds ; default value: none<br />
:'''From server version 1.4.1-9.07268<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>Gerry</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 />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<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 />
:Bugs caused by enabling latency_reduction: http://bugs.mtasa.com/view.php?id=8191 + http://bugs.mtasa.com/view.php?id=8226<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 />
====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 persistent resources which are loaded when the server starts. Persistent resources are not stopped even if all the other resources that depend on them stop; that is, the only way to stop them is by explicitly using the ''stop'' server command or [[stopResource]] scripting function. To load several resources, add more <resource> parameters.<br />
<br />
:In addition, there are several flags which control how the server deals with each resource:<br />
<br />
:* '''src''': the resource name. This is the only mandatory flag.<br />
:* '''startup''': controls whether the resource will be started with the server or not. If "1", "true" or "yes", the resource will be started. If not specified, defaults to not starting the resource.<br />
:* '''protected''': if "1", "true" or "yes", the resource will not be able to be stopped when started. Otherwise, even if not specified, it will default to the normal behaviour.<br />
:* '''default''': if given a "1", "true" or "yes" value, this resource will be the one who populates the built-in HTTP server main page, which is seen when no resource is given in the web address. It is not possible to have more than one default resource.<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Gerryhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=49739Server mtaserver.conf2016-11-02T05:04:29Z<p>Gerry: /* httpserver */</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>[INDONESIA]Independent Of Strong</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>128.199.82.12</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>100</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 100. It is a required parameter.<br />
<br />
====httpserver====<br />
:''<httpserver>Emv Net</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 />
====allow_gta3_img_mods====<br />
:''<allow_gta3_img_mods>none</allow_gta3_img_mods><br />
:By default, the server will block the use of locally customized gta3.img player skins. <br />
:This setting can be used to allow such mods. Not recommended for competitive servers.<br />
:Values: none or peds ; default value: none<br />
:'''From server version 1.4.1-9.07268<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 />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<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 />
:Bugs caused by enabling latency_reduction: http://bugs.mtasa.com/view.php?id=8191 + http://bugs.mtasa.com/view.php?id=8226<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 />
====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 persistent resources which are loaded when the server starts. Persistent resources are not stopped even if all the other resources that depend on them stop; that is, the only way to stop them is by explicitly using the ''stop'' server command or [[stopResource]] scripting function. To load several resources, add more <resource> parameters.<br />
<br />
:In addition, there are several flags which control how the server deals with each resource:<br />
<br />
:* '''src''': the resource name. This is the only mandatory flag.<br />
:* '''startup''': controls whether the resource will be started with the server or not. If "1", "true" or "yes", the resource will be started. If not specified, defaults to not starting the resource.<br />
:* '''protected''': if "1", "true" or "yes", the resource will not be able to be stopped when started. Otherwise, even if not specified, it will default to the normal behaviour.<br />
:* '''default''': if given a "1", "true" or "yes" value, this resource will be the one who populates the built-in HTTP server main page, which is seen when no resource is given in the web address. It is not possible to have more than one default resource.<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Gerryhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=49738Server mtaserver.conf2016-11-02T05:03:34Z<p>Gerry: /* 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>[INDONESIA]Independent Of Strong</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>128.199.82.12</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>100</maxplayers><br />
:This parameter specifies the number of maximum player slots available on the server;<br />
:default value: 100. 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 />
====allow_gta3_img_mods====<br />
:''<allow_gta3_img_mods>none</allow_gta3_img_mods><br />
:By default, the server will block the use of locally customized gta3.img player skins. <br />
:This setting can be used to allow such mods. Not recommended for competitive servers.<br />
:Values: none or peds ; default value: none<br />
:'''From server version 1.4.1-9.07268<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 />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<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 />
:Bugs caused by enabling latency_reduction: http://bugs.mtasa.com/view.php?id=8191 + http://bugs.mtasa.com/view.php?id=8226<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 />
====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 persistent resources which are loaded when the server starts. Persistent resources are not stopped even if all the other resources that depend on them stop; that is, the only way to stop them is by explicitly using the ''stop'' server command or [[stopResource]] scripting function. To load several resources, add more <resource> parameters.<br />
<br />
:In addition, there are several flags which control how the server deals with each resource:<br />
<br />
:* '''src''': the resource name. This is the only mandatory flag.<br />
:* '''startup''': controls whether the resource will be started with the server or not. If "1", "true" or "yes", the resource will be started. If not specified, defaults to not starting the resource.<br />
:* '''protected''': if "1", "true" or "yes", the resource will not be able to be stopped when started. Otherwise, even if not specified, it will default to the normal behaviour.<br />
:* '''default''': if given a "1", "true" or "yes" value, this resource will be the one who populates the built-in HTTP server main page, which is seen when no resource is given in the web address. It is not possible to have more than one default resource.<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Gerryhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=49737Server mtaserver.conf2016-11-02T05:03:08Z<p>Gerry: /* 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>[INDONESIA]Independent Of Strong</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>128.199.82.12</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 />
====allow_gta3_img_mods====<br />
:''<allow_gta3_img_mods>none</allow_gta3_img_mods><br />
:By default, the server will block the use of locally customized gta3.img player skins. <br />
:This setting can be used to allow such mods. Not recommended for competitive servers.<br />
:Values: none or peds ; default value: none<br />
:'''From server version 1.4.1-9.07268<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 />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<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 />
:Bugs caused by enabling latency_reduction: http://bugs.mtasa.com/view.php?id=8191 + http://bugs.mtasa.com/view.php?id=8226<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 />
====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 persistent resources which are loaded when the server starts. Persistent resources are not stopped even if all the other resources that depend on them stop; that is, the only way to stop them is by explicitly using the ''stop'' server command or [[stopResource]] scripting function. To load several resources, add more <resource> parameters.<br />
<br />
:In addition, there are several flags which control how the server deals with each resource:<br />
<br />
:* '''src''': the resource name. This is the only mandatory flag.<br />
:* '''startup''': controls whether the resource will be started with the server or not. If "1", "true" or "yes", the resource will be started. If not specified, defaults to not starting the resource.<br />
:* '''protected''': if "1", "true" or "yes", the resource will not be able to be stopped when started. Otherwise, even if not specified, it will default to the normal behaviour.<br />
:* '''default''': if given a "1", "true" or "yes" value, this resource will be the one who populates the built-in HTTP server main page, which is seen when no resource is given in the web address. It is not possible to have more than one default resource.<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Gerryhttps://wiki.multitheftauto.com/index.php?title=Server_mtaserver.conf&diff=49736Server mtaserver.conf2016-11-02T05:01:57Z<p>Gerry: /* 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>[INDONESIA]Independent Of Strong</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 />
====allow_gta3_img_mods====<br />
:''<allow_gta3_img_mods>none</allow_gta3_img_mods><br />
:By default, the server will block the use of locally customized gta3.img player skins. <br />
:This setting can be used to allow such mods. Not recommended for competitive servers.<br />
:Values: none or peds ; default value: none<br />
:'''From server version 1.4.1-9.07268<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 />
:More information: [[Anti-cheat_guide|Anti-cheat guide]]<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 />
:Bugs caused by enabling latency_reduction: http://bugs.mtasa.com/view.php?id=8191 + http://bugs.mtasa.com/view.php?id=8226<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 />
====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 persistent resources which are loaded when the server starts. Persistent resources are not stopped even if all the other resources that depend on them stop; that is, the only way to stop them is by explicitly using the ''stop'' server command or [[stopResource]] scripting function. To load several resources, add more <resource> parameters.<br />
<br />
:In addition, there are several flags which control how the server deals with each resource:<br />
<br />
:* '''src''': the resource name. This is the only mandatory flag.<br />
:* '''startup''': controls whether the resource will be started with the server or not. If "1", "true" or "yes", the resource will be started. If not specified, defaults to not starting the resource.<br />
:* '''protected''': if "1", "true" or "yes", the resource will not be able to be stopped when started. Otherwise, even if not specified, it will default to the normal behaviour.<br />
:* '''default''': if given a "1", "true" or "yes" value, this resource will be the one who populates the built-in HTTP server main page, which is seen when no resource is given in the web address. It is not possible to have more than one default resource.<br />
<br />
[[Category: Support]]<br />
[[ru:Server mtaserver.conf]]</div>Gerryhttps://wiki.multitheftauto.com/index.php?title=Installing_and_Configuring_Nginx_as_an_External_Web_Server&diff=49731Installing and Configuring Nginx as an External Web Server2016-11-01T04:14:20Z<p>Gerry: /* Edit mtaserver.conf */</p>
<hr />
<div>==Internal vs External==<br />
The MTA:SA server comes with a built-in 'internal' HTTP server which clients use to automatically download resource files. It is only a basic HTTP server which does not support compression or multiple client connections. <br />
By adding an external HTTP server such as '''nginx''' or '''lighttpd''', resource download speed can be increased and bandwidth usage (and player waiting time) decreased.<br />
Note that the external HTTP server can be on the same machine as the MTA server.<br />
<br />
==nginx vs Apache==<br />
We recommend nginx or lighttpd as they are better suited to handle the hundreds of file requests that MTA:SA clients will generate. Apache can be used, but will require settings tweaking and the mtasever.conf setting <'''httpmaxconnectionsperclient'''> may have to be reduced to prevent timeouts.<br />
<br />
The following guide is for installing and configuring nginx solely for MTA:SA. It assumes:<br />
* You are not already using nginx for other web sites on your server.<br />
* MTA:SA server is installed on the same server.<br />
* You are using Debian 7 (but should work on other distributions in a similar way.)<br />
<br />
==Installing nginx:==<br />
Update system:<br />
apt-get update<br />
apt-get upgrade<br />
<br />
Install nginx:<br />
apt-get install nginx<br />
<br />
Ensure nginx is not running:<br />
/etc/init.d/nginx stop<br />
<br />
==Configuring nginx:==<br />
<!--<br />
====Edit: /etc/nginx/sites-available/default====<br />
Find the ''''root'''' line and change it to point to the '''''http-client-files''''' directory in your MTA:SA server install:<br />
root /PATH_TO_MTA_SERVER/mods/deathmatch/resource-cache/http-client-files;<br />
Find the ''''listen'''' and change it to use an unused server port: (Remove # if present)<br />
listen 20080;<br />
--><br />
====Edit: /etc/nginx/sites-enabled/mta-server1====<br />
In the directory '''/etc/nginx/sites-enabled/''' create a file called '''mta-server1''' with the following content:<br />
server {<br />
listen 20080;<br />
root /PATH_TO_MTA_SERVER/mods/deathmatch/resource-cache/http-client-files;<br />
server_name localhost;<br />
access_log off;<br />
}<br />
'''**Important**: Change PATH_TO_MTA_SERVER to the actual absolute path of your MTA:SA server install directory'''<br />
====Edit: /etc/nginx/nginx.conf====<br />
At the top of the file, add this line to increase the max number of files that can be opened:<br />
worker_rlimit_nofile 5000;<br />
Find the ''''worker_connections'''' line and change it to this:<br />
worker_connections 5000;<br />
Find the ''''gzip'''' settings and make sure gzip is on:<br />
gzip on;<br />
and ''''gzip_types'''' is set for any file type:<br />
gzip_types *;<br />
<br />
==Testing nginx:==<br />
Start nginx:<br />
/etc/init.d/nginx start<br />
<br />
=====Test #1=====<br />
Open your internet browser, and try this address: '''<nowiki>http://YOUR_SERVER_IP:20080/admin/client/admin_ACL.lua</nowiki>'''<br/><br />
If prompted to download a file - SUCCESS!<br />
<br />
=====Test #2=====<br />
To test the compression is working, go here: http://www.whatsmyip.org/http-compression-test/ and enter '''<nowiki>http://YOUR_SERVER_IP:20080/admin/client/admin_ACL.lua</nowiki>''' in the white box and press 'Test'.<br/><br />
If green tick - SUCCESS!<br />
<br />
==Configure MTA:SA server:==<br />
====Edit mtaserver.conf====<br />
Set '''httpdownloadurl''' to be like this:<br />
<httpdownloadurl>'''<nowiki>http://YOUR_SERVER_IP: 128.199.82.12</nowiki>'''<[INDONESIA]OF Strong><br />
<br />
And start MTA:SA server.<br />
<br />
<!--<br />
==Test it all works!==<br />
Connect MTA:SA client and view nginx log files to confirm files are being downloaded: '''/var/log/nginx/access.log'''<br />
<br />
==Final thing==<br />
To improve performance, and to avoid huge boring log files, edit '''/etc/nginx/sites-available/default''' and add this line under the '''listen''' one:<br />
access_log off;<br />
and reload the nginx configuration:<br />
/etc/init.d/nginx reload<br />
--></div>Gerryhttps://wiki.multitheftauto.com/index.php?title=Installing_and_Configuring_Nginx_as_an_External_Web_Server&diff=49730Installing and Configuring Nginx as an External Web Server2016-11-01T04:13:36Z<p>Gerry: /* Edit mtaserver.conf */</p>
<hr />
<div>==Internal vs External==<br />
The MTA:SA server comes with a built-in 'internal' HTTP server which clients use to automatically download resource files. It is only a basic HTTP server which does not support compression or multiple client connections. <br />
By adding an external HTTP server such as '''nginx''' or '''lighttpd''', resource download speed can be increased and bandwidth usage (and player waiting time) decreased.<br />
Note that the external HTTP server can be on the same machine as the MTA server.<br />
<br />
==nginx vs Apache==<br />
We recommend nginx or lighttpd as they are better suited to handle the hundreds of file requests that MTA:SA clients will generate. Apache can be used, but will require settings tweaking and the mtasever.conf setting <'''httpmaxconnectionsperclient'''> may have to be reduced to prevent timeouts.<br />
<br />
The following guide is for installing and configuring nginx solely for MTA:SA. It assumes:<br />
* You are not already using nginx for other web sites on your server.<br />
* MTA:SA server is installed on the same server.<br />
* You are using Debian 7 (but should work on other distributions in a similar way.)<br />
<br />
==Installing nginx:==<br />
Update system:<br />
apt-get update<br />
apt-get upgrade<br />
<br />
Install nginx:<br />
apt-get install nginx<br />
<br />
Ensure nginx is not running:<br />
/etc/init.d/nginx stop<br />
<br />
==Configuring nginx:==<br />
<!--<br />
====Edit: /etc/nginx/sites-available/default====<br />
Find the ''''root'''' line and change it to point to the '''''http-client-files''''' directory in your MTA:SA server install:<br />
root /PATH_TO_MTA_SERVER/mods/deathmatch/resource-cache/http-client-files;<br />
Find the ''''listen'''' and change it to use an unused server port: (Remove # if present)<br />
listen 20080;<br />
--><br />
====Edit: /etc/nginx/sites-enabled/mta-server1====<br />
In the directory '''/etc/nginx/sites-enabled/''' create a file called '''mta-server1''' with the following content:<br />
server {<br />
listen 20080;<br />
root /PATH_TO_MTA_SERVER/mods/deathmatch/resource-cache/http-client-files;<br />
server_name localhost;<br />
access_log off;<br />
}<br />
'''**Important**: Change PATH_TO_MTA_SERVER to the actual absolute path of your MTA:SA server install directory'''<br />
====Edit: /etc/nginx/nginx.conf====<br />
At the top of the file, add this line to increase the max number of files that can be opened:<br />
worker_rlimit_nofile 5000;<br />
Find the ''''worker_connections'''' line and change it to this:<br />
worker_connections 5000;<br />
Find the ''''gzip'''' settings and make sure gzip is on:<br />
gzip on;<br />
and ''''gzip_types'''' is set for any file type:<br />
gzip_types *;<br />
<br />
==Testing nginx:==<br />
Start nginx:<br />
/etc/init.d/nginx start<br />
<br />
=====Test #1=====<br />
Open your internet browser, and try this address: '''<nowiki>http://YOUR_SERVER_IP:20080/admin/client/admin_ACL.lua</nowiki>'''<br/><br />
If prompted to download a file - SUCCESS!<br />
<br />
=====Test #2=====<br />
To test the compression is working, go here: http://www.whatsmyip.org/http-compression-test/ and enter '''<nowiki>http://YOUR_SERVER_IP:20080/admin/client/admin_ACL.lua</nowiki>''' in the white box and press 'Test'.<br/><br />
If green tick - SUCCESS!<br />
<br />
==Configure MTA:SA server:==<br />
====Edit mtaserver.conf====<br />
Set '''httpdownloadurl''' to be like this:<br />
<httpdownloadurl>'''<nowiki>http://YOUR_SERVER_IP: 128.199.82.12</nowiki>'''</httpdownloadurl><br />
<br />
And start MTA:SA server.<br />
<br />
<!--<br />
==Test it all works!==<br />
Connect MTA:SA client and view nginx log files to confirm files are being downloaded: '''/var/log/nginx/access.log'''<br />
<br />
==Final thing==<br />
To improve performance, and to avoid huge boring log files, edit '''/etc/nginx/sites-available/default''' and add this line under the '''listen''' one:<br />
access_log off;<br />
and reload the nginx configuration:<br />
/etc/init.d/nginx reload<br />
--></div>Gerry