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.
Update please?
Also does anyone know how to configure this plugin with TownyChat?
is there any documentation concerning the config file and tax accounts
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.
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.
@MojatoGames
For the sake of four letters, it doesn't seem worthwhile.
@Danteland
Salesmania, is working perfectly. Why would it need an update? In regards to 'upcoming features' Justin is currently occupied due to real life reasons.
Is this plugin still being updated?
Maybe an alias for auction like auc? It makes it easier for the players to auction fast.
Thanks,
MojatoGaming
@MrREOM
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.
@peaceone
I've went ahead and moved that comment to a ticket. The comment section really isn't the place for server logs.
@peaceone
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.
@peaceone
Sorry, I'm really not sure. Have you tried re-downloading it?
i love this plugin i have seen many servers with it but i have ran into this issue and i don't know why its happening, the plugin will not generate a folder. any know bugs about this?
Can you make it so it shows the Display name if the person has a display name (Nickname) on essentials or on anyother plugin? Also, in the Syntax section on the english.yml when I try to put a color code it doesn't show up after the reload.
I will not reply to any issues posted here. Submit a ticket and be as detailed as possible. Includes steps to reproduce the issue. Thank you.
That fixed it, thanks duder
thanks for the plugin too!
@TorgusAmorgus
Stop the server, delete the english locale file, then restart.
hi
at the count down at the end of the auction, it says that %d time is remaining instead of the actual time.
using the beta build. Any ideas?
@ViscousSummer88
Unfortunately I don't use this plugin myself nor am I able to do any large scale testing. If you could submit a ticket with as much detail as possible, including any error logs, configuration, and preferably the steps required to reproduce the issue, then I may be able to get it sorted out at some point.
Any idea on the issue with the auctions locking up and having to be manually removed via the config to get them working again..?