SOLEA API 26.2

Minecraft 1.21.1 · NeoForge

Release focused on economy, auction house (HDV), and NPC shop improvements. EN/FR included.

---

Economy (Money)

Player Commands

• /money — displays your balance
• /pay <player> <amount> — transfer between players (amount required, tax configurable)
• /baltop — ranking of the richest players

Admin Commands

• /money give|set|remove|view <player> [amount]

GameRule

• /gamerule moneysystem true|false — enables/disables the entire money system (default: false)
• When disabled: money commands, monetary event rewards, monetary NPC shops, and /ah are blocked

soleaapi-money.toml config

• Provider internal (Solea balance in SavedData) or command (delegation via configurable console commands)
• Symbol, starting balance, cap, min/max pay, tax, cooldown, baltop size
• Command templates for external economies ({player}, {amount}, {target})

Events

• Configurable money rewards (global + event-specific overrides) in the /events menus

API & placeholders

• SoleaApiFacade: getBalance, deposit, withdraw, isMoneyEnabled
• Placeholders {money} and {money_formatted}

---

Auction House

Commands

• /ah — main menu: browse, buy, sell
• /ah sell — shortcut to the sell screen

How it works

• Sales are for currency only (no item-for-item trades)
• One-click purchase on a listing
• My Listings: cancel and retrieve the item
• Price entered in chat (e.g., 5000, 250k, 1.5m) — handy for large amounts
• Sort: recent / price ↑ / price ↓
• Sales tax, listing limit per player, expired items returned to the seller (queue upon login if inventory is full)

soleaapi-ah.toml configuration

• maxListingsPerPlayer, listingExpireMinutes, taxPercent, minPrice, maxPrice, pageSize

Admin runtime

• /solea edit ah expiretime <minutes> — listing duration
• /solea edit ah expiretime off — no expiration
• /solea edit ah expiretime info — current value

---

NPC — currency shops & trade editor

Trade types

• Item ↔ Item — standard trade (vanilla MerchantMenu)
• Purchase ($) — the player pays money, receives the item
• Sale ($) — the player gives the item, receives money

Trade Editor (Redesign)

• 6-line menu with self-explanatory buttons (Item / Buy / Sell)
• Empty item slots for placing your items (no more collectible windows)
• Enter money amounts in chat (click on gold bar)
• Trade list: left-click = edit, right-click = delete
• Detailed trade information (type, price, summary)

---

Fixes

• Client startup crash: money config loading moved to ModConfigEvent (no longer in common setup)
• HDV: your own listings visible in /ah (marked “Your listing”)
• GUI: decorative panes are not collectible; item slots are actually empty

---

Requirements

• Minecraft 1.21.1
• NeoForge 21.1+
• JDK 21 (server)

Install on the server for full functionality. Client optional (hybrid).

---

Quick help

/solea help — list of player & admin commands
/gamerule moneysystem true — enable the economy before /money, /pay, /ah