Shopping - A Player-Driven Marketplace

A Minecraft plugin that provides both fixed-price shops and timed auctions for players to trade items with each other.

=== FEATURES ===

Shop System:
- List items for sale at fixed prices
- Paginated GUI showing 36 items per page
- Automatic sorting by price (cheapest first)
- Remove your listings anytime
- Vault economy integration

Auction System:
- Timed auctions (1 minute to 24 hours)
- Competitive bidding with automatic increments
- Auctions end automatically when time expires
- Instant refunds when outbid
- Offline support - claim items when you return
- Paginated auction browser (36 auctions per page)

=== REQUIREMENTS ===

- Minecraft 1.21+
- Paper/Spigot/Purpur
- Java 21+
- Vault plugin
- Any economy plugin (EssentialsX, CMI, etc.)

=== COMMANDS ===

Shop:
/shop - Open shop menu
/shop sell <price> - List held item for sale
/shop remove - Remove your items

Auctions:
/auction (or /auc) - Open auction menu
/auction start <price> <minutes> - Start auction with held item
/auction list - List all active auctions (text)
/auction cancel - Cancel all your auctions
/auction claim - Claim won items

=== PERMISSIONS ===

All permissions default to true (everyone has access):
- shopping.menu
- shopping.sell
- shopping.remove
- shopping.auction
- shopping.auction.start
- shopping.auction.bid
- shopping.auction.list
- shopping.auction.cancel
- shopping.auction.claim

=== HOW TO USE ===

Selling in Shop:
1. Hold the item you want to sell
2. Type: /shop sell 100
3. Your item is listed for $100
4. When bought, you receive the money automatically

Starting an Auction:
1. Hold the item you want to auction
2. Type: /auction start 50 30
3. Auction runs for 30 minutes starting at $50
4. Highest bidder wins when time expires

Bidding:
1. Open auction menu: /auction
2. Click any auction item
3. Automatically bids current price + $1
4. If outbid, you're refunded immediately

=== INSTALLATION ===

1. Download the JAR file
2. Place in your plugins/ folder
3. Ensure Vault and an economy plugin are installed
4. Restart your server
5. Start trading!

=== FAQ ===

Q: What if a player is offline when an auction ends?
A: Items go to a pending queue. Use /auction claim to get them.

Q: Do auctions survive restarts?
A: Yes! Everything is saved to disk.

=== DATA STORAGE ===

The plugin creates these files:
- plugins/Shopping/items.yml - Shop listings
- plugins/Shopping/auctions.yml - Active auctions
- plugins/Shopping/pending_items.yml - Unclaimed items

=== CREDITS ===

Author: Touchie771
Command Framework: LiteCommands by Rollczi
Economy API: Vault