\n# hShop<\/p>\n
**A fully customizable GUI shop plugin with multi-currency support, per-item cooldowns, buy limits, and a clean decoration system.**<\/p>\n
—<\/p>\n
## What is hShop?<\/p>\n
hShop is a shop plugin I built because I was tired of bloated alternatives that made simple things complicated. It uses file-based categories (one yml per category), so adding new shop sections is as easy as dropping a new file into the `categories\/` folder.<\/p>\n
Every item in every category is fully configurable, buy prices, sell prices, cooldowns, per player limits, currency type, slot position, enchantments, flags, etc. It’s built to be readable and easy to edit.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **File-based categories** – each category has its own `.yml` file, just drop it in and reload
\n– **Dual currency support** – items can use either Vault or hShards as their currency, configurable per-item
\n– **Buy limits** – limit how many times a player can buy a specific item (resets are admin-controllable)
\n– **Per-item cooldowns** – set a cooldown in seconds on any item individually
\n– **Confirm purchase menu** – optional confirmation screen before a purchase goes through
\n– **Decoration system** – fully customize the look of menus with filler items, border layouts, navigation buttons and more via decoration yml files
\n– **Custom icon slots** – pin category icons to specific slots in the main menu, or leave them on AUTO
\n– **Pagination** – category pages auto-paginate with configurable next\/prev buttons
\n– **Sell support** – players can sell items back through the shop GUI, `\/sellhand`, or `\/sellall`
\n– **Global sell multiplier** – scale all sell prices server-wide from a single config value
\n– **Permission per category** – restrict entire categories to specific permission nodes
\n– **Sounds** – configurable sounds for opening menus, successful purchases, sells, and failures
\n– **Transaction logging** – all buys and sells are logged to a file
\n– **PlaceholderAPI support** – via hShards integration
\n– **Fully async-safe** – data operations won’t lag your main thread<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
| Dependency | Required? |
\n|—|—|
\n| Paper 1.21+ | \u2705 Required |
\n| Vault | \u2705 Required |
\n| hShards | \u2b50 Soft (for HSHARDS currency) |
\n| PlaceholderAPI | \u2b50 Soft |<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission | —<\/p>\n ## Bypass Permissions<\/p>\n | Permission | Effect | —<\/p>\n ## Category Configuration<\/p>\n Each category lives in `plugins\/hShop\/categories\/ “`yaml items: —<\/p>\n ## Item Lore Placeholders<\/p>\n These work inside any item’s `lore` list:<\/p>\n | Placeholder | Description | —<\/p>\n ## Multi-Currency<\/p>\n hShop supports two currencies side by side. Each item can have its own currency type, some items can cost Vault money, others can cost hShards, all in the same category. Set it per item with `currency: VAULT` or `currency: HSHARDS`.<\/p>\n hShards integration is automatic if the plugin is present on your server.<\/p>\n —<\/p>\n ## Works great with hShards<\/p>\n hShop pairs with hShards to give your server a second economy. Players earn shards by selling items, receiving them from admins, or through the interest system, then spend them in the shop on special items that cost `HSHARDS` instead of regular money.<\/p>\n —<\/p>\n *Made by hPlugins by hodakazy*<\/p>\n *The words used in this plugin are inspired by zShop, such as decorations and pagination*<\/p>\n","protected":false},"excerpt":{"rendered":" A very customisable and weirdly easy to use Shop plugin.<\/p>\n","protected":false},"featured_media":82466,"template":"","meta":{"_minecraft_slug":"hshop","_minecraft_project_id":"UvbypAUm","_minecraft_author":"hodakazy","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":39,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hshop.zip","_minecraft_size_bytes":88584,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:46:54.731929Z","_minecraft_date_created":"2026-03-27T05:56:03.189496Z","_minecraft_date_modified":"2026-03-28T06:12:08.394273Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hshop","_minecraft_icon_attachment_id":82466,"_minecraft_imported_at":"2026-06-04T17:32:54+00:00","_minecraft_import_hash":"7c9048d624ad2daa28cf543967effe3b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,89,873,126,127,128,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-82465","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-game-mechanics","mod_category-library","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","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| `\/hshop` | Open the main shop | `hshop.use` |
\n| `\/hshop
\n| `\/sellhand` | Sell the item you’re holding | `hshop.use` |
\n| `\/sellall` | Sell all eligible items in your inventory | `hshop.use` |
\n| `\/hshopa reload` | Reload the plugin | `hshop.admin` |
\n| `\/hshopa toggle shop` | Toggle the shop on\/off | `hshop.admin` |
\n| `\/hshopa toggle buy
\n| `\/hshopa toggle sell
\n| `\/hshopa createcategory
\n| `\/hshopa deletecategory
\n| `\/hshopa createitem
\n| `\/hshopa deleteitem
\n| `\/hshopa giveitem
\n| `\/hshopa setprice
\n| `\/hshopa setlimit
\n| `\/hshopa setcooldown
\n| `\/hshopa resetlimit
\n| `\/hshopa resetcooldown
\n| `\/hshopa info
\n|—|—|
\n| `hshop.bypass.cooldown` | Skip item buy cooldowns |
\n| `hshop.bypass.limit` | Skip buy limits |
\n| `hshop.bypass.sell` | Skip sell restrictions |<\/p>\n
\ndisplay-name: “&aWeapons”
\nicon: DIAMOND_SWORD
\nicon-slot: AUTO # or a slot number like 13
\nicon-lore:
\n – “&7Buy and sell weapons.”
\n – “&8Items: &7{item_count}”
\n – “&eClick to open!”
\ndecoration: default
\ntitle: “&8\u00bb &a{category_name} &8\u00ab &7({page}\/{total_pages})”
\nrows: 6
\nsort: 1
\nenabled: true
\npermission: “”<\/p>\n
\n diamond_sword:
\n name: “&b&lDiamond Sword”
\n material: DIAMOND_SWORD
\n amount: 1
\n slot: AUTO
\n currency: VAULT
\n lore:
\n – “&8Buy: &a{buy_price} {currency}”
\n – “&8Sell: &c{sell_price} {currency}”
\n buy:
\n enabled: true
\n price: 250.0
\n limit: -1
\n cooldown: -1
\n sell:
\n enabled: true
\n price: 100.0
\n“`<\/p>\n
\n|—|—|
\n| `{buy_price}` | Buy price of the item |
\n| `{sell_price}` | Sell price of the item |
\n| `{currency}` | Currency display name |
\n| `{currency_type}` | Currency type (VAULT or HSHARDS) |
\n| `{buy_limit}` | Max buy limit (-1 = \u221e) |
\n| `{buy_limit_remaining}` | How many the player can still buy |
\n| `{cooldown_remaining}` | Time left on cooldown |
\n| `{buy_status}` | Colored buyable status |
\n| `{sell_status}` | Colored sellable status |<\/p>\n