Auction House

by Ghazlawl

Upcoming Changes

The following changes will be coming in the v2.0 release.

  • Created web interface so admins can view transactions for their server.
  • Optimized replication for our friends using overseas internet. (Structures should no longer cause lag spikes when coming back into replication range.) This change applies to the auctioneer, stockman, and mailbox.
  • Optimized icon brushes for Browse UI and Mailbox UI. (Icon is now cached instead of being redrawn each tick.)
  • Added average price panel to the Create Auction UI. Average prices will be displayed for the currently-selected quantity/quality for items and level for dinos (genders, mutations, etc will be introduced in a later update) per Market ID.
  • Added Auction House Replicator buff that chunk replicates classes from the server to clients which helps dramatically with freezes when placing down auctioneers or coming within replication range of an auctioneer.
  • Added Currency Exchanger to Clean Up menu.
  • Added missing creatures to the families filter dropdown when browsing auctions.
  • Added a ’14 Day (2 Weeks)’ option to the duration dropdown when creating auctions.
  • Added ‘Max Dino Level’ to Debug UI.
  • Added highest bidder text ot the Browse UI.
  • Added debug flag to test INI settings for structure decay.
  • Fixed inability to reclaim lost bids. (This is a retroactive change; all lost bids will now appear in the Mailbox UI for 14 days.)
  • Fixed inability to place mailbox underwater in certain situations.
  • Fixed bug where searching for ‘blueprint’ when browsing dinos would cause a network error.
  • Fixed HTML appearing in artifact descriptions in the Browse UI and Mailbox UI.
  • Fixed false positive for “Rex_Character_BP_C” when “IndominusRex_Character_BP_C” is blacklisted but not both.
  • Changed transporter to take the offset of the dino being claimed into account when trying to spawn it into the world. This should drastically reduce failures related to claiming a Tusoteuthis.
  • Changed INIWorldScanAllowPlebs to “replicated”. (Did this even work before?)
  • Changed INIManifestRange to “replicated”. (Did this work either?)
  • Changed INIMaxDinoLevel to use the creatures base level instead of current level.
  • Changed Currency Exchanger exchanges to “not replicated”. (Cuts down on network bandwidth.)
  • Changed World Scan process to be more easier to maintain in the future.
  • Changed the “Unable to spawn dino!” notification on the Mailbox UI to be more helpful.
  • Changed Type filter to be sorted alphabetically.
  • Changed missing class icons in the Browse UI and Mailbox UI.
  • Changed highest bidder icon in the Browse UI.
  • Changed whitelist and blacklist INI settings to remove extra spaces when saved.
  • INIMarketID is now trimmed (spaces are removed from the left and right) when registered.
  • Removed ‘Port’ from Debug UI.
  • Removed ‘Is Banned’ from Debug UI.
  • Removed world scan option for plebs; only admins may perform a manual world scan.
  • Removed a lot of unused variables that had accumulated over time.
  • Removed undocumented nameplates functionality.

Rules

Keep the Monkeys Happy!

A guide to help you stay unbanned from the Auction House. When using the Auction House, the following activities can anger the monkeys and get you banned. Note: This is not a complete list.

  • Using the Auction House to…
    • Transfer your items to another server or single-player game. Period. Don’t be lazy.
    • Move items across the map by posting auctions in Location A, then purchasing or canceling them at Location B . The Auction House is not a valid means for transporting goods across the map. Again, don’t be lazy.
    • Collude with other players, ie, players who agree to sell each other goods for an unfair amount because they’re friends, or in the same tribe on another server, etc.
    • Hide your valuables on PvP servers.
    • List admin-spawned items, or use admin-spawned resources to buy items.
    • Post items or resources that have been made ridiculously common on your server.  For example, if you have the “Resource Crops” mod installed on your server, and you can literally grow your own element in a crop plot, those resources are invalid for trading on the Auction House.
    • Attempt to reverse-engineer or manipulate the Auction House data.

Are bans permanent?

The length of a ban is determined by the severity of the infraction. If you were auto-banned by Auction Bot, and it was an honest mistake, then the ban will likely be lifted. If you are found to be intentionally abusing the mod then the ban will likely stay.


Structures

Existing Items/Structures

Auctioneer

An auctioneer in a tent. Can trade all items except for dinosaurs.

Auctioneer (Wooden Cart)

An auctioneer next to a wooden cart. This auctioneer has a “traveling merchant” feel. Can trade all items except for dinosaurs.

Auctioneer (Minimal)

A lone auctioneer. This auctioneer might be hiding in a cave or deep in the forest. Can trade all items except for dinosaurs.

Stockman (“Dino Auctioneer”)

An auctioneer with an assortment of cages and creatures. Can only trade dinosaurs.

Stockman (Minimal)

A less established dino auctioneer. Can only trade dinosaurs.

Transporter (“Dino Transporter”)

Used to transport dinos to and from the Auction House backend server.

Inventory Manifest

Can be placed into nearby inventories to pull payments from then while browsing auctions.

Currency Exchanger

A monkey that can exchange resources (or coins) for other resources (or coins). Completely configurable by server admins.


INI Settings

This section was updated on 04/30/18 to be better organized.

INI settings can be used to fine-tune how the mod works for your single-player game or dedicated server. All settings should be placed under in GameUserSettings.ini in the [AuctionHouse] section.

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

Inventory Manifest & Transporter Settings

ManifestRange (v1.4+)

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 (v1.5+)

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 what payments are allowed or disallowed.

Additional settings will be added in the future!

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

DisableBlueprintTrades

Disables the ability to purchase blueprints.

Defaults to FALSE.

DisableBlueprintTrades=True

PurchaseBlacklist

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

No default value.

PurchaseBlacklist=PrimalItem_WeaponCrossbow_C,PrimalItemAmmo_RefinedTranqDart_C

PurchaseWhitelist

The list of items 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 (v1.5+)

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

No default value.

DinoBlacklist=PrimalDinoCharacter_Dodo_BP_C,PrimalDinoCharacter_Jerboa_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

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

DisallowCoreClasses

Disallows core classes (Wood, Wooden Foundation, etc). Auctions will appear in the search results but players will be unable to purchase them.

Defaults to FALSE.

DisallowCoreClasses=True

DisallowScorchedEarthClasses

Disallows Scorched Earth classes (Jerboa, Sand, etc). Auctions will appear in the search results but players will be unable to purchase them.

Defaults to FALSE.

DisallowScorchedEarthClasses=True

DisallowAberrationClasses

Disallows Aberration classes (Element Ore, Glider Suit, etc). Auctions will appear in the search results but players will be unable to purchase them.

Defaults to FALSE.

DisallowAberrationClasses=True

DisallowModdedClasses

Disallows modded classes (S+, Awesome Teleporters). Auctions will appear in the search results but players will be unable to purchase them.

Defaults to FALSE.

DisallowModdedClasses=True

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 (v1.5+)

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 (v1.5+)

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 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 (v1.5+)

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 (v1.5+)

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 (v2.0+)

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 increase 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

World Scan Settings

These settings pertain to the world scan. The world scan happens periodically (every 10m) and keeps a running list of any classes it detects in the world. The detected classes are replicated to clients, if needed, and are used to spawn items and dinos.

  • WorldScanAllowPlebs has been removed in v2.0.

WorldScanMaxStructures (v1.4+)

Limits the number of structures that are analyzed during the world scan.

Defaults to 20.

WorldScanMaxStructures=20

WorldScanMaxDinos (v1.4+)

Limits the number of dinos that are analyzed during the world scan.

Defaults to 20.

WorldScanMaxDinos=20

WorldScanMaxPlayers (v1.4+)

Limits the number of players that are analyzed during the world scan.

Defaults to 20.

WorldScanMaxPlayers=20

Replication Settings

These settings control how many and how fast classes are replicated to the client during a world scan, if needed.

RepItemClassesPerChunk (v2.0+)

The number of item classes to replicate per chunk.

Defaults to 50. Minimum value of 1; maximum value of 500.

RepItemClassesPerChunk=50

RepItemInterval (v2.0+)

The number of seconds to wait before replicating another chunk of item classes.

Defaults to 5. Minimum value of 1; maximum value of 60.

RepItemInterval=5

RepDinoClassesPerChunk (v2.0+)

The number of dino classes to replicate per chunk.

Defaults to 10. Minimum value of 1; maximum value of 200.

RepDinoClassesPerChunk=10

RepDinoInterval (v2.0+)

The number of seconds to wait before replicating another chunk of dino classes.

Defaults to 5. Minimum value of 1; maximum value of 60.

RepDinoInterval=5

Structure Limits

These settings pertain to structure limits and are very buggy. (Sorry about that!) These settings may be changed in the future to work the like the vanilla turret limits work.

UseStructureLimits (v1.5+)

Whether or not to use player/tribe/server structure limits.

Defaults to FALSE.

UseStructureLimits=False

PlayerStructureLimit (v1.5+)

The maximum number of per-type structures that can be personally owned by a player. For example, each player can personally place up to 10 auctioneers, 10 stockmen, 10 mailboxes, etc. Once the limit is reached for a specific type then the player will not be able to place any more structures of that type.

Defaults to 10. Minimum value of 1; maximum value of 100.

PlayerStructureLimit=10

TribeStructureLimit (v1.5+)

The maximum number of per-type structures that can be owned by a tribe. For example, each tribe can place up to 25 auctioneers, 25 stockmen, 25 mailboxes, etc. Once the limit is reached for a specific type then no one in the tribe will not be able to place any more structures of that type.

Defaults to 25. Minimum value of 1; maximum value of 100.

TribeStructureLimit=25

ServerStructureLimit (v1.5+)

The absolute maximum number of per-type structures that can be placed on the server. For example, the server can have up to 100 auctioneers, 100 stockmen, 100 mailboxes, etc. Once the limit is reached for a specific type then no one on the server will able to place any more structures of that type.

Defaults to 100.  Minimum value of 1; maximum value of 100.

ServerStructureLimit=100

Admin Commands

This mod adds 10 new structures and 4 optional new currencies.

Auctioneer

Used to create and purchase item auctions.

cheat giveitem "Blueprint'/Game/Mods/AuctionHouse/Auctioneer/PrimalItemStructure_Auctioneer.PrimalItemStructure_Auctioneer'" 1 0 0

Auctioneer (Wooden Cart)

A variant of the Auctioneer. Used to create and purchase item auctions.

cheat giveitem "Blueprint'/Game/Mods/AuctionHouse/Auctioneer/PrimalItemStructure_Auctioneer_Cart.PrimalItemStructure_Auctioneer_Cart'" 1 0 0

Auctioneer (Minimal)

A variant of the Auctioneer. Used to create and purchase item auctions.

cheat giveitem "Blueprint'/Game/Mods/AuctionHouse/Auctioneer/PrimalItemStructure_Auctioneer_Minimal.PrimalItemStructure_Auctioneer_Minimal'" 1 0 0

Stockman (“Dino Auctioneer”)

Used with a transporter to create a purchase dino auctions.

cheat giveitem "/Game/Mods/AuctionHouse/Stockman/PrimalItemStructure_Stockman.PrimalItemStructure_Stockman" 1 0 0 false

Stockman (Minimal)

A variant of the stockman. Used with a transporter to create a purchase dino auctions.

cheat giveitem "/Game/Mods/AuctionHouse/Stockman/PrimalItemStructure_Stockman_Minimal.PrimalItemStructure_Stockman_Minimal" 1 0 0 false

Transporter (“Dino Transporter”)

Dinos must be placed on this in order to appear in the Create Auction UI.

cheat giveitem "/Game/Mods/AuctionHouse/Transporter/PrimalItemStructure_AuctionHouseTransporter.PrimalItemStructure_AuctionHouseTransporter" 1 0 0 false

Mailbox

Used to claim canceled, expired, or purchased items or dinos.

cheat giveitem "Blueprint'/Game/Mods/AuctionHouse/Mailbox/PrimalItemStructure_AuctionHouseMailbox.PrimalItemStructure_AuctionHouseMailbox'" 1 0 0

Copper Coin

A copper coin. Can be used by private markets to create and purchase auctions.

cheat giveitem "Blueprint'/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Copper.PrimalItemResource_AuctionHouseCoin_Copper'" 100 0 0

Silver Coin

A silver coin. Can be used by private markets to create and purchase auctions. For most admins, 1 Silver Coin = 100 Copper Coin when configuring exchanges.

cheat giveitem "Blueprint'/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Silver.PrimalItemResource_AuctionHouseCoin_Silver'" 100 0 0

Gold Coin

A gold coin. Can be used by private markets to create and purchase auctions. For most admins, 1 Gold Coin = 100 Silver Coin when configuring exchanges.

cheat giveitem "Blueprint'/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Gold.PrimalItemResource_AuctionHouseCoin_Gold'" 100 0 0

Platinum Coin

A platinum coin. Can be used by private markets to create and purchase auctions. For most admins, 1 Platinum Coin = 100 Gold Coin when configuring exchanges.

cheat giveitem "Blueprint'/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin_Platinum.PrimalItemResource_AuctionHouseCoin_Platinum'" 100 0 0

Megapithecus Coin (“Old Coin”)

An old coin. Typically not used since copper, silver, gold, and platinum coins were added in 1.6.

cheat giveitem "Blueprint'/Game/Mods/AuctionHouse/Currency/PrimalItemResource_AuctionHouseCoin.PrimalItemResource_AuctionHouseCoin'" 100 0 0

Flag

A flag with the symbol of the Auctioneers on it.

cheat giveitem "/Game/Mods/AuctionHouse/Flags/PrimalItemStructure_AuctionHouseFlag.PrimalItemStructure_AuctionHouseFlag" 1 0 0 false

Exchanger

Used to exchange items or resources for other items or resources. Note: This structure does not come pre-configured. It will not work until exchanges are configured by an admin.

cheat giveitem "Blueprint'/Game/Mods/AuctionHouse/Exchanger/PrimalItemStructure_AuctionHouseExchanger.PrimalItemStructure_AuctionHouseExchanger'" 1 0 0

Exchanger (Minimal)

A variant of the exchanger. Used to exchange items or resources for other items or resources. Note: This structure does not come pre-configured. It will not work until exchanges are configured by an admin.

cheat giveitem "Blueprint'/Game/Mods/AuctionHouse/Exchanger/PrimalItemStructure_AuctionHouseExchanger_Minimal.PrimalItemStructure_AuctionHouseExchanger_Minimal'" 1 0 0

Engrams

This mod adds 11 new engrams.

  • Auctioneer
  • Auctioneer (Wooden Cart)
  • Auctioneer (Minimal)
  • Stockman (“Dino Auctioneer”)
  • Minimal Stockman
  • Transporter (“Dino Transporter”)
  • Mailbox
  • Inventory Manifest
  • Flag
  • Exchanger
  • Exchanger (“Minimal”)

Hiding Engrams

Some server admins prefer to hide the engrams. This can be useful for a variety of reasons such as creating a community auction house.

Auctioneer

OverrideNamedEngramEntries=(EngramClassName="EngramEntry_Auctioneer_C",EngramHidden=True,EngramPointsCost=10,EngramLevelRequirement=0,RemoveEngramPreReq=False)

Auctioneer (Wooden Cart)

OverrideNamedEngramEntries=(EngramClassName="EngramEntry_Auctioneer_Cart_C",EngramHidden=True,EngramPointsCost=1,EngramLevelRequirement=0,RemoveEngramPreReq=False)

Auctioneer (Minimal)

OverrideNamedEngramEntries=(EngramClassName="EngramEntry_Auctioneer_Minimal_C",EngramHidden=True,EngramPointsCost=1,EngramLevelRequirement=0,RemoveEngramPreReq=False)

Stockman (“Dino Auctioneer”)

OverrideNamedEngramEntries=(EngramClassName="EngramEntry_Stockman_C",EngramHidden=True,EngramPointsCost=1,EngramLevelRequirement=0,RemoveEngramPreReq=False)

Stockman (Minimal)

OverrideNamedEngramEntries=(EngramClassName="EngramEntry_Stockman_Minimal_C",EngramHidden=True,EngramPointsCost=1,EngramLevelRequirement=0,RemoveEngramPreReq=False)

Transporter (“Dino Transporter”)

OverrideNamedEngramEntries=(EngramClassName="EngramEntry_AuctionHouseTransporter_C",EngramHidden=True,EngramPointsCost=1,EngramLevelRequirement=0,RemoveEngramPreReq=False)

Mailbox

Note: It is not recommended that this engram be hidden. This is a structure that players use to retrieve their auctions.

OverrideNamedEngramEntries=(EngramClassName="EngramEntry_AuctionHouseMailbox_C",EngramHidden=True,EngramPointsCost=1,EngramLevelRequirement=0,RemoveEngramPreReq=False)

Inventory Manifest

Note: It is not recommended that this engram be hidden. This is a crafted item that players can use to pull resources from nearby inventories because physically carrying the buyout price for some auctions is sometimes impossible.

OverrideNamedEngramEntries=(EngramClassName="EngramEntry_InventoryToken_C",EngramHidden=True,EngramPointsCost=1,EngramLevelRequirement=0,RemoveEngramPreReq=False)

Flag

OverrideNamedEngramEntries=(EngramClassName="EngramEntry_AuctionHouseFlag_C",EngramHidden=True,EngramPointsCost=1,EngramLevelRequirement=0,RemoveEngramPreReq=False)

Exchanger

OverrideNamedEngramEntries=(EngramClassName="EngramEntry_AuctionHouseExchanger_C",EngramHidden=True,EngramPointsCost=1,EngramLevelRequirement=0,RemoveEngramPreReq=False)

Exchanger (Minimal)

OverrideNamedEngramEntries=(EngramClassName="EngramEntry_AuctionHouseExchanger_Minimal_C",EngramHidden=True,EngramPointsCost=1,EngramLevelRequirement=0,RemoveEngramPreReq=False)

Harvest Rate Normalization

Harvest Rate Normalization (“HRN”) is a way to appropriate the bid and buyout amounts per auction to make it seem as though a player is paying or receiving a desirable amount of resources depending on their server’s Harvest Amount Multiplier (“HAM”) compared to the HAM of the other server. Bids that are stored in the database are normalized down to 1x so they can be recalculated depending on the HAM of the requesting server.

Note: At some point in the future we will be extending the HRN formula to include the number of resources/consumables/etc received to keep the amounts in a 1:1 ratio instead of a possible ratio of 1:2, 1:4, etc.

Example 1

Ghazlawl has a HAM of 10x. He lists an Ascendant Metal Pick for 10,000 metal ingots. No matter who buys the item Ghazlawl will still receive 10,000 metal ingots.

RedDwarf has a HAM of 2x. For him, the buyout price of Ghazlawl’s item would be ((2/10)*10,000), or 2,000 metal ingots.

Blitzfire has a HAM of 1x. For him, the buyout price of Ghazlawl’s item would be ((1/10)*10,000), or 1,000 metal ingots.

Carl has a HAM of 50x. For him, the buyout price of Ghazlawl’s item would be ((50/10)*10,000), or 50,000 metal ingots.

Example 2

Carl has a HAM of 50x. He lists a Journeyman Assault Rifle for 100,000 metal ingots. No matter who buys the item Carl will still receive 100,000 metal ingots.

RedDwarf has a HAM of 2x. For him, the buyout price of Carl’s item would be ((2/50)*100,000), or 4,000 metal ingots.

Blitzfire has a HAM of 1x. For him, the buyout price of Carl’s item would be ((1/50)*100,000), or 2,000 metal ingots.

Ghazlawl has a HAM of 10x. For him, the buyout price of Carl’s item would be ((10/50)*100,000), or 20,000 metal ingots.


Frequently Asked Questions

Can I restrict auctions to only my server?

Say you want to…

a) Have a single server where players can only buy/sell with each other.
b) Have multiple servers that can buy/sell with each other.

… then you will need to create a unique “Market ID” (for example, “MYTOKEN1234”) and specify it in your GameUserSettings.ini file. For example:

[AuctionHouse]
MarketID=MYTOKEN1234

Note: Please for the love of Zeus do not use “MYTOKEN1234”. This is only an example. Use something random and unique. Do not use hyphens or special characters.

How do I enable Megapithecus Coins?

Important: Only servers that use a private market can use custom currencies. Custom currencies are not allowed on the global market.

To enable Megapithecus Coins (or Glory Coins, or any other currency), you must do the following:

  • Make sure the currency that you’re trying to enable exists on the server. Megapithecus Coins are included in this mod. Glory Coins and other currencies are not.
  • Get the class name of the currency you’re trying to enable. For example, Megapithecus Coins are PrimalItem_AuctionHouseCoin_C.
  • Update your GameUserSettings.ini file accordingly.
  • Make sure the currency that you’re trying to use are in a nearby inventory so the world scan can detect them.
  • Restart your server and wait 1-2 minutes before testing.

For example, your GameUserSettings.ini file may look like this:

[AuctionHouse]
MarketID=YOUR_TOKEN_HERE
ExtraCurrencyItems=PrimalItemResource_AuctionHouseCoin_C

How do the coins work?
Do you generate coins over time?
Is there a bank?
Where do they come from?

Megapithecus Coins, if you choose to use them, do not come from anywhere. They are simply part of the mod as an example currency that can be used if you choose to. Some servers spawn them into the world for events while some servers add them to supply drops. How you hand them out to your players is up to you as a server admin.

Why does it say “Connecting to server, please wait…”?

It can take up to 1, sometimes 2, minutes (60-120 seconds) to connect to the Auction House server when restarting your server and when placing auctioneers and mailboxes in the world. If it still says “connecting” after 5 minutes then please post a bug report with your server name, IP address, and your in-game character name.

Why can’t I ask for thatch, fiber, etc?

Thatch, fiber, etc are incredibly easy to farm. The purpose of this mod is to create a way for players to sell items they believe are valuable for resources that are equally as valuable. Also, the monkeys only like items of high value so they don’t really like thatch and fiber. It’s nothing personal; blame the monkeys.

Can I use the Auction House to transfer items to my friend’s server?

No. The auction house was created as a way for players to legitimately buy and sell items with other players. It was not created to be used as an item transfer service, a personal storage vault, or any other wacky thing people have come up with. Please keep the market fair. Please do not use the Auction House in any way other than it’s intended purpose. All auctions are monitored by an automated system and cheating or exploiting the system will result in players not being allowed to use the Auction House anymore.

Why can I see modded items on one server but not another?

Modded items don’t always have engrams or classes in the Primal Game Data (PGD). Modded items and dinos need to be detected by the server before they will appear in search results, which happens passively during the “World Scan” event. Modded items only need to be detected once because the mod keeps a cumulative list of all of the item and dino classes that it detects, so eventually most classes should be found over time on each server.

Here is an scenario that players often experience:

Player A lists modded kibble on the Auction House. Player B wants to buy the modded kibble but is unable to see the item in the Auction House. Since Player A is the one listing the modded kibble, it is obvious that the World Scan has detected the modded kibble class on Player A’s server. However, Player B’s server doesn’t know about the modded kibble class yet, therefore it cannot spawn the modded kibble into the world, and therefore doesn’t include the modded kibble in the search results. Once Player B’s server becomes aware of the modded kibble class through the passive World Scan, the modded kibble will be included in the search results for Player B.

How is Max Dino Level calculated?

The default Max Dino Level value for your server is calculated using the following formula: ($DifficultyValue * 38) + (($DifficultyValue * 38) / 2) + 71 + ($Total * 0.25). In human readable terms, that’s Wild Max + Perfect Tame + Tamed Levels + Breeding Gap. It’s not a perfect calculation but it covers the needs of most players. We’ve also added the MaxDinoLevel INI setting if the calculated value isn’t suitable for your server.

Can I override the calculated Max Dino Level?

Yes. You can change the Max Dino Level setting to a value that is appropriate for your server by setting MaxDinoLevel in GameUserSettings.ini. For example, if you’re using a core mod that changes the max wild dino level to 1,000, you would want to set MaxDinoLevel to something like 2,000.

v1.5 (“Dino Auctions”) FAQs

Can I buy/sell modded dinos?

Yes. Similar to the way items work, modded dinos are supported as well.

How does level/gender/breeding work? Will I get the same exact dino?

Yes. The dino you receive will have the exact same stats, gender, affinity, colors, etc. If your auction expires you will receive the exact same dino you listed. Custom paint jobs will be removed, however. (Sorry, nothing we can really do about that right now.)

If I uninstall the mod will I lose my purchased items/dinos?

Nope! The items and dinos you receive from the Auction House are not specific to the Auction House mod. Remember to cancel and claim all your active auctions though before uninstalling the mod or you won’t be able to get them back unless you reinstall it.

Why is the dino auction duration for automatically set to 5 days?

Transporting a dino takes a lot of effort by the monkeys and they’re not too keen on transporting dinos to and from the different realms any more than they have to. We asked them if there was any wiggle room in this decision and they said no. (Or rather, they grunted at us, which we’re pretty sure means no.)

Why are some dinos blocked?

Short answer, people can be jerks. The monkeys don’t allow vanilla bosses (gorilla, spider, dragon, etc), vanilla alphas (alpha carno, alpha rex, etc), or non-tameable vanilla dinos (trilobites, dodorex, etc) to be bought or sold on the Auction House.

Why are there list and purchase limits?

Short answer, again, people can be jerks. For now the monkeys have limits in place that allow up to 5 dino purchases per hour per player and up to 10 dino listings per 24-hour period per player. These values are doubled for private markets.

These values will be increased over time once post-launch testing and fixes are completed.

Why do I have to pay a fee?

We deliberated for about two weeks whether or not a fee was a good idea. Long story short we want to stay in line with how auction houses in other games operate and provide more immersion for the auctioneers while also deterring people from making senseless auctions. This change is aimed to reel in some of the crazy auctions you may have seen in the past.

How are fees calculated?

The fee is essentially 1% of the quantity being sold or the buyout price, whichever is higher, per day and should max out at 500 metal ingots in most cases. Private markets can change the fee to be a flat price (1 megapithecus coin per auction, for example) if the admin wanted to.

Can I change the fee currency and amount?

Short answer, yes, but only on private markets. The public market uses a normalized fee currency of metal ingots. While a flat fee can be specified on private markets, the percentage-based fee amount (1%) cannot be changed. The monkeys have been pretty stubborn about that one. (We tried!)

Can we increase the max buyout amount for dinos?

Yes, but right now it’s capped at 2,000 x Harvest Rate (ie, 1x caps at 2k, 2x caps at 4k, 5x caps at 10k, etc), with a hard cap of 20k for private markets. We meant to double the max buyout limit for dinos but it slipped through the cracks and will be updated in an upcoming release (1.5b), soon.

What is “Summoning Sickness”?

Summoning Sickness is a debuff that dinos get after being purchased from the Auction House. Because traveling through time and space is exhausting, this debuff disables the ability to sell them again for a few hours. Dinos can be listed on the Auction House again once the debuff expires.


Road Map

This section is basically a brain dump and is subject to change at any time.

Fertilized Egg Auctions

High priority. Functionally working on the dev branch but needs more polish.

Inventory Manifest v2

High priority. Rework the inventory manifest to not only pull resources for payment but also pull items from when creating auctions.

Admin Currency Exchanger

High priority. Admins want an additional exchanger that can only be spawned by admins and contains a list of exchanges that is different than the regular exchanger.

Player Feedback

High priority. Players want some substantial improvements to be made to the UI and mechanics.

Requested Improvements

  • Configurable fee for relisting expired auctions from the mailbox.
    • Currently the same listing fee that was used to create the auction is used to relist the auction.
  • “Relist All” button, similar to “Claim All”, that will relist all auctions in the Mailbox UI. (TreeZenDE)
  • Ability for players to specify a quantity when selling items that stack.
    • Currently players can only sell stacks of items (ie, 5 stacks of 100) instead of in bulk (ie, 1 auction of 500).
    • There will need to be a hard limit to the quantity that can be sold at once.
  • Better INI settings to limit what can be purchased from the AH. (TreeZenDE)
    • Support for “Only Aberration Dinos” or “Only SE Items”, etc.
  • Per-auctioneer support for whitelists/blacklists.
    • This auctioneer only sells Scorched Earth dinos, this auctioneer only sells low quality items, etc.
  • Add dino mutation count to Browse UI. (Jazzy)
  • Move source icon (Aberration, SE, etc) to the result so players don’t have to click the item to see its source.
  • Ability for admins to specify item quality index (0-15) when configuring exchanges.
  • Log all of the exchanges performed by the currency exchanger. (Corran)
    • “It would be good to see what they’re exchanging Coins for, so that we know what prices are high, or what they need more of.”
  • Ability for players to set what can and can’t spawn on a transporter (“Flying Dinos”, “Water Dinos”, “Land Dinos”, etc.)
  • Change “Quality” dropdown to use qualities from the game mode since some mods alter quality names.
  • Ability for admins to toggle whether or not blacklisted items/dinos appear in the search results.
    • Some players feel that showing results makes the AH feel more alive while other players feel like hiding them makes blacklisted items/dinos on the AH less confusing.

3D Dino Preview

Medium priority. Players would like the ability to see what a dinosaur looks like before purchasing.

  • Will be an additional panel on the Browse UI.
  • Will accurately show the colors of the dino so players can preview what they’re purchasing.
  • Interaction should support zooming and rotating, if possible.

Custom Model Interface

Medium priority. Modders would like the ability to use their own models instead of the ones that come with the Auction House. The specifics regarding how it will be implemented aren’t set in stone yet but it should be fairly simple to configure.

COD System

Medium priority. Players would like a COD (Cash on Delivery) system so they can create auctions that players can purchase without the purchaser having to pay until the item is received.

  • COD auctions will be removed from the AH and appear in the purchaser’s mailbox when they click “Buy”.
  • The auction will remain in the player’s mailbox for 12 hours, giving them enough time to gather the payment amount.
  • After 24 hours, if the purchaser has not paid for the auction, it will return to AH.

Faction/Reputation System

Medium priority. Reputation will be accumulated for each faction, which can lead to better or worse deals.

  • Three factions include auctioneers, stockmen, and egg trader.
    • Creating and purchasing auctions will increase a player’s reputation.
    • Canceling auctions will decrease a players reputation.
    • Breaking the rules of the Auction House will severely lower a players reputation.
    • Possibility of simple daily quests that can be completed to raise your reputation with a specific faction.
  • The higher a players reputation the better deals they get and can possibly create/purchase more auctions per day.
  • The lower a players reputation the worse deals they get.
  • If a players reputation gets too low (“Hated”) they may not be allowed to interact with auctioneers until it is high enough.
    • One way for these players to raise their reputation might be to farm bananas and turn them in.

Additional Structures/Auctioneers

Medium priority. The following additional structures would be nice but aren’t required.

  • “Traveling” Merchant
    • Will appear on the map at random.
    • Will have a boolean flag that will show only specific items such as weapons, structures, etc.
  • “Companion” Merchant
    • A reconfigured dinosaur that doesn’t attack but can follow players around the map. Could possibly be a gorilla riding a parasaur. Worst case it can be the minimal auctioneer.

Structure Limits

Medium priority. Current implementation of structure limits isn’t working correctly. Need to revisit.

Web-based Interface

Low priority. Players want to be able to use the auction house from computers and mobile devices.

Update: A temporary interface has been launched that allows players to view the average buyout price for a given item or dino. It can be found here: https://linode.ghazlawl.com/ark/mods/auctionhouse/averages/

Self-Building Auction Area

Low priority. The initial structure placement for auctioneers, transporters, and mailboxes can be confusing. The self-building auction area will build a small area complete with everything needed to get started with the auction house.

This feature will only be available to admins.


JSON API

This mod includes a public read-only JSON API endpoint that developers and server admins can use to extract information about their auctions. Please refer to the URLs below for each endpoint and its respective parameters. Each endpoint request is cached for one (1) hour to keep our servers happy and to save bandwidth.

Active Public Auctions

This endpoint will retrieve a JSON-formatted list of all active public market auctions.

https://linode.ghazlawl.com/ark/mods/auctionhouse/api/json/v1/auctions/

Active Private Market Auctions

This endpoint will retrieve a JSON-formatted list of all active auctions that belong to the specified Market ID. If you have a private market with multiple servers connected by a Market ID then all auctions from all connected servers will be included in this list.

https://linode.ghazlawl.com/ark/mods/auctionhouse/api/json/v1/auctions/?MarketID=[YOUR-MARKET-ID-HERE]

Active Player Auctions

This endpoint will retrieve a JSON-formatted list of all active auctions created by the specified player using their Steam ID. This list isn’t restricted to a single server or market.

https://linode.ghazlawl.com/ark/mods/auctionhouse/api/json/v1/auctions/?PlayerSteamID=[PLAYER-STEAM-ID-HERE]