The Guild Wars 2 Wikis will be undergoing maintenance on Wednesday, October 1, in order to upgrade the wiki software. The wikis will be unavailable for approximately 90 minutes starting at 17:00 UTC.
Notice something wrong, missing, or unsatisfactory? Feel free to edit pages yourself and make use of discussion pages. Wiki content is created, maintained, and administrated by players. See how you can help.

Command line arguments

From Guild Wars 2 Wiki
(Redirected from Command line)
Jump to: navigation, search


Command line arguments are directives which are added to the start up command of the game executable. There are directives which change the client's behavior, streamline player login and enable diagnostics.

Command line arguments can be prefixed with either "-" or "/", so these are the same:

/clientport 80
-clientport 80

Arguments can be separated by space (" ") or colon (":"), so these are the same:

-clientport 80

[edit] Using command line arguments

Windows via shortcut

You can execute switches directly from your Guild Wars 2 shortcut:

  1. Right click on your Guild Wars 2 shortcut and select 'Properties'.
  2. In the 'Target Area' field you will see the location of your Guild Wars 2 executable file:
    ...\Guild Wars 2\Gw2.exe
  3. Write the desired command line arguments after the quote marks, each beginning with a space:
    "...\Guild Wars 2\Gw2.exe" -perf -windowed
Windows via start/run

If you don't plan on using an argument frequently, it can be easier to use the Windows' Run command for a single invocation.

  1. Click the "Start" button
  2. Select "Run" (not required for Windows 7)
  3. Enter the path to the GW2.exe in quotes followed by the arguments you wish to use (same as above, but in a single line).
  4. Press enter.
  1. Right/ctrl-click and choose ShowPackageContent
  2. Find Contents>Resources>CiderSettings.plist
  3. Using TextEdit find this line:
  4. <string>--cmdline ""</string>
  5. Add the command line arguments you want between the quotation marks like this:
  6. <string>--cmdline "-testVerticalFov"</string>
Via PATH variables

An alternative is to add the GW2 directory to your user PATH environment variable. This allows gw2 to be executed as a command line command, enabling easy access to arguments. After performing the following, GW2 can be invoked as "gw2 -<argument string>" from the command line:

  1. Start the "run" dialogue, either with Win-R, or by hitting the windows key, entering "run", and hitting enter.
  2. Enter the following command, without quotes: "control sysdm.cpl", and hit enter to run it.
  3. Go to the Advanced tab.
  4. Press the "Environment variables" button at the bottom.
  5. Double click the PATH variable under "user variables", the top section.
  6. Prefix the list with "<install directory>;" (without quotes and with the semi-colon)

[edit] List of command line arguments

[edit] -authsrv [string]

Specifies the IP or DNS that can be used to connect to a login server.

[edit] -autologin

Launches the game automatically, if the client has been set to remember the Account Name and Password. (This command is unavailable since the 2014 September Feature Pack)

[edit] -bmp

Forces the game to create lossless screenshots as .BMP files. Use for creating high-quality screenshots at the expense of much larger files.

[edit] -clientport 80

Instructs the client to connect to the game servers over port 80 (HTTP) instead of the industry standard gaming port 6112. Some ISPs throttle different port traffic at different times of day so this helps some people get a better connection. (It isn't the default because some ISPs also modify port 80 traffic, which will break the game connection.) Note: -clientport takes an argument but it must be "80".

[edit] -copydat

[verification requested]

Copies all the files in the current dat file to a new dat file.

[edit] -dat [string]

Uses the specified file instead of the default GW2.dat file.

[edit] -diag

Instead of launching the game, this command creates a detailed diagnostic file that contains diagnostic data that can be used for troubleshooting. The file, NetworkDiag.log, will be located in your game directory or "Documents\Guild Wars . If you want to use this feature, be sure to create a separate shortcut for it.

[edit] -dx9single

Enables the Direct3D 9c renderer in single-threaded mode. Improves performance in Wine with CSMT.

[edit] -email [string]

Used in conjunction with -password and -nopatchui to skip patching and login to the specified account directly.
note: does NOT change email address in Patcher-login screen. Thus it cannot be used WITHOUT -nopatchui.

[edit] -forwardrenderer

Uses Forward Rendering instead of Deferred Rendering (unfinished).
  • This currently may lead to shadows and lighting to not appear as expected.

[edit] -fps [number]

Sets maximum frames per second parameter.

[edit] -image

Runs the patch UI only in order to download any available updates; closes immediately without loading the login form.
  • Recommended: Create an extra Guild Wars 2 shortcut (e.g. "Guild Wars 2 Updater") specifically to use this command line switch.

[edit] -maploadinfo

Shows diagnostic information during map loads, including load percentages and elapsed time.

[edit] -mce

Start the client with Windows Media Center compatibility, switching the game to full screen and restarting Media Center (if available) after the client is closed.

[edit] -nopatchui

Hides the user interface during the update process.
  • This command must be used in conjunction with the -email and -password arguments to function, or it will result in a black screen.

[edit] -nomusic

Disables music and background music.

[edit] -noui

Disables the user interface. This does the same thing as pressing Ctrl Shift H in the game.

[edit] -nosound

Disables audio system completely.

[edit] -password [string]

Enables auto-log-in with the specified passsword and either (A) is used with the -email option or (B) details have previously been saved using the "Remember Account Name" checkbox. This argument must not be preceded by any other argument other than -email. The -nopatchui argument must also be specified for this to work (as of Oct 13, 2012). This argument implies -autologin.
Warning: Putting your password in a shortcut or a batch file makes it easily accessible to everybody with access to your computer.
Never use this option if you are sharing your computer with other people whom you do not trust completely.
"<...>\Guild Wars 2\Gw2.exe" -email -password 12345 -nopatchui
Note If your password includes spaces, it needs to be enclosed in quote marks.
"<...>\Guild Wars 2\Gw2.exe" -email -password "1234 5" -nopatchui

[edit] -prefreset

Resets game settings.

[edit] -repair

Start the client, checks the files for errors and repairs them as needed. This can take a long time (1/2 hour or an hour) to run as it checks the entire contents of the (currently) 30 gigabyte archive.

[edit] -shareArchive

Opens the Gw2.dat file in shared mode so that it can be accessed from other processes while the game is running.

[edit] -uispanallmonitors

Spreads user interface across all monitors in a triple monitor setup.

[edit] -uninstall

Presents the uninstall dialog. If uninstall is accepted, it deletes the contents of the Guild Wars 2 installation folder except GW2.EXE itself and any manually created subfolders. Contents in subfolders (if any) are not deleted.

[edit] -useOldFov

Disables the widescreen field-of-view enhancements and restores the original field-of-view.

[edit] -verify

Used to verify the .dat file.

[edit] -windowed

Forces Guild Wars 2 to run in windowed mode.
In game, you can switch to windowed mode by pressing Alt+Enter or clicking the window icon in the upper right corner.

[edit] -umbra gpu

Forces the use of umbra's GPU accelerated culling.
  • In most cases, using this results in higher cpu usage and lower gpu usage decreasing the frame-rate.

[edit] Non-functional command line arguments

The following arguments are found in the client, but do not produce a verifiable effect. Some worked at one time, but were later removed from the game (usually without explanation).

[edit] -allowinstall

Used to display the installer dialog.

[edit] -audio <string>

Unknown effects.

[edit] -assetsrv <string>

Used to specify the IP or DNS to use for downloading assets.

[edit] -cinema <string>

Unknown effects.

[edit] -combatlog <string>

Unknown effects.

[edit] -cuda

Allowed the game to use Nvidia CUDA processing if available.

[edit] -defaultcharname <string>

Unknown effects.

[edit] -defaultLang <string>

Specified the default language the client will use.

[edit] -enabledevice

Unknown effects.

[edit] -exit

Closes launcher or game client immediately after starting it.

[edit] -filesrv <string>

Once used to specify the file server.

[edit] -isRelaunch

Unknown effects.

[edit] -lang <string>

Unknown effects.

[edit] -localdat

Specified the location of the local data file.
performs the same function as -dat, does NOT specify the local.dat under My Documents\Guild Wars 2

[edit] -map <string>

Unknown effects.

[edit] -multi

to run 2+ accounts at the same time. Non Functional -July 28,2013

[edit] -nodelta

Unknown effects.

[edit] -nopatch

Prevented the game from patching on launch (the launcher can get stuck at 0% during checking for updates however).

[edit] -perf

Displayed performance indicators such as; Triangles, memory usage, frames per second and transfer rate in bytes per second are displayed in multi-colored text in the middle of the right side of the Guild Wars 2 window. Support for this was removed in BWE2.

[edit] -portal <string>

Specified the IP-address or DNS-name to use to connect to a portal server.

[edit] -portalalias <string>

Unknown effects.

[edit] -token <string>

Unknown effects.

[edit] -tokenpassword <string>

Unknown effects.

[edit] -usenewbrowser

Unknown effects.

[edit] -usenewlauncher

Enabled by default. Was previously used to trigger the GUI launcher.

[edit] -useoldlauncher

Launched the game using an old style launcher which also allows users to see the old style login screen with music.
Allowed people to use the pre-July 2012 update launcher (which did not check hardware configuration and used a different set of logon fields); was primarily useful for people using Virtual Machine. Disabled as part of the August 21, 2012 update.

[edit] -userid <string>

Unknown effects.
Personal tools
Other languages