INI Settings (4.x)

INI settings can be used to fine-tune how the mod works for your single-player game or dedicated server. The following settings go in GameUserSettings.ini under a section called [AuctionHouse].

-Quick Links- Private Market Settings Manifest & Transporter Settings Allow/Disallow Settings Hide Players/Servers Settings Min/Max Settings Currency Exchanger Settings Fee Settings Miscellaneous Settings select[name=”table-of-contents”] { width: 100%; background: #f0f0f0; border: none; color: #333; padding: 10px; } select[name=”table-of-contents”] option { color: #333; }

MarketID

A unique ID that is used to enable purchasing from, and selling to, other servers that are part of your private network. All servers in your network will need to have this value set to communicate with each other. Only use alphanumeric characters for this value! Do not use spaces, slashes, apostrophes, or any other special characters.

No default value. Should not contain special characters; spaces will be removed.

MarketID=MYMARKETID1234

ExtraPaymentClasses

The list of additional items that can be used to bid on and buyout auctions from an Auction House. Only works for servers using a private market (Market ID). As of the 4.x update this setting replaces the “ExtraCurrencyItems” setting.

No default value.

ExtraPaymentClasses=/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Gold.PrimalItemResource_AuctionHouseCoin_Gold

For example, to add the built-in copper, silver, gold, and platinum coins, you can use this setting:

ExtraPaymentClasses=/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Copper.PrimalItemResource_AuctionHouseCoin_Copper,/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Silver.PrimalItemResource_AuctionHouseCoin_Silver,/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Gold.PrimalItemResource_AuctionHouseCoin_Gold,/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Platinum.PrimalItemResource_AuctionHouseCoin_Platinum

Manifest & Transporter Settings

ManifestRange

The range that an inventory containing an inventory manifest must be within of an auctioneer for it to be detected.

Defaults to 10,000. Minimum value of 1,000; maximum value of 50,000.

ManifestRange=10000

TransporterRange

The range that a transporter must be within of an auctioneer or mailbox for it to be detected.

Defaults to 5,000. Minimum value of 1,000; maximum value of 25,000.

TransporterRange=5000

Allow/Disallow Settings

These settings control what can be purchased on, and sold from, your server, as well as which payments are allowed or disallowed.

AllowSingleplayer

Allows your server to trade with single-player games. If you are the admin of your server and you trust your players then you can set this to true to allow trades from single-player games to appear in search results. As of the 4.x update this setting replaces the “EnableSingleplayerTrades” setting.

Defaults to FALSE.

AllowSingleplayer=True

AllowSellingDisallowedItems

Allows players to sell items that are in the “Disallowed Item Classes” list and/or that are not in the “Allowed Item Classes” list. Items may not appear in search results but they will still appear in the “My Auctions” tab and the mailbox.

Defaults to FALSE.

AllowSellingDisallowedItems=True

AllowSellingDisallowedDinos

Allows players to sell dinos that are in the “Disallowed Dino Classes” list and/or that are not in the “Allowed Dino Classes” list. Dinos may not appear in search results but they will still appear in the “My Auctions” tab and the mailbox.

Defaults to FALSE.

AllowSellingDisallowedDinos=True

DisallowBlueprints

Disables the ability to purchase or list blueprints. As of the 4.x update this setting replaces the “DisableBlueprintTrades” setting.

Defaults to FALSE.

DisallowBlueprints=True

DisallowFlyerDinos

Disallows flyer dinos. Useful for Aberration servers. Auctions will appear in the search results but players will be unable to purchase them.

Defaults to FALSE.

DisallowFlyerDinos=True

DisallowWaterDinos

Disallows water dinos. (Why would you want to do this?) Auctions will appear in the search results but players will be unable to purchase them.

Defaults to FALSE.

DisallowWaterDinos=True

DisallowedSources

Disallows the specified sources (Core, Aberration, Mod, etc) from being purchased on, or sold from, your server. As of the 4.x update this setting replaces the “DisallowSources” setting.

Valid sources are:

  • Core
  • Aberration
  • Extinction
  • Genesis
  • Ragnarok
  • Scorched Earth
  • Valguero
  • Mod

No default value.

DisallowedSources=Core,Aberration,Extinction,Genesis,Scorched Earth,Ragnarok,Valguero,Mod

DisallowedPlayers

Disallows the specified Steam IDs from using the Auction House on your server. The specified players will still be able to use the Auction House on other servers as long as they aren’t also blacklisted there. As of the 4.x update this setting replaces the “PlayersBlacklist” setting.

No default value.

DisallowedPlayers=123456789,234567891,345678912

DisallowedItemClasses

The list of items or fertilized eggs that cannot be purchased by players. If this value is set then items in this list will not appear in search results. As of the 4.x update this setting replaces the “PurchaseBlacklist” setting.

No default value.

DisallowedItemClasses=/Game/PrimalEarth/CoreBlueprints/Weapons/PrimalItem_WeaponCrossbow.PrimalItem_WeaponCrossbow,/Game/PrimalEarth/CoreBlueprints/Weapons/PrimalItemAmmo_ArrowTranq.PrimalItemAmmo_ArrowTranq

AllowedItemClasses

The list of items or fertilized eggs that can be purchased by players. If this value is set then only items in this list will appear in search results. As of the 4.x update this setting replaces the “PurchaseWhitelist” setting.

No default value.

AllowedItemClasses=/Game/PrimalEarth/CoreBlueprints/Weapons/PrimalItem_WeaponCrossbow.PrimalItem_WeaponCrossbow,/Game/PrimalEarth/CoreBlueprints/Weapons/PrimalItemAmmo_ArrowTranq.PrimalItemAmmo_ArrowTranq

DisallowedDinoClasses

The list of creatures that cannot be purchased by players. If this value is set then creatures in this list will not appear in search results. As of the 4.x update this setting replaces the “DinoBlacklist” setting.

No default value.

DisallowedDinoClasses=/Game/PrimalEarth/Dinos/Dodo/Dodo_Character_BP.Dodo_Character_BP,/Game/PrimalEarth/Dinos/Giganotosaurus/Gigant_Character_BP.Gigant_Character_BP

AllowedDinoClasses

The list of creatures that can be purchased by players. If this value is set then only creatures in this list will appear in search results. As of the 4.x update this setting replaces the “DinoWhitelist” setting.

No default value.

AllowedDinoClasses=/Game/PrimalEarth/Dinos/Dodo/Dodo_Character_BP.Dodo_Character_BP,/Game/PrimalEarth/Dinos/Giganotosaurus/Gigant_Character_BP.Gigant_Character_BP

DisallowedPaymentClasses

The list of items that cannot be used to pay for auctions. If this value is set then auctions that ask for these items as payment won’t appear in search results. As of the 4.x update this setting replaces the “PaymentBlacklist” setting.

No default value.

DisallowedPaymentClasses=/Game/PrimalEarth/CoreBlueprints/Resources/PrimalItemResource_Element.PrimalItemResource_Element,/Game/PrimalEarth/CoreBlueprints/Resources/PrimalItemResource_MetalIngot.PrimalItemResource_MetalIngot

AllowedPaymentClasses

The list of items that can be be used to pay for auctions. If this value is set then only auctions that ask for these items as payment will appear in search results. As of the 4.x update this setting replaces the “PaymentWhitelist” setting.

No default value.

AllowedPaymentClasses=/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Gold.PrimalItemResource_AuctionHouseCoin_Gold

Hide Players/Servers Settings

HideServers (v3.2+)

Hides all auctions posted from the specified IP address from appearing in search results. If you don’t know a server’s IP address, you can ask for it in the Discord server.

No default value.

HideServers=IP1,IP2:OptionalPort,IP3

HidePlayers (v3.2+)

Hides all auctions posted by the specified Steam IDs from appearing in search results. This setting is useful for hiding that one guy from that one server that you really don’t like. If you don’t know the player’s Steam ID, you can ask for it in the Discord server.

No default value.

HidePlayers=SteamID1,SteamID2,SteamID3

Min/Max Settings

These settings control the min/max values for things like item quality, dino level, etc.

MaxItemQuality

The maximum quality index of items that will show up in search results. For example, 0 is primitive, 1 is ramshackle, etc. As of the 4.x update this setting replaces the “MaxItemQualityIndex” setting.

No default value. Minimum value of 0; maximum value of 255.

MaxItemQuality=1

MaxPaymentAmount

The maximum payment amount players can enter when creating auctions.

No default value. Minimum value of 1; maximum value of 50,000 for the public market; 100,000 for private markets.

MaxPaymentAmount=10000

MaxDinoLevel

The maximum base level (before level points have been applied) that will appear in search results when browsing dino auctions.

Defaults to the server-configured maximum. Minimum value of 1; maximum value of 65,535. Please mind that the absolute max dino base level in Ark is 1786.

MaxDinoLevel=200

Currency Exchanger Settings

ExchangerConfig

The configuration for all exchanges that the Currency Exchanger will allow players to craft. The format is below. Note the placement of commas, semicolons, and colons. A colon separates the receive and asking items, a semicolon separates exchanges, commas separate values.

As of the 4.x update this setting replaces the “CurrencyExchanger” setting.

The Admin Exchanger uses the same format but the setting is AdminExchangerConfig instead of ExchangerConfig.

A tool has been created to help server admins configure their currency exchangers. It can be found here.

The format is as follows:
ReceivedItem1,ReceivedQuantity1:AskingItem1a,AskingQuantity1a,AskingItem1b,AskingQuantity1b;ReceivedItem2,ReceivedQuantity2:AskingItem2a,AskingQuantity2a;

For example, to add exchanges that allow players to exchange 100 stone and 100 wood for 1 element, or 100 gold coins for 1 element, you can use this setting:

ExchangerConfig=/Game/PrimalEarth/CoreBlueprints/Resources/PrimalItemResource_Element.PrimalItemResource_Element,1:/Game/PrimalEarth/CoreBlueprints/Resources/PrimalItemResource_Stone.PrimalItemResource_Stone,100,/Game/PrimalEarth/CoreBlueprints/Resources/PrimalItemResource_Wood.PrimalItemResource_Wood,100;/Game/PrimalEarth/CoreBlueprints/Resources/PrimalItemResource_Element.PrimalItemResource_Element,1:/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Gold.PrimalItemResource_AuctionHouseCoin_Gold,100;

For example, to add exchanges that allow players to exchange 100 copper coins for 1 silver coin, 100 silver coins for 1 gold coin, 100 gold coins for 1 platinum coin, as well as the inverse, you can use this setting:

ExchangerConfig=/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Silver.PrimalItemResource_AuctionHouseCoin_Silver,1:/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Copper.PrimalItemResource_AuctionHouseCoin_Copper,100;/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Gold.PrimalItemResource_AuctionHouseCoin_Gold,1:/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Silver.PrimalItemResource_AuctionHouseCoin_Silver,100;/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Platinum.PrimalItemResource_AuctionHouseCoin_Platinum,1:/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Gold.PrimalItemResource_AuctionHouseCoin_Gold,100;/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Copper.PrimalItemResource_AuctionHouseCoin_Copper,100:/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Silver.PrimalItemResource_AuctionHouseCoin_Silver,1;/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Silver.PrimalItemResource_AuctionHouseCoin_Silver,100:/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Gold.PrimalItemResource_AuctionHouseCoin_Gold,1;/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Gold.PrimalItemResource_AuctionHouseCoin_Gold,100:/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Platinum.PrimalItemResource_AuctionHouseCoin_Platinum,1;

Fee Settings

FeeOverrideClass

The item to use for the fee instead of metal ingots. Use this setting if you want your players to pay the fee with another resource (coins, etc) instead of metal ingots. As of the 4.x update this setting replaces the “FeeCurrencyOverride” setting.

No default value.

FeeOverrideClass=/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Copper.PrimalItemResource_AuctionHouseCoin_Copper

FeeFlatAmount

The flat amount to charge for the fee when creating auctions. This will disable the percent-based fee and will instead charge a flat amount for each listing. For example, if you are using coins on your server and only want to charge 5 coins per auction then set this value to 5.

No default value. Minimum value of 1; maximum value of 20,000.

FeeFlatAmount=5

Misc Settings

ExtraMods

Specifies the list of mod directories that the mod didn’t automatically detect (this is rare but can happen for a variety of reasons).

The mod directory for a mod can be extracted from any of the spawn commands provided by the mod. Using the TC’s Auto Rewards mod as an example, if the spawn command is:

Blueprint'/Game/Mods/TCsAutoRewards/Main/Currency/PrimalItemConsumable_TCsAR_CurrencyARc.PrimalItemConsumable_TCsAR_CurrencyARc'

Then the mod directory would be:

TCsAutoRewards

No default value.

ExtraMods=ModDirectory1,ModDirectory2

Password

Sets the password for access your server transactions using the Transactions Manager web app. Only use alphanumeric characters for this value! Do not use spaces, slashes, apostrophes, or any other special characters.

No default value.

Password=MyPassword12345

Port

Optional. Sets the reported port for your server. Used exclusively by the “HideServers” INI setting.

No default value.

Port=12345

HarvestAmountMultiplier

Allows you to specify an override for the server-configured Harvest Amount Multiplier (“HAM”). Since the HAM value is used to calculate the maximum buyout amount for a server, setting this value will not only change the amount you receive when claiming specific auctions and the amount you can ask for when creating auctions, but it will also increase the amount you pay when purchasing auctions.

Defaults to the server-configured Harvest Amount Multiplier (1x, 2x, 5x, etc). Minimum value of 1; maximum value of 10.

HarvestAmountMultiplier=5

CreatureSpecies

Allows you to change the creatures used for auctioneers. Valid options are:

  • Monkey
  • Human
  • Hidden

Defaults to “Monkey“.

CreatureSpecies=Human

CompanionSpecies

Allows you to change the creatures used for auctioneer companions. Valid options are:

  • Monkey
  • Bulbdog
  • Ferox
  • Jerboa
  • Hidden

Defaults to “Monkey“.

CompanionSpecies=Bulbdog