Store

Store Shop - Brief Introduction

========================================

Overview: A player-to-player trading shop plugin for Minecraft, with a built-in Credits economy system. Supports listing, buying, acquiring, and collecting items, with automatic synchronization to the Points plugin.

========================================

Basic Info

========================================

• Version: V0.1.2
• Platform: Paper 26.2 (api-version: 26.2)
• Dependencies: No hard dependencies; if the Points plugin is installed, Credits will be fully mirrored with it
• Main class: com.pactlight.store.StorePlugin
• Data storage: plugins/Store/ directory

========================================

Features

========================================

1. Shop GUI: /store gui opens a 6x9 interface. Rows 1-5 display listings (45 slots). Row 6 contains pagination (prev / player head / next) and a points viewer entry.
2. Post / Acquire: /store post - hold an item to publish a SELL or BUY order. Enter quantity and price via chat prompts. Prices support decimals (e.g. 0.5, 520.123, up to 3 decimal places).
3. Trading: Left-click a BUY listing to sell your held item. Right-click a SELL listing to buy. Supports collecting, returning, and automatic owner notifications.
4. Credits Economy: Built-in Credits accounts with add, remove, and balance queries. Auto-saved; data persists across server restarts. Balances support decimals.
5. Auto Save: Automatic periodic saving (default 300 seconds), no manual action needed.
6. Fully Configurable: All messages, colors, GUI content, and save intervals can be customized in config.yml.
7. Fees: A listing fee is charged to the publisher as a percentage of the total price (unit price x quantity, default 5%; publishing is rejected if the balance is insufficient). A purchase fee is paid on top by the paying party (default 5%), while the seller still receives the full price. Both rates are configurable under "fees" in config.yml; set to 0 to disable.

========================================

Commands

======================================== /store - Show command help /store gui - Open the shop GUI /store post - Post or acquire an item from your hand /store purchase - Buy a specific SELL listing by item ID (SELL listings only; the item ID is shown in the GUI tooltip)

========================================

Integration with Points Plugin

======================================== The Credits system fully mirrors the Points plugin, and both balances and prices support decimals (up to 3 decimal places). If Points is installed, both systems stay in sync automatically (balances and all add/remove operations are shared) with no extra configuration. Without Points, Credits operates independently, with data stored in plugins/Store/.

========================================

Installation

========================================

1. Place Store-*.jar in the server's plugins directory;
2. Start the server - the config file is auto-generated in plugins/Store/;
3. Optionally install the Points plugin for Credits synchronization;
4. All text, colors, and GUI content are customizable in config.yml.