Salesmania

Salesmania

Salesmania is an auction plugin developed for InvisionCraft as an alternative to other similar plugins that were either too buggy, or simply didn't fit our needs. Eventually i'd like this plugin to handle other forms of buying/selling/trading but for now the main focus has been the auction feature.

Features

Auction Features

  • Item blacklist (items that can't be auctioned)
  • Persistent enable/disable of auction
  • Cooldown (time between auctions)
  • Custom locale support (each player can select his/her own locale)
  • Completely customizable output
  • Item stash holds players items if inventory is full or offline (use /collect)
  • Allow/Disallow use in creative mode
  • Custom time remaining notifications
  • Minimum/maximum bid increment
  • Minimum/maximum starting bid
  • Server taxes
  • Anti-snipe
  • Players able to ignore auction broadcasts
  • Uses vault for easily-readable item names
  • Uses vault for economy support
  • Mob spawners show mob type
  • Simpler start command compared to other similar plugins
  • Auction queues
  • Able to view the currently queued auctions
  • Greatly reduced risk of losing items or currency on server crashes/restarts
  • Channel support (TownyChat and Herochat)
  • For servers without channels, broadcasts are sent only to worlds in the appropriate world group.
  • World groups (see below)
  • World guard region support (see below)
  • Support for renamed items, written books, and enchanted books.
  • Probably more stuff i forgot to list

World Groups

World groups are a new feature in v1.3. Each group has an independent auction queue. Players in one group can not bid on auctions from another group. Separate broadcast channels can also be specified for each group. This can also be used to prevent items from moving between worlds, the item stash is now world group specific. If a player is not in the same world group at the end of an auction it will be added to the item stash and only able to be retrieved from the correct group.

Worldguard Region Support

Worldguard region support will be included in v1.39.1(beta) and later versions. This feature adds an extreme amount of flexibility. You'll be able to set the commands that are allowed in each region and also whether or not players will be able to receive items within that region. If you set the toStash configuration setting, all auction items will automatically be sent to the players item stash. You could then set deny: [collect] to disallow players from collecting items from their stash in that region. You can restrict your players ability to collect items, bid, start auctions, or anything you want.

Upcoming Features

  • Selling.
  • API support for web auctions.

You can expect many, many more features. I'm looking forward to hearing everyones comments or suggestions on how I can improve the plugin or features you're looking forward to :)

Requirements

This plugin depends on vault for economy compatibility and easily readable item names. It should work with every economy plugin that is supported by Vault.

Locales

Salesmania fully supports custom locales. The latest english locale file can always be found here

If you create a locale in a different language I would be extremely appreciative if you submitted it to be included in later versions:

  • Email it here
  • Fork on github and submit a pull request
  • Submit a ticket here or here containing the locale

Commands

Auction

/auction start <starting bid> [quantity] [time] - Auctions the item you are holding
/auction bid <bid> - Bids on the item that is being auctioned
/auction info - Displays information on the current auction
/auction ignore - Ignores all auction messages
/auction end - Ends the auction with the last bidder as the winner.
/auction cancel - Cancels the auction, item is returned to owner and the last bid is returned
/auction enable|disable - Enables or disables the auction

Salesmania

/salesmania reload - Reloads all configuration and locales
/salesmania locale set <locale> - Changes your current locale
/salesmania locale list - Lists all available locales

Stash

/collect - Collects items stored in the Item Stash

Permissions

  • salesmania.auction.start - Allows you to start an auction.
  • salesmania.auction.bid - Allows you to bid on an auction.
  • salesmania.auction.cancel - Allows you to cancel ANY auction.
  • salesmania.auction.end - Allows you to end ANY auction.
  • salesmania.auction.enable - Allows you to enable the auction.
  • salesmania.auction.disable - Allows you to disable the auction.
  • salesmania.admin.reload - Allows you to reload configuration

The full permissions list can be found here

Documentation

With Salesmania, I've always kept in mind that the user interface should be as simple as possible, and it is. There's really only a few simple commands exposed to your players. Unfortunately, behind that simplicity is a complex plugin full of advanced features and more are being added all the time. Long story short, we need documentation. I'll be working on this as v1.4 rolls around and the code base becomes more and more stable. Meanwhile, everyone should always feel free to ask any questions in the comments, or via PM if it's something more in-depth.

For people that might be interested in helping document Salesmania, I've opened up the wiki here: https://github.com/B2OJustin/Salesmania/wiki

Keep in mind that Salesmania was never designed to be just a plugin. For developers, there's a great API that makes it easily extensible. If you're interested in hooking into Salesmania to extend it or add features in your own plugin but don't know where to start, I'm ALWAYS happy to help fellow developers.

Source code
InvisionCraft

donate

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of oLLyyy oLLyyy Apr 05, 2014 at 03:23 UTC - 0 likes

    Update please?

    Also does anyone know how to configure this plugin with TownyChat?

  • Avatar of highfaller highfaller Dec 15, 2013 at 01:42 UTC - 0 likes

    This updating any time soon?

    For new blocks/items it shows as "locale message not found" and for enchant books does not show it's enchants.

  • Avatar of ManBeastPigDev ManBeastPigDev Oct 16, 2013 at 14:30 UTC - 0 likes

    The auctions freeze periodically, maybe once a day or once every few hours. I have to disable and enable and it works again. dont think there is an error log for it.

    Crafty Creeper Party Server

  • Avatar of Staticpast Staticpast Sep 10, 2013 at 13:07 UTC - 0 likes

    @MojatoGames: Go

    For the sake of four letters, it doesn't seem worthwhile.

  • Avatar of Staticpast Staticpast Sep 10, 2013 at 13:04 UTC - 0 likes

    @Danteland: Go

    Salesmania, is working perfectly. Why would it need an update? In regards to 'upcoming features' Justin is currently occupied due to real life reasons.

    Last edited Sep 10, 2013 by Staticpast
  • Avatar of Danteland Danteland Aug 31, 2013 at 11:14 UTC - 0 likes

    Is this plugin still being updated?

  • Avatar of MojatoGames MojatoGames Aug 04, 2013 at 16:36 UTC - 0 likes

    Maybe an alias for auction like auc? It makes it easier for the players to auction fast.

    Thanks,

    MojatoGaming

  • Avatar of B2OJustin B2OJustin Jun 24, 2013 at 02:22 UTC - 0 likes

    @Redstone_: Go

    Submit 2 separate enhancement tickets and I will slowly try to make time for it. Another project (Champions) is taking up most of my time for now and there are a few issues here, but i do plan to take care of them all at some point after the champions release.

  • Avatar of B2OJustin B2OJustin Jun 24, 2013 at 02:15 UTC - 0 likes

    @peaceone: Go

    I've went ahead and moved that comment to a ticket. The comment section really isn't the place for server logs.

  • Avatar of B2OJustin B2OJustin Jun 24, 2013 at 02:13 UTC - 0 likes

    @peaceone: Go

    Sorry, not much I can do without more information. You can file a ticket if you'd like. Just be sure to include the startup log.

What are your thoughts on plugin metrics?

  1. Choices:

  1. Results
  2. 0 comments

Facts

Date created
Jun 06, 2012
Categories
Last update
Apr 21, 2013
Development stage
Release
Language
  • enUS
  • frFR
  • ptBR
License
GNU General Public License version 3 (GPLv3)
Curse link
Salesmania
Downloads
5,326
Recent files

Authors