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 plugins/ and restart the server.
  2. The plugin creates plugins/mcCoinShop/ with config.yml, messages.yml, sales.yml, coupons.yml, deals.yml, earning.yml, discord.yml, a guis/ folder with the menus and a coinshop/ folder with four example categories (ranks, weapons, blocks, cosmetics).
  3. Run /coinshop to see the default shop.

Upgrading from 1.x#

Delete the old plugins/mcCoinShop/guis folder first so the new menus are created. Your config.yml layout stays close to 1.x and category files keep their format. Player balances and purchase counts import when each player next joins.

Rank commands

The example Ranks category runs LuckPerms commands such as lp user %player% parent add vip. Change them to your own rank plugin, or remove the items you do not want, before opening the shop to players.