Shop Plugin

A physical shop and cashier system for your Minecraft server with virtual shopping baskets and Vault economy integration.

Features

Cash Register System

• Create Registers: Use /register create while looking at any block to turn it into a Cash Register
• Visual Holograms: Floating text displays above each register showing the shop status
• Persistent Storage: Register locations are saved in registers.yml

Shop Status

• Toggle Open/Closed: Use /shop toggle to switch between OPEN and CLOSED status
• Visual Indicators: The hologram above registers changes dynamically:
  • Open: Green "● OPEN CASH REGISTER"
  • Closed: Red "○ CLOSED (Check back later)"
• Sound Effects: Door open/close sounds play when toggling

Shopping Basket

• Add Items: Right-click while holding a shop item (diamonds, gold, iron, emeralds, etc.) to add it to your virtual basket
• View Basket: Use /basket to see your current items and total
• Persistent: Items stay in your basket until checkout or server restart

Checkout Process

• Open Register: Right-click on an OPEN Cash Register to open the checkout GUI
• View Items: See all basket items with individual prices
• Purchase: Click the Green Wool button to complete checkout
• Payment: Automatically deducts total from player balance (requires Vault economy)
• Delivery: Items are added to your inventory (or dropped on ground if full)
• Confirmation: "Chime" sound plays on successful purchase

Blocked Actions

When the shop is CLOSED:

• Cannot add items to basket
• Cannot open checkout GUI
• Players receive: "Sorry, the shop is currently closed!"

How to Use

For Players

1. Find shop items - Look for valuable materials (diamonds, gold, iron, emeralds, etc.)
2. Add to basket - Right-click with an item to add it to your virtual basket
3. Check basket - Run /basket to see your items and total cost
4. Checkout - Find a Cash Register and right-click it when the shop is OPEN
5. Complete purchase - Click the green wool button to pay and receive items

For Administrators

1. Create a register - Run /register create while looking at a block
2. Toggle shop status - Use /shop toggle to open or close the shop

Tips & Tricks

• Place multiple registers around your spawn for convenience
• The hologram makes it easy to find registers from a distance
• Shop items are automatically priced (diamond = $100, gold = $50, etc.)
• Players can hold multiple of the same item to add several at once

Known Limitations

• Basket contents reset when the server restarts
• Economy requires Vault plugin to be installed on the server
• Only pre-configured items can be sold (diamond, gold, iron, emerald, redstone, lapis, coal, copper, glowstone, ender pearl)