Auction House: Difference between revisions

(this is currently what i have completed for the page any tips on edits that can be made or ideas on adages are appreciated.)
m (→‎GUI (graphical user interface): Table: set text-alight to center)
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The '''Auction House''' is one of the ways that Players are able to trade goods for Profit/[[Currency]] in Blockgame like the Bazaar. When you want to sell an item on the Auction House just have the item in your hand then use the required command and the wished sell price to post. Buying items can either be done in a search for the resource or a general search of what is in the market currently. If you are attempting to buy an item and don't have enough funds there will be a prompt that you need more money in your bank. All items that do not sell within a 30 Day limit or the sale is canceled by the player, will be placed in the collections bin to be re-taken.
{| class="infobox" style="float: left; margin-right: 10px; border: 1px solid #ccc; padding: 10px;"
[[File:Auction House GUI.png|thumb|The Auction House GUI]]
|-
| colspan="2" style="text-align: center;" | [[File:Site-community-image.png|150px]]
|}The '''Auction House''' is a method through which players can trade goods for [[Currency]] in Blockgame, much like the [[The Bazaar]]. You can only access the Auction House while in [[Midgard]] by using <code>/ah</code> or speaking to the [[Auctioneer]] located in the [[Origin]] town hall. You can sell anything you find out in the world. Use this to snag great deals, undercut rivals, and amass great wealth. You can often find players bartering or asking for specific items in the in-game chat, which will often result in that item being put up on the auction house.
 
Blockgame's Auction House is currently managed by [https://zauctionhouse.groupez.dev/ zAuctionHouse]. The plugin used has changed in the past, and could change again in the future.
<!--'How to use' section needs a screenshot added displaying the purchase/back menu when an item is clicked on.-->
= <u>How to use The Auction House</u> =
 
When you wish to sell an item on the Auction House, place the item in your main hand, then use <code>/ah sell [price] [quantity]</code> to post it. When listing an item on the Auction House, a fee totaling 5% of the item's list price is deducted from the player's balance. The minimum list price for any listing is 10 coin.


* <big>The Diamond in the bottom right brings the player to their current sales.</big>
* <big>The schulker box brings the Player to their Expired sales.</big>
* <big>The Hopper gives the Option to Filter the items for sale in the Auction House.</big>
* <big>The chest symbol lets you refresh the page.</big>
* <big>The arrow is the next page button and gives the ability to see further items on the Auction house.</big>
* <big>The piece of paper lets players see all recent Transactions that have been completed.</big>


<div style="text-align:center;"><span style="color:red; font-size:125%;">'''If a quantity is not specified when selling stackable items, the ENTIRE STACK will be put up for sale.'''</span></div>


<big>'''All Transactions are funded with the Players Bank Account and cannot be withdrawn to your inventory.'''</big><tabber>
 
Buying items can be done either by searching for the specific resource or by conducting a general search of what is currently available on the market. When you click on an item, you are given the option to confirm the purchase or return to browsing the auction house. If you attempt to buy an item without having enough funds, you will receive a prompt indicating that more money is needed in your bank.
 
Any listed items that do not sell within a 48 hour limit, or are canceled by the player, will be placed in the Expired Items menu. Items that have expired will be held for 7 days from the time of expiration. If the player does not retrieve the item from the menu within this time, the item is permanently deleted.
 
 
<div style="text-align:center;"><span style="color:red; font-size:125%;">'''All transactions are funded with the player's Balance and cannot be withdrawn to your inventory.'''</span></div>
 
== <u>GUI (graphical user interface)</u> ==
 
The Auction House GUI consists of 6 rows and 9 columns. Items are listed in pages, each containing 28 items. The bottom row of the GUI contains the Next Page and Previous Page buttons, as well as navigation buttons. The navigation buttons are explained below. [[File:Auction House GUI.png|thumb|The Auction House GUI]][[File:Auction_House_Ingame_Guide.png|thumb|The Auction House in-game Guide.]]
 
<tabber>
|-|=
|-|=
{| class="mw-collapsible mw-collapsed wiki-table" width="100%" border=1 style="text-align:center;"
{| class="wiki-table" width="90%" border=1 style="text-align:center;" cellpadding="5"
!Name
!Icon
!Description
|-
|Your Items
|[[File:Icon_AH_your_items.png|50px]]
| Displays every item you have listed that is currently for sale.
|-
| Expired Items
|[[File:Icon_AH_expired_items.png|50px]]
| Displays every expired listing you currently have.
|-
|Bought Items
|[[File:Icon_AH_bought_items.png|50px]]
| Displays items you have purchased. <br> This menu is only used when your inventory is full when items are purchased. Otherwise, purchased items enter your inventory instantly.
|-
|Categories
|[[File:Icon_AH_categories.png|50px]]
| Allows you to filter items by category, e.g. Ranger Armor, Repair, Food.
|-
|Sort Type
|[[File:Icon_AH_sort_type.png|50px]]
| Sorts Auction House listings, cycling through four options: Decreasing Date/Price and Ascending Date/Price.
|-
|Next/Previous Page
|[[File:Icon_AH_next_page.png|50px]][[File:Icon_AH_previous_page.png|50px]]
| Navigates through the Auction House pages.
|-
|Information
|[[File:Icon_AH_Information.png|50px]]
| Displays a guide on how to use the Auction House while hovering. Refreshes the Auction House when clicked.
|}
</tabber>
 
<br>
 
[[File:Auction_House_Categories.png|left|thumb|The Categories GUI.]]
 
<br><br><br><br>
 
The Categories button is notable, as it allows you to filter the Auction House by item type. For example, you can search for items granting Repair, Food items, or Blockgame's custom Materials for crafting in origin. <br>
 
 
<br><br><br><br><br>
 
== <u>Commands</u> ==
 
There are three commands available to manage the Auction House.
 
{| class="mw-collapsible wiki-table sortable" width="80%" border=1 style="text-align:center; margin-left: auto; margin-right: auto;"
!Command
!Command
!Description
!Description
!Permission Needed
|-
|<code>/ah</code>
|Open the Auction House
|None
|-
|<code>/ah search [ItemName]</code>
|Search for a Item in the Auction House (also works with a part of the name)
|None
|-
|<code>/ah sell [Price] [Quantity]</code>
|Sell the item in your main hand / Hotbar
|None
|}
<!--Plugin and Config: https://zauctionhouse.groupez.dev/configurations/commands-and-permissions -->
= <u>Rank System Influence</u> =
As you progress in Blockgame and advance through player [[Ranks]], the number of items you can sell will increase accordingly. Initially, players will have the ability to post 8 listings at once, starting at the Nomad rank. With each subsequent rank, the number of items that can be sold increases by 2, culminating in a maximum of 50 sales when the rank of Goblin King is achieved. When you reach the maximum sales limit at your current rank, a prompt will notify you that you have reached your current maximum sales capacity.
The table below lists every rank and the total number of Auction House slots each provides:
{| class="mw-collapsible mw-collapsed wiki-table sortable" width="60%" border=1 style="text-align:center; margin-left: auto; margin-right: auto;"
!Rank
!Cost
!AH Slot Total
|-
|Nomad
|500
|8
|-
|Hermit
|700
|10
|-
|Peasant
|1000
|12
|-
|Commoner
|1500
|14
|-
|Citizen
|2200
|16
|-
|Conscript
|3200
|18
|-
|-
|<code>/ah</code>
|Squire
|Use this command to Open the option menu to the Auction House.
|4700
|20
|-
|-
|<code>/ah active</code>
|Guard
|Brings up the HUD with all Items you are attempting to sell.
|6900
|22
|-
|-
|<code>/ah expired</code>
|Captain
|Shows all Items that have not sold in the allotted time on the Auction House.
|10000
|24
|-
|-
|<code>/ah search [ItemName]</code>
|Knight
|This Command give the player a chance to search for specific Items.
|15000
|26
|-
|-
|<code>/ah sell [ItemPrice]</code>
|Paladin
|When this Command is used it takes the Item Currently in hand and places it
|22000
in the Auction House for the given Price
|28
|-
|-
|<code>/ah transactions</code>
|Commander
|Shows a menu of your personal Interactions on the Auction House.
|32000
Buy and sell records you have made can be seen here.
|30
|-
|-
|General
|47000
|32
|-
|Warlord
|69000
|34
|-
|Noble
|100000
|36
|-
|Aristocrat
|150000
|38
|-
|Viscount
|220000
|40
|-
|Earl
|320000
|42
|-
|Duke
|470000
|44
|-
|Royal
|690000
|46
|-
|Monarch
|1000000
|48
|-
|Goblin King
|10000000
|50
|}
|}
</tabber> 


=== <big>Rank System and Transaction increases</big> ===
<!--Insert Image of prompt!-->
While you are playing Blockgame and increasing player [[Ranks]] the amount of Items you can sell will increase every rank. Starting off players will have the ability to do 8 sales at once with the rank of Nomad. Once the player is able to rank up the amount of items that can be sold is increased by 2 every rank with a max amount of 50 when the rank of Goblin King is reached. Once the Limit is reached at your current Rank, there will be a prompt that will tell you have reached your current max sales.
 
<!--Add Category-->

Latest revision as of 11:34, 20 September 2024

The Auction House is a method through which players can trade goods for Currency in Blockgame, much like the The Bazaar. You can only access the Auction House while in Midgard by using /ah or speaking to the Auctioneer located in the Origin town hall. You can sell anything you find out in the world. Use this to snag great deals, undercut rivals, and amass great wealth. You can often find players bartering or asking for specific items in the in-game chat, which will often result in that item being put up on the auction house.

Blockgame's Auction House is currently managed by zAuctionHouse. The plugin used has changed in the past, and could change again in the future.

How to use The Auction House

When you wish to sell an item on the Auction House, place the item in your main hand, then use /ah sell [price] [quantity] to post it. When listing an item on the Auction House, a fee totaling 5% of the item's list price is deducted from the player's balance. The minimum list price for any listing is 10 coin.


If a quantity is not specified when selling stackable items, the ENTIRE STACK will be put up for sale.


Buying items can be done either by searching for the specific resource or by conducting a general search of what is currently available on the market. When you click on an item, you are given the option to confirm the purchase or return to browsing the auction house. If you attempt to buy an item without having enough funds, you will receive a prompt indicating that more money is needed in your bank.

Any listed items that do not sell within a 48 hour limit, or are canceled by the player, will be placed in the Expired Items menu. Items that have expired will be held for 7 days from the time of expiration. If the player does not retrieve the item from the menu within this time, the item is permanently deleted.


All transactions are funded with the player's Balance and cannot be withdrawn to your inventory.

GUI (graphical user interface)

The Auction House GUI consists of 6 rows and 9 columns. Items are listed in pages, each containing 28 items. The bottom row of the GUI contains the Next Page and Previous Page buttons, as well as navigation buttons. The navigation buttons are explained below.

 
The Auction House GUI
 
The Auction House in-game Guide.
Name Icon Description
Your Items   Displays every item you have listed that is currently for sale.
Expired Items   Displays every expired listing you currently have.
Bought Items   Displays items you have purchased.
This menu is only used when your inventory is full when items are purchased. Otherwise, purchased items enter your inventory instantly.
Categories   Allows you to filter items by category, e.g. Ranger Armor, Repair, Food.
Sort Type   Sorts Auction House listings, cycling through four options: Decreasing Date/Price and Ascending Date/Price.
Next/Previous Page    Navigates through the Auction House pages.
Information   Displays a guide on how to use the Auction House while hovering. Refreshes the Auction House when clicked.


 
The Categories GUI.





The Categories button is notable, as it allows you to filter the Auction House by item type. For example, you can search for items granting Repair, Food items, or Blockgame's custom Materials for crafting in origin.







Commands

There are three commands available to manage the Auction House.

Command Description Permission Needed
/ah Open the Auction House None
/ah search [ItemName] Search for a Item in the Auction House (also works with a part of the name) None
/ah sell [Price] [Quantity] Sell the item in your main hand / Hotbar None

Rank System Influence

As you progress in Blockgame and advance through player Ranks, the number of items you can sell will increase accordingly. Initially, players will have the ability to post 8 listings at once, starting at the Nomad rank. With each subsequent rank, the number of items that can be sold increases by 2, culminating in a maximum of 50 sales when the rank of Goblin King is achieved. When you reach the maximum sales limit at your current rank, a prompt will notify you that you have reached your current maximum sales capacity.

The table below lists every rank and the total number of Auction House slots each provides:

Rank Cost AH Slot Total
Nomad 500 8
Hermit 700 10
Peasant 1000 12
Commoner 1500 14
Citizen 2200 16
Conscript 3200 18
Squire 4700 20
Guard 6900 22
Captain 10000 24
Knight 15000 26
Paladin 22000 28
Commander 32000 30
General 47000 32
Warlord 69000 34
Noble 100000 36
Aristocrat 150000 38
Viscount 220000 40
Earl 320000 42
Duke 470000 44
Royal 690000 46
Monarch 1000000 48
Goblin King 10000000 50