Serial

From Multi Theft Auto: Wiki
Revision as of 21:37, 29 October 2021 by Dutchman101 (talk | contribs) (Added netcafe note)
Jump to navigation Jump to search

Serials are used by MTA and server administrators to reliably identify a PC that a player is using. Serials are 32 characters long and contain letters and numbers.

They are mostly used for banning players, because a computer with a dynamic IP can change IP every now and then, making IP bans ineffective. MTA wants to give server owners a more reliable way to ban players and keep them out, which is why serials were invented.

Their reliability is so high that many players tend to have the same serial for 6 years or longer (in theory unlimited amount of years) unless they use a different PC at some point. This gives serials a wide range of potential uses in scripting and anti-abuse purposes and systems. But for vast reasons, please avoid using them in place of user accounts, a practise that will come with a variety of problems (some of which for security reasons we won't mention, and situations like when a player starts using a different PC and loses their account data without ability to transfer it, or somehow ends up changing their serial as per the below paragraph (intended or by accident). So basically, again, do not rely on serials for critical functions on your server.

Notes

Serials are the most accurate form of identifying players that MTA has. However, you shouldn't rely on them entirely: players may change their serial, although this is very difficult to do due to MTA AC protections (serials aren't only based on hardware, but more). Besides, a player can simply use another computer with a different serial in order to fool your scripts or evade server bans.

Please note that the reliability of serials isn't as high for internet cafe's. In internet cafe's, the risk of serial duplication is much, much higher than otherwise (for reasons we don't want to explain due to security concerns) so if you suspect a duplication, please check the player for AC / SD code #34. This is easily done in the default Admin panel (under "AC Detected" on player info), but note that if your server has a high amount of problems due to duplicated serials from netcafe players, you could make a special script to alternate for those players or eventually put SD #34 in your mtaserver.conf (see AC guide - CTRL + F to SD #34 but also make sure to read the warning on that entry, so as not to overuse it/only use it when you have no other choice.

Practical Examples

You can find the serial of an individual player by opening the admin panel, selecting the relevant player from list and looking at the player information tab, or by opening server\mods\deathmatch\logs\ > server.log and finding a relevant entry, which will look like this:

CONNECT: PlayerName connected (IP: 11.246.33.390 Serial: 3AE8CACD72H193D950D0T3L6373AQ144 Version: 1.5.8-9.20802.0). In this example, that player's serial would be 3AE8CACD72H193D950D0T3L6373AQ144

In order to ban this player from your server, you'd go to 'Bans' tab in admin panel and select "Ban Serial", then enter that serial.. or the equivalent in your custom admin panel / using addBan, banPlayer, or by editing banlist.xml to add that entry while the server is not running.

Related scripting functions