EzAuction

1. Open the target Discord channel → Copy Webhook URL → Copy Webhook URL → Copy Webhook URL → Copy Webhook URL → Copy Webhook URL. 2. In-game or via console, run: ``` /auctiondiscord webhook set url https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN ``` 3. Verify with `/auctiondiscord webhook test` - a test embed will appear in your channel immediately.

```yml

discord.yml - webhook section

webhook: enabled: true url: "https://discord.com/api/webhooks/123456789/YOURTOKEN" username: "EzAuction" use-embeds: true events: auction_start: true auction_end: true auction_bid: true auction_cancel: true ```

For the full DiscordSRV integration guide and all options, see the Discord integration docs.

```yml holograms: enabled: true update-interval-ticks: 100 search-radius: 2.5 height-offset: 1.75 max-holograms: 100 batch-update: true require-permission: false # Set true to require a permission node view-permission: ezauction.hologram.view # Permission node for viewing/interacting proximity-limit: false # Set true to restrict by distance proximity-distance: 32.0 # Max distance for interaction ```

Need more details? See the Need more details? for all YAML, MySQL, menu, and advanced settings options.

Requirements

| Requirement | Notes | |-------------|-------| | Java 21+ | Matches the Paper 1.21+ API target used by EzAuction. | | Paper / Spigot / Purpur 1.21+ | The plugin relies on Paper-compatible server APIs. | | Vault | Provides the economy bridge for deposits, buy orders, and payouts. | | Economy plugin (recommended: EzEconomy) | A Vault-compatible provider is required. EzEconomy is recommended for best compatibility and modern features. | | Optional: EzShops | Unlock live value overlays via `values.mode = ezshops-buy` or `ezshops-sell`. | | Optional: Custom limit resolver | Expose `AuctionListingLimitResolver` as a Bukkit service to scale listing caps. | | Optional: Menu localisation overrides | Duplicate the bundled `_nl`, `_es`, or `_zh` menu files to keep translations in sync with your branding. |

Configuration Overview

- Value display – Toggle `storage.type` between `yaml` and `mysql`; MySQL connections support SSL flags and pool tuning. - Value display – `menu.browser` and `menu.confirm` control inventory sizes, filler panes, and navigation slots across all language variants. - Value display – Configure default price suggestions and click adjustments for both listing and buy-order editors. - Value display – Clamp durations, enforce minimum pricing, schedule custom duration options, and reserve refundable deposits, with automatic executor-based expiry sweeps. - Value display – Tweak click increments, confirmation buttons, and chat prompts through `messages/menu-interactions_*.yml` per locale. - Value display – Manage `live-auctions.enabled`, `queue-enabled`, `display-in-chat`, and `announcement-interval-ticks` to stage listings for announcements or GUI previews. - Value display – Display configured material prices or EzShops-sourced estimates, templated through `values.format`.

Optional Integrations

- Expose a custom `AuctionListingLimitResolver` service to scale listing caps with ranks, islands, or other progression data. - Install EzShops so the auction browser can display buy or sell prices directly in listing lore when configured. - Install PlaceholderAPI to unlock `%ezauction_*%` placeholders for leaderboards, scoreboards, or Discord relays.

Network Setup (Bungee/Velocity)

1. Switch `storage.type` to `mysql` and point each Paper/Purpur backend to the same credentials so listings, buy orders, and returns are stored centrally. The bundled MySQL driver implements `DistributedAuctionListingStorage` so inserts and claims remain atomic across servers. 2. Drop the same `EzAuction.jar` on every gameplay server behind your proxy, then copy a single set of tuned configs (`auction.yml`, `auction-storage.yml`, `messages/*.yml`) to keep menus, limits, and language consistent network-wide. 3. Restart each backend (avoid /reload) after editing the configs so every instance warms its cache from MySQL before players join. The manager only serves listings once storage is marked ready. 4. If a lobby should not show auctions, leave EzAuction off that node or point it at a different `table-prefix` so it maintains a separate pool. 5. Confirm every server shares the same Vault economy provider or synchronised balance backend. Currency withdrawals happen locally, so mismatched economy data across nodes can desync deposits and reserved funds.

- EzAuction ships with `menu-layout_*.yml` and `menu-interactions_*.yml` bundles for English, Dutch, Spanish, and Chinese (`_en`, `_nl`, `_es`, `_zh`). - Copy any bundle to another locale tag (for example `_de`) to introduce custom language support without touching code. - Keep button text consistent across languages so navigation slots and confirmation buttons remain aligned with the GUI configuration.

```java package com.example.auctionlimits;

import com.skyblockexp.ezauction.api.AuctionListingLimitResolver; import org.bukkit.Bukkit; import org.bukkit.plugin.ServicePriority; import org.bukkit.plugin.java.JavaPlugin;

public final class AuctionLimitPlugin extends JavaPlugin {

@Override public void onEnable() { saveDefaultConfig();

AuctionListingLimitResolver resolver = (sellerId, baseLimit) -> { int bonus = getConfig().getInt("extra-slots." + sellerId.toString(), 0); return Math.max(0, baseLimit + bonus); };

Bukkit.getServicesManager().register( AuctionListingLimitResolver.class, resolver, this, ServicePriority.Normal ); }

@Override public void onDisable() { Bukkit.getServicesManager().unregisterAll(this); } } ```

```yml name: AuctionLimitPlugin version: 1.0.0 main: com.example.auctionlimits.AuctionLimitPlugin loadbefore: [EzAuction] ```

```yml

plugins/AuctionLimitPlugin/config.yml

extra-slots: 123e4567-e89b-12d3-a456-426614174000: 2 2a2f4982-0c7a-4f13-86a1-4f85c4a94cf7: 4 ```

This companion plugin registers before EzAuction enables and adds any configured bonus slots per player UUID on top of EzAuction's base limit. Update the UUID keys or compute the bonus however you like to reflect your network's progression rules.

auction.yml

```yml storage: type: yaml # or mysql mysql: host: localhost port: 3306 database: skyblock username: root password: secret use-ssl: true table-prefix: ezauction_ pool: maximum-pool-size: 10 minimum-idle: 2 connection-timeout-millis: 10000 idle-timeout-millis: 600000 max-lifetime-millis: 1800000 menu: browser: title: "&2Auction House &7({page}/{total_pages})" size: 54 filler: material: GRAY_STAINED_GLASS_PANE display-name: "&8 " navigation: previous-slot: 45 close-slot: 49 next-slot: 53 empty-listing-slot: 22 confirm: title: "&2Confirm Purchase" size: 27 filler: material: GRAY_STAINED_GLASS_PANE display-name: "&8 " confirm-slot: 11 listing-slot: 13 cancel-slot: 15 listings: default-duration-hours: 24 max-duration-hours: 72 minimum-price: 10.0 listing-deposit-percent: 5.0 max-listings-per-player: 3 live-auctions: enabled: false queue-enabled: true display-in-chat: true announcement-interval-ticks: 200 values: enabled: false format: "&7Value: &6{value}" materials: diamond: 2500.0 ```

auction-storage.yml

```yml type: yaml # or mysql mysql: host: localhost port: 3306 database: skyblock username: root password: secret use-ssl: true table-prefix: ezauction_ pool: maximum-pool-size: 10 minimum-idle: 2 connection-timeout-millis: 10000 idle-timeout-millis: 600000 max-lifetime-millis: 1800000 ```

auction-values.yml

```yml enabled: false mode: configured # or ezshops-buy / ezshops-sell format: "&7Value: &6{value}" materials: diamond: 2500.0 ```