Beta Phase

ProtonAuctions is currently in Public Beta (v1.0.0.0-BETA).

The transaction engine and the money paths are the most mature part of the plugin. Peripheral features, specific platform integrations, and advanced configuration are still maturing.

We prioritise data safety. The installation-bound encryption key means an invalid or expired licence makes transactions fail cleanly and never corrupts or locks your data. Where a feature is marked BETA, the code exists but is still being refined.

---

System Integrity (The Core)

The transaction backbone.

Component	Status	Notes
Native Rust VM	STABLE	Every money-moving operation runs as encrypted bytecode in the native VM.
DRM / Licensing	STABLE	Ed25519 signed tickets, per-build session and opcode seeding, native integrity checks and a 7-day offline grace.
Atomic Money Path	STABLE	A purchase, bid or buyout is all-or-nothing. A failure at any step rolls the whole transaction back, so no half-finished sales and no created or destroyed money.
Escrow Fail-Safe	STABLE	When a payout cannot complete, the item or money is routed to the Claim Bin rather than lost.
Concurrency Locks	STABLE	Per-auction and per-player mutexes prevent double sales and race conditions.
Search Engine	STABLE	In-memory inverted index with prefix and multi-token matching.

---

Platform & Storage

Supported environments and database drivers.

Platform / Driver	Status	Notes
Paper 1.21.0 - 1.21.11	SUPPORTED	Primary target.
Paper 26.1.x	SUPPORTED	Runs on Java 25.
Paper 26.2	SUPPORTED	Runs on Java 25.
Paper (below 1.21.0)	UNSUPPORTED	The minimum supported version is 1.21.0.
Folia	SUPPORTED	Requires a Folia-safe Vault such as VaultUnlocked, the default Vault crashes on Folia.
SQLite	STABLE	Default local storage. Single-server.
MySQL / MariaDB	BETA	Full schema and encrypted storage support.
PostgreSQL	BETA	Full schema and encrypted storage support.
Redis Sync	BETA	Cross-server cache invalidation via pub/sub. Requires Redis 6+. A visible cross-server round trip needs a shared MySQL or PostgreSQL database, since SQLite is single-server.

---

Economy & Transactions

The financial engine behaviour.

Feature	Status	Notes
BIN Listings	STABLE	Buy-now purchases, sales and configurable tax.
Auction Bidding	STABLE	Bid increments, top-bidder tracking and anti-snipe.
Instant Buyout	STABLE	Buy an auction outright at the buyout price.
Multi-Currency	STABLE	Real cross-currency exchange rates, configured or learned from trades. A currency whose plugin is not present renders with a fallback symbol. Sales in a currency with no exchange rate yet are left out of prices until it has one.
Currency Autopilot	BETA	Heuristic scanner that adopts an unknown economy plugin automatically. It runs a small canary deposit and withdrawal to validate a provider, so confirm a few transactions before opening to the public. Disabled by default.
Claims (Items)	STABLE	Item retrieval, auto-claim on join, and expiry return.
Claims (Revenue)	STABLE	Payout vouchers, including expiry forfeit and auto-deposit. Autopilot-detected currencies are excluded from voucher payout.
Sales History	STABLE	Ledger recording and the history view.

---

Barter System (Item-for-Item Trading)

A currency-free trading system that lets players exchange items directly.

Feature	Status	Notes
Core Barter Trading	STABLE	Full item-for-item flow with encrypted escrow. Items are held securely until the trade resolves.
Create Listings	STABLE	Players list items for barter with optional requested items.
Submit Offers	STABLE	Multiple concurrent offers per listing.
Accept/Reject Offers	STABLE	Seller reviews and responds. Rejected items return via Claims.
Offer Withdrawal	STABLE	Offerers withdraw pending offers and reclaim their items.
Listing Expiration	STABLE	Configurable expiration. Items auto-return to the seller via Claims.
Offer Expiration	STABLE	Configurable expiration. Offered items auto-return to the offerer via Claims.
Requested Items	STABLE	Sellers specify desired items and see a live match tally. Advisory only. Offers are not force-rejected.
Trade Notifications	STABLE	In-game messages for offer received, accepted, rejected, expired and listing expired.
Barter GUI	STABLE	Dedicated views for browsing, creating, offering and managing trades.

The Barter System is disabled by default. Enable it in config.yml under barterSettings.enabled: true.

---

Economy Analytics Engine (ML-Powered)

An internal analytics system providing market intelligence, price suggestions and exploit detection. It learns your server's own economy from its own trades. Nothing is pre-loaded, and the model it builds stays on your server. The only thing that can send anything outward is the optional beta telemetry, covered in Data & Privacy.

Feature	Status	Notes
Data Ingestion	STABLE	Buffered batch processing with a capped buffer and overflow protection.
Grace Period	STABLE	Configurable data-collection window before suggestions activate (default 24 hours).
Price Suggestions	BETA	Suggests a price via /ah suggest, learned from your server's trades. It stays silent on items without enough history.
Confidence Calculation	BETA	Variance, echo and staleness penalties lower confidence on volatile or thin data.
Custom-Item Pricing	BETA	Identifies items from Nexo, Oraxen, ItemsAdder, MMOItems and MythicMobs by their own plugin id, and spawners from SilkSpawners and SpawnerMeta by their mob, and prices by rarity.
Market Trend Analysis	BETA	Detects RISING_FAST, RISING, STABLE, FALLING, FALLING_FAST.
Time-to-Sell Estimates	BETA	Estimates how long items take to sell at different prices.
Dynamic Thresholds	STABLE	Auto-adjusts the minimum data required based on server activity (small SMP vs large economy).
Anomaly Detection	BETA	Statistical detection of price outliers, wash trading, coordinated activity and volume spikes.
ML Fraud Detection	EXPERIMENTAL	A deep autoencoder and a graph neural network (GCN) in native Rust for wash-trading and collusion detection. Requires a valid licence.
Training Scheduler	BETA	Trains only when the server is above 18 TPS and quiet, to avoid peak-hour impact.
EWMA Price Normalization	STABLE	Handles natural inflation and deflation without false positives.
Trust Score System	BETA	Weights training data by how trustworthy each trader is, so fake trades cannot poison the pricing. Penalises new accounts, rewards established ones.

The Economy Analytics Engine is enabled by default (economyEngine.enabled: true). It only collects data locally, and suggestions become available after the grace period (default 24 hours) and once there is enough trade history. Set economyEngine.enabled: false to turn it off.

---

External Data Hooks

The analytics engine reads other economy, shop, trade and payment plugins. Player shops and trades teach it real prices, server shops and sell plugins set price floors and ceilings, and payments between players feed fraud detection. The more real sources connected, the better the engine understands your server's economy. Each hook is described on the Supported Plugins page.

{% hint style="info" %} AVAILABLE means the integration is built and active. BETA means it is built but limited. EXPERIMENTAL means it is built but has not been checked against the real plugin. PLANNED means it is on the roadmap. Planned integrations are added on request or by community impact, not on a fixed timeline.

Native Integration

Plugin	Status	Notes
ProtonAuctions	AVAILABLE	Native. All auction, bid, buyout and barter sales are ingested automatically.

Economy Providers

Plugins that provide virtual currencies and balance management.

Plugin	Status	Notes
Vault	AVAILABLE	The core economy bridge and the primary path. Any economy plugin that registers with Vault works through it.
EssentialsX Economy	AVAILABLE	Works through its Vault economy.
PlayerPoints	AVAILABLE	Direct hook. Usable as a real second currency with exchange rates.
TokenManager	AVAILABLE	Direct hook for a token currency. Its latest release, 3.2.8 from April 2023, did not start on Paper 1.21.4 or 1.21.8 in our tests.
Eco	BETA	Direct hook.
CoinsEngine / ExcellentEconomy	AVAILABLE	Each of its currencies can price listings. A currency that is also the Vault economy is used as that, never counted twice.
GemsEconomy	AVAILABLE	Each of its currencies can price listings.
EcoBits	AVAILABLE	Each of its currencies can price listings. A currency set as the Vault economy is used as that.
X-Prison	AVAILABLE	Each of its currencies can price listings. X-Prison only keeps balances for players who are online, so a payout to a seller who is offline waits in /ah claim.
zEssentials	AVAILABLE	Each of its economies can price listings. A payout to a player who is offline waits in /ah claim, because zEssentials cannot confirm it.

Shop Plugins

Plugins that handle item buying and selling, the primary data sources for price intelligence.

Plugin	Status	Notes
UltimateShop	AVAILABLE	Shop prices become price limits. Config key economyEngine.hooks.ultimateshop.
ShopGUIPlus	AVAILABLE	Shop prices become price limits, in the shop's real currency. Config key economyEngine.hooks.shopguiplus.
QuickShop-Hikari	AVAILABLE	Chest-shop sales between players. Config key economyEngine.hooks.quickshop.
ChestShop	AVAILABLE	Player shop sales, admin shops as price limits. Config key economyEngine.hooks.chestshop.
SignShop	AVAILABLE	Player sign-shop sales, admin signs as price limits. Config key economyEngine.hooks.signshop.
Shopkeepers	AVAILABLE	Villager shop trades in its currency item. Config key economyEngine.hooks.shopkeepers.
InsaneShops	AVAILABLE	Player shop trades, admin shops as price limits. Config key economyEngine.hooks.insaneshops.
ExcellentShop	AVAILABLE	Chest-shop trades, its virtual shop as price limits. Config key economyEngine.hooks.excellentshop.
EconomyShopGUI	AVAILABLE	Shop prices become price limits. Config key economyEngine.hooks.economyshopgui.
EconomyShopGUI Premium	AVAILABLE	Same hook as the free version.
GUIShop	AVAILABLE	Its price list becomes price limits. Config key economyEngine.hooks.guishop.
AutoSellChests	AVAILABLE	What its chests sell at becomes a price floor. Config key economyEngine.hooks.autosellchests.
dtlTraders	AVAILABLE	Its NPC trader prices become price limits. Config key economyEngine.hooks.dtltraders.
Shop	AVAILABLE	Conjurate's shop plugin. Its shop page prices become price limits. Config key economyEngine.hooks.shopconjurate.
EssentialsX worth	AVAILABLE	worth.yml prices become price floors. Config key economyEngine.hooks.essentials.
CMI	AVAILABLE	/sell sales and its worth list become price floors. Config key economyEngine.hooks.cmi.
ShopChest	UNSUPPORTED	Fails to start on current Paper versions and is no longer maintained.

Trading Plugins

Plugins that handle player-to-player trading.

Plugin	Status	Notes
AxTrade	AVAILABLE	Item-for-money player trades ingested. Config key economyEngine.hooks.axtrade.
Trade System	AVAILABLE	Item-for-money trades, and money handed over for nothing checked for alt rings. Trade System itself runs up to Paper 1.21.4. Config key economyEngine.hooks.tradesystem.

Money Between Players

Payments between players, checked for alt rings by fraud detection and never used for prices.

Plugin	Status	Notes
EssentialsX	AVAILABLE	/pay. Config key economyEngine.hooks.essentials.
CMI	AVAILABLE	/pay. With CMI's own economy off, only a /pay typed with the payee's full name is seen, and none while CMI asks to confirm payments. Config key economyEngine.hooks.cmi.
zEssentials	AVAILABLE	/pay between two players who are online. Config key economyEngine.hooks.zessentials.
X-Prison	AVAILABLE	Payments in its currencies. Config key economyEngine.hooks.xprison.
UltraCoinFlip	AVAILABLE	Coinflip winnings. Config key economyEngine.hooks.ultracoinflip.
Duels	AVAILABLE	Money-bet duel winnings, also in the Duels Optimised fork. Config key economyEngine.hooks.duels.

Imports From Other Auction Plugins

Moving a server over from another auction plugin, with its listings, items waiting to be collected, money still owed and past sales. See Migrating.

Plugin	Status	Notes
zAuctionHouse	AVAILABLE	Listings, items waiting to be collected and past sales.
Player Auctions	AVAILABLE	Listings including bid auctions, items waiting to be collected, money owed and past sales.
AuctionMaster	AVAILABLE	Listings including bid auctions, items waiting to be collected, money owed and past sales.
AuctionHouse (klugemonkey)	AVAILABLE	Listings, returned items and past sales.
Auction House (Kiranhart)	BETA	Listings including bid auctions, items waiting to be collected, money owed and past sales. Checked on real data from version 2.121 and on a test database with the newest version's columns. Its MySQL storage is not checked yet.
AxAuctions	EXPERIMENTAL	Listings, returned items, money owed and past sales. Built from its public storage format, not yet checked against a real AxAuctions database.

Custom Items & Mobs

Plugins that add custom content, important for identifying non-vanilla items.

Plugin	Status	Notes
Oraxen	AVAILABLE	Custom items identified by their own plugin id and priced by rarity.
Nexo	AVAILABLE	Custom items identified by their own plugin id and priced by rarity.
ItemsAdder	AVAILABLE	Custom items identified by their own namespaced id.
MMOItems	AVAILABLE	Custom items identified by type/id and priced by their MMOItems tier.
MythicMobs	AVAILABLE	MythicMobs items identified by their MythicMobs type.
SilkSpawners	AVAILABLE	Spawners identified by their mob.
SpawnerMeta	AVAILABLE	Spawners identified by their mob and upgrades, so an upgraded spawner is priced apart from a plain one.
ExecutableItems	PLANNED	Custom items with abilities.
ExecutableBlocks	PLANNED	Custom block activators.
ExecutableEvents	PLANNED	Custom event handling.
SafariNet	PLANNED	Mob catcher plugin.
RealisticVillagers	PLANNED	Enhanced villager trading.

Jobs & Income Plugins

Plugins that reward players with currency, useful for understanding income sources.

Plugin	Status	Notes
Jobs Reborn	PLANNED	Most popular jobs plugin. Requires CMILib.
ExcellentJobs	PLANNED	Lightweight jobs by NightExpress.
Time is Money	PLANNED	AFK/playtime income.
LootConomy	PLANNED	Currency drops from mobs/blocks.

Crate & Loot Plugins

Plugins that distribute items, useful for tracking item supply entering the economy.

Plugin	Status	Notes
ExcellentCrates	PLANNED	Advanced crate system by NightExpress.
RoseLoot	PLANNED	Customizable loot tables.

Prison & Gamemode Plugins

Specialized plugins for specific server types.

Plugin	Status	Notes
X Prison Core	AVAILABLE	Its currencies, its autosell prices as price floors, and payments between players.

Farming & Collection Plugins

Plugins that affect item production and storage.

Plugin	Status	Notes
Better Farming	PLANNED	Auto-farming plugin.
InfiniteCrops	PLANNED	Advanced crop system.
AdvancedChests	PLANNED	The paid version's auto-sell. The free version cannot sell, so it has nothing to read.

Permissions & Utility

Core plugins that may provide useful context or player data.

Plugin	Status	Notes
PlaceholderAPI	AVAILABLE	Custom currencies can be read through PlaceholderAPI, and ProtonAuctions offers its own placeholders for players, the market, item values and top lists. See Placeholders.
LuckPerms	AVAILABLE	No hook needed. Rank perks such as listing limits and listing time use permission nodes, so they work with LuckPerms or any permissions plugin.
Ultra Permissions	AVAILABLE	Works the same way, through permission nodes.
NightCore	AVAILABLE	Nothing to hook. It is the library that CoinsEngine, ExcellentEconomy and ExcellentShop run on.

Quests & Progression

Plugins that track player progression and may involve item rewards.

Plugin	Status	Notes
ExcellentQuests	PLANNED	Quest system by NightExpress.

Teams & Social

Plugins that group players, useful for detecting coordinated trading.

Plugin	Status	Notes
BetterTeams	PLANNED	Team/clan system.
Guilds	PLANNED	Guild management.

Moderation & Anti-Cheat

Plugins that may flag suspicious players, useful context for anomaly detection.

Plugin	Status	Notes
Grim Anticheat	PLANNED	Modern anticheat.
Ultra Punishments	PLANNED	Punishment system.
AdvancedBan	AVAILABLE	Banned players' sales are left out of prices. The server ban list and EssentialsX bans are read the same way.
LiteBans	AVAILABLE	Banned players' sales are left out of prices.
Staff++	PLANNED	Staff tools.
CombatLogX	AVAILABLE	The auction house combat block can follow CombatLogX's own combat tag.

Server Utilities

General server plugins that may provide useful context.

Plugin	Status	Notes
ViaVersion	PLANNED	Version compatibility.
VeinMiner	PLANNED	Block breaking enhancement.
SuperVanish	PLANNED	Vanish plugin.
BetterRTP	PLANNED	Random teleport.
InvSee++	PLANNED	Inventory inspection.
AngelChest Free	PLANNED	Death chest plugin.
spark	PLANNED	Performance profiler.
ajLeaderboards	PLANNED	Leaderboard system.
ClearLagg	PLANNED	Entity/item cleanup.
UltimateAutoRestart	PLANNED	Auto-restart management.
PlugManX	PLANNED	Plugin management.
MassiveCore	PLANNED	Core library for Factions.

Integration Methods: Depending on the plugin, ProtonAuctions uses one of these methods:

1. Event Listeners - Capturing a plugin's trades as they happen
2. Direct API - Native method calls for balances and currencies
3. Price Lists - Reading a plugin's fixed price list when it announces no trades, again every five minutes and on /ahadmin reload
4. Vault Bridge - Using Vault as an intermediary for economy operations
5. PlaceholderAPI - Reading values via PAPI placeholders, for custom currencies

The specific method is chosen automatically based on what each plugin supports. /ahadmin hooks shows which integrations are working on your server.

Integration Priority: Shop plugins and economy providers are the highest priority for price intelligence. Payment plugins feed fraud detection. Other integrations provide supplementary context for anomaly detection and trust scoring.

Integration Policy: To have your plugin supported by the Economic Engine, ensure it is either open-source or provides a stable, well-defined API. Because we already track a large number of plugins, support cannot be guaranteed unless it is requested by clients or has a meaningful impact on the server community.

---

Advanced Features

Specific mechanics and quality-of-life tools.

Feature	Status	Notes
Shulker Previews	STABLE	Content inspection.
Item Matching	STABLE	Material, display-name, lore and custom-model-data matchers. Custom items from Nexo, Oraxen, ItemsAdder, MMOItems and MythicMobs are identified by their own plugin id. Potions, filled shulkers, spawners and other item variants are told apart.
Sorting	STABLE	Price, time and name sorting.
Anti-Snipe	STABLE	A bid inside the window extends the end time and keeps the winning bid.
Price Clamps	STABLE	Minimum and maximum listing prices are enforced.
Item Watchers	BETA	Watch and unwatch commands with a matching-listing notification.
Placeholders	BETA	ProtonAuctions' own PlaceholderAPI placeholders for player stats, the market, item values and top lists, served from a cache so scoreboards never wait on the database. See Placeholders.
Restrictions	BETA	Blocked worlds, no selling in creative, and a combat block that can follow CombatLogX. See Restrictions.
Rank Limits	BETA	Listing limits, listing time and barter limits per rank, through permission nodes. See Rank limits.
Pointer Menus	BETA	The auction house drawn on screen and used with a mouse cursor, through a resource pack, with an in-game layout editor for staff. Off by default. See Pointer Menus.
Permissions	PARTIAL	The node hierarchy is implemented. Full coverage of every node is still being refined.

---

What this means for you

1. Single Servers: If you run a Paper 1.21.0+ server on SQLite with Vault and an economy provider, ProtonAuctions is Stable for you.
2. Networks: MySQL, PostgreSQL and Redis cross-server sync are implemented but still maturing. Roll them out gradually.
3. 26.x servers: 26.1.x and 26.2 are supported on Java 25, the same build as 1.21.x.
4. Economy: standard currencies are the primary path. If you use Currency Autopilot, confirm a few transactions before opening to the public.
5. Barter System: enable it for item-based economies. It is off by default so you opt in.
6. Analytics Engine: on by default, collecting locally. Expect roughly a 24-hour grace period, plus enough trade history, before /ah suggest starts returning prices. Hooks into your shop and worth plugins give it price limits from day one.

Bug Reports: please report anything odd with a BETA, PENDING or EXPERIMENTAL feature to our Discord.