ВЕРСИИ (3)

## 🐛 Bug Fixes in v1.0.1 **Fixed:** Expired items no longer appear simultaneously in both main listings and expired section. Previously, when an auction listing expired after 24 hours, the item would incorrectly remain visible in the main auction GUI while also appearing in the expired items section. This has been fully resolved. ✅ **Now:** Items properly disappear from main listings upon expiration and are only accessible through the expired items vault.

## 🚀 Version 1.0.1 Changelog We are glad to introduce a new update for **MinepoursAh**! This version focuses on critical bug fixes for the Sell GUI and introduces a handy update notifier. ### 🐛 Bug Fixes * **Fixed `/ah sellgui` Inventory Issues:** * Fixed a bug where players could not put items into the GUI slot using **Shift + Left Click**. * Fixed an issue where the hotbar slots (specifically **Slot 1** and **Slot 2**) were accidentally locked/blocked while the Sell GUI was open. * Everything now functions perfectly as intended! ### ➕ New Features * **Update Notifier:** * Added an automatic in-game notification system. * If a new plugin update is available, server administrators will receive a notification with a direct download link. --- *Thank you for using MinepoursAh! If you encounter any further bugs, please report them on our issue tracker.*

# MinepoursAh - Advanced Auction House Plugin A powerful, feature-rich auction house plugin for Paper 1.21+ servers with Vault economy integration. Let your players buy and sell items in a beautiful GUI with advanced filtering, price history, and multi-item listing. --- ## ✨ Features ### 🏪 Core Auction System - **Beautiful GUI** with customizable cyan-blue color scheme - **Multi-page browsing** with intuitive navigation - **Buy & Sell** items with Vault economy integration - **24-hour listing expiration** with automatic return system - **Offline sales** - sellers receive money even when offline ### 🔍 Advanced Filtering - **12 item categories** (Weapons, Armor, Tools, Food, Blocks, Farming, Potions, Enchanted, Mob Drops, Misc, Other, All) - **Smart category detection** - items automatically sorted to correct categories - **Quick category switching** via hopper menu ### 📊 Price Analytics - **Weekly average prices** displayed on item hover - **Sales statistics** - total items sold and money spent - **Transaction history** tracking ### 🛡️ Protection & Limits - **Price limits per item category** - prevent junk items being sold for millions - **Listing limits per player** - customizable via permissions (`minepoursah.limiter.<number>`) - **Anti-dupe protection** - all GUI interactions secured - **Config validation** - automatic recovery from corrupted configs ### 🎨 Quality of Life - **Sell GUI** (`/ah sellgui <price>`) - list up to 5 items at once - **Right-click to remove** your own listings instantly - **Expired items vault** - reclaim unsold items after 24h - **Relist expired items** with one click - **Sound effects** for all actions - **Multi-language support** (Russian & English included) - **Configurable GUI title** and messages ### 👑 Admin Features - **Full plugin reload** (`/ah reload`) with timing info - **Social media links** command - **Configurable price limits** per category - **Console logging** for all reloads --- ## 📋 Commands | Command | Permission | Description | |---------|-----------|-------------| | `/ah` | `minepoursah.use` | Open the auction house GUI | | `/ah sell <price>` | `minepoursah.sell` | Sell the item in your main hand | | `/ah sellgui <price>` | `minepoursah.sell` | Open GUI to sell up to 5 items at once | | `/ah help` | `minepoursah.use` | Show help menu | | `/ah reload` | `minepoursah.admin` | Fully reload config and language files | | `/ah social` | `minepoursah.admin` | Display social media links | --- ## 🔑 Permissions ### Basic Permissions | Permission | Default | Description | |-----------|---------|-------------| | `minepoursah.use` | `true` | Access to auction and help | | `minepoursah.sell` | `true` | Ability to list items for sale | ### Listing Limits Control how many items each group can list simultaneously: | Permission | Max Listings | |-----------|-------------| | `minepoursah.limiter.3` | 3 listings | | `minepoursah.limiter.5` | 5 listings | | `minepoursah.limiter.10` | 10 listings | | `minepoursah.limiter.15` | 15 listings | | `minepoursah.limiter.20` | 20 listings | | `minepoursah.limiter.25` | 25 listings | | `minepoursah.limiter.50` | 50 listings | | `minepoursah.limiter.100` | 100 listings | > 💡 **How it works:** Players get the **highest** limit they have permission for. If a player has both `minepoursah.limiter.5` and `minepoursah.limiter.10`, they can list up to 10 items. ### Admin Permissions | Permission | Default | Description | |-----------|---------|-------------| | `minepoursah.admin` | `op` | Access to reload and social commands | --- ## 📦 LuckPerms Setup Examples ### Default Player (3 listings) /lp group default permission set minepoursah.use true /lp group default permission set minepoursah.sell true /lp group default permission set minepoursah.limiter.3 true ### VIP Player (5 listings) /lp group vip permission set minepoursah.use true /lp group vip permission set minepoursah.sell true /lp group vip permission set minepoursah.limiter.5 true ### Premium Player (10 listings) /lp group premium permission set minepoursah.use true /lp group premium permission set minepoursah.sell true /lp group premium permission set minepoursah.limiter.10 true ### Admin (50 listings + admin commands) /lp group admin permission set minepoursah.use true /lp group admin permission set minepoursah.sell true /lp group admin permission set minepoursah.admin true /lp group admin permission set minepoursah.limiter.50 true --- ## ⚙️ Configuration All settings are stored in `plugins/MinepoursAh/config.yml`: yaml language: "ru" auction: max-price: 10000000000 expiration-hours: 24 gui: title: "&b&lАукцион &9&lMP" confirm-title: "&bПодтверждение покупки" categories-title: "&bКатегории" my-listings-title: "&dМои лоты" Language files are in `plugins/MinepoursAh/lang/` - fully customizable (RU/EN included). Use `/ah reload` to apply changes without restarting. --- ## 🛡️ Price Limits System The plugin automatically limits prices based on item value to prevent junk items from being sold for millions: | Category | Max Price | Examples | |----------|-----------|---------| | 🗑️ Junk | 25,000 | Dirt, flowers, sticks, string, seeds | | 📦 Common | 100,000 | Most regular items, basic materials | | 💎 Valuable | 500,000 | Iron, gold, emeralds, golden apples | | 🔮 Epic | 1,000,000 | Diamonds, enchanted books, blaze rods | | ⭐ Legendary | 5,000,000 | Netherite, elytra, nether stars, beacons | > If a player tries to list an item above its category limit, they will see a clear message showing the maximum allowed price for that item. --- ## 📊 Statistics Tracked - Total items sold across the entire server - Total money spent on all auction purchases - Price history per item type with 7-day rolling average - Sales counter per item material - Stats persist through server restarts --- ## 🔧 Dependencies **Required:** Paper 1.21+, Vault, Economy plugin (EssentialsX, CMI, etc.) **Optional:** Essentials, LuckPerms (recommended) --- ## 📥 Installation 1. Download the latest `.jar` file and place in `plugins/` folder 2. Ensure Vault and an economy plugin are installed 3. Restart server 4. Configure permissions with LuckPerms 5. Done! Players use `/ah` --- ## 🌐 Social Links - [Telegram](https://t.me/minepours) - [WebSite](https://minepours.ru/) - [Discord](https://discord.gg/gMNvd8dJ87) --- ## ❤️ Credits Created with love by vesperade --- ## 📜 License Распростронение расрешено, только с указанием источника и автора, :)