# \u2744\ufe0f FrozenShop<\/p>\n
A clean, fully configurable GUI shop plugin for Minecraft servers running **1.21 \u2013 1.21.x**.
\nEconomy is powered exclusively by **Vault**.<\/p>\n
—<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
| Dependency | Type | Notes |
\n|—|—|—|
\n| Spigot \/ Paper 1.21+ | Required | Server software |
\n| Vault | Required | Economy bridge |
\n| An economy plugin | Required | EssentialsX, CMI, etc. |
\n| PlaceholderAPI | Optional | Enables `%frozenshop_totalspent%` |<\/p>\n
—<\/p>\n
## \u2699\ufe0f Installation<\/p>\n
1. Drop `FrozenShop.jar` into your `\/plugins` folder
\n2. Make sure **Vault** and an economy plugin are installed
\n3. Start the server \u2014 default config and shop files generate automatically
\n4. Edit `plugins\/FrozenShop\/config.yml` and `plugins\/FrozenShop\/shops\/*.yml`
\n5. Run `\/frozenshop reload` to apply changes without restarting<\/p>\n
—<\/p>\n
## \ud83d\udcac Commands<\/p>\n
| Command | Permission | Description | —<\/p>\n ## \ud83d\udd11 Permissions<\/p>\n | Permission | Default | Description | —<\/p>\n ## \ud83d\uddc2\ufe0f File Structure<\/p>\n “` —<\/p>\n ## \ud83d\uded2 Adding a Shop Item<\/p>\n Open any file inside `shops\/` and add a block under `items:`:<\/p>\n “`yaml To run a **console command** instead of giving an item, set `giveitem: false` and fill `command`:<\/p>\n “`yaml > \u26a0\ufe0f **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.<\/p>\n —<\/p>\n ## \ud83d\udcc4 Placeholders (PlaceholderAPI)<\/p>\n | Placeholder | Description | —<\/p>\n ## \ud83d\udd27 Config Tips<\/p>\n – `confirm-cooldown-ticks` \u2014 prevents accidental double-purchases (set to `0` to disable) —<\/p>\n ## \ud83d\udc64 Author<\/p>\n Made by **DrFrozen**<\/p>\n","protected":false},"excerpt":{"rendered":" The ultimate replica of DonutSMP Shop for free<\/p>\n","protected":false},"featured_media":73712,"template":"","meta":{"_minecraft_slug":"frozenshop","_minecraft_project_id":"kSXuOyHB","_minecraft_author":"DrFrozenXD","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":97,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"frozenshop.zip","_minecraft_size_bytes":42438,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:44:42.456050Z","_minecraft_date_created":"2026-04-29T03:28:48.609288Z","_minecraft_date_modified":"2026-04-19T11:20:41.253716Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/frozenshop","_minecraft_icon_attachment_id":73712,"_minecraft_imported_at":"2026-06-04T06:58:31+00:00","_minecraft_import_hash":"c783895dc5ed03a8b704c52ce7526bd6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,127,128,129],"mod_loader":[131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-73711","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|—|—|—|
\n| `\/shop` | `frozenshop.open` | Open the main shop menu |
\n| `\/frozenshop reload` | `frozenshop.admin` | Reload all configs live |
\n| `\/frozenshop addcategory
\n| `\/frozenshop removecategory
\n| `\/frozenshop addhanditem
\n| `\/toggleshopmessages` | `frozenshop.toggle` | Toggle purchase messages on\/off per player |<\/p>\n
\n|—|—|—|
\n| `frozenshop.open` | Everyone | Open the shop |
\n| `frozenshop.admin` | OP | All admin commands |
\n| `frozenshop.toggle` | Everyone | Toggle personal shop messages |<\/p>\n
\nplugins\/FrozenShop\/
\n\u251c\u2500\u2500 config.yml \u2190 Main menu, confirm menu, sounds, messages
\n\u251c\u2500\u2500 saves.yml \u2190 Auto-generated \u2014 player data (do not edit)
\n\u2514\u2500\u2500 shops\/
\n \u251c\u2500\u2500 end.yml
\n \u251c\u2500\u2500 farming.yml
\n \u251c\u2500\u2500 food.yml
\n \u251c\u2500\u2500 gear.yml
\n \u2514\u2500\u2500 nether.yml \u2190 Add your own .yml files here for new categories
\n“`<\/p>\n
\nitems:
\n my_item:
\n price: 500
\n slot: 9
\n material: DIAMOND
\n displayname: ‘&bShiny Diamond’
\n amount: 1
\n giveitem: true
\n givelore: false
\n hide_attributes: false
\n command: ”
\n lore:
\n – ‘&fBuy Price: �bf52b$%price%’
\n“`<\/p>\n
\n giveitem: false
\n command: ‘give %player% diamond 1’
\n“`<\/p>\n
\n|—|—|
\n| `%frozenshop_totalspent%` | Total money a player has spent in the shop |<\/p>\n
\n– `use-actionbars: true` \u2014 shows purchase messages in the action bar instead of chat
\n– `play-open-sound: true` \u2014 plays a sound when the main shop opens
\n– All colour codes support legacy `&` codes and hex `&#RRGGBB` format<\/p>\n