ARK: Survival Evolved Wiki
Register
(Add valid dinosaur type tags)
Willfe42 (talk | contribs)
(Combine two tables (no point in separating just the level tuning option))
Line 281: Line 281:
 
* Trike
 
* Trike
 
* Turtle
 
* Turtle
|}
 
 
|}
 
|}
   
==== Leveling Adjustments ====
 
The following options adjust how players gain levels and engram points. They should be added to the <tt>[/script/shootergame.shootergamemode]</tt> section of <tt>Game.ini</tt>, located in the same folder as <tt>GameUserSettings.ini</tt> (see above for the location for each platform) to take effect:
 
 
{| class="wikitable sortable"
 
|-
 
! Option !! Arguments !! Effects and Example
 
 
|-
 
|-
 
|
 
|

Revision as of 12:11, 28 June 2015

Note: A new set of options and commands has been added to the game and will be added to this page soon. Refer to http://steamcommunity.com/app/346110/discussions/0/594821545178117961/ in the meantime for details on the new options.

Server Configuration Options

These are options that can only be set at server startup. They control server-wide player notifications, voice chat and core gameplay features.

Most options can be specified on the command line when launching the server or in the configuration file. Options that must be specified on the command line are noted below.

Command Line Usage

The server is launched via the command line using a basic syntax to specify options:

<executable> <map_name>?listen[?<option>=<value>][?<option>=<value>]...[?<option>=<value>]

Following the <executable> name, options are specified as a single string with each option separated by a question mark (?). Most options require a value argument. Refer to the option reference below for more details.

When an option isn't specified, its default value is used automatically.

For example, to launch a server that shows each player a crosshair and a position marker on their map, allows players to view themselves in third person and enforces a minimum distance between player structures by different players and tribes on a Linux host:

./ShooterGameServer TheIsland?listen?ServerCrosshair=True?AllowThirdPersonPlayer=True?MapPlayerLocation=True?MaxStructuresInRange=100

To launch the same server on Windows:

start ShooterGameServer.exe "TheIsland?listen?ServerCrosshair=True?AllowThirdPersonPlayer=True?MapPlayerLocation=True?MaxStructuresInRange=100"

On Windows, quote marks (") are used to ensure the command shell doesn't attempt to interpret or alter the options string.

Configuration File Usage

Most options can also be specified in the game's configuration file. The location of the configuration file varies by platform:

Platform Configuration File Location
Linux ShooterGame/Saved/Config/LinuxServer/GameUserSettings.ini
Windows ShooterGame/Saved/Config/WindowsServer/GameUserSettings.ini

The file contains options for both the game client and the game server. Options for the game client aren't used by the server. Server options are specified in the section labeled [ServerSettings], which is usually located at the bottom of the file.

For all supported platforms, options are listed one per line using the same basic syntax:

<option>=<value>

All options in the configuration file require a value. If an option isn't listed in the configuration file, its default value is used automatically.

To configure a game server with the same configuration as shown in [#Command_Line_Usage Command Line Usage] (above):

ServerCrosshair=True
AllowThirdPersonPlayer=True
MapPlayerLocation=True
MaxStructuresInRange=100

With these options in the configuration file, the server can be launched with a much shorter command line. For Linux:

./ShooterGameServer TheIsland?listen

For Windows:

start ShooterGameServer.exe "TheIsland?listen"

Options

Option Value Type Default Effect
<map_name> string None (command line only) Specifies the map to use for gameplay

Note: This option is mandatory and must be the first option specified on the command line. As of this writing, the only map available is TheIsland.

listen N/A None (command line only) Listen for (and accept) player connections from other systems

Note: This option is mandatory for multiplayer servers.

alwaysNotifyPlayerJoined boolean False Players will always get notified if someone joins the server
alwaysNotifyPlayerLeft boolean False Players will always get notified if someone leaves the server
allowThirdPersonPlayer boolean False Enables 3rd Person view
globalVoiceChat boolean False Voice chat turns global
ShowMapPlayerLocation boolean False Show each player their own precise position when they view their map
noTributeDownloads boolean False Disables downloading characters from other servers
proximityChat boolean False Only players near each other can see their chat messages
serverPVE boolean False Disables PvP, enables PvE
serverHardcore boolean False Enables hardcore mode (player characters revert to level 1 upon death)
serverForceNoHud boolean False HUD always disabled
bDisableStructureDecayPvE boolean False Disable the gradual (7 days) decay of player structures
bAllowFlyerCarryPvE boolean False Permit flying dinosaurs to pick up other dinosaurs and players when mounted by a player in PvE
MaxStructuresInRange integer Unknown Specifies the maximum number of structures that can be constructed within a certain (currently hard-coded) range.
MaxPlayers integer Unknown Specifies the maximum number of players that can play on the server simultaneously. Must be placed under [/script/engine.gamesession] in GameUserSettings.ini to function when not used in the command line.
DifficultyOffset float

0.0-1.0

Unknown Specifies the difficulty level of the creatures and the quality (and frequency) of loot spawned by the server. At 0.0, creatures and loot scale down by approximately 50%. At 1.0, they scale up by approximately 300%.[1]
ServerPassword string None If specified, players must provide this password to join the server.
ServerAdminPassword string None If specified, players must provide this password (via the in-game console) to gain access to administrator commands on the server.
DayCycleSpeedScale float 1.0 Specifies the scaling factor for the passage of time in the ARK, controlling how often day changes to night and night changes to day. The default value 1 provides the same cycle speed as the singleplayer experience (and the official public servers). Values lower than 1 slow down the cycle; higher values accelerate it. Base time when value is 1 appears to be 1 minute real time equals approx. 28 minutes game time. Thus, for an approximate 24 hour day/night cycle in game, use .035 for the value.
NightTimeSpeedScale float 1.0 Specifies the scaling factor for the passage of time in the ARK during night time. This value determines the length of each night, relative to the length of each day (as specified by DayTimeSpeedScale. Lowering this value increases the length of each night.
DayTimeSpeedScale float 1.0 Specifies the scaling factor for the passage of time in the ARK during the day. This value determines the length of each day, relative to the length of each night (as specified by NightTimeSpeedScale. Lowering this value increases the length of each day.
DinoDamageMultiplier float 1.0 Specifies the scaling factor for the damage dinosaurs deal with their attacks. The default value 1 provides normal damage. Higher values increase damage. Lower values decrease it.
PlayerDamageMultiplier float 1.0 Specifies the scaling factor for the damage players deal with their attacks. The default value 1 provides normal damage. Higher values increase damage. Lower values decrease it.
StructureDamageMultiplier float 1.0 Specifies the scaling factor for the damage structures deal with their attacks (i.e. spiked walls). The default value 1 provides normal damage. Higher values increase damage. Lower values decrease it.
PlayerResistanceMultiplier float 1.0 Specifies the scaling factor for the resistance to damage players receive when attacked. The default value 1 provides normal damage. Higher values decrease resistance, increasing damage per attack. Lower values increase it, reducing damage per attack. A value of 0.5 results in a player taking half damage while a value of 2.0 would result in taking double normal damage.
DinoResistanceMultiplier float 1.0 Specifies the scaling factor for the resistance to damage dinosaurs receive when attacked. The default value 1 provides normal damage. Higher values decrease resistance, increasing damage per attack. Lower values increase it, reducing damage per attack. A value of 0.5 results in a dino taking half damage while a value of 2.0 would result in a dino taking double normal damage.
StructureResistanceMultiplier float 1.0 Specifies the scaling factor for the resistance to damage structures receive when attacked. The default value 1 provides normal damage. Higher values decrease resistance, increasing damage per attack. Lower values increase it, reducing damage per attack. A value of 0.5 results in a structure taking half damage while a value of 2.0 would result in a structure taking double normal damage.
XPMultiplier float 1.0 Specifies the scaling factor for the experience received by players, tribes and dinosaurs for various actions. The default value 1 provides the same amounts of experience as in the singleplayer experience (and official public servers). Higher values increase XP amounts awarded for various actions; lower values decrease it.
PvEStructureDecayPeriodMultiplier float 1.0 Specifies the scaling factor for the decay rate of player structures in PvE mode. The specific effect(s) of this option and its range of valid values are unknown as of this writing.
PvEStructureDecayDestructionPeriod Unknown 0 Specifies the time required for player structures to decay in PvE mode. The specific effect(s) of this option and its range of valid values are unknown as of this writing.
ResourcesRespawnPeriodMultiplier float 1.0 Newly added and undocumented server config option - added to your config file automatically by release 180. Suspected purpose is to change the respawn rate of resource nodes, unknown how the value will effect respawn times though. Will update when purpose of value is confirmed along with understanding of how the mechanic effects gameplay.
TamingSpeedMultiplier float 1.0 Specifies the scaling factor for dinosaur taming speed. Higher values make taming faster.
HarvestAmountMultiplier float 1.0 Specifies the scaling factor for yields from all harvesting activities (chopping down trees, picking berries, carving carcasses, mining rocks, etc.). Higher values increase the amount of materials harvested with each strike.
HarvestHealthMultiplier float 1.0 Specifies the scaling factor for the "health" of items that can be harvested (trees, rocks, carcasses, etc.). Higher values increase the amount of damage (i.e. "number of strikes") such objects can withstand before being destroyed, which results in higher overall harvest yields.
PlayerCharacterWaterDrainMultiplier float 1.0 Specifies the scaling factor for player characters' water consumption. Higher values increase water consumption (player characters get thirsty faster).
PlayerCharacterFoodDrainMultiplier float 1.0 Specifies the scaling factor for player characters' food consumption. Higher values increase food consumption (player characters get hungry faster).
PlayerCharacterStaminaDrainMultiplier float 1.0 Specifies the scaling factor for player characters' stamina consumption. Higher values increase stamina consumption (player characters get tired faster).
PlayerCharacterHealthRecoveryMultiplier float 1.0 Specifies the scaling factor for player characters' health recovery. Higher values increase the recovery rate (player characters heal faster).
DinoCharacterFoodDrainMultiplier float 1.0 Specifies the scaling factor for dinosaurs' food consumption. Higher values increase food consumption (dinosaurs get hungry faster).
DinoCharacterStaminaDrainMultiplier float 1.0 Specifies the scaling factor for dinosaurs' stamina consumption. Higher values increase stamina consumption (dinosaurs get tired faster).
DinoCharacterHealthRecoveryMultiplier float 1.0 Specifies the scaling factor for dinosaurs' health recovery. Higher values increase the recovery rate (dinosaurs heal faster).
DinoCountMultiplier float 1.0 Specifies the scaling factor for dinosaur spawns. Higher values increase the number of dinosaurs spawned throughout the ARK.


.ini-Only Options

The following options can only be set in the [/script/shootergame.shootergamemode] section of Game.ini, located in the same folder as GameUserSettings.ini (see above for the location for each platform). Specifying them on the command line will have no effect.

Option Arguments Effects and Example

OverrideEngramEntries=(
EngramIndex=<index>
[,EngramHidden=<hidden>]
[,EngramPointsCost=<cost>]
[,EngramLevelRequirement=<level>]
[,RemoveEngramPreReq=<remove_prereq>])

index integer Engram to configure[note 1]
hidden true|false If true, hide the engram in the players' Engrams panel
cost integer Engram points needed to learn engram
level integer Minimum level needed to learn engram
remove_prereq true|false Engram points needed to learn engram
Configure the status and requirements for learning an engram. The EngramIndex argument is always required; the rest are optional, but at least one must be provided in order for the option to have any effect. The option may be repeated in GameUserSettings.ini once for each engram to be configured.

The examples provided here are split into multiple lines for space considerations. In the configuration file, an entry must be placed entirely on a single line. Multiple OverrideEngramEntities entries can be specified in the file, but EngramIndex values should not be repeated across multiple entries.

OverrideEngramEntities=(EngramIndex=0,
EngramHidden=false)
OverrideEngramEntities=(EngramIndex=1,
EngramHidden=false,EngramPointsCost=3,
EngramLevelRequirement=3,
RemoveEngramPreReq=true)

DinoSpawnWeightMultipliers=(
DinoNameTag=<tag>
,SpawnWeightMultiplier=<factor>]
[,OverrideSpawnLimitPercentage=<override>]
[,SpawnLimitPercentage=<limit>])

tag string Dinosaur type to adjust
factor true|false Weight factor for this type
override true|false If true, use the specified SpawnLimitPercentage
limit float Maximum percentage (among all spawns) for this type
Customizes the spawning rate for a given dinosaur type (at all dinosaur spawn points). Types with a larger SpawnWeightMultiplier are selected more often when spawning new dinosaurs than types with lower multipliers. When OverrideSpawnLimitPercentage is specified (and true), the type will never be spawned more than SpawnLimitPercentage * 100 percent of the time, regardless of multiplier. For example, a SpawnLimitPercentage of 0.25 specifies that the type will be selected for spawning no more than 25% of the time.

The examples provided here are split into multiple lines for space considerations. In the configuration file, an entry must be placed entirely on a single line. Multiple DinoSpawnWeightMultipliers entries can be specified in the file, but DinoNameTag values should not be repeated across multiple entries.

DinoSpawnWeightMultipliers=(DinoNameTag=Bronto,
SpawnWeightMultiplier=10.0,
OverrideSpawnLimitPercentage=true,
SpawnLimitPercentage=0.5)

The valid dinosaur type tags are:

  • Anky
  • Argent
  • Bat
  • Bronto
  • Carno
  • Coel
  • Dilo
  • Dodo
  • Mammoth
  • Mega
  • Para
  • Phiomia
  • Piranha
  • Ptera
  • Raptor
  • Rex
  • Sabertooth
  • Sarco
  • Scorpion
  • Stego
  • Spino
  • Spider
  • Titanboa
  • Trike
  • Turtle

LevelExperienceRampOverrides=(
ExperiencePointsForLevel[<n>]=<points>
[,ExperiencePointsForLevel[<n>]=<points>]
...
[,ExperiencePointsForLevel[<n>]=<points>])

n integer Level to configure
points integer Points needed to reach level
Configure the total number of levels available to players and dinosaurs and the experience points required to reach each level.

This directive can be specified twice in the configuration file. The first time it appears, the values provided will configure player levels. The second time it appears, the values provided will configure dinosaur levels.

Because of this, each time the directive is used, it must list all of the levels players (or dinosaurs) can reach on the server. One ExperiencePointsForLevel argument must appear for each desired level. Values for <n> must be sequential, starting from zero.

The examples provided here are split into multiple lines for space considerations. In the configuration file, an entry must be placed on a single line.

LevelExperienceRampOverrides=(
ExperiencePointsForLevel[0]=1,
ExperiencePointsForLevel[1]=5,
...
ExperiencePointsForLevel[64]=1000)
LevelExperienceRampOverrides=(
ExperiencePointsForLevel[0]=1,
ExperiencePointsForLevel[1]=5,
...
ExperiencePointsForLevel[34]=1000)

The first example specifies 65 player levels. The second example (when placed in the configuration file after the first example) specifies 35 dinosaur levels.

OverridePlayerLevelEngramPoints=<points>
points integer Engram points granted
Configure the number of engram points granted to players for each level gained.

This option must be repeated for each player level configured on the server; if there are 65 player levels available, this option should appear in the configuration file 65 times.

The first appearance of the option configures engram points for reaching level 1. The next one configures engram points for level 2, and so on all the way to the 65th appearance, which configures engram points for level 65.

OverridePlayerLevelEngramPoints=5
OverridePlayerLevelEngramPoints=10
...
OverridePlayerLevelEngramPoints=100

Administrator Whitelisting

Players can be whitelisted as administrators on the server via their SteamID. These players can use cheat commands on the server automatically, as if they'd authenticated themselves via the enablecheats command (described below).

To whitelist administrators, create the file ShooterGame/Saved/AllowedCheaterSteamIDs.txt. In the file, list each player's SteamID, one per line.

SteamIDs for all connected players can be listed in-game via the cheat ListPlayers command. Players can be kicked from the server (using their SteamIDs) via the cheat KickPlayer command. Refer to the following section for details.

Note: When this method is used, it's not necessary to specify a server administrator password. A password can still be specified, and can be used by players not on the whitelist to gain administrator privileges, but the server will function without it and will still automatically grant privileges to whitelisted administrators.

Server Administration and Client Commands

Some of these commands are not available until you have authenticated yourself with the enablecheats command and enabled cheats on your player character with the setcheatplayer command. Commands that work both on the server and in single-player mode don't need to be prefixed with "admincheat" if shown when they're being used in single-player mode.

Command Arguments Context Effects and Example
enablecheats <password>
password string Server administrator password
Server Enable server administrator commands for the current player. The password provided should match the server's ServerAdminPassword option (see above).

enablecheats pass123

setcheatplayer true|false true to enable, false to disable Server, local Enable cheat commands that affect the current player, mounted dinosaurs and the game world

setcheatplayer true

admincheat addexperience <amount> 0 <share>
amount integer Amount to add
share integer 1: player only
0: share with tribe
Server, local Adds the specified number of experience points to the player (or the currently mounted dinosaur if the player is mounted)

admincheat addexperience 1000 0 1

admincheat AllowPlayerToJoinNoCheck <player>
player string Player to whitelist
Server Adds the specified player to the server's whitelist.

admincheat AllowPlayerToJoinNoCheck Bob

admincheat Ban <player>
player string Player to ban
Server Add the specified player to the server's banned list.

admincheat Ban Bob

admincheat Broadcast <message>
player string Message to broadcast
Server Broadcast a message to all players on the server.

admincheat Broadcast Hi, everybody!

admincheat DamageTarget <amount>
damage integer Damage amount (in HP)
Server, local Deals the specified amount of damage to the creature or object in the player's crosshairs. Warning: this command can destroy the entire game map (including the terrain); its usage is not recommended.

admincheat DamageTarget 1000

admincheat DestroyAll <type>
type string Type to destroy
Server, local Destroys all creatures of the specified type.

admincheat DestroyAll Ankylo_Character_BP_C

admincheat destroyallenemies None Server, local Destroys all dinosaurs on the map. This does not prevent new ones from spawning as usual.

admincheat destroyallenemies

admincheat DisallowPlayerToJoinNoCheck <player>
player string Player to remove
Server Removes the specified player from the server's whitelist.

admincheat DisallowPlayerToJoinNoCheck Bob

admincheat EnemyInvisible true|false true to be ignored, false for normal behavior Server, local When enabled, all creatures on the map will ignore the current player, even when attacked.

admincheat EnemyInvisible true

admincheat ExecSetSleeping true|false true to put to sleep, false to wake up Server Puts the current player character to sleep or wakes them up.

admincheat ExecSetSleeping true

admincheat fly None Server, local Activates "fly mode", permitting the player character to move freely in any direction without physics or gravity being applied. Use the walk command to disable the mode.

admincheat fly

admincheat forcetame None Server, local Immediately tames the dinosaur under the player's crosshairs. Dinosaurs tamed with this command can be ridden even when no saddle is equipped.

admincheat forcetame

admincheat ghost None Server, local Toggles "ghost mode", permitting the player character to pass freely through objects in the world that normally block movement, including the terrain itself. Repeat the command to disable the mode.

admincheat ghost

admincheat GiveItemNum <item_id> <quantity> <quality> <blueprint>
item_id integer Item type to add
quantity integer Number of items to add
quality integer Quality of added items
blueprint boolean true to add the item's blueprint, false to add the item
Server, local Adds the specified item to the player's inventory (or its blueprint) in the specified quantity and with the specified quality.

admincheat GiveItemNum 1 1 1 false

admincheat giveresources None Server, local Add 50 units of each resource in the game to the player's inventory

admincheat giveresources

admincheat god None Server, local Toggles "god mode", making the player invulnerable to damage from attacks, explosions or from falling. This does not prevent player character death by drowning (infinitestats must be enabled to prevent this). Repeat the command to disable the mode.

admincheat god

admincheat HurtMe None Server, local Damages the player character.

admincheat HurtMe

admincheat infinitestats None Server, local Gives the player character infinite food, water, stamina, carrying capacity and keeps Torpor at zero. Repeat the command to disable its effects.

admincheat infinitestats

admincheat KickPlayer <steam_id>
steam_id string Player to kick[2]
Server Forcibly disconnect the specified player from the server.
admincheat ListPlayers None Server List all connected players and their SteamIDs.
admincheat PlayersOnly None Server, local Stops all creature movement in the game world and halts crafting. Players can still move normally. Repeat the command to disable its effects.

admincheat PlayersOnly

admincheat saveworld None Server, local Forces the server to save the game world to disk in its current state. In single-player mode, the game saves this information locally.

admincheat saveworld

admincheat SetMessageOfTheDay <message>
message string Message to use
Server Sets the server's "message of the day", displayed to players when they connect it.

admincheat SetMessageOfTheDay Beware the dodo.

admincheat SetPlayerPos <x> <y> <z>
x, y, z floats Coordinates to use
Server, local Moves the player character's to the specified position instantly.

admincheat SetPlayerPos -71467 -52156 0

admincheat settimeofday <hour>:<minute>[:<second>]
hour integer, 0-23
minute integer, 0-59
second integer, 0-59
(optional; defaults to 0)
Server, local Sets the game world's time of day to the specified time.

admincheat settimeofday 06:30:00

admincheat slomo <factor>
factor float
0.0-5.0
Speed multiplier; 0.0 to stop time completely, 1.0 for normal speed, higher values increase speed
Server, local Sets the speed of the passage of time on the server.

admincheat slomo 0.5

admincheat summon <type>
type string Type to summon
Server, local Spawn a creature of the specified type in front of the player character.

admincheat summon Ankylo_Character_BP_C

admincheat teleport None Server, local Moves the player character forward in the direction the player is facing until the character collides with an object or the terrain.

admincheat teleport

admincheat ToggleInfiniteAmmo None Server, local Provides unlimited ammunition for all of the player character's weapons. Repeat the command to disable its effects.

admincheat ToggleInfiniteAmmo

admincheat Unban <player>
player string Player to unban
Server Remove the specified player from the server's banned list.

admincheat Unban Bob

admincheat walk None Server, local Deactivates "fly mode" (activated by the fly command). Physics and gravity will be applied to the player character normally.

admincheat walk

admincheat giveengrams None Server, local Unlocks all crafting recipes for the player character. Warning: this may crash the game client or server (or both).[3]

admincheat giveengrams

stat fps None Server, local Enables an on-screen display showing the game's current FPS and frame display time. Repeat the command to disable its effects.

stat fps

togglegun None Server, local Prevents the player character's equipped item (or hands if nothing is equipped) from being displayed. Repeat the command to disable its effects.

togglegun

Notes

  1. A list of engrams is still needed.

References