SimpleStore - Spigot Plugin

A simple shop plugin for Spigot 1.19.4+

Features

How to Open the Shop

Use the command /SimpleStore or /ss
Right-click air while holding an emerald in your main hand (this feature can be toggled on/off with /SimpleStore toggle)

Shop Interface

First Two Rows (18 slots): Display items for sale
Third Row (Bottom Row):
- Left button (Slot 19): Previous page
- Middle button (Slot 23): Close shop
- Right button (Slot 27): Next page

Purchasing Items

Left Click: Purchase 1 * amount (amount can be configured in the config file)
Shift + Left Click: Purchase 64 * amount

Commands

Command	Permission	Description
`/SimpleStore`	`simplestore.use`	Open the shop
`/SimpleStore help`	`simplestore.use`	Display help information
`/SimpleStore reload`	`simplestore.reload`	Reload the configuration file
`/SimpleStore toggle`	`simplestore.use`	Toggle the emerald right-click feature

Permissions

simplestore.use - Use the shop (Default: true)
simplestore.reload - Reload the configuration file (Default: op)
simplestore.admin - Admin permission → Access to all commands (Default: op)

Configuration File

The configuration file is located at plugins/SimpleStore/config.yml

Shop Name

shop-name: "&aSimple Shop"

Adding Items

items:
  1:  # Item ID (used for sorting)
    material: DIAMOND  # Item type
    amount: 1  # Quantity per purchase
    name: "&bDiamond"  # Display name
    lore:  # Item description
      - "&7Buy a shiny diamond"
      - "&eLeft Click: Buy x1"
      - "&eShift+Left Click: Buy x64"
    price: 5  # Price (number of emeralds)

Custom Messages

All messages can be customized in the messages section of the configuration file:

messages:
  prefix: "&a[SimpleStore] &r"
  purchase-success: "&aSuccessfully purchased &e{amount}x {item} &afor &e{price} emeralds!"
  # ... more messages

GUI Settings

You can customize navigation buttons and filler items:

gui:
  rows: 3
  previous-page-slot: 18
  next-page-slot: 26
  close-slot: 22
  # ... more settings

Installation

Place the downloaded JAR file into your server's plugins folder
Restart the server or use /reload confirm
Edit the plugins/SimpleStore/config.yml configuration file
Use /SimpleStore reload to reload the configuration

Notes

Currently only supports using emeralds as currency
Items are automatically paginated, with a maximum of 14 items per page
Automatically checks player inventory space and emerald count when purchasing
Supports Chinese text display and color codes (using the & symbol)

Color Codes

&0 - Black
&1 - Dark Blue
&2 - Dark Green
&3 - Cyan
&4 - Dark Red
&5 - Purple
&6 - Gold
&7 - Gray
&8 - Dark Gray
&9 - Blue
&a - Green
&b - Aqua
&c - Red
&d - Pink
&e - Yellow
&f - White
&l - Bold
&n - Underline
&o - Italic
&r - Reset

Current Version

Plugin Version: 1.0
Spigot API: 1.19.4+
Java: 17+

Author

mcmohen

SimpleStore-GUI