# Installation

## 📦 ShopMaster - Installation Guide

Learn how to install and set up ShopMaster on your Minecraft server in just a few steps. This guide covers requirements, installation, dependencies, and basic configuration.

***

### ✅ Prerequisites

Before installing ShopMaster, make sure your server meets the following requirements:

* Minecraft Server: **Spigot**, **Paper, Folia**, or a compatible fork (version **1.16.5 or higher**)
* Java Version: **Java 11 or higher**

***

### 🧰 Installation Process

#### 🔽 Step 1: Download the Plugin

Visit the official ShopMaster page and download the latest `ShopMaster.jar` file.

#### ⚠️ Step 2: Prepare the Server

> Make sure your server is **completely shut down** before installing the plugin to avoid data loss or loading issues.

#### 📂 Step 3: Plugin Installation

1. Navigate to the `/plugins` directory in your server files.
2. Place the downloaded `ShopMaster.jar` file into this folder.

#### ▶️ Step 4: Start the Server

* Launch your server as usual.
* ShopMaster will automatically generate its folder: `/plugins/ShopMaster/`
* Check the console for confirmation messages indicating the plugin loaded successfully.

***

### 🔗 Dependencies

#### Required

| Plugin    | Purpose                            |
| --------- | ---------------------------------- |
| **Vault** | Handles economy system integration |

#### Optional (Soft Dependencies)

ShopMaster works seamlessly with several other plugins to enhance features:

| Plugin               | Feature                                          |
| -------------------- | ------------------------------------------------ |
| **PlaceholderAPI**   | Enables use of placeholders in messages and GUIs |
| **TokenManager**     | Adds support for token-based economy             |
| **PlayerPoints**     | Allows using points as currency                  |
| **BreweryX**         | Compatibility with custom potion recipes         |
| **ExecutableItems**  | Custom items with effects and abilities          |
| **ExecutableBlocks** | Shop items on interactive blocks                 |
| **MMOItems**         | Full support for MMOItems RPG system             |
| **ItemsAdder**       | Works with custom items and textures             |
| **Oraxen**           | Integration for Oraxen-based custom models       |

***

### ⚙️ Initial Configuration

After installation, go to `/plugins/ShopMaster/` to find your configuration files.

#### 🔧 Quick Start

1. Open `config.yml` and adjust global plugin settings.
2. Edit `messages.yml` to customize shop messages.
3. Use the command `/adminshop reload` to apply changes without restarting the server.

***

For advanced usage, check out our full documentation or join the **ShopMaster Support Discord** for help and updates.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xshyo.us/premium-plugins/shopmaster/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.