FAuction

26.3 compatibility

A fix for Folia servers. If you run Paper or Spigot, nothing in this release changes anything for you and you can update whenever it suits you. If you run Folia, this one is worth taking. The Folia support shipped in 2.2.0 left two windows open where a player disconnecting at the wrong moment could make an item, or a payment, disappear. Both are closed.

Items lost on a disconnection

When a player cancelled one of their own auctions, bought an item, took back an expired item or put one up for sale, the item was removed from the database before being handed over. If the player disconnected during that short moment, the item was never handed over and was gone for good. The operation is now undone cleanly instead: the auction goes back on the market, an expired item goes back to the expired items, and an item taken for a sale that could not be saved is placed in its seller's expired items. The player finds their item again when they log back in, and every case is logged to the console.

Sales blocked by the duplication protection

After such a disconnection, the item's signature stayed stuck in the anti-duplication filter. From then on nobody could put a visually identical item up for sale, server-wide, until the next restart. The signature is now released in every case.

Pending payments in XP and LEVEL mode

Payments held for a seller who was offline were credited from the wrong thread under Folia, which Folia does not allow. They now go through the player's own region thread. A payment that does not go through stays owed to the player instead of being cleared.

Updating

Replace the jar and restart. No configuration change, no database change, and nothing for your players to do.

Folia support

FAuction now officially supports Folia, in addition to Paper and its other forks. - Every scheduled operation in the plugin — one-off async/sync work as well as the recurring auction expiration, cache refresh, pending currency delivery, and anti-spam cleanup tasks — now runs through a Folia-aware scheduler instead of the plain Bukkit scheduler, which Folia does not support. - The unmaintained TaskChain dependency (co.aikar:taskchain-bukkit, no release since 2019-2021) has been fully removed. - No configuration change required; behavior on regular Paper servers is unchanged.

Command framework replaced: ACF → Cloud

The plugin no longer runs on ACF, which is no longer maintained, but on [Cloud](https://cloud.incendo.org) 2.x instead. - Nothing changes for your permissions or command paths: /ah, /hdv and all 13 subcommands are exactly where they were. - /ah help has a new layout, generated by Cloud. - /ah help <query> now shows the help for a single command. - /ah admin reload now reloads the language file too — it used to only be read at startup. - /ah admin migrate now refuses a migration version it doesn't recognize (and tab-completes the ones it does), instead of silently doing nothing and reporting success. - /ah sell now refuses NaN or Infinity as a price before touching your inventory. - Minimum server version is now Paper 1.16.5.

Language files

- Language files are now versioned and updated automatically, exactly like the other configuration files — no action required. - Your customised texts are preserved; a lang_<code>.yml.bak backup is kept next to the file before its first automatic update. - A language the plugin doesn't ship (e.g. lang_de.yml) keeps every key you wrote and falls back to English for the rest. - Chinese (lang_zhcn.yml) gained 3 messages that were silently never sent before (max_price, clear_cache, migrate).

Other

- Various dependency updates and internal hardening (CodeQL findings addressed).

Bug Fixes

- Fixed a crash (NumberFormatException) when running /ah sell while money-format used a thousands separator (e.g. #,##0). - Fixed inconsistent price formatting in chat messages (listing confirmation, minimum/maximum price errors) — they now match the format already shown in the GUI instead of raw values like 1000.0.

Some auctions (and items sitting in the expired-items view) could no longer be cancelled or claimed. The console showed an error such as: [FAuction] Auction X could not be deleted from the database ; kept on the market instead of being lost from the cache for nothing. Cause: on SQLite, new listings were assigned an id guessed locally instead of the one the database actually generated. Once the highest-id listing had ever been sold or removed, that guess fell out of sync with the database — so any new listing added afterward got an id that didn't match any real row, making it permanently impossible to delete or claim. Fix: new auctions and expired items now always use the id the database itself assigned. No more drift between the in-memory cache and the database, and no more stuck listings. If you were affected, existing stuck items should resolve themselves once you sell/cancel/withdraw them again after updating; any that were already orphaned may need a manual database check (see the plugin's SQL tables if in doubt).

Rewrite the duplication protection to make it better. This rewrite aims to eliminate as many false positives and remaining vulnerabilities as possible.

Categories display rework new block exemple :

  '51':
    utility: category
    material: BOOK
    title: "&5Filter."
    description:
      - "&eClick here to change filter"
      - "{previousCategories}"
      - "&e{currentCategory}"
      - "{nextCategories}"

Better code + update dependencies + support 26.2

new option hideFlag

gui:
  size: 54
  type: CHEST
  name: "Auction House {Page}/{TotalPage}"
  title: "&eItem : &6{ItemName}"
  replaceTitle: false
  hideFlag: false
  description:
    - "&5Sold by : &6{OwnerName}"
    - "&5Price : &6{Price}"
    - "&5Expires on : &6{ExpireTime}"
    - "&5Remaining time : &6{RemainingTime}"
    - "&5Lore :"
    - "{lore}"

1.21.11 support

Memory leak fix

1.21.10 compatibility, rework item selection, update dependency

1.21.9 compatibility

set in database.yml (only if you have mariadb database) : type: MariaDB

Patch for gui size

New lang system by @seetch

New Sorting system, new command ah search and more category customisation New block in gui configuration :

    utility: sorting
    material: BOOK
    title: "&5Sort."
    description:
      - "&eClick here to sort item"
      - "&eCurrent sort : {sortDisplayName}"

New configuration sort.yml New command /ah search ITEM_TYPE Thank to seetch for more category customisation

Add PostgreSQL support In database.yml set type to PostgreSQL

patch on min price calcul

bug patch

Duplication fix

patch for categories load default file + custom file

1.21.8 support + dependency update

1.21.7 support

Update dependency

Remaining time correction

Item visualization in AuctionConfirmGui

Feature flipping for hashcode duplication control

1.21.6 support

Money format feature flipping

Anti duplication rework

Spigot compatibility

Correction for command block

SQLite correction

New command step :

  '45':
    utility: command
    value : "This is a command"
    material: CHEST_MINECART
    title: "&cThis block execute a command"
    description: {}

New message : add this in your lang file

buy_auction_target_success: "The player {player} bought your item {item} at the price of {price}."

SQLite rework

Add support for other currency like experience and level in config.yml

currencyUse: VAULT # VAULT, EXPERIENCE, LEVEL

Mysql improvement Thanks to @NezuShin

1.21.5 support

Dependency update + duplication protection

Empty message don't send message

Java 16 minimum support

Linux directory creation fix

ItemPrice format correction

Add new menu configuration to have custom menu. Configuration example : https://github.com/Florianpal1/FAuctionUI/blob/main/en/me… You can add gui configuration in FAuction/gui/menus New block to access to menu

  '26':
    utility: menu
    id: main 
    material: CHEST_MINECART
    title: Go to the main menu
    description: {}

New configuration in config.yml to choose the gui open with command /ah :

defaultGui: AUCTION# The default gui open with /ah command

Possible value : AUCTION, EXPIRE, HISTORIC, PLAYER, MENU:id

Nullptr correction

Nullptr correction

historic and playerview fix

Next gui correction

New configuration allows you not to send certain messages

message-send:
  AUCTION_OPEN: true

For configuration see lang file Exemple : buy_auction_success -> BUY_AUCTION_SUCCESS

To make migration execute command : ah admin migrate 1.7.8 add in lang file : migrate: "You have migrated to {version}." migrate_help_description: "Migrate to another version."

Correction

In auctionConfirm.yml add :

gui.auction:
    title: "&eItem : &6{ItemName}"
    replaceTitle: false
    description:
      - "&5Sold by : &6{OwnerName}"
      - "&5Price : &6{Price}"
      - "&5Expires on : &6{ExpireTime}"
      - "&5Lore :"
      - "{lore}"

New purge command : /ah admin purge all /ah admin purge auction /ah admin purge expire /ah admin purge historic Decimal format correction Sqlite correction

New configuration in config.yml : decimalFormat: "0.00"

Add 2 feature flipping - item-expiration - cache-update

SQLite correction + Remaining time placeholder for auction new placeholder for auction gui : {RemainingTime}

Mysql Correction

Disable the plugin if it cannot start correctly

New Configuration system Please backup your configuration file before updating The new configuration system will automatically update your configuration files.

Permission fix

New chart on bstats and dependency update

Add new category ENCHANTED to filter all enchanted item Add new permission fauction.user contains : - fauction.list - fauction.sell - fauction.expire

Code Refacto + possible bug correction

CacheReloadEvent correction

Better Configuration + Event correction

SQL Expire correction

API Documentation : https://github.com/Florianpal1/FAuction/wiki/API New Event : AuctionAddEvent AuctionBuyEvent AuctionCancelEvent CacheReloadEvent ExpireAddEvent ExpireRemoveEvent

Bug correction for category, next et previous

Java 8 Support + Correction

Refacto

Add Head texture and CustomModelData to Action Confirm GUI confirm utilities. Thank to @NezuShin

Refacto + Optimization

Add Placeholder api : Get number of player auction : %fauction_auction_number% Get number of player expire : %fauction_expire_number% Get number of player historic : %fauction_historic_number% Add new Configuration in config.yml : cacheUpdate: 72000 #In ticks 72000 ticks == 1 Hour

Add api : to get api object use FAuction.getApi() for maven or gradle : https://github.com/Florianpal1/FAuction/packages/2339230

First Version