iteshop

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

🔑 Permissions

MIT licence — © 2026 Bicode_DEV.