All Mods Resource Packs Data Packs Shaders Modpacks Plugins
FAuction

FAuction

by Florianpal • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

FAuction

FAuction is a 100% gui auction house management plugin. There is only one command. All gui are 100% configurable.

Wiki | GitHub | Discord

Support :

Features :

  • Full language customization (English, French, Russian, Simplified Chinese)
  • Used Aikar Commands
  • Modded or Custom item support
  • Fully Customisable Gui
  • Multiple currency modes : Vault economy, XP points or XP levels
  • Search auctions by material
  • Configurable category filters (weapons, tools, armor, blocks, food, potions, enchanted, custom, ...)
  • Configurable sort options (by date or by price, ascending/descending)
  • Purchase confirmation gui
  • Transaction history (buyer, seller, date)
  • Player view : see only your own listings
  • Auction limitation (per rank, or per LuckPerms meta)
  • Configurable minimum and maximum price per item (support Shulker)
  • Shulker/Barrel visualization
  • Packet-spam / duplication protection
  • Multi-server support via a shared database
  • PlaceholderAPI support

Gui Translation : https://github.com/Florianpal1/FAuctionUI

Custom Configuration :

All gui are configurable, you can make your own gui with custom head texture and customModelData.

Custom head texture is only available for Paper server.

For more detail see the documentation : Gui Configuration

Dependency :

  • Java 21
  • Paper server (or a Paper fork)
  • SQLite, MySQL, MariaDB or PostgreSQL
  • Vault (optional, only required for the default VAULT currency mode — the EXPERIENCE and LEVEL modes don't need it)
  • PlaceholderAPI (optional, for placeholders)
  • LuckPerms (optional, only for per-rank auction limits via meta)

Installation :

  • Put the jar file in plugins of all servers
  • Configure database.yml for MySQL/MariaDB/PostgreSQL (same database for every server if you run a network ; SQLite is enough for a single server)

bstats

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
1.13.x
Bukkit Folia Paper Purpur Spigot
12h ago 1
26.3 26.2 26.1.x +2
Bukkit Folia Paper Purpur Spigot
12h ago 1
26.2 26.1.x 1.21.x +5
Bukkit Folia Paper Purpur Spigot
12h ago 1
26.2 26.1.x 1.21.x +5
Bukkit Folia Paper Purpur Spigot
12h ago 1
26.2 26.1.x 1.21.x +1
Bukkit Paper Purpur Spigot
12h ago 1
26.2 26.1.x 1.21.x +1
Bukkit Paper Purpur Spigot
12h ago 1
26.2 26.1.x 1.21.x +1
Bukkit Paper Purpur Spigot
12h ago 1
26.2 26.1.x 1.21.x +1
Bukkit Paper Purpur Spigot
12h ago 1
26.1.x 1.21.x 1.20.x +4
Bukkit Paper Purpur Spigot
12h ago 1
26.1.x 1.21.x 1.20.x +4
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +3
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +4
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.13.x
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Purpur Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Spigot
12h ago 1
1.21.x 1.20.x 1.19.x +6
Bukkit Paper Spigot
12h ago 1
[V2.3.0] FAuction 2.3.0 by Florianpal on Oct 15, 2026
Download
## ✨ New features

### Name the commands yourself

The commands are no longer fixed to /ah, /hdv and their English subcommands. A new commands: section in config.yml lets you rename every one of them, or add aliases:

``yaml
commands:
root: ["ah", "hdv"]
list: ["list"]
search: ["search"]
sell: ["sell", "vendre"]
expire: ["expire"]
help: ["help"]
admin: ["admin"]
`

  • The first name of each list is the main one, shown in the help and in the error messages. The others are aliases.
  • Permissions do not change**: renaming sell to vendre keeps fauction.sell.
  • A change needs a full restart**: /ah admin reload detects it and tells you to restart.
  • A mistake never stops the plugin**: invalid or duplicate names fall back to the defaults, and the console says what was refused.

### Update notifications

At startup and on every
/ah admin reload, FAuction checks GitHub for a newer release and warns the console, with a link to it.

  • Nothing is downloaded or installed, and the check runs asynchronously (Paper and Folia).
  • A server without internet access shows no warning.
  • Turn it off with update-checker.enabled: false in config.yml.

## 🔧 Other changes

  • New bStats chart: players per plugin version.
  • New message commands_restart_required in every language file.

## ⬆️ Updating

Replace the jar and restart. Your
config.yml` and language files are updated automatically: the new keys are added and your existing values are kept.

[V2.2.2] FAuction 2.2.2 by Florianpal on Oct 15, 2026
Download
26.3 compatibility
[V2.2.1] FAuction 2.2.1 by Florianpal on Oct 15, 2026
Download
  • 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.

[V2.2.0] Folia support by Florianpal on Oct 15, 2026
Download
### 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.

[V2.1.0] FAuction 2.1.0 by Florianpal on Oct 15, 2026
Download
### 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).
[V2.0.2] FAuction 2.0.2 by Florianpal on Oct 15, 2026
Download
## 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).

[2.0.0] FAuction 2.0.0 by Florianpal on Oct 15, 2026
Download
Rewrite the duplication protection to make it better. This rewrite aims to eliminate as many false positives and remaining vulnerabilities as possible.


[1.9.10] FAuction 1.9.10 by Florianpal on Oct 15, 2026
Download
Categories display rework

new block exemple :

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

[V1.9.9] FAuction 1.9.9 by Florianpal on Oct 15, 2026
Download
Better code + update dependencies + support 26.2
[V1.9.8] FAuction 1.9.8 by Florianpal on Oct 15, 2026
Download
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}"
``


[V1.9.7] FAuction 1.9.7 by Florianpal on Oct 15, 2026
Download
1.21.11 support
[V1.9.6] FAuction 1.9.6 by Florianpal on Oct 15, 2026
Download
Memory leak fix
[V1.9.5] FAuction 1.9.5 by Florianpal on Oct 15, 2026
Download
1.21.10 compatibility, rework item selection, update dependency
[V1.9.4] FAuction 1.9.4 by Florianpal on Oct 15, 2026
Download
1.21.9 compatibility
[V1.9.3] FAuction 1.9.3 by Florianpal on Oct 15, 2026
Download
set in database.yml (only if you have mariadb database) :

type: MariaDB
[V1.9.2] FAuction 1.9.2 by Florianpal on Oct 15, 2026
Download
Patch for gui size
[V1.9.1] FAuction 1.9.1 by Florianpal on Oct 15, 2026
Download
New lang system by @seetch
[V1.9.0] FAuction 1.9.0 by Florianpal on Oct 15, 2026
Download
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
[V1.8.25] FAuction 1.8.25 by Florianpal on Oct 15, 2026
Download
Add PostgreSQL support
In database.yml set type to PostgreSQL
[V1.8.24] FAuction 1.8.24 by Florianpal on Oct 15, 2026
Download
patch on min price calcul
[V1.8.23] FAuction 1.8.23 by Florianpal on Oct 15, 2026
Download
bug patch
[V1.8.22] FAuction 1.8.22 by Florianpal on Oct 15, 2026
Download
Duplication fix
[V1.8.21] FAuction 1.8.21 by Florianpal on Oct 15, 2026
Download
patch for categories load default file + custom file
[V1.8.20] FAuction 1.8.20 by Florianpal on Oct 15, 2026
Download
1.21.8 support + dependency update
[V1.8.19] FAuction 1.8.19 by Florianpal on Oct 15, 2026
Download
1.21.7 support
[V1.8.18] FAuction 1.8.18 by Florianpal on Oct 15, 2026
Download
Update dependency
[V1.8.17] FAuction 1.8.17 by Florianpal on Oct 15, 2026
Download
Remaining time correction
[V1.8.16] FAuction 1.8.16 by Florianpal on Oct 15, 2026
Download
Item visualization in AuctionConfirmGui
[V1.8.15] FAuction 1.8.15 by Florianpal on Oct 15, 2026
Download
Feature flipping for hashcode duplication control
FAuction Icon
Download FAuction
Select game version
Select platform