Startup parameters: Difference between revisions
VaileasysBot (talk | contribs) m (→top: Category project: Modding) |
m (Bump version, minor fixes) |
||
Line 1: | Line 1: | ||
{{ | {{Languages}} | ||
{{Header|Modding|version=Version | {{Header|Modding|version=Version 41|incver=78.16}} | ||
{{TOC right}} | |||
Project Zomboid has | Project Zomboid has customizable '''startup parameters''', as either JVM arguments or game arguments. This can be used to override "vmArgs" in the .json file. JVM arguments must end with a <code>--</code>, even if there are no game arguments. | ||
;Create shortcut: | ;Create shortcut: | ||
# Navigate to the game folder | #Navigate to the game folder | ||
# Create a shortcut of the executable file (ProjectZomboid32.exe/ProjectZomboid64.exe) | #Create a shortcut of the executable file (ProjectZomboid32.exe/ProjectZomboid64.exe) | ||
# Add the appropriate | #Add the appropriate JVM arguments in the "Target:" line<br>Example: <code>C:\ProjectZomboid64.exe -Xmx1024m -Xms1024m -- -nosteam</code> | ||
;[[Steam]] application: | |||
#Right-click the game in the Library | |||
#Select "Properties..." | |||
#Add desired options under "LAUNCH OPTIONS" | |||
==Game arguments== | ==Game arguments== | ||
===Client & server=== | |||
===Client & | |||
{| class="pztable-com" | {| class="pztable-com" | ||
|- | |- | ||
! Arguments | ! Arguments | ||
! | ! style="width: 50%;" | Description | ||
! Example | ! Example | ||
|- | |- | ||
Line 38: | Line 35: | ||
|- | |- | ||
| <code>[[Debug mode|-debug]]</code> | | <code>[[Debug mode|-debug]]</code> | ||
| Launches the game in debug mode. | | Launches the game in the [[debug mode]]. | ||
| | | | ||
|} | |} | ||
Line 46: | Line 43: | ||
|- | |- | ||
! Arguments | ! Arguments | ||
! | ! style="width: 50%;" | Description | ||
! Example | ! Example | ||
|- | |- | ||
Line 74: | Line 71: | ||
|- | |- | ||
! Arguments | ! Arguments | ||
! | ! style="width: 50%;" | Description | ||
! Example | ! Example | ||
|- | |- | ||
Line 104: | Line 101: | ||
| Steam servers require two additional ports to function (I'm guessing they are both UDP ports, but you may need TCP as well). These are in addition to the DefaultPort= setting. These can be specified in two ways: In the server's INI file as SteamPort1= and SteamPort2=. Using command-line options -steamport1 and -steamport2. | | Steam servers require two additional ports to function (I'm guessing they are both UDP ports, but you may need TCP as well). These are in addition to the DefaultPort= setting. These can be specified in two ways: In the server's INI file as SteamPort1= and SteamPort2=. Using command-line options -steamport1 and -steamport2. | ||
| | | | ||
|} | |} | ||
==JVM arguments== | ==JVM arguments== | ||
===Client & server=== | |||
===Client & | |||
{| class="pztable-com" | {| class="pztable-com" | ||
|- | |- | ||
! Arguments | ! Arguments | ||
! | ! style="width: 50%;" | Description | ||
! Example | ! Example | ||
|- | |- | ||
Line 139: | Line 134: | ||
| enables debugging | | enables debugging | ||
| | | | ||
|} | |} | ||
Line 146: | Line 140: | ||
|- | |- | ||
! Arguments | ! Arguments | ||
! | ! style="width: 50%;" | Description | ||
! Example | ! Example | ||
|- | |- | ||
Line 152: | Line 146: | ||
| '''Windows users:''' When the Server starts, a temporary sqlite file will be created in "TEMP", however it will not be deleted after stopping the Server. A way to avoid this is by adding a JVM option <code>-Dorg.sqlite.lib.path=natives</code> and put a copy of the .dll called sqlitejdbc.dll in the server's natives/ directory. It will then use that one instead of extracting the .dll from the .jar file every time. | | '''Windows users:''' When the Server starts, a temporary sqlite file will be created in "TEMP", however it will not be deleted after stopping the Server. A way to avoid this is by adding a JVM option <code>-Dorg.sqlite.lib.path=natives</code> and put a copy of the .dll called sqlitejdbc.dll in the server's natives/ directory. It will then use that one instead of extracting the .dll from the .jar file every time. | ||
| <code>-Dorg.sqlite.lib.path=natives</code> | | <code>-Dorg.sqlite.lib.path=natives</code> | ||
|} | |} | ||
[[Category:Multiplayer]] | [[Category:Multiplayer]] |
Revision as of 00:35, 22 October 2023
Modding > Startup parameters
Template:TOC right
Project Zomboid has customizable startup parameters, as either JVM arguments or game arguments. This can be used to override "vmArgs" in the .json file. JVM arguments must end with a --
, even if there are no game arguments.
- Create shortcut
- Navigate to the game folder
- Create a shortcut of the executable file (ProjectZomboid32.exe/ProjectZomboid64.exe)
- Add the appropriate JVM arguments in the "Target:" line
Example:C:\ProjectZomboid64.exe -Xmx1024m -Xms1024m -- -nosteam
- Steam application
- Right-click the game in the Library
- Select "Properties..."
- Add desired options under "LAUNCH OPTIONS"
Game arguments
Client & server
Arguments | Description | Example |
---|---|---|
-nosteam
|
Disables Steam integration on client/server. | |
-cachedir=<path>
|
Sets the path for the game data cache dir. | -cachedir="C:\Zomboid "
|
-modfolders
|
Option to control where mods are loaded from. Any of the 3 keywords may be left out and may appear in any order. | -modfolders workshop,steam,mods
|
-debug
|
Launches the game in the debug mode. |
Client
Arguments | Description | Example |
---|---|---|
+connect <ip:port>
|
Server address to connect, when joining a server using Steam. | +connect 127.0.0.1:16261
|
+password <password>
|
Server password to connect, when joining a server using Steam. | +password ServersPassword
|
-debugtranslation
|
Writes possible translation issues to homedir "/Zomboid/translationProblems.txt" | |
-safemode
|
Launches the game with reduced resolution and disables some graphical effects to reduce strain on lower-end graphics cards. | |
-nosound
|
Disables the game audio |
Server
Arguments | Description | Example |
---|---|---|
-adminpassword
|
Option to bypasses the enter-a-password prompt when creating a server. | -adminpassword YourPasswdXYZ
|
-servername
|
You can choose a different servername by using this option when starting the server. | -servername MySecondServer
|
-ip <ip>
|
Option to handle multiple network cards. Example: | -ip 127.0.0.1
|
-port <port>
|
Option which overrides the .ini option "DefaultPort". | -port 16261
|
-udpport <port>
|
Option which overrides the .ini option "UDPPort". | -port 16262
|
-steamvac <true/false>
|
Option to enable/disable VAC on Steam servers. On the server command-line use -steamvac true/false. In the server's INI file, use SteamVAC=true/false. | |
-steamport1 <port> -steamport2 <port>
|
Steam servers require two additional ports to function (I'm guessing they are both UDP ports, but you may need TCP as well). These are in addition to the DefaultPort= setting. These can be specified in two ways: In the server's INI file as SteamPort1= and SteamPort2=. Using command-line options -steamport1 and -steamport2. |
JVM arguments
Client & server
Arguments | Description | Example |
---|---|---|
-Xmx
|
Maximum amount of Memory. (1024m=1Gig, 2048m=2Gig, 4096m=4Gig) |
-Xmx1024m
|
-Xms
|
Initial/Minimum Memory allocation. (1024m=1Gig, 2048m=2Gig, 4096m=4Gig) |
-Xms1024m
|
-Dzomboid.steam=<boolean>
|
Disables/enables Steam integration on client/server. (0=disabled, 1=enabled) |
-Dzomboid.steam=1
|
-Duser.home=<path>
|
overwrites the "/Zomboid" homedir to whatever path you want. | -Duser.home=C:\Zomboid
|
-Dsoftreset
|
option to perform a Soft Reset | |
-Ddebug
|
enables debugging |
Server
Arguments | Description | Example |
---|---|---|
-Dorg.sqlite.lib.path=<path>
|
Windows users: When the Server starts, a temporary sqlite file will be created in "TEMP", however it will not be deleted after stopping the Server. A way to avoid this is by adding a JVM option -Dorg.sqlite.lib.path=natives and put a copy of the .dll called sqlitejdbc.dll in the server's natives/ directory. It will then use that one instead of extracting the .dll from the .jar file every time.
|
-Dorg.sqlite.lib.path=natives
|