# ShopGuiNEXT - SpigotMC Description

## ShopGuiNEXT - Modern Shop Plugin

**Version:** 0.1.0
**Author:** NrleryxDev
**Minecraft Versions:** 1.8 - 1.21
**Price:** Free
---


## Description

**ShopGuiNEXT** is a modern, feature-rich shop plugin designed for Spigot/Paper servers. With its beautiful GUI interface, dynamic pricing system, and multi-language support, it provides an excellent shopping experience for both players and server administrators.

### ✨ Key Features

** Multi-Language Support**
- Full support for **English** and **Turkish**
- Player-based language preferences
- Easy to add more languages

** Dynamic Pricing System**
- Prices change based on supply and demand
- Automatic price adjustments after transactions
- Configurable price multipliers
- Real-time price updates

** Modern GUI Interface**
- Beautiful, user-friendly inventory menus
- Category-based organization
- Search functionality
- Pagination support
- Customizable item displays

** Advanced Search System**
- Search items by name
- Real-time search results
- Paginated search results
- Quick access to items

**⚙️ Admin Panel**
- Easy category management
- Item creation and editing
- Price adjustment tools
- Stock management
- Daily limit configuration

** Flexible Storage**
- **YAML** file storage (default)
- **MySQL** database support
- Easy data migration
- Backup and export utilities

** Integrations**
- **Vault** integration (optional, for economy)
- **PlaceholderAPI** support
- Custom events for other plugins

** Pre-configured Categories**
- **Blocks** - Building materials
- **Tools** - Pickaxes, axes, shovels
- **Weapons** - Swords, bows, tridents
- **Food** - Various food items
- **Ores** - Valuable resources
- **Redstone** - Redstone components
- **Decoration** - Decorative items

---

## Features in Detail

### Multi-Language System
Players can easily switch between languages using `/shop language <tr|en>`. All GUI elements, messages, and item descriptions are fully localized.

### Dynamic Pricing
The plugin features an intelligent pricing system that adjusts item prices based on recent transactions. When items are bought frequently, prices increase. When items are sold frequently, prices decrease. This creates a realistic economy.

### Modern GUI
All interactions happen through beautiful inventory-based GUIs. No need to remember complex commands - everything is visual and intuitive.

### Search Functionality
Players can quickly find items using `/shop search <query>`. The search is fast, accurate, and supports pagination for large result sets.

### Admin Tools
Server administrators have access to a comprehensive admin panel where they can:
- Create and manage categories
- Add, edit, and remove items
- Adjust prices and stock
- Set daily purchase limits
- Configure all shop settings

### Storage Options
Choose between YAML files (simple, no setup required) or MySQL database (for larger servers or multi-server setups).

---

## Commands

### Player Commands
- `/shop` - Open the main shop menu
- `/shop <category>` - Open a specific category
- `/shop language <tr|en>` - Change your language preference
- `/shop search <query>` - Search for items

### Admin Commands
- `/shopadmin` - Open admin panel (requires `shop.next.admin` permission)
- `/shop reload` - Reload plugin configuration (requires `shop.next.reload` permission)

---

## Permissions

- `shop.next.use` - Use the shop (default: true)
- `shop.next.admin` - Access admin panel (default: op)
- `shop.next.reload` - Reload plugin (default: op)
- `shop.next.*` - All permissions (default: op)





---





## ⚙️ Configuration

### Main Configuration (`config.yml`)
```yaml
storage-type: file # file or mysql
mysql:
host: localhost
port: 3306
database: shop
username: root
password: password
dynamic-pricing:
enabled: true
multiplier: 0.1
stock-reset:
enabled: true
time: "00:00"
```

### Shop Items (`shops.yml`)
All categories and items are configured in `shops.yml`. The plugin comes with 7 pre-configured categories and 70+ items ready to use!

---

## Installation

1. Download the latest version of **ShopGuiNEXT**
2. Place the JAR file in your server's `plugins` folder
3. Start or restart your server
4. Configure `config.yml` and `shops.yml` to your liking
5. (Optional) Install **Vault** for economy integration
6. (Optional) Install **PlaceholderAPI** for placeholder support
7. Enjoy your new shop system!

---

## Requirements

### Required
- **Spigot** or **Paper** 1.8 - 1.21
- **Java 17+**

### Optional
- **Vault** - For economy integration (highly recommended)
- **PlaceholderAPI** - For placeholder support

---

## Screenshots

*[Add your screenshots here]*

---

## Version Support

- ✅ **Minecraft 1.8**
- ✅ **Minecraft 1.12**
- ✅ **Minecraft 1.20**
- ✅ **Minecraft 1.21**

The plugin uses NMS adapters to ensure compatibility across different Minecraft versions.

---

## Bug Reports & Support

Found a bug? Have a suggestion? Please report it on the [GitHub Issues]( https://github.com/NrleryxDev/ShopguiNEXT/issues) page.

---

## License

This plugin is free to use on your server. You may not redistribute, modify, or claim this plugin as your own.

---

## Credits

**Developer:** NrleryxDev
**Plugin Name:** ShopGuiNEXT
**Version:** 0.1.0

---

## Changelog

### Version 0.1.0 (Initial Release)
- ✨ Initial release
- Multi-language support (TR/EN)
- Dynamic pricing system
- Modern GUI interface
- Search functionality
- ⚙️ Admin panel
- YAML and MySQL storage
- Vault and PlaceholderAPI integration
- 7 pre-configured categories
- 70+ pre-configured items

---

## ⭐ Features Summary

✅ Multi-language support (TR/EN)
✅ Dynamic pricing system
✅ Modern GUI interface
✅ Search functionality
✅ Admin panel
✅ YAML & MySQL storage
✅ Vault integration
✅ PlaceholderAPI support
✅ Version compatibility (1.8-1.21)
✅ Pre-configured categories and items
✅ Daily purchase limits
✅ Stock management
✅ Custom events for developers

---

**Thank you for choosing ShopGuiNEXT!**

If you enjoy this plugin, please consider leaving a review and rating!

---

*Last Updated: November 2025*