hShop

A fully customizable GUI shop plugin with multi-currency support, per-item cooldowns, buy limits, and a clean decoration system.

---

What is hShop?

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.

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.

---

Features

• File-based categories - each category has its own .yml file, just drop it in and reload
• Dual currency support - items can use either Vault or hShards as their currency, configurable per-item
• Buy limits - limit how many times a player can buy a specific item (resets are admin-controllable)
• Per-item cooldowns - set a cooldown in seconds on any item individually
• Confirm purchase menu - optional confirmation screen before a purchase goes through
• Decoration system - fully customize the look of menus with filler items, border layouts, navigation buttons and more via decoration yml files
• Custom icon slots - pin category icons to specific slots in the main menu, or leave them on AUTO
• Pagination - category pages auto-paginate with configurable next/prev buttons
• Sell support - players can sell items back through the shop GUI, /sellhand, or /sellall
• Global sell multiplier - scale all sell prices server-wide from a single config value
• Permission per category - restrict entire categories to specific permission nodes
• Sounds - configurable sounds for opening menus, successful purchases, sells, and failures
• Transaction logging - all buys and sells are logged to a file
• PlaceholderAPI support - via hShards integration
• Fully async-safe - data operations won't lag your main thread

---

Requirements

Dependency	Required?
Paper 1.21+	✅ Required
Vault	✅ Required
hShards	⭐ Soft (for HSHARDS currency)
PlaceholderAPI	⭐ Soft

---

Commands

Command	Description	Permission
/hshop	Open the main shop	hshop.use
/hshop <category>	Open a specific category directly	hshop.use
/sellhand	Sell the item you're holding	hshop.use
/sellall	Sell all eligible items in your inventory	hshop.use
/hshopa reload	Reload the plugin	hshop.admin
/hshopa toggle shop	Toggle the shop on/off	hshop.admin
/hshopa toggle buy <category> <item>	Toggle buying for an item	hshop.admin
/hshopa toggle sell <category> <item>	Toggle selling for an item	hshop.admin
/hshopa createcategory <id>	Create a new category	hshop.admin
/hshopa deletecategory <id>	Delete a category	hshop.admin
/hshopa createitem <category> <id> <material>	Add an item to a category	hshop.admin
/hshopa deleteitem <category> <id>	Remove an item	hshop.admin
/hshopa giveitem <player> <category> <item> <amount>	Give a player a shop item	hshop.admin
/hshopa setprice <category> <item> buy|sell <price>	Change a price	hshop.admin
/hshopa setlimit <category> <item> <limit>	Change a buy limit	hshop.admin
/hshopa setcooldown <category> <item> <seconds>	Change a cooldown	hshop.admin
/hshopa resetlimit <player> <category> <item>	Reset a player's limit	hshop.admin
/hshopa resetcooldown <player> <category> <item>	Reset a player's cooldown	hshop.admin
/hshopa info <category> [item]	View category or item details	hshop.admin

---

Bypass Permissions

Permission	Effect
hshop.bypass.cooldown	Skip item buy cooldowns
hshop.bypass.limit	Skip buy limits
hshop.bypass.sell	Skip sell restrictions

---

Category Configuration

Each category lives in plugins/hShop/categories/<name>.yml. Here's what a typical one looks like:

display-name: "&aWeapons"
icon: DIAMOND_SWORD
icon-slot: AUTO        # or a slot number like 13
icon-lore:
  - "&7Buy and sell weapons."
  - "&8Items: &7{item_count}"
  - "&eClick to open!"
decoration: default
title: "&8» &a{category_name} &8« &7({page}/{total_pages})"
rows: 6
sort: 1
enabled: true
permission: ""

items:
  diamond_sword:
    name: "&b&lDiamond Sword"
    material: DIAMOND_SWORD
    amount: 1
    slot: AUTO
    currency: VAULT
    lore:
      - "&8Buy: &a{buy_price} {currency}"
      - "&8Sell: &c{sell_price} {currency}"
    buy:
      enabled: true
      price: 250.0
      limit: -1
      cooldown: -1
    sell:
      enabled: true
      price: 100.0

---

Item Lore Placeholders

These work inside any item's lore list:

Placeholder	Description
{buy_price}	Buy price of the item
{sell_price}	Sell price of the item
{currency}	Currency display name
{currency_type}	Currency type (VAULT or HSHARDS)
{buy_limit}	Max buy limit (-1 = ∞)
{buy_limit_remaining}	How many the player can still buy
{cooldown_remaining}	Time left on cooldown
{buy_status}	Colored buyable status
{sell_status}	Colored sellable status

---

Multi-Currency

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.

hShards integration is automatic if the plugin is present on your server.

---

Works great with hShards

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.

---

Made by hPlugins by hodakazy

The words used in this plugin are inspired by zShop, such as decorations and pagination