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
-clientport 80

Using command line arguments[edit]

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.
Macintosh
  1. Right/ctrl-click GuildWars2.app 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)

List of command line arguments[edit]

-authsrv [string][edit]

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

-autologin[edit]

Launches the game automatically, if the client has been set to remember the Account Name and Password.

-bmp[edit]

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

-clientport 80[edit]

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".

-copydat[edit]

[verification requested]

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

-dat [string][edit]

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

-diag[edit]

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.

-dx9single[edit]

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

-email [string][edit]

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.

-forwardrenderer[edit]

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

-fps [number][edit]

Sets maximum frames per second parameter.

-image[edit]

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.

-maploadinfo[edit]

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

-mce[edit]

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.

-nopatchui[edit]

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.

-nomusic[edit]

Disables music and background music.

-noui[edit]

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

-nosound[edit]

Disables audio system completely.

-password [string][edit]

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.
Example:
"<...>\Guild Wars 2\Gw2.exe" -email myname@myprovider.com -password 12345 -nopatchui
Note If your password includes spaces, it needs to be enclosed in quote marks.
Example:
"<...>\Guild Wars 2\Gw2.exe" -email myname@myprovider.com -password "1234 5" -nopatchui

-prefreset[edit]

Resets game settings.

-repair[edit]

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 20-30 gigabyte archive.

-shareArchive[edit]

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

-uispanallmonitors[edit]

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

-uninstall[edit]

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.

-useOldFov[edit]

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

-verify[edit]

Used to verify the .dat file.

-windowed[edit]

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.

-umbra gpu[edit]

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.

Non-functional command line arguments[edit]

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).

-allowinstall[edit]

Used to display the installer dialog.

-audio <string>[edit]

Unknown effects.

-assetsrv <string>[edit]

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

-cinema <string>[edit]

Unknown effects.

-combatlog <string>[edit]

Unknown effects.

-cuda[edit]

Allowed the game to use Nvidia CUDA processing if available.

-defaultcharname <string>[edit]

Unknown effects.

-defaultLang <string>[edit]

Specified the default language the client will use.

-enabledevice[edit]

Unknown effects.

-exit[edit]

Closes launcher or game client immediately after starting it.

-filesrv <string>[edit]

Once used to specify the file server.

-isRelaunch[edit]

Unknown effects.

-lang <string>[edit]

Unknown effects.

-localdat[edit]

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

-map <string>[edit]

Unknown effects.

-multi[edit]

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

-nodelta[edit]

Unknown effects.

-nopatch[edit]

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

-perf[edit]

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.

-portal <string>[edit]

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

-portalalias <string>[edit]

Unknown effects.

-token <string>[edit]

Unknown effects.

-tokenpassword <string>[edit]

Unknown effects.

-usenewbrowser[edit]

Unknown effects.

-usenewlauncher[edit]

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

-useoldlauncher[edit]

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.

-userid <string>[edit]

Unknown effects.