iteshop

Admin shop + player auction house + secure player-to-player trading — one server-side plugin, no required dependency, hardened against item duplication.

---

🏪 /shop — server shop (categories, XP or money)

A shop organised into categories (icon selection menu). For each item the admin picks the currency: XP levels or money (Vault).

• Configure it in config.yml, or entirely in game.
• Category icons can be special items (custom model data, typed potions, glowing) — set one with the item in your hand via /shop admin icon.
• Anti-exploit blacklist: items that regenerate XP can't be sold for XP, so there's no infinite currency loop.

💰 /ah · /hdv — player auction house

Players list their own items and choose how they want to be paid: XP levels, money (Vault), another item (e.g. pay in diamonds), or free.

• Guided selling: /ah sell shows clickable chat buttons, and Tab suggests values at every step — no syntax to memorise.
• Search, sort and filter built into the menu: search by name (/ah search <word>), sort (newest, price ↑/↓, name) and filter by payment type. Every option stays visible; the active one is highlighted in green.
• Each listing shows the seller, a colour-coded price, its age, and a ✔ / ✘ indicator telling you whether you can afford it.
• Offline sellers receive their earnings on reconnect (money is paid instantly).

🤝 /trade — secure player trading

/trade <player> sends a clickable request in chat. Once accepted, a trade window opens for both players.

• Drag and drop your items into your side, just like a crafting table.
• Wool indicators at the top: yours (left) is your confirm button, the partner's (right) shows whether they confirmed — red means not ready, green means ready.
• Quantity picker: shift-click a stack to choose exactly how many to put in (-32 / -8 / -1 / +1 / +8 / +32, one, all).
• When both players confirm, a 5-second countdown starts — cancellable at any time. Changing an offer resets both confirmations (anti-scam).
• /trade settings — auto-decline requests, or only accept players from your whitelist (/trade allow / /trade disallow).
• /trade watch <player> (admin) — spectate a trade live, or replay the last one (who gave what).

🌍 Multi-language

English by default, with French included. Every player can pick their own language (/iteshop language fr), while admins set the server default (/iteshop language default <code>). Add your own by dropping a lang/<code>.yml file — any missing key falls back to English.

🔒 Duplication-hardened

This was a hard requirement throughout development:

• Purchases and listing removals are idempotent — a fast double-click can't buy or refund twice.
• Trading uses a strict escrow model: an item is either in your inventory or in the trade, never both. Every item is returned or exchanged exactly once — including on menu close, cancel, disconnect, or server shutdown.
• All menu clicks and drags are validated server-side; locked areas reject shift-clicks, drags, double-click collect and creative middle-click.

📦 Compatibility

• Paper (or forks) branch 26.x (26.1 / 26.2), running on Java 25.
• Vault is optional — without it, XP / item / free modes still work; only the money option is disabled.

⌨️ Commands

Command	Role
/shop	Open the server shop (categories)
/shop admin add <category> <xp\|money> <price>	(OP) add the held item
/shop admin icon <category> [MATERIAL]	(OP) set a category icon
/shop admin delete <category> <number>	(OP) remove an item
/shop admin list · reload	(OP) list items / reload config
/ah · /hdv	Browse and buy listings
/ah search <word>	Search listings by name
/ah sell	Sell the held item (guided)
/ah sell myshop · collect	Manage listings / collect earnings
/ah admin	(OP) moderate every listing
/trade <player>	Send a trade request
/trade settings	Trade privacy settings
/trade watch <player>	(OP) spectate / replay a trade
/iteshop language	Change language (yours, or the server default)

🔑 Permissions

Node	Default	Grants
shop.use	everyone	open /shop
shop.admin	OP	manage the admin shop
playershop.use	everyone	browse / buy
playershop.sell	everyone	create listings
playershop.admin	OP	moderate listings
trade.use	everyone	trade with other players
trade.admin	OP	spectate / replay trades
iteshop.admin	OP	server language, reload

---

MIT licence — © 2026 Bicode_DEV.