❄️ FrozenShop

A clean, fully configurable GUI shop plugin for Minecraft servers running 1.21 – 1.21.x.
Economy is powered exclusively by Vault.

---

📋 Requirements

Dependency	Type	Notes
Spigot / Paper 1.21+	Required	Server software
Vault	Required	Economy bridge
An economy plugin	Required	EssentialsX, CMI, etc.
PlaceholderAPI	Optional	Enables %frozenshop_totalspent%

---

⚙️ Installation

1. Drop FrozenShop.jar into your /plugins folder
2. Make sure Vault and an economy plugin are installed
3. Start the server — default config and shop files generate automatically
4. Edit plugins/FrozenShop/config.yml and plugins/FrozenShop/shops/*.yml
5. Run /frozenshop reload to apply changes without restarting

---

💬 Commands

Command	Permission	Description
/shop	frozenshop.open	Open the main shop menu
/frozenshop reload	frozenshop.admin	Reload all configs live
/frozenshop addcategory <name>	frozenshop.admin	Create a new shop category file
/frozenshop removecategory <name>	frozenshop.admin	Delete a shop category
/frozenshop addhanditem <category> <price>	frozenshop.admin	Add the item in your hand to a shop
/toggleshopmessages	frozenshop.toggle	Toggle purchase messages on/off per player

---

🔑 Permissions

Permission	Default	Description
frozenshop.open	Everyone	Open the shop
frozenshop.admin	OP	All admin commands
frozenshop.toggle	Everyone	Toggle personal shop messages

---

🗂️ File Structure

plugins/FrozenShop/
├── config.yml        ← Main menu, confirm menu, sounds, messages
├── saves.yml         ← Auto-generated — player data (do not edit)
└── shops/
    ├── end.yml
    ├── farming.yml
    ├── food.yml
    ├── gear.yml
    └── nether.yml    ← Add your own .yml files here for new categories

---

🛒 Adding a Shop Item

Open any file inside shops/ and add a block under items::

items:
  my_item:
    price: 500
    slot: 9
    material: DIAMOND
    displayname: '&bShiny Diamond'
    amount: 1
    giveitem: true
    givelore: false
    hide_attributes: false
    command: ''
    lore:
      - '&fBuy Price: &#0bf52b$%price%'

To run a console command instead of giving an item, set giveitem: false and fill command:

    giveitem: false
    command: 'give %player% diamond 1'

⚠️ YAML tip: Every item key under items: must be unique within the same file. Duplicate keys will cause items to silently disappear from the shop.

---

📄 Placeholders (PlaceholderAPI)

Placeholder	Description
%frozenshop_totalspent%	Total money a player has spent in the shop

---

🔧 Config Tips

• confirm-cooldown-ticks — prevents accidental double-purchases (set to 0 to disable)
• use-actionbars: true — shows purchase messages in the action bar instead of chat
• play-open-sound: true — plays a sound when the main shop opens
• All colour codes support legacy & codes and hex &#RRGGBB format

---

👤 Author

Made by DrFrozen