Getting started

Installation

Requirements#

  • Paper 1.21.4 or newer (including 26.1), or a Paper fork.
  • Java 21 or newer.
  • No required dependencies. Vault, PlayerPoints and PlaceholderAPI are optional soft dependencies.

Install#

  1. Put the jar in your server's plugins/ folder.
  2. Restart the server. The plugin creates plugins/mcShardShop/ with config.yml, items.yml, earning.yml, messages.yml, menus.yml, holograms.yml and webhooks.yml.
  3. The console prints a line such as Ready: 18 items, 0 stands, rotation #1. when startup is done.
Works out of the box

The plugin ships with 18 starter items, so the shop fills itself as soon as you place the first stand.

Upgrading from 1.x#

Swap the jar and restart. DecentHolograms is no longer needed. Balances, displays, items and settings import by themselves on the first start, and your old files are kept in plugins/mcShardShop/v1-backup.

Database errors

If the database cannot be opened (for example wrong MySQL details), the plugin logs the problem and turns itself off. Check the storage section of config.yml.