Client on Linux Manual - Revision history

Desovsky: Added section about serial validation workaround connected to nvme-only machines

2025-12-07T21:40:44Z

Added section about serial validation workaround connected to nvme-only machines

← Older revision		Revision as of 21:40, 7 December 2025
Line 137:		Line 137:
	winetricks -q wmp10		winetricks -q wmp10
	</syntaxhighlight>		</syntaxhighlight>
			<br>
	'''Special Detections (SD)'''<br>		'''Special Detections (SD)'''<br>
	This was already described above in general terms, of possible issues if you're not using 32-bit prefix as is recommended. But for this "Specific issues" section we will go in-depth more regarding '''SD #21''' kick from AC that commonly affects Linux/Wine users:<br>		This was already described above in general terms, of possible issues if you're not using 32-bit prefix as is recommended. But for this "Specific issues" section we will go in-depth more regarding '''SD #21''' kick from AC that commonly affects Linux/Wine users:<br>
Line 149:		Line 149:

	'''Note''': In some scenario's, while creating your 32-bit prefix, it may be needed to change Windows version on the bottom to Windows 7. But avoid it whenever possible.		'''Note''': In some scenario's, while creating your 32-bit prefix, it may be needed to change Windows version on the bottom to Windows 7. But avoid it whenever possible.
			<br><br>
			'''Serial Validation fails'''<br>
			On some Linux systems, MTA may fail the serial validation step during first startup. This workaround might work if your machine uses only NVMe storage devices.<br>
			To check wether your system is affected, run:
			<syntaxhighlight>ls -l /dev/disk/by-id</syntaxhighlight>
			If the output doesn't contain any entry starting with "ata-" or "scsi-", then this might be the cause of serial validation problems for you.<br>
			You can work around this issue by temporarily connecting any SATA-based storage device to your system. This includes:
			#internal SATA HDDs/SSDs
			#external USB hard drives that use USB–SATA bridge controllers
			Once the device is connected, the system will expose the required ata-* or scsi-* identifiers. While the device is still connected, [https://wiki.multitheftauto.com/wiki/Server_Manual#Linux_installation start the MTA Server natively on Linux] (not through Wine), then launch MTA client using your preferred way. The serial validation should now succeed.<br>
			After successful validation, the SATA device usually no longer needs to remain connected unless the Wine prefix is recreated or MTA requires serial verification again.
	<br><br>		<br><br>
	'''Font Artifacts'''<br>		'''Font Artifacts'''<br>

Fernando187: other methods

2025-09-16T12:36:00Z

other methods

← Older revision		Revision as of 12:36, 16 September 2025
Line 2:		Line 2:
	{{Warning\|This page is for Linux players '''ONLY''', for Windows go [[Client Manual\|here]].\|true}}		{{Warning\|This page is for Linux players '''ONLY''', for Windows go [[Client Manual\|here]].\|true}}

	==Lutris==		==Other Methods==
			These are related Client on Linux methods for other setups:

			===Lutris===

	Lutris can be used instead for easier Prefix management, see		Lutris can be used instead for easier Prefix management, see
	[[Client on Linux using Lutris Manual]]		[[Client on Linux using Lutris Manual]]

	==Bottles/Soda==		===Bottles/Soda===

	Bottles can also be used in conjunction with the Soda runner, see		Bottles can also be used in conjunction with the Soda runner, see
	[[Client on Linux using Bottles/Soda Manual]]		[[Client on Linux using Bottles/Soda Manual]]

			===Steam Deck===
			Steam Deck mobile device can also be used to play MTA, see
			[[Client on Steam Deck Manual]]

	==Before you start==		==Before you start==

Gamelaster at 13:48, 22 June 2025

2025-06-22T13:48:42Z

← Older revision		Revision as of 13:48, 22 June 2025
Line 17:		Line 17:
	Read the [[Client_Manual\|Client Manual]] page for further informations, or join us on [https://mtasa.com/discord Discord].		Read the [[Client_Manual\|Client Manual]] page for further informations, or join us on [https://mtasa.com/discord Discord].

	~~During this tutorial, make sure~~ to '''~~only use~~ 32-bit Wine prefix''' ~~for MTA:SA~~, or ~~else you'll run into a plethora of hard~~-to-~~fix~~ issues.		It is recommended to use '''32-bit Wine prefix'''. But if you do not want to install 32-bit libs, or your distro ships with enforced WoW64 Wine mode, use 64-bit Wine prefix instead, although 64-bit Wine prefix introduces some instability, bugs and potential performance issues, but it's still very playable.

	===Requirements===		===Requirements===
Line 24:		Line 24:
	* Wine (get it on your package manager (synaptic, apt, pacman, yum, etc.); follow instructions [https://www.winehq.org/download/ubuntu here] if you're using Ubuntu; (Install Wine Staging if you want better audio quality (experimental))		* Wine (get it on your package manager (synaptic, apt, pacman, yum, etc.); follow instructions [https://www.winehq.org/download/ubuntu here] if you're using Ubuntu; (Install Wine Staging if you want better audio quality (experimental))
	* Winetricks (same as wine, get it on your package manager, or follow instructions [https://wiki.winehq.org/Winetricks here])		* Winetricks (same as wine, get it on your package manager, or follow instructions [https://wiki.winehq.org/Winetricks here])
	* 32-bit GPU mesa drivers for your GPU (for arch, use package lib32-mesa)		* '''(for 32-bit wine bottle only)''' 32-bit GPU mesa drivers for your GPU (for arch, use package lib32-mesa)
	* 32-bit Audio drivers (for arch, follow instructions [https://wiki.archlinux.org/title/wine#Sound here]		* '''(for 32-bit wine bottle only)''' 32-bit Audio drivers (for arch, follow instructions [https://wiki.archlinux.org/title/wine#Sound here]
	* TLS libraries (for arch, use packages gnutls and lib32-gnutls)		* TLS libraries (for arch, use packages gnutls and '''(lib32-gnutls for 32-bit wine bottle only)''')
	* MTA:SA version 1.6 or newer (1.6 contains many improvements for Wine)		* MTA:SA version 1.6 or newer (1.6 contains many improvements for Wine)
	* Windows fonts:		* Windows fonts:
Line 38:		Line 38:
	* Get them via your package manager (apt, pacman (ttf-tahoma and ttf-ms-fonts from AUR))		* Get them via your package manager (apt, pacman (ttf-tahoma and ttf-ms-fonts from AUR))

	==Create new ~~32-bit~~ prefix==		==Create new prefix==

	Firstly, we need to create ~~32-bit~~ prefix~~, as default Wine prefix is almost always 64-bit~~:		Firstly, we need to create a new prefix:

	# Start Winetricks		# Start Winetricks
	# Select '''Create new prefix'''		# Select '''Create new prefix'''
	# ~~Select~~ '''32-bit prefix'''		# If you can, select '''32-bit prefix'''. If you did not installed 32-bit libraries, or you have enforced WoW64, create '''64-bit prefix'''.
	# Write name of prefix, we will use '''mtasa'''		# Write name of prefix, we will use '''mtasa'''

Line 66:		Line 66:

	Firstly, we need to assure that our prefix have required fonts, mentioned in Requirements part. If you installed those fonts via package manager or into your Linux system, Wine should be able to pick them up automatically.<br/>		Firstly, we need to assure that our prefix have required fonts, mentioned in Requirements part. If you installed those fonts via package manager or into your Linux system, Wine should be able to pick them up automatically.<br/>
	If that doesn't work, manually install them in <syntaxhighlight lang="lua">~/.local/share/wineprefixes/mtasa/drive_c/windows/Fonts</syntaxhighlight>.		If that doesn't work, manually install them in <syntaxhighlight lang="lua">~/.local/share/wineprefixes/mtasa/drive_c/windows/Fonts</syntaxhighlight>

	If you installed Wine Staging, we can enable '''Environmental Audio Extensions (EAX)''', which is experimental feature, although I didn't encountered any issues with it.		If you installed Wine Staging, we can enable '''Environmental Audio Extensions (EAX)''', which is experimental feature, although I didn't encountered any issues with it.
Line 76:		Line 76:
	# Go to '''Staging''' tab		# Go to '''Staging''' tab
	# Enable Environmental Audio Extensions (EAX)		# Enable Environmental Audio Extensions (EAX)

			===For 64-bit prefix===

			Normally for DirectX games, DirectX to OpenGL shim is used. Wine WoW64 have significant performance issues in games using OpenGL.
			Because of this, it is recommended to install DXVK through WineTricks. In the past, DXVK did not worked with MTA, although, so far it works quite nicely, although it's less stable as on 32-bit bottle with internal DirectX to OpenGL shim.

			# Open Winetricks
			# Select '''mtasa prefix'''
			# Select '''Install a Windows DLL or component'''
			# Select '''dxvk'''

	==Running the game==		==Running the game==
Line 95:		Line 105:
	* "No audio card detected" when launching either GTA:SA or MTA		* "No audio card detected" when launching either GTA:SA or MTA
	* Using standard Full-screen mode on MTA might cause some occasional artifacts		* Using standard Full-screen mode on MTA might cause some occasional artifacts
	* Enabling DXVK might not break GTA:SA, but it breaks MTA		* Enabling DXVK might not break GTA:SA, but it breaks MTA (NOTE: DXVK seems to work on latest versions of Wine, DXVK and MTA)
	* Using Linux brings a higher-than-usual chance for game crashes due to various reasons (sometimes to do with resources & mods on individual servers)		* Using Linux brings a higher-than-usual chance for game crashes due to various reasons (sometimes to do with resources & mods on individual servers)
	* CEF crashes with some wine versions. Use [https://github.com/multitheftauto/mtasa-blue/issues/1000 workaround] for this issue		* CEF crashes with some wine versions. Use [https://github.com/multitheftauto/mtasa-blue/issues/1000 workaround] for this issue
Line 140:		Line 150:
	Apply all the changes and you're good to go.<br>		Apply all the changes and you're good to go.<br>
	(Make sure you have ''''d3dx9_42'''' installed in your prefix)		(Make sure you have ''''d3dx9_42'''' installed in your prefix)
	<syntaxhighlight> winetricks d3dx9_42</syntaxhighlight><br><br>		<syntaxhighlight> winetricks d3dx9_42</syntaxhighlight><br/>
			(NOTE: This does not work anymore, MTA stops due integrity check failure.)
			<br><br>

	'''Closing words'''<br>		'''Closing words'''<br>

-ffs-PLASMA at 11:08, 6 June 2025

2025-06-06T11:08:32Z

← Older revision		Revision as of 11:08, 6 June 2025
Line 6:		Line 6:
	Lutris can be used instead for easier Prefix management, see		Lutris can be used instead for easier Prefix management, see
	[[Client on Linux using Lutris Manual]]		[[Client on Linux using Lutris Manual]]

			==Bottles/Soda==

			Bottles can also be used in conjunction with the Soda runner, see
			[[Client on Linux using Bottles/Soda Manual]]

	==Before you start==		==Before you start==

Gamelaster at 08:30, 29 June 2023

2023-06-29T08:30:24Z

← Older revision		Revision as of 08:30, 29 June 2023
Line 21:		Line 21:
	* 32-bit GPU mesa drivers for your GPU (for arch, use package lib32-mesa)		* 32-bit GPU mesa drivers for your GPU (for arch, use package lib32-mesa)
	* 32-bit Audio drivers (for arch, follow instructions [https://wiki.archlinux.org/title/wine#Sound here]		* 32-bit Audio drivers (for arch, follow instructions [https://wiki.archlinux.org/title/wine#Sound here]
			* TLS libraries (for arch, use packages gnutls and lib32-gnutls)
	* MTA:SA version 1.6 or newer (1.6 contains many improvements for Wine)		* MTA:SA version 1.6 or newer (1.6 contains many improvements for Wine)
	* Windows fonts:		* Windows fonts:

Gamelaster: New latest tutorial on running MTASA 1.6 on Wine

2023-06-28T13:47:01Z

New latest tutorial on running MTASA 1.6 on Wine

← Older revision		Revision as of 13:47, 28 June 2023
Line 17:		Line 17:
	The hardware requirements for Multi Theft Auto: San Andreas are the same as on Windows.		The hardware requirements for Multi Theft Auto: San Andreas are the same as on Windows.
	For software requirements, you need:		For software requirements, you need:
	* Wine (get it on your package manager (synaptic, apt, pacman, yum, etc.); follow instructions [https://www.winehq.org/download/ubuntu here] if you're using Ubuntu		* Wine (get it on your package manager (synaptic, apt, pacman, yum, etc.); follow instructions [https://www.winehq.org/download/ubuntu here] if you're using Ubuntu; (Install Wine Staging if you want better audio quality (experimental))
			* Winetricks (same as wine, get it on your package manager, or follow instructions [https://wiki.winehq.org/Winetricks here])
	* Windows fonts ~~installed~~:		* 32-bit GPU mesa drivers for your GPU (for arch, use package lib32-mesa)
			* 32-bit Audio drivers (for arch, follow instructions [https://wiki.archlinux.org/title/wine#Sound here]
			* MTA:SA version 1.6 or newer (1.6 contains many improvements for Wine)
			* Windows fonts:
	** tahoma.ttf		** tahoma.ttf
	** tahomabd.ttf		** tahomabd.ttf
	** verdana.ttf		** verdana.ttf
	~~Get them on the Internet, e.g. [http://fontonic.com/ fontonic.com]~~

	~~Or get~~ the zip archive with the 3 fonts {{WineFonts}}.		You can download them from following places:
			* Get them on the Internet, e.g. [http://fontonic.com/ fontonic.com]
			* Get the zip archive with the 3 fonts {{WineFonts}}.
			* Get them via your package manager (apt, pacman (ttf-tahoma and ttf-ms-fonts from AUR))

			==Create new 32-bit prefix==

			Firstly, we need to create 32-bit prefix, as default Wine prefix is almost always 64-bit:

	~~Install them in: <syntaxhighlight lang="lua">~/.wine/dosdevices/c:/windows/Fonts/</syntaxhighlight>~~		# Start Winetricks
	~~(~/ points to your user home folder on Linux~~, ~~.wine is the default wineprefix)~~		# Select '''Create new prefix'''
			# Select '''32-bit prefix'''
			# Write name of prefix, we will use '''mtasa'''

	==Installing the game==		==Installing the game==
	~~Download~~ the MTA installer from [http://www.mtasa.com mtasa.com], ~~ensure you can launch~~ it (~~chmod +x~~) ~~then install it when~~ you ~~want~~.<br>		(You can skip this if you installed the game via Steam or other supported Games Store)
	'''~~Make sure to only use 32-bit Wine prefix for MTA:SA~~, ~~or else you~~'~~ll run into a plethora of hard-to-fix~~ issues.'''		Install the game from DVD or ISO into our prefix, by executing following command:
			<syntaxhighlight lang="bash">
			WINEPREFIX=~/.local/share/wineprefixes/mtasa wine /mnt/setup.exe
			</syntaxhighlight>
			(Replace /mnt/setup.exe with path to installer's setup.exe)

			Complete the installation as usual, you can keep installation path as is.<br/>
			Afterwards, download the MTA installer from [http://www.mtasa.com mtasa.com], and execute it inside our prefix with following command:
			<syntaxhighlight lang="bash">
			WINEPREFIX=~/.local/share/wineprefixes/mtasa wine ~/Downloads/mtasa-1.6.exe
			</syntaxhighlight>
			(As previously, change path to the installer)<br/>
			Keep the options as is, only change is required if installation path of GTA is different from default, in that case, browse the path to the game.

			==Configuring prefix==

			Firstly, we need to assure that our prefix have required fonts, mentioned in Requirements part. If you installed those fonts via package manager or into your Linux system, Wine should be able to pick them up automatically.<br/>
			If that doesn't work, manually install them in <syntaxhighlight lang="lua">~/.local/share/wineprefixes/mtasa/drive_c/windows/Fonts</syntaxhighlight>.

			If you installed Wine Staging, we can enable '''Environmental Audio Extensions (EAX)''', which is experimental feature, although I didn't encountered any issues with it.
			You can enable it as follows:

			# Open Winetricks
			# Select '''mtasa prefix'''
			# Select '''Run winecfg'''
			# Go to '''Staging''' tab
			# Enable Environmental Audio Extensions (EAX)

	==Running the game==		==Running the game==
	Once installed, double-clicking on the ~~Multi Theft Auto.exe~~ should work. If not, try in a terminal the following command: "wine Multi Theft Auto.exe~~" in the directory you installed Multi Theft Auto to.~~		Once installed, double-clicking on the Desktop shortcut or menu item should work. If not, try in a terminal the following command:
	~~If it doesn't work, check the contents of the file c:/Program_Files/Multi Theft Auto~~/~~MTA/CEGUI.log, which may contain useful information.~~		<syntaxhighlight lang="bash">
			WINEPREFIX=~/.local/share/wineprefixes/mtasa wine ~/.local/share/wineprefixes/mtasa/drive_c/Program\ Files/MTA\ San\ Andreas\ 1.6\Multi\ Theft\ Auto.exe
			</syntaxhighlight>

	===Known issues===		===Known issues===

Gamelaster: Remove old information

2023-06-27T09:33:28Z

Remove old information

← Older revision		Revision as of 09:33, 27 June 2023
Line 18:		Line 18:
	For software requirements, you need:		For software requirements, you need:
	* Wine (get it on your package manager (synaptic, apt, pacman, yum, etc.); follow instructions [https://www.winehq.org/download/ubuntu here] if you're using Ubuntu		* Wine (get it on your package manager (synaptic, apt, pacman, yum, etc.); follow instructions [https://www.winehq.org/download/ubuntu here] if you're using Ubuntu
	~~(as of MTA 1.4.1 Ubuntu's default Wine package seems to be incompatible with Visual C++, which is required to install MTA)~~
	* Windows fonts installed:		* Windows fonts installed:
	** tahoma.ttf		** tahoma.ttf
Line 45:		Line 45:
	#:which is located in the "GTA San Andreas User Files" folder, which can be found in your home directory.<br>'''(Remember to create a copy, if you're playing San Andreas in singleplayer)'''		#:which is located in the "GTA San Andreas User Files" folder, which can be found in your home directory.<br>'''(Remember to create a copy, if you're playing San Andreas in singleplayer)'''
	#Try to delete your MTA config file		#Try to delete your MTA config file
	#:which is: "MTA San Andreas 1.3/MTA/coreconfig.xml"<br>'''(Also remember to create a copy, if you don't want to lose your edited MTA configuration)'''		#:which is: "MTA San Andreas 1.6/MTA/coreconfig.xml"<br>'''(Also remember to create a copy, if you don't want to lose your edited MTA configuration)'''
	* MTA won't start on Ubuntu 12.04 LTS [Temporary fix is available [https://forum.mtasa.com/topic/36206-mta-13-wont-start-on-ubuntu-1204/#comment-366248 here]. Although, just updating away from such an old version of Ubuntu is the recommended way to go]

	* "SD #16 Error" when connecting to a server		* "SD #16 Error" when connecting to a server

Notdamy at 14:53, 15 March 2023

2023-03-15T14:53:37Z

← Older revision		Revision as of 14:53, 15 March 2023
Line 90:		Line 90:
	<br><br>		<br><br>
	'''Font Artifacts'''<br>		'''Font Artifacts'''<br>
	If you see weird fonts artifacts [https://media.discordapp.net/attachments/278521065435824128/1000827089022373978/unknown.png like this] then you need to add a new DLL override to your prefix/bottle.		If you see weird fonts artifacts [https://media.discordapp.net/attachments/278521065435824128/1000827089022373978/unknown.png like this] then you need to add a new DLL override to your prefix/bottle. <br>
	#Open '''Wine configuration''' for your prefix/bottle, go to the Libraries tab		#Open '''Wine configuration''' for your prefix/bottle, go to the Libraries tab
	#Click on the ''''New override for library''':' dropdown and select ''''d3dx9_42''''		#Click on the ''''New override for library''':' dropdown and select ''''d3dx9_42''''
	#Click on ''''Edit...'''' and select ''''Builtin (Wine)'''' then 'OK'		#Click on ''''Edit...'''' and select ''''Builtin (Wine)'''' then 'OK'
	Apply all the changes and you're good to go.<br><br>		Apply all the changes and you're good to go.<br>
			(Make sure you have ''''d3dx9_42'''' installed in your prefix)
			<syntaxhighlight> winetricks d3dx9_42</syntaxhighlight><br><br>

	'''Closing words'''<br>		'''Closing words'''<br>

Notdamy: Added a new workaround (font artifacts)

2022-07-24T18:36:04Z

Added a new workaround (font artifacts)

← Older revision		Revision as of 18:36, 24 July 2022
Line 89:		Line 89:
	'''Note''': In some scenario's, while creating your 32-bit prefix, it may be needed to change Windows version on the bottom to Windows 7. But avoid it whenever possible.		'''Note''': In some scenario's, while creating your 32-bit prefix, it may be needed to change Windows version on the bottom to Windows 7. But avoid it whenever possible.
	<br><br>		<br><br>
			'''Font Artifacts'''<br>
			If you see weird fonts artifacts [https://media.discordapp.net/attachments/278521065435824128/1000827089022373978/unknown.png like this] then you need to add a new DLL override to your prefix/bottle.
			#Open '''Wine configuration''' for your prefix/bottle, go to the Libraries tab
			#Click on the ''''New override for library''':' dropdown and select ''''d3dx9_42''''
			#Click on ''''Edit...'''' and select ''''Builtin (Wine)'''' then 'OK'
			Apply all the changes and you're good to go.<br><br>

	'''Closing words'''<br>		'''Closing words'''<br>
	To avoid many of the roadblocks when it comes to Linux/Wine issues in general, just use 32-bit Prefix as suggested. However, if you still run into issues, you can inform yourself better about MTA's Linux/Mac support levels and background by joining the [https://discord.gg/mtasa MTA discord] and going to #help-support channel, to specifically read information at this pinned message: https://discord.com/channels/278474088903606273/278521065435824128/894932698269900830		To avoid many of the roadblocks when it comes to Linux/Wine issues in general, just use 32-bit Prefix as suggested. However, if you still run into issues, you can inform yourself better about MTA's Linux/Mac support levels and background by joining the [https://discord.gg/mtasa MTA discord] and going to #help-support channel, to specifically read information at this pinned message: https://discord.com/channels/278474088903606273/278521065435824128/894932698269900830

TheNormalnij: /* Known issues */ Added cef workaround link

2022-01-04T22:34:33Z

Known issues: Added cef workaround link

← Older revision		Revision as of 22:34, 4 January 2022
Line 53:		Line 53:
	* Enabling DXVK might not break GTA:SA, but it breaks MTA		* Enabling DXVK might not break GTA:SA, but it breaks MTA
	* Using Linux brings a higher-than-usual chance for game crashes due to various reasons (sometimes to do with resources & mods on individual servers)		* Using Linux brings a higher-than-usual chance for game crashes due to various reasons (sometimes to do with resources & mods on individual servers)
			* CEF crashes with some wine versions. Use [https://github.com/multitheftauto/mtasa-blue/issues/1000 workaround] for this issue
	<br><br>		<br><br>
	'''* Making the mistake of using a 64-bit prefix may ''specifically'' result in:'''		'''* Making the mistake of using a 64-bit prefix may ''specifically'' result in:'''
Line 61:		Line 62:

	<br>		<br>

	===Specific issues with workarounds===		===Specific issues with workarounds===
	<br>		<br>