Difference between revisions of "Hosting"
(→Authorization) |
(→Frequently Asked Questions) |
||
(97 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
This page contains all information needed if you wish to host your own Ark Arena server instance. | This page contains all information needed if you wish to host your own Ark Arena server instance. | ||
− | + | <b>Ark Arena is absolutely free to install for anyone who wants to run an Arena server. </b> | |
− | == | + | == Configuration == |
− | === | + | === Environment === |
− | + | At this time, Arena is only guaranteed to run correctly on a dedicated server with direct box access. Although it is possible to run in a shared hosting environment, success it not guarenteed. | |
− | |||
− | |||
− | |||
− | + | If you would like to run Arena in a shared hosting environment, our recommendation is [https://pingperfect.com PingPerfect]. This host has been tested and verified to work with Arena. We receive no revenue for this recommendation. | |
=== Mod Map ID === | === Mod Map ID === | ||
Line 17: | Line 14: | ||
=== Map Name === | === Map Name === | ||
ArenaModMap | ArenaModMap | ||
+ | |||
+ | === Server Launch Arguments === | ||
+ | -culture=en | ||
=== GameUserSettings.ini === | === GameUserSettings.ini === | ||
− | Add the following to the bottom of your GameUserSettings.ini file | + | Add the following to the bottom of your GameUserSettings.ini file. For most setups, these are the only parameters you should need to set manually. |
PreventDownloadSurvivors=true | PreventDownloadSurvivors=true | ||
PreventDownloadItems=true | PreventDownloadItems=true | ||
Line 37: | Line 37: | ||
ElementShardsMultiplier=1.0 | ElementShardsMultiplier=1.0 | ||
LeaderboardName=YOUR COMMUNITY NAME HERE | LeaderboardName=YOUR COMMUNITY NAME HERE | ||
+ | |||
+ | ==== Configurations Details ==== | ||
+ | All configurations go in the [ArkArena] section of GameUserSettings.ini. | ||
+ | |||
+ | In most circumstances, only the <strong>required</strong> properties should be used. | ||
+ | |||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! Configuration !! Required !! Type !! Description !! Default Value | ||
+ | |- | ||
+ | | StartingElementShardsQuantity || yes || number || The amount of element shards a player will have the first time they join the server || 0 | ||
+ | |- | ||
+ | | ElementShardsMultiplier || yes || number || The rate at which players will earn element shards || 1.0 | ||
+ | |- | ||
+ | | LeaderboardName || yes || text || The name of your leaderboard for tracking player stats. Please use a unique name. || "" | ||
+ | |- | ||
+ | | DisableGold || no || true/false || Disables purchases of gold and spending gold in the Collection tab || false | ||
+ | |- | ||
+ | | AFKTimeout || no || number || Set your maximum AFK time in seconds. We recommend 900 (15 minutes). <br> If players are AFK longer than this time they will be removed from the server.<br>Disabled if set to 0 or not used || 0 | ||
+ | |- | ||
+ | | ClusterMode || no || number || Useful when running multiple Arena servers in a cluster.<br> <strong>In most circumstances this parameter should not be used</strong> <br>0 = Cluster Mode disabled. <br>1 = Deathmatch game modes only. <br>2 = Capture the Artifact only || 0 | ||
+ | |- | ||
+ | | DynamicShardsMultiplier || no || true/false || When enabled, the Element shard multiplier can be changed while the server is active using a cheat command.<br>See [[Hosting#Cheat_Commands|Cheat Commands]] for details || false | ||
+ | |} | ||
=== Game.ini === | === Game.ini === | ||
Line 53: | Line 77: | ||
GlobalCorpseDecompositionTimeMultiplier=0.1 | GlobalCorpseDecompositionTimeMultiplier=0.1 | ||
HairGrowthSpeedMultiplier=1000.0 | HairGrowthSpeedMultiplier=1000.0 | ||
+ | OverrideNamedEngramEntries=(EngramClassName="EngramEntry_TekBoots_C",EngramLevelRequirement=0,EngramPointsCost=0,EngramHidden=False,RemoveEngramPreReq=True) | ||
+ | OverrideNamedEngramEntries=(EngramClassName="EngramEntry_TekGloves_C",EngramLevelRequirement=0,EngramPointsCost=0,EngramHidden=False,RemoveEngramPreReq=True) | ||
+ | OverrideNamedEngramEntries=(EngramClassName="EngramEntry_TekHelmet_C",EngramLevelRequirement=0,EngramPointsCost=0,EngramHidden=False,RemoveEngramPreReq=True) | ||
+ | OverrideNamedEngramEntries=(EngramClassName="EngramEntry_TekPants_C",EngramLevelRequirement=0,EngramPointsCost=0,EngramHidden=False,RemoveEngramPreReq=True) | ||
+ | OverrideNamedEngramEntries=(EngramClassName="EngramEntry_TekShirt_C",EngramLevelRequirement=0,EngramPointsCost=0,EngramHidden=False,RemoveEngramPreReq=True) | ||
+ | OverrideNamedEngramEntries=(EngramClassName="EngramEntry_SpaceDolphin_Saddle_C",EngramLevelRequirement=0,EngramPointsCost=0,EngramHidden=False,RemoveEngramPreReq=True) | ||
+ | EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TekBoots_C",LevelToAutoUnlock=0) | ||
+ | EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TekGloves_C",LevelToAutoUnlock=0) | ||
+ | EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TekHelmet_C",LevelToAutoUnlock=0) | ||
+ | EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TekPants_C",LevelToAutoUnlock=0) | ||
+ | EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TekShirt_C",LevelToAutoUnlock=0) | ||
+ | EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_SpaceDolphin_Saddle_C",LevelToAutoUnlock=0) | ||
=== Extra Files === | === Extra Files === | ||
Line 59: | Line 95: | ||
https://drive.google.com/file/d/10FsqdsRwnxGCEA-4u1y-n7j7mb6IlRDD/view?usp=sharing | https://drive.google.com/file/d/10FsqdsRwnxGCEA-4u1y-n7j7mb6IlRDD/view?usp=sharing | ||
+ | |||
+ | == In-Game Shop == | ||
+ | === Additional Items === | ||
+ | At this time there is no ability to customize the In-Game shop through configuration. If there are additional items you would like to add to the Arena shop, please [[Hosting#Contact|Contact Metsfan in Discord]]. | ||
+ | |||
+ | If an item is added to the in-game shop it will be available for all Arena servers. At this time we do not support server-specific items. | ||
+ | |||
+ | === Gold === | ||
+ | Unfortunately Server owners cannot modify the Gold system in any way. All revenue earned from Gold will go to the mod developer unless otherwise discussed with the mod developer. | ||
+ | |||
+ | If this is an issue, you can choose to disable Gold through configuration. See the [[Hosting#Configurations_Details|Configuration]] section for details. | ||
+ | |||
+ | Gold cannot be given through cheat commands. The only way to receive Gold is by purchasing it in the Arena shop, or through a gift directly from the mod developer. | ||
+ | |||
+ | ==== Revenue Sharing ==== | ||
+ | If you would like to add new cosmetic items to the shop which are your own intellectual property, please [[Hosting#Contact|Contact Metsfan in Discord]] and we can discuss a revenue sharing opportunity. | ||
+ | |||
+ | == Cheat Commands == | ||
+ | |||
+ | Server admins will have access to the following custom cheat commands | ||
+ | |||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! Command Syntax !! Description !! Notes !! Example | ||
+ | |- | ||
+ | | cheat scriptcommand addcurrency <steamid> <amount> || Give Element Shards to a specific player || amount should be a number || cheat scriptcommand addcurrency 76561198027275868 10000 | ||
+ | |- | ||
+ | | cheat scriptcommand addcurrency <amount> || Give Element Shards to the current player || amount should be a number || cheat scriptcommand addcurrency 10000 | ||
+ | |- | ||
+ | | cheat scriptcommand addgamecurrency <steamid> <amount> || Give Hexagons to a specific player in Capture the Artifact || amount should be a number || cheat scriptcommand addgamecurrency 76561198027275868 5000 | ||
+ | |- | ||
+ | | cheat scriptcommand addgamecurrency <amount> || Give Hexagons to the current player in Capture the Artifact || amount should be a number || cheat scriptcommand addgamecurrency 5000 | ||
+ | |- | ||
+ | | cheat scriptcommand endcta <result> || Prematurely end a Capture the Artifact game || Values for result:<br>0 = Draw<br>1 = Red Team wins<br>2 = Blue Team wins || cheat scriptcommand endcta 0 | ||
+ | |- | ||
+ | | cheat scriptcommand setshardrate <rate> || Update the Element Shards multiplier for the current session.<br>This value will be lost if the server is restarted || rate should be at least 1.0. Decimals are allowed<br>Requires DynamicShardsMultiplier=true in the [ArkArena] configuration section.<br>See [[Hosting#Configurations_Details|Configuration]] for details. || cheat scriptcommand setshardrate 1.5 | ||
+ | |} | ||
+ | |||
+ | == Frequently Asked Questions == | ||
+ | |||
+ | '''How do I reset my leaderboard?'''<br> | ||
+ | To reset your leaderboard: | ||
+ | |||
+ | # Go into your GameUserSettings.ini in the [ArkArena] section and change the LeaderboardName property to something new. | ||
+ | # In your ark server installation, delete the following directory | ||
+ | <ArkInstallation>/ShooterGame/Saved/SaveGames/ArkArena/Ratings | ||
+ | |||
+ | '''How do I wipe an individual player's items and shards?'''<br> | ||
+ | In your ark server, visit the following directory, and delete the file <Steam64ID>.sav | ||
+ | <ArkInstallation>/ShooterGame/Saved/SaveGames/ArkArena | ||
+ | |||
+ | '''How do I wipe items and shards for all players?'''<br> | ||
+ | In your ark server, visit the following directory, and delete all files ending in .sav | ||
+ | <ArkInstallation>/ShooterGame/Saved/SaveGames/ArkArena | ||
+ | |||
+ | '''Can I monetize my Arena server?'''<br> | ||
+ | Yes, you may sell whatever products you want on your Arena server, as long as you have the rights to sell whatever you are selling. | ||
+ | |||
+ | '''Who gets the revenue from Gold?'''<br> | ||
+ | All revenue earned from Gold will go to the mod developer. Unfortunately this cannot be changed. See [[Hosting#Gold|Gold]] for more details. | ||
+ | |||
+ | '''Can I run other mods or plugins on my Arena server?'''<br> | ||
+ | Most mods and plugins should work together with Arena. However Arena does override some base game functionality which can cause certain mods to not work correctly. If you want to run a specific mod which is not working correctly with Arena, please contact Metsfan in discord, however there is no guarantee that the changes will be possible. |
Latest revision as of 14:58, 1 May 2022
This page contains all information needed if you wish to host your own Ark Arena server instance.
Ark Arena is absolutely free to install for anyone who wants to run an Arena server.
Contents
Configuration
Environment
At this time, Arena is only guaranteed to run correctly on a dedicated server with direct box access. Although it is possible to run in a shared hosting environment, success it not guarenteed.
If you would like to run Arena in a shared hosting environment, our recommendation is PingPerfect. This host has been tested and verified to work with Arena. We receive no revenue for this recommendation.
Mod Map ID
1517538187
Map Name
ArenaModMap
Server Launch Arguments
-culture=en
GameUserSettings.ini
Add the following to the bottom of your GameUserSettings.ini file. For most setups, these are the only parameters you should need to set manually.
PreventDownloadSurvivors=true PreventDownloadItems=true PreventDownloadDinos=true PreventUploadSurvivors=true PreventUploadItems=true PreventUploadDinos=true XPMultiplier=10.0 StructureResistanceMultiplier=2.0 EnablePvPGamma=true DifficultyOffset=0.0 PreventTribeAlliances=true PreventSpawnAnimations=true [ArkArena] StartingElementShardsQuantity=10000 ElementShardsMultiplier=1.0 LeaderboardName=YOUR COMMUNITY NAME HERE
Configurations Details
All configurations go in the [ArkArena] section of GameUserSettings.ini.
In most circumstances, only the required properties should be used.
Configuration | Required | Type | Description | Default Value |
---|---|---|---|---|
StartingElementShardsQuantity | yes | number | The amount of element shards a player will have the first time they join the server | 0 |
ElementShardsMultiplier | yes | number | The rate at which players will earn element shards | 1.0 |
LeaderboardName | yes | text | The name of your leaderboard for tracking player stats. Please use a unique name. | "" |
DisableGold | no | true/false | Disables purchases of gold and spending gold in the Collection tab | false |
AFKTimeout | no | number | Set your maximum AFK time in seconds. We recommend 900 (15 minutes). If players are AFK longer than this time they will be removed from the server. Disabled if set to 0 or not used |
0 |
ClusterMode | no | number | Useful when running multiple Arena servers in a cluster. In most circumstances this parameter should not be used 0 = Cluster Mode disabled. 1 = Deathmatch game modes only. 2 = Capture the Artifact only |
0 |
DynamicShardsMultiplier | no | true/false | When enabled, the Element shard multiplier can be changed while the server is active using a cheat command. See Cheat Commands for details |
false |
Game.ini
Add the following to the [/script/shootergame.shootergamemode] section of your Game.ini file
[/script/shootergame.shootergamemode] IncreasePvPRespawnIntervalBaseAmount=0 IncreasePvPRespawnIntervalCheckPeriod=30 IncreasePvPRespawnIntervalMultiplier=1 bIncreasePvPRespawnInterval=false LimitTurretsNum=5 GlobalSpoilingTimeMultiplier=5.0 ConfigOverrideItemMaxQuantity=(ItemClassString="PrimalItemConsumable_RawMutton_C",Quantity=(MaxItemQuantity=200, bIgnoreMultiplier=true)) ConfigOverrideItemMaxQuantity=(ItemClassString="PrimalItemConsumable_RawPrimeMeat_C",Quantity=(MaxItemQuantity=200, bIgnoreMultiplier=true)) bDisableFriendlyFire=true PoopIntervalMultiplier=1000 GlobalCorpseDecompositionTimeMultiplier=0.1 HairGrowthSpeedMultiplier=1000.0 OverrideNamedEngramEntries=(EngramClassName="EngramEntry_TekBoots_C",EngramLevelRequirement=0,EngramPointsCost=0,EngramHidden=False,RemoveEngramPreReq=True) OverrideNamedEngramEntries=(EngramClassName="EngramEntry_TekGloves_C",EngramLevelRequirement=0,EngramPointsCost=0,EngramHidden=False,RemoveEngramPreReq=True) OverrideNamedEngramEntries=(EngramClassName="EngramEntry_TekHelmet_C",EngramLevelRequirement=0,EngramPointsCost=0,EngramHidden=False,RemoveEngramPreReq=True) OverrideNamedEngramEntries=(EngramClassName="EngramEntry_TekPants_C",EngramLevelRequirement=0,EngramPointsCost=0,EngramHidden=False,RemoveEngramPreReq=True) OverrideNamedEngramEntries=(EngramClassName="EngramEntry_TekShirt_C",EngramLevelRequirement=0,EngramPointsCost=0,EngramHidden=False,RemoveEngramPreReq=True) OverrideNamedEngramEntries=(EngramClassName="EngramEntry_SpaceDolphin_Saddle_C",EngramLevelRequirement=0,EngramPointsCost=0,EngramHidden=False,RemoveEngramPreReq=True) EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TekBoots_C",LevelToAutoUnlock=0) EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TekGloves_C",LevelToAutoUnlock=0) EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TekHelmet_C",LevelToAutoUnlock=0) EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TekPants_C",LevelToAutoUnlock=0) EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TekShirt_C",LevelToAutoUnlock=0) EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_SpaceDolphin_Saddle_C",LevelToAutoUnlock=0)
Extra Files
Extract the following zip file into the directory on your server
<ArkInstallation>/ShooterGame/Saved/SaveGames/ArkArena/Structures
https://drive.google.com/file/d/10FsqdsRwnxGCEA-4u1y-n7j7mb6IlRDD/view?usp=sharing
In-Game Shop
Additional Items
At this time there is no ability to customize the In-Game shop through configuration. If there are additional items you would like to add to the Arena shop, please Contact Metsfan in Discord.
If an item is added to the in-game shop it will be available for all Arena servers. At this time we do not support server-specific items.
Gold
Unfortunately Server owners cannot modify the Gold system in any way. All revenue earned from Gold will go to the mod developer unless otherwise discussed with the mod developer.
If this is an issue, you can choose to disable Gold through configuration. See the Configuration section for details.
Gold cannot be given through cheat commands. The only way to receive Gold is by purchasing it in the Arena shop, or through a gift directly from the mod developer.
Revenue Sharing
If you would like to add new cosmetic items to the shop which are your own intellectual property, please Contact Metsfan in Discord and we can discuss a revenue sharing opportunity.
Cheat Commands
Server admins will have access to the following custom cheat commands
Command Syntax | Description | Notes | Example |
---|---|---|---|
cheat scriptcommand addcurrency <steamid> <amount> | Give Element Shards to a specific player | amount should be a number | cheat scriptcommand addcurrency 76561198027275868 10000 |
cheat scriptcommand addcurrency <amount> | Give Element Shards to the current player | amount should be a number | cheat scriptcommand addcurrency 10000 |
cheat scriptcommand addgamecurrency <steamid> <amount> | Give Hexagons to a specific player in Capture the Artifact | amount should be a number | cheat scriptcommand addgamecurrency 76561198027275868 5000 |
cheat scriptcommand addgamecurrency <amount> | Give Hexagons to the current player in Capture the Artifact | amount should be a number | cheat scriptcommand addgamecurrency 5000 |
cheat scriptcommand endcta <result> | Prematurely end a Capture the Artifact game | Values for result: 0 = Draw 1 = Red Team wins 2 = Blue Team wins |
cheat scriptcommand endcta 0 |
cheat scriptcommand setshardrate <rate> | Update the Element Shards multiplier for the current session. This value will be lost if the server is restarted |
rate should be at least 1.0. Decimals are allowed Requires DynamicShardsMultiplier=true in the [ArkArena] configuration section. See Configuration for details. |
cheat scriptcommand setshardrate 1.5 |
Frequently Asked Questions
How do I reset my leaderboard?
To reset your leaderboard:
- Go into your GameUserSettings.ini in the [ArkArena] section and change the LeaderboardName property to something new.
- In your ark server installation, delete the following directory
<ArkInstallation>/ShooterGame/Saved/SaveGames/ArkArena/Ratings
How do I wipe an individual player's items and shards?
In your ark server, visit the following directory, and delete the file <Steam64ID>.sav
<ArkInstallation>/ShooterGame/Saved/SaveGames/ArkArena
How do I wipe items and shards for all players?
In your ark server, visit the following directory, and delete all files ending in .sav
<ArkInstallation>/ShooterGame/Saved/SaveGames/ArkArena
Can I monetize my Arena server?
Yes, you may sell whatever products you want on your Arena server, as long as you have the rights to sell whatever you are selling.
Who gets the revenue from Gold?
All revenue earned from Gold will go to the mod developer. Unfortunately this cannot be changed. See Gold for more details.
Can I run other mods or plugins on my Arena server?
Most mods and plugins should work together with Arena. However Arena does override some base game functionality which can cause certain mods to not work correctly. If you want to run a specific mod which is not working correctly with Arena, please contact Metsfan in discord, however there is no guarantee that the changes will be possible.