INI Settings

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


Private Market Settings

These settings will only go into effect if you specify a unique Market ID. Custom currencies (Megapithecus Coins, Glory Coins, etc) can only be used on private markets.

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.

This item was previous known as “ClusterToken” but was renamed because it was confusing.

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

MarketID=MYMARKETID1234

ExtraCurrencyItems

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

No default value.

ExtraCurrencyItems=PrimalItemResource_AuctionHouseCoin_C

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

Whitelist/Blacklist Settings

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

DisableCreaturePurchasing

Disables the ability to purchase creatures using a Stockman.

Defaults to FALSE.

DisableCreaturePurchasing=False

DisableCreatureSelling

Disables the ability to sell creatures using a Stockman.

Defaults to FALSE.

DisableCreatureSelling=False

DisableFertilizedEggPurchasing

Disables the ability to purchase fertilized eggs using a Hatchery.

Defaults to FALSE.

DisableFertilizedEggPurchasing=False

DisableFertilizedEggSelling

Disables the ability to sell fertilized eggs using a Hatchery.

Defaults to FALSE.

DisableFertilizedEggSelling=False

DisableItemPurchasing

Disables the ability to purchase items using an Auctioneer.

Defaults to FALSE.

DisableItemPurchasing=False

DisableItemSelling

Disables the ability to sell items using an Auctioneer.

Defaults to FALSE.

DisableItemSelling=False

DisableBlueprintTrades

Disables the ability to purchase blueprints.

Defaults to FALSE.

DisableBlueprintTrades=True

EnableSingleplayerTrades

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 show up in the search results.

Defaults to FALSE.

EnableSingleplayerTrades=True

PurchaseBlacklist

The list of items or fertilized eggs that cannot be purchased from an Auction House.

No default value.

PurchaseBlacklist=PrimalItem_WeaponCrossbow_C,PrimalItemAmmo_RefinedTranqDart_C

PurchaseWhitelist

The list of items or fertilized eggs that can be purchased from an Auction House. If this value is set then only items in this list will show up in search results.

No default value.

PurchaseWhitelist=PrimalItem_WeaponCrossbow_C,PrimalItemAmmo_RefinedTranqDart_C

DinoBlacklist

The list of dinos that cannot be purchased from an Auction House.

No default value.

DinoBlacklist=Dodo_Character_BP_C,Gigant_Character_BP_C

DinoWhitelist

The list of dinos that can be purchased from the Auction House.

No default value.

DinoWhitelist=Dodo_Character_BP_C,Gigant_Character_BP_C

PaymentBlacklist

The list of items that cannot be used to pay for items at an Auction House. If this value is set then search results won’t show items that ask for these items as payment.

No default value.

PaymentBlacklist=PrimalItemResource_Wood_C,PrimalItemResource_MetalIngot_C

PaymentWhitelist

The list of items that can be be used to pay for items at an Auction House. If this value is set then search results will only show items that ask for these items as payment.

No default value.

PaymentWhitelist=PrimalItemResource_AuctionHouseCoin_C

PlayersBlacklist

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 blacklisted there also.

No default value.

PlayersBlacklist=123456789,234567891,345678912

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

DisallowSources (v3.2+)

Disallows the specified sources (Core, Aberration, Mod, etc) from being purchased on, or sold from, your server.

No default value.

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

Hide Players/Servers Settings

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

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,IP3

Min/Max Settings

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

MaxItemQualityIndex

The maximum quality index of items that will show up in search results. For example, 0 is primitive, 1 is ramshackle, etc.

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

MaxItemQualityIndex=1

MaxPaymentAmount

The maximum payment amount players can enter when creating auctions.

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

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.

MaxDinoLevel=200

Currency Exchanger Settings

CurrencyExchanger

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.

The Admin Currency Exchanger uses the same format but the setting is AdminCurrencyExchanger instead of CurrencyExchanger.

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;

CurrencyExchanger=PrimalItemResource_Element_C,1:PrimalItemResource_Stone_C,10,PrimalItemResource_Wood_C,10;PrimalItemResource_Element_C,10:PrimalItemResource_AuctionHouseCoin_C,100;

Fee Settings

FeeCurrencyOverride

The item to use for the fee instead of the default. The default item to use is metal ingots, so use this setting if you want your players to pay the fee with another resource, coins, etc, instead of metal ingots. Only works for servers using a private market (Market ID).

No default value.

FeeCurrencyOverride=PrimalItemResource_MetalIngot_C

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

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

World Scan Settings

These settings pertain to the world scan. The world scan happens once on startup and then periodically (every 60 minutes) to keep a running list of any classes it detects in the world.

DisableInitialScan (v3.2+)

Disables the initial world scan that happens once on startup. The initial world scan usually takes a while to complete but runs in the background. It scans engram entries, spawn regions, creature remaps, etc. If your server is experiencing issues on startup then try setting this value to TRUE.

Defaults to FALSE.

DisableWorldScan=True

DisablePeriodicScan (v3.2+)

Disables the periodic world scan that happens every 60 minutes. Periodic scans are usually short but run in the background. They scan nearby creatures, players, and structure inventories. If your server is experiencing issues periodically then try setting this value to TRUE.

Defaults to FALSE.

DisablePeriodicScan=True

PeriodicScanInterval (v3.2+)

The number of seconds between periodic scans. If your server is experiencing issues periodically then try increasing this value or disabling periodic scans.

Defaults to 3600 (1 hour). Clamped between 600 (10 minutes) and 21600 (6 hours).

PeriodicScanInterval=21600

ScanCycleInterval (v3.2+)

The number of seconds between scan cycles during initial and periodic scans. To reduce the amount of strain on servers, each scan is broken down into cycles where X classes are scanned per cycle. If your server is experiencing a noticeable amount of lag or rubber-banding during scans then try increasing this value.

Defaults to 2. Clamped between 1 and 60 (1 minute).

ScanCycleInterval=60

ScanCycleNumItemClasses (v3.2+)

The number of item classes to scan during each cycle. If your server is experiencing a noticeable amount of lag or rubber-banding during scans then try lowering this value.

Defaults to 25. Clamped between 0 and 100.

ScanCycleNumItemClasses=5

ScanCycleNumCreatureClasses (v3.2+)

The number of creature classes to scan during each cycle. If your server is experiencing a noticeable amount of lag or rubber-banding during scans then try lowering this value.

Defaults to 10. Clamped between 0 and 100.

ScanCycleNumCreatureClasses=5

ScanMaxNearbyCreatures (v3.2+)

The number of nearby creatures to scan during each cycle. If your server is experiencing a noticeable amount of lag or rubber-banding during scans then try lowering this value.

Defaults to 20. Clamped between 0 and 100.

ScanMaxNearbyCreatures=5

ScanMaxNearbyCreatureInventories (v3.2+)

The number of nearby creature inventories to scan during each cycle. If your server is experiencing a noticeable amount of lag or rubber-banding during scans then try lowering this value.

Defaults to 20. Clamped between 0 and 100.

ScanMaxNearbyCreatureInventories=5

ScanMaxNearbyStructureInventories (v3.2+)

The number of nearby structure inventories to scan during each cycle. If your server is experiencing a noticeable amount of lag or rubber-banding during scans then try lowering this value.

Defaults to 20. Clamped between 0 and 100.

ScanMaxNearbyStructureInventories=5

ScanMaxNearbyInventoryItems (v3.2+)

The number of items in a given inventory (creature, player, or structure) to scan during each cycle. If your server is experiencing a noticeable amount of lag or rubber-banding during scans then try lowering this value.

Defaults to 50. Clamped between 0 and 1,000.

ScanMaxNearbyInventoryItems=100