ezAuctions icon

ezAuctions -----

A simple, text-based auction system




## What's Changed
* Bump Scoreboard Library to 2.2.0 by @Silverwolfg11 in https://github.com/elian1203/ezAuctions/pull/65 - FIX FOR SCOREBOARD ISSUES IN 1.21.1


**Full Changelog**: https://github.com/elian1203/ezAuctions/compare/2.3.0...2.3.1
----------, Oct 16, 2024

## What's Changed
* Add auto cancel feature if no bids placed within set number of seconds by @elian1203 in https://github.com/elian1203/ezAuctions/pull/60
* Remove :"" from auction.info in messages.properties causing item name to display incorrectly by @elian1203 in https://github.com/elian1203/ezAuctions/pull/61
* Add support for currency name placeholder from vault by @elian1203 in https://github.com/elian1203/ezAuctions/pull/62
* Add boundary feature to limit where players can start/bid on auctions by @elian1203 in https://github.com/elian1203/ezAuctions/pull/63


**Full Changelog**: https://github.com/elian1203/ezAuctions/compare/2.2.3...2.3.0
----------, Sep 14, 2024

## What's Changed
* Fix 1.20.4 and 1.20.6 support. by @Silverwolfg11 in https://github.com/elian1203/ezAuctions/pull/56
* Fix illegal item stack sizes in hover events and default messages file by @Momshroom in https://github.com/elian1203/ezAuctions/pull/59

## New Contributors
* @Momshroom made their first contribution in https://github.com/elian1203/ezAuctions/pull/59

**Full Changelog**: https://github.com/elian1203/ezAuctions/compare/2.2.2...2.2.3
----------, Sep 14, 2024

  • Stop sending bid messages for sealed auctions
----------, Mar 2, 2024

  • Fix prefix raw load order
----------, Oct 9, 2023

- Add update command to allow manual updating
- Use key from default messages.properties if missing
----------, Oct 9, 2023

- Fix exception from MiniMessage when item has colors in name/lore
----------, Oct 9, 2023

* Add support for auto updating plugin when new release available on github
* Plugin will now check for latest supported plugin version based on api-version in spigot.yml
* login.updatemessage will now display server and update version
* Plugin will auto download the latest update and apply it (remove old jar, move new jar) on server shutdown
----------, Sep 22, 2023

IF RUNNING 2.0.0-2.0.1 YOU MUST UPDATE TO THIS VERSION, THERE IS A DUPE BUG
  • Fix critical item duplication bug caused by incorrectly counting number of items in inventory
  • Make auction amount string case-insensitive
----------, Aug 29, 2023

  • Fix messages still using {0} for args in default messages.properties file
----------, Aug 10, 2023

Rewrite plugin from the ground up.
VERY IMPORTANT:
  • Minecraft versions 1.20.1 and up supported. Anything under is NO LONGER supported
  • Existing config.yml and messages.properties files MUST be deleted! There have been numerous changes in these files and using the older versions WILL cause errors
  • Flat file storage type is no longer supported. The default storage type is SQLite, but MySQL/MariaDB are also supported.
  • Database structure has been redone. This means that your database will be starting from scratch. Player ignores will be gone, saved items that players have yet to retrieve will be gone, etc)
  • If you are using the plugin API at all (for events through code or DiscordSrv for example), you will need to update to use the latest API as most things have changed. The same events still exist, but underlying event data may have changed.
New features
  • Folia supported! The plugin now runs smoothly on the multithreaded Folia server platform. Spigot and Paper are still supported.
  • All messages replaced to use MiniMessage! This message format allows for advanced message features and ultimate control of your chat messages
    • Using MiniMessage, you can now format your numbers to any locale. See the below example where all the numbers have been formatted in Arabic. The item name is in Arabic due to the user's language being set to Arabic.
[​IMG]
  • You can now add click commands, player hovers, and more. See https://docs.advntr.dev/minimessage/format.html for more details
  • Addon messages (skull, autobuy, sealed, repair) no longer have to be on separate lines. See the below example where the skull messages is right after the item name
[​IMG]
  • Custom formatting for custom item names. As you can see in the screenshot above, the item has a custom name of "Skull of Notch" and has thus been italicized
  • Gradients now supported
[​IMG]
    • Scoreboard also supports MiniMessage
  • Console logging of auctioned items full data. You can now protect your player's items in the event of a server crash while an auction is running or just have detailed logs of what players auctioned
Code (Text):
[20:17:13 INFO]: [ezAuctions] Item starting in auction. Auctioneer: Elian Amount: 1 Item: DIAMOND_SWORD NBT: {Damage:0,Enchantments:[{id:"sharpness",lvl:5s}],RepairCost:1,display:{Name:'{"text":"mlg sword"}'}}
  • Plugin operations are almost entirely asynchronous, reducing load on the main thread for non-Folia servers
----------, Aug 9, 2023

- Hex colors are now supported in the messages.properties file. Hex colors can be specified as such: &#[hex value], example: &#FF0000 will be translated to red
- The order of commands in the /auctions help page can now be changed via the config
- Ensure that only commands the player has permission to use will be shown in the help
- Added ability to disable *most* messages by setting the value in the message.properties to empty
- Fix exception when loading plugin without Vault installed
----------, Jul 10, 2023

Fix a bug where files were not included in the jar
----------, Jun 26, 2023

  • Remove deprecation warnings when starting server
  • Resolve exception thrown to console when the plugin is loaded without vault/econ provider
----------, May 9, 2023

  • Fix error when running end command
  • Fix shutdown errors from task scheduling
----------, Apr 23, 2022

  • Automatically add missing message.properties keys to file
  • Updated 1.18 reflection method to hopefully be less version dependent
----------, Dec 12, 2021

  • Added 1.18 support
  • Added missing message in message.properties (command.auction.end.help)
----------, Dec 11, 2021

Add item on main thread - fixed an issue from last version
----------, Sep 20, 2021

- Count players in auction queue as participating in auction for blocked command purposes
- Run auction reward in an async task to prevent issues with vault/luckperms
----------, Sep 18, 2021

  • Fix item hover on 1.17
----------, Jul 10, 2021

Small fix on an NPE
----------, Jun 19, 2021

  • Bumped Java version to 11
  • Added safety check when getting auction player to ensure they have player data created
  • No longer show auction scoreboards to players in blocked auction worlds or in worlds where the player is not in the originating world of the auction when per-world-broadcast is enabled
  • Added configurable auction queue cooldown that limits how often players can start auctions
----------, Jun 19, 2021

  • Added per-world-broadcast config option which limits broadcasts to players in the world which the auction was started in
    • auctions:
      per-world-broadcast: true
  • Added support for permissions to bypass queue limits
    • ezauctions.auction.queuelimit.# to allow a bypass of the auction queue limit to that #
    • ezauctions.auction.currentlimit.# to allow a bypass of not being able to have more than one auction currently running or in queue
Explanation of how to use the new permissions:

ezauctions.auction.queuelimit.# where the # is queue limit for that player. This means that if the auction queue is at that # or more, they cannot start a new auction

ezauctions.auction.currentlimit.# where # is the current limit for that player. This means that if the player already has items being auctioned or in the queue, they can add more to that #. Not having that permission means they can only have an auction either running or in the queue. If the # is 1, they can have an auction running and 1 in the queue, and the number can be as big as you'd like.
----------, Feb 22, 2021

  • Add warning message to detect if plugin was reloaded or enabled by an external plugin
  • Added character limit of 40 characters to each line in the scoreboard to prevent errors
----------, Feb 15, 2021

- Implemented tax exemption permission, granted with ezauctions.taxexempt
----------, Dec 17, 2020

  • Add config option for quotes around custom named items
  • Fix misnomer for prior work penalty with anvils
  • Fixed packet exploits
  • Require a specific permission for ending other players' auctions.

New config key: auctions.toggles.quotes-around-name
New messages key: command.auction.end.attempt-others

You can find the keys at our wiki here
Config
Messages

Thank you for your continued use of the plugin!
----------, Nov 30, 2020

A few new features and changes. Thank you for using this plugin!

- Players can no longer receive auction winnings on blocked auction worlds
- Per world auctions are now available. When enabled the player must bid in the world where the auction was started and must be in the world to receive their winnings (delayed until they return)
- The auction starting min/max are now configurable
- Fixed errors with /auc remove
- /auc end is now available to end auctions early while still having the winnings go to the highest bidder
- Plugins can implement their own database (check the merge request linked below)

To view all changes see the merge request here
Merge Request

To view the config/messages file on the wiki click the links below
Config
Messages

Config Changes:
auctions.minimum.starting-price
auctions.maximum.starting-price
auctions.per-world-auctions

Messages:
command.no_perm={prefix}&cYou don''t have permission to run this command!
command.no_current_auction=&cThere is no current auction.
# {0} is the error messages
command.error_prefix={prefix}&cError: {0}
# {0} is the base command. {1} is the syntax
command.usage={prefix}&cUsage: &b{0} {1}
command.auction.start.invalid_start_price.min={prefix} &cStarting price is too low!
command.auction.start.invalid_start_price.max={prefix} &cStarting price is too high!
auction.end={prefix}&9The auction has been ended!
command.bid.wrong_world={prefix}&cYou cannot bid in this world! You must be in {0}.
reward.blocked_world={prefix}&cYou cannot receive items in this world.
reward.relogged_blocked_world={prefix}&cYou have winnings that cannot be claimed in this world.
# {0} is the world in which the item resides
reward.wrong_world={prefix}&cYou cannot collect your winnings until you return to world {0}.
reward.relogged_wrong_world={prefix}&cYou have winnings in world {0}. Return to that world to claim them.
----------, Jun 20, 2020

The last version had a few issues that have been amended in this new version
- Removed debug messages that were accidentally left over
- Added auction queue help message to the default config and wiki so as to not confuse anyone
- Fixed cancelled auctions not rewarding the highest bidder
- Fixed an error caused by the auction queue
----------, Apr 3, 2020

Apologizes for how long it took to post this update.
Changes:
- Fixed consecutive bids being handled wrong
- Added a new sub command that shows what items are in the auction queue
- Fix 1.12 compatibility
- Basic spigot tab completion added

Update to messages.properties:
Added strings are command.auction.queue.list, command.auction.queue.empty, command.auction.queue.item

The messages file as well as other files and information is always available on gitlab. Thank you so much for using our plugin!
----------, Mar 25, 2020

- MC 1.15 support
- SQLite, MySQL support added
- Better version checking method which may not require modification for future MC versions
- Better handling of JSON storage for servers with high player counts
- Full credits to Silverwolfg11

IMPORTANT

You must update the config file when updating or you will get errors.

In the config.yml you will find a new section "data" which you must copy over. You may keep it as is and it will work fine, or you may change the storage type to SQLite or MySQL at your discretion.

In messages.properties you will find two new strings, "command.auction.save.help" and "command.auction.save". It is not necessary to put these in your messages file, however it is recommended.

Thank you for using the plugin and I hope you enjoy. Any issues can be reported on our discord server.
----------, Dec 20, 2019

- Added "/auc sb" alias for "/auc scoreboard"
- Added "blocked-commands" in config to restrict players from executing certain commands when participating in an auction


These changes have generated changes to the config and messages files.

As always you can find these files on the wiki.
Config
Messages

You may either delete your config and messages files or manually add these new sections.

The config file has the new list auctions.blocked-commands

The new messages file has one new strings:
- auction.blocked_command
----------, Oct 29, 2019

- Deny players in creative mode from auctioning (in config)
- Scoreboards!!! An auto-updating scoreboard for auctions
- '/auc scoreboard' command added to ignore the scoreboard
- Accompanying permission is ezauctions.auction.scoreboard

These changes have generated changes to the config and messages files.

As always you can find these files on the wiki.
Config
Messages

You may either delete your config and messages files or manually add these new sections.

The config file has the new option auctions.toggles.deny-creative and a new section named scoreboard.

The new messages file has multiple new strings:
- command.auction.scoreboard.help
- command.auction.scoreboard.enabled
- command.auction.scoreboard.disabled
- scoreboard.title
- scoreboard.body
- scoreboard.current_bid
- scoreboard.current_bid_sealed
- scoreboard.time
- scoreboard.skull
- scoreboard.repair.price
- scoreboard.repair.impossible
- scoreboard.autobuy
- scoreboard.sealed
----------, Aug 4, 2019

- Should fix plugin running on 1.13
----------, Jun 3, 2019

- Updated serialization method so it should be more reliable and give less errors
- Added new placeholders for auction.bid, auction.time_left, auction.finish, and auction.finish.no_bids
- These placeholders allow the item to be in those messages (and can be hovered over)
- Added ability to use custom item names when available (anvil names)

These changes have generated changes to the config and messages files. The config file has a new option which is auctions.toggles.display-custom-name
The messages.properties file does not have any new messages, however it has explanations for the new placeholders.

View these files here
Config
Messages
----------, May 18, 2019

- Added support for 1.14 and 1.14.1
----------, May 14, 2019

- Update Vault API
----------, Oct 21, 2018

- Update to support MC 1.13.1
- Fixed formatting with auction start message (&l, &m, etc)
- Added new sub command for ignoring auctions from specific players

To properly update you will have to delete your messages file OR add these new lines to the messages file.
https://pastebin.com/HJev3nUK

Ensure that they are pasted on a new line otherwise they may not work properly. Once they are added to the file you may edit them the same as you can with the other messages.
----------, Sep 3, 2018

- Update to support MC 1.13
- Changed method of checking latest version
- Got rid of item ID support for blocked items
----------, Jul 28, 2018

- Fixed serialization of enchanted books (bug where if you logged off after auctioning an enchanted book that had no bids, you wouldn't receive it upon rejoining)
- Fixed update notification always going off even when plugin is up to date
----------, Feb 24, 2018

- Small fix for a big problem (fix error due to Reflection mistakes / item names will show up in chat again)
----------, Jul 29, 2017

- Fixed banners showing up as tile.banner.name in auctions
----------, Jul 29, 2017

- Changed bidding system - fixed an issue where some of the losing bidders wouldn't have their money returned
- Restricted bidding in a blocked world

NOTE:

You should either delete your messages file or update it manually.

For manual updating:


messages.properties updates:
Simply add this on a separate line at the end of the file:
"command.bid.blocked_world={prefix}&cYou cannot place a bid in this world!"
----------, Jul 26, 2017

- Fixed being able to bid higher than the auto-buy and override it.
----------, Jul 17, 2017

- Fixed item translation parsing
- Support for UTF-8 in messages file
- "/auc startsealed" help no longer appears when sealed auctions are disabled
- Update checking runs async now to prevent lag on startup/reload
----------, Jul 8, 2017

- Added translation for items! Based off of whatever the player's game language is set to.
----------, Jul 6, 2017

- Changed the way the console is messaged which should allow 1.11.2 usage
- Added an update checker and message on join
- Changed messaging so that if your messages file is missing a message, it won't show huge error message in console

NOTE:
You should either delete your config and messages files or update them manually.

For manual updating:


config.yml updates:
general.check-updates
See config on wiki

messages.properties updates:
Simply add this on a separate line at the end of the file:
"login.updatemessage={prefix}&9An update is available!"
----------, Jun 21, 2017

  • Fixed buyout issue where you could set the buyout at a price lower than the auction starting price
  • Added bStats Metrics
----------, Jun 20, 2017

Resource Information
Author:
----------
Total Downloads: 17,591
First Release: Jun 20, 2017
Last Update: Oct 16, 2024
Category: ---------------
All-Time Rating:
34 ratings
Find more info at github.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings