Patch notes

1.8.0

• Added bStats metrics (plugin ID 33559)
• Hardened Modrinth update check for donut-orders: pick newest release by date, strip version suffixes, warn in console, notify donutorders.admin on join (update-check.notify-ops-on-join)
• Confirmed support matrix: Bukkit / Spigot / Paper / Purpur / Folia on Minecraft 1.20.1–26.2
• Relicensed to Apache-2.0; added OSS contributor docs; removed committed build/AI clutter

1.7.0

• New-order chat broadcast to other online players (orders.broadcast-on-create, order-created-broadcast)
• Folia-safe: recipients messaged on their entity thread

1.6.1

• Fixed empty enchanted-book Select Enchant picker on modern Paper
• Enchant list cache clears on /orders admin reload

1.6.0

• MySQL storage backend and cross-server order sync
• updated_at tracking and optimistic updates to reduce duplicate payouts

1.5.1

• Folia enable crash fix (runAsync / scheduler hardening)

1.5.0

• Enchanted book orders, VIP order limits, New Order item search

1.3.1

• Fixed New Order picker Previous page always returning to page 1

DonutOrders v1.7.0

New Features

• New-order chat broadcast — when a player creates a buy order, all other online players see a chat announce (item, amount, price). The creator still gets the private order-created confirmation only.

Configuration

• orders.broadcast-on-create (default true) — set to false to disable the public announce.
• order-created-broadcast in messages.yml — {0} buyer, {1} item, {2} amount, {3} price per item. Missing keys fall back to jar defaults on /orders admin reload.

Compatibility

• Same loaders as 1.6.1 (Paper / Folia / Purpur family). Folia-safe: each recipient is messaged on their entity thread.

Upgrade Notes

1. Replace the DonutOrders jar with 1.7.0. Keep your existing plugins/DonutOrders/ folder.
2. Optional: add broadcast-on-create: true under orders: in config.yml, and order-created-broadcast to messages.yml, then /orders admin reload. If you skip this, in-code / jar defaults still enable the announce.
3. Confirm by creating an order on one account and checking chat on another.

DonutOrders v1.6.1

Bug Fixes

• Empty enchant picker — New Order → Enchanted Book no longer opens an empty Select Enchant GUI. Modern Paper returns false from Enchantment#canEnchantItem for enchanted books; the picker now builds the list via stored-enchant checks so vanilla (and storeable) enchants appear again.

Improvements

• Enchant list cache clears on /orders admin reload.

Compatibility

• Same loaders as 1.6.0 (Paper / Folia / Purpur family). Drop-in jar replace.

Upgrade Notes

1. Replace the DonutOrders jar with 1.6.1.
2. Restart or use your preferred hot-swap flow, then open New Order → Enchanted Book to confirm the enchant list populates.

DonutOrders v1.6.1

Bug Fixes

• Empty enchant picker — New Order → Enchanted Book no longer opens an empty Select Enchant GUI. Modern Paper returns false from Enchantment#canEnchantItem for enchanted books; the picker now builds the list via stored-enchant checks so vanilla (and storeable) enchants appear again.

Improvements

• Enchant list cache clears on /orders admin reload.

Compatibility

• Same loaders as 1.6.0 (Paper / Folia / Purpur family). Drop-in jar replace.

Upgrade Notes

1. Replace the DonutOrders jar with 1.6.1.
2. Restart or use your preferred hot-swap flow, then open New Order → Enchanted Book to confirm the enchant list populates.

DonutOrders v1.6.0

New Features

• MySQL storage backend — set database.type: mysql in config.yml so multiple servers share one database
• Cross-server order sync — orders created or fulfilled on one server appear on all servers sharing the MySQL database (polls every database.sync-interval-seconds, default 5)

Improvements

• updated_at column on orders for change tracking and safe multi-server merges
• Optimistic DB updates on fulfill/collect prevent duplicate payouts when two servers race
• Critical paths refresh the order from the database before mutating

Bug Fixes

• None

Configuration

database:
  type: mysql          # sqlite (default) or mysql
  sync-interval-seconds: 5
  mysql:
    host: localhost
    port: 3306
    database: donutorders
    username: donutorders
    password: ""
    pool-size: 10

Compatibility

• SQLite remains the default — no config change required for single-server setups
• Existing SQLite databases auto-migrate (updated_at column added on startup)
• Drop-in jar replacement; restart all network servers after switching to MySQL

Upgrade Notes

1. For cross-server: create a MySQL database, grant access, set database.type: mysql on every server
2. Replace the jar with DonutOrders-1.6.0.jar on all servers
3. Restart servers — console should show (MySQL backend) when configured correctly
4. Verify an order placed on server A appears in /orders on server B within a few seconds

DonutOrders v1.5.1

New Features

• None

Improvements

• Folia async scheduling hardened — runAsync always uses Paper's AsyncScheduler on regionalised servers; legacy BukkitScheduler async calls are never used on Folia
• Startup load falls back to synchronous DB read if async scheduling is unavailable, then continues enable on the global thread
• Scheduled task failures are logged instead of crashing the server thread

Bug Fixes

• Fixed Folia enable crash (UnsupportedOperationException from CraftScheduler.runTaskAsynchronously during StorageManager.loadAll) on Folia 1.21.x
• All scheduler entry points (runAtEntity, runGlobal, runGlobalRepeating, runAsync, etc.) now catch UnsupportedOperationException and route to the correct Paper/Folia scheduler as a safety net

Configuration

• None

Compatibility

• Drop-in update from 1.5.0 (and older 1.3.x / 1.4.x builds still on broken Folia async scheduling)
• folia-supported: true unchanged in plugin.yml
• No database migration required
• Tested build target: Paper/Folia 1.20.6+ API; runtime tested on JDK 21

Upgrade Notes

1. Replace the jar with DonutOrders-1.5.1.jar
2. Restart the server (recommended over hot-reload for scheduler changes)
3. Confirm console shows Folia detected — using regionised schedulers. followed by Enabled successfully with no UnsupportedOperationException
4. Run /orders on a Folia 1.21.4 server to verify the marketplace opens

DonutOrders v1.5.0

New Features

• Enchanted book orders — New Order → Enchanted Book opens an enchant picker, then a level picker (Sharpness, Efficiency, Unbreaking, and other vanilla book enchants). Listings show names like Sharpness V Enchanted Book; sellers must deliver the exact enchanted book
• VIP order limits — per-rank and per-permission active order caps via OrderLimitManager (wired into order creation, join/quit cache, LuckPerms updates, and PlaceholderAPI)
• Item search in New Order picker — compass button opens a chat search; filter persists across pagination; clear-search button when a filter is active

Improvements

• /orders admin reload refreshes cached order limits for all online players
• New Order GUI title shows the active search filter when filtering
• Order list / delivery / wrong-item messages use enchant-aware item names

Configuration

• ENCHANTED_BOOK added to default items.yml allowed list
• orders.default-limit — default active order cap (default: 2)
• orders.max-per-player — legacy alias kept in sync with default-limit
• rank-limits — per-LuckPerms-group caps (e.g. default: 2, vip: 5)
• Optional permission override: donutorders.limit.<n> (highest wins)
• New messages.yml keys for enchant picker and New Order search UI

Compatibility

• Drop-in update from 1.3.x / 1.4.x
• Folia-supported unchanged
• No database migration required
• Soft-depends on LuckPerms and PlaceholderAPI (optional; features degrade gracefully when absent)
• Placeholder: %donutorders_order_limit%

Upgrade Notes

1. Replace the jar with DonutOrders-1.5.0.jar
2. Restart the server (or reload after reviewing config)
3. If upgrading an existing install, add ENCHANTED_BOOK under allowed-items in items.yml, then /orders admin reload
4. Review config.yml — add or adjust rank-limits if you use VIP ranks:

   rank-limits:
     default: 2
     vip: 5
   

   Or grant LuckPerms permission donutorders.limit.5 instead of/in addition to rank limits.
5. Ensure VIP players have LuckPerms group vip (maps to group.vip) or the permission node above.
6. Test /orders → New Order → Enchanted Book + Search (compass), and confirm VIP players can hold more active orders than default.

Improvements

• New Order item picker Previous/Next now share the same Folia-safe open path

Bug Fixes

• Fixed Previous in the New Order item picker always returning to page 1 instead of the previous page