RandomMarket - Dynamic Random Market System

# RandomMarket - Dynamic Random Market System

RandomMarket is a powerful and user-friendly market plugin that offers players random items through an intuitive GUI interface. The market automatically refreshes at configurable intervals, and prices are dynamically calculated based on item quantity, making bulk purchases more economical.

## ✨ Features

### Core Features
- **Random Item Selection**: Market randomly selects items from your configured list
- **Auto-Refresh System**: Market automatically updates at configurable intervals (default: 5 minutes)
- **Dynamic Pricing**: Prices adjust based on quantity - buy more, pay less per unit!
- **GUI Interface**: Beautiful and easy-to-use graphical menu
- **Chat Announcements**: All online players are notified when the market refreshes
- **Vault Integration**: Full compatibility with all economy plugins (EssentialsX, CMI, etc.)

### Smart Pricing System
- Quantity-based discounts: Higher quantities = lower unit prices
- Configurable price limits (min/max)
- Base price system for each item
- Automatic price calculation

### ⚙️ Configuration
- Fully customizable item list
- Adjustable refresh intervals
- Customizable GUI (title, size, slots, filler)
- Price range limits
- Easy-to-edit YAML configuration

## Commands

- `/randommarket` or `/rmarket` or `/rm` - Opens the market GUI
- `/randommarket reload` - Reloads the plugin configuration (requires permission)

## Installation

1. Download and place `RandomMarket-1.0.0.jar` into your server's `plugins` folder
2. Install **Vault** plugin (required)
3. Install an economy plugin (EssentialsX, CMI, etc.)
4. Start your server
5. Configure items and prices in `plugins/RandomMarket/config.yml`
6. Use `/randommarket reload` to apply changes

## ⚙️ Configuration

### Basic Settings
market:
update-interval: 5 # Minutes between market refreshes
price:
min: 10.0
max: 1000.0### Adding Itemsml
market:
items:
- material: DIAMOND
display-name: "&bDiamond"
min-amount: 1
max-amount: 5
base-price: 100.0### GUI Settings
gui:
title: "&6&lRandom Market"
size: 27
filler: "GRAY_STAINED_GLASS_PANE"
slots: [10, 13, 16]## Requirements

- **Minecraft**: 1.19+
- **Java**: 8+
- **Vault**: Required
- **Economy Plugin**: EssentialsX, CMI, or any Vault-compatible economy plugin

## How It Works

1. Market displays 3 random items from your configured list
2. Each item has a random quantity (between min-amount and max-amount)
3. Prices are calculated dynamically based on quantity
4. Market refreshes automatically every X minutes
5. Players receive chat notifications when market updates
6. Players can purchase items directly from the GUI

## Tips

- Add more items to your config for more variety
- Adjust `update-interval` to control how often market refreshes
- Use color codes in `display-name` for better GUI appearance
- Test prices before going live to ensure balance

## Updates

Stay tuned for future updates and improvements!

## Support

For issues, suggestions, or questions, please contact the developer or leave a review.

---

**Enjoy your dynamic random market system!**