Documentation - NPCShops

NPCShops is a plugin that allows you to create nice shops with the ability to buy, repurchase and sell items. It has integration with custom items and extensive configuration.​

Responsible for creating a new shop, in the <name> value we enter the name of the shop, which cannot be repeated. The name will be displayed in the GUI.

Example: /NPCShops create MyShop


Using this command you can edit prices or items in a given shop. The first argument is responsible for selecting whether we want to edit items or price. The second one is to select the shop we want to edit.

Example: /NPCShops edit items MyShop


With this command you will delete a shop that you no longer need.

Example: /NPCShops remove MyShop


This command allows us to open the shop's graphical interface to another player. First, we select the player, then the shop, and finally whether the player should receive information about opening the shop.

Example: /NPCShops forceopen MyNick MyShop -s


The command opens a graphical interface that allows us to add, remove and edit shops without the need to enter commands.


It shows us a simple list of currently existing shops.


The command reloads the entire plugin. A command is required to confirm any changes to shops.


Used to open the selected shop.

Example: /shop MyShop​

npcshops.update-info - Sends update information on entry
npcshops.admin - Provides access to the /npcshops command
npcshops.shopuse - Gives access to every shop
npcshops.shopuse.<shop> - Allows you to open only the selected shop​

The basic, or simple, configuration involves an easy-to-use interface available under /NPCShops gui​

Click on enderchest to create a new shop.


Write its name on the plate


Press LMB to edit items in the shop


Click on an item in your inventory to add it to the shop.


Set its buy and sell price. To confirm the changes, enter NPCShops reload


If you have set the wrong price, you can easily change it by entering RMB in Edit price


Now after committing your changes using NPCShops reload you can enjoy the item in the shop.​

Index 0 shows us an example item that always appears after creating a new shop. Index 1 shows the item that was added when describing the basic configuration. Index 2 is a representation of an item from an advanced configuration.

Material: Material [e.g. BOOK]
Enchantments: Enchant:EnchantLevel [e.g. MENDING:1]
Flags: ItemFlag [e.g. HIDE_ATTRIBUTES]


It is also possible to add custom items, otherwise known as a full ItemStack.



Example integration with oraxen:
​