Plugin Features
Here is a detailed description of most of the features and how they work here.
Economy Support
Player Auctions hooks into your favorite economy plugin using Vault to make auction selling/bidding and purchasing support your economy. You can control the static cost system in the config.yml.
Auction Categories
Player Auctions has automatic auction categories so auction items are in their own categories to make it easy to search and look for items in their category. The items for each category can be configured in the guis/category.yml.
Proxy Support
Player Auctions supports multi server auction auctioning and purchasing, for this to work you will need to make sure you have MySQL setup properly. You can setup MySQL in the config.yml, and easily convert your data from SQLite to MySQL easily. You will also need to setup a another plugin on your proxy called AuctionSync, you can download this here.
Please note before going to the 1st step, AuctionSync only supports the specific proxies:
If you wish for more proxies support to be added, please let us know and we may add it. If you have any of the proxies list above, you can proceed with syncing your auctions!
Make sure you have AuctionSync on your proxy and you enable the expansion in the Player Auctions expansions.yml on all of your sub servers that you want to be able to sync up. Once you've got all of them to load on all of your servers, go into your proxy config and configure the needed options.
For the proxy configuration file, you will need to edit the host option to your proxy's IP address. You'll also need to edit the needed port, you will need to open a port on your proxy and place it in that option. You'll also need to put all of your sub-servers' IP address' in the allowed-ips list to make sure they authenticate properly. The auth option is the "token" for this syncing system and it is randomly generated, you will need to put this in the configuration file of all the sub servers' config.
For the Player Auctions integrated expansion, you will need to edit the host option to your proxy's IP address (If you're using pterodactyl with the proxy on the same node as the servers, then you most likely you will connect to your local ip container address which by default is 172.18.0.1). You'll also need to edit the needed port, you will need to put the port that you opened on your proxy and place it into that option. You will also need to put your auth token that you just got from your proxy.
This system is currently in beta mode and there still might be missing syncing/issues, please open issues on our discord server.
Discord Alerts
Player Auctions supports discord notifications using Discord webhooks and Player Auctions' auction discord addon. Make sure that you enable the expansion in the Player Auctions expansions.yml and then configure the options correctly.
If you're struggling where to find a Discord webhook URL you can follow the steps below:
Right click on the discord channel you wish to send alerts to
Then click on "Edit channel"
Click on "Integrations"
Click on "Webhooks"
Click on "New Webhook"
Finally, click on "Copy Webhook URL"
Auction Menus
Player Auctions has a verity of menus that make it easily usable for a player. Here is a list of the current menus and what they do.
Player Auction Menu - This menu shows a list of all the auctions that are currently on the server.
Search Menu - This menu lets players search for auctions (by item type, item name, id) that are currently in that menu. You can also search auctions by the players exact name as well.
Confirm Menu - This menu shows all the available categories that are on the server and will open the Player Auctions menu.
Bidding Menu - This menu lets players to add an offer the the current bid.
Preview Menu - This menu shows contents that are inside of an item. (e.g. Shulker boxes).
My Auctions Menu - This menu shows a list of auctions the auctions the player owns.
Expired Auctions Menu - This menu shows a list of all the expired auctions.
Recent Auction Menu - This menu shows a list of all the recent bought/sold auctions.
Start Auction Menu - This menu lets players to easily start an auction via a menu.
Auction Bidding/Selling
In Player Auctions, there are two types of auctions, you can sell items or bid items. Here is how both of them work.
Bidding
With bidding, an auction is on the market for a certain amount of time and players can offer an amount, the player with the highest price will get the item when the time has ended.
Selling
With selling, an auction is on the market for a certain amount of time and players can purchase that auction at any time. When a player purchases this auction, they can choose the amount of that item they want in the confirm menu. Obviously, this changes the price as well to make it cheaper if they're buying less.
If a player has not purchased the item and the time has ended, the item will appear in the expired auctions menu where you can collect that item again.
Last updated