CraftBay

Auction off your precious items! CraftBay is an auctioning system that allows players to trade their items by bidding for them. After a set amount of time, the highest bid wins. Payment is handled by your server's economy system via Vault.

Notice that CraftBay v1.2 and above require at least CraftBukkit Beta 1.4.6-R0.1 to work and will not run on older server versions.

Intended use

Despite the wide availability of shopping plugins, an auction is still the best way for auctioneers to achieve the maximum price for their goods by reaching a broad audience and having them duke it out. Experience shows that especially rare items such as enchanted tools and armor can make for a very intense and exciting fight for the highest bid. The winning bid may even exceed the price for the same item available in shops.

Features

  • Players can auction off items from their inventory
  • Bid for items with your in-game currency
  • World blacklist
  • Live notifications about auction activity (players can mute it)
  • Third party chat plugin support: Herochat and ChannelChat
  • Spam protection: Suppress messages when people spam bids
  • Custom message/language support
  • Admin commands to moderate auction activity
  • Auction history for in-game review
  • Auctions survive server restarts
  • Informative display of item properties (damage, enchantments, etc)

Commands

  • /auction This command will always direct you to an overview of your current options.
  • /auc An alias for /auction that works with all of the below
  • /auc ? Get help
  • /auc info Display information about the current auction
  • /auc history [id] Review past or queued future auctions
  • /auc bid [amount] Place a bid
  • /bid [amount] Shortcut for /auction bid
  • /auc start [starting price] Auction off an item
  • /auc hand [starting price] Auction off the item in your hand
  • /auc end [delay] End the current auction
  • /auc cancel [id] Cancel an auction
  • /auc ignore Ignore broadcasts
  • /auc listen Receive broadcasts

Admin Commands

Admins have additional commands to get more information than normal users, moderate the market activity, auction off spawned items or stimulate the economy by bidding for items on behalf of the bank.

  • /auc bank <item> <amount> [starting price] Auction off a spawned item
  • /auc fake <name> [starting price] Auction off a fake item
  • /auc bankbid [amount] Place a bid on behalf of the bank
  • /auc log [id] Display the log of an auction
  • /auc reload Reload the configuration file

Permissions

The defaults are set up so anyone can query auction information and place bids. Permission to start auctions, however, is not granted by default. Administrative actions default to op.

  • auction.info Query information about the current auction
  • auction.bid Place bids for auctions. Implies auction.receive
  • auction.start Start your own auction
  • auction.admin Perform administrative commands
  • auction.receive Receive items you won (since v1.2.1)
  • auction.nofee Player is exempted from the auction fee
  • auction.notax Player is exempted from the auction tax

How it works

Every player with the appropriate permission can start an auction for any amount of items in their inventory. To do so, they can simply type /auc hand to sell whatever they are holding in their hand, or /auc start to be presented with a chest interface to put their items in. If everything is alright, the auction will be publicly announced and the plugin will claim the item and start accepting bids.

Placing a bid means declaring the maximum amount you are willing to pay for the item. After the auction times out, the participant with the highest bid wins, but all he has to pay is just enough to beat the second highest bid.

The result of this system is that sniping, that is overbidding by a small amount in the last second, becomes very difficult. Also players don't have to worry about placing an unnecessarily high bid when nobody else is interested in paying nearly as much. They can just declare the maximum amount right away and be guaranteed to pay up to that but no more, and only as much as is necessary to win. Also, nobody else will know about it unless they bid even more.

Find an example of how it works.

Integration

Chat

CraftBay will announce the start of any auction to online players and notify them about changes of prices or winners. This functionality necessitates a way of ignoring broadcasts, which comes out of the box. But this plugin also supports third party chat plugins. If your server uses any of them, their use can be activated in the configuration file. Currently supported are Herochat and ChannelChat.

Language

With version 1.1, all the in-game output is configurable and CraftBay comes with two language files: English (en_US), German (de_DE) and Simplified Chinese (zh_CN). The preferred language can be chosen in the configuration file and changed at run-time.

Fun facts

  • This plugin always takes care of proper stack sizes when dealing items.
  • Auctions will survive a server restart.
  • Multiple items can only be auctioned if they have identical damage values and enchantments on them.
  • A cancelled auction or one that ends without any bids will return the item to the owner.
  • If items are handed over to a player with a full inventory, they will be dropped where he is standing.

Credits

This plugin is loosely based on iAuction by rob4001. After installing it I found that it did not quite do what I wanted or not in the way I thought it should be done, so I reimplemented most of it and applied many structural changes.


Comments

Posts Quoted:
Reply
Clear All Quotes

About This Project

Categories

Members

Recent Files