Set up Mobs of any type as admin shop. Shops will use a Inventory-Menu to buy/sell items


This plugin requires LangSwitch

Feel free to open an issue on the git to share your translations

You need to download the translations from GitHub or use the auto downloader

Version 2.0+ requires MegaMenus


This plugin allows you to set up villagers or other mobs as shops.
They will sell items as admin shop (this means infinite stock), or as player shops if placed above a chest.
The shop will be displayed as inventory over multiple pages you can modify with chat commands as admin or if you own the shop.
Buy items with a primary click and sell them with a secondary click (usually primary is the left mouse button).
You can also name the shop mobs and set the variant (Villager profession).
Additionally you can set items to ignore damage, nbt or use oredict entries.
Please note that your server needs any economy Plugin for this to work

Latest Version: 2.2.1 (2019-08-14) (Written, compiled and tested for spongevanilla-1.12.2-7.2.0)


For every edit command but create, please look at the shop
(The commands are written as Usage Messages, you can google docopt for more information)

  • /vshop create [--at <World/X/Y/Z/Rotation>] <EntityType> [--skin <Skin>] [DisplayName]
  • /vshop delete (deletes shop)
  • /vshop add [-l <Limit>] <~|BuyPrice> <~|SellPrice> [Currency] [-o <Index>] [--filter <ignore_nbt|ignore_damage|type_only|oredict|normal>]
  • /vshop remove <Index> (removes item from shop)
  • /vshop link (connect a playershop to a different chest)
  • /vshop identify or /vshop id
  • /vshop save
  • /vshop reload (reload settings.conf)
  • /vshop ledger [Player] or /vshop log [Player] (display last 100 transactions the players shops made)
  • /vshop list [Player] (list all shops, offer invsee for player shops and tp)
  • /vshop tphere <Shop ID> moves a shop by id (/vshop identify) to your current location


  • vshop.edit.admin edit any shop, create admin shops, /vshop save, /vshop reload, /vshop list
  • vshop.edit.player is required to create your player shop
  • the add, remove and delete command are always available for shops you own
  • vshop.create.<ENTITYTYPE> is required for each entity type a player should be allowed to create, where colons are replaced with dots and dashed are taken out. so for example minecraft:villagers would require vshop.create.minecraft.villager
  • vshop.edit.identify for /vshop identify
  • vshop.edit.linkchest for /vshop link
  • vshop.edit.move for /vshop tphere
  • vshop.ledger.base for /vshop ledger
  • vshop.ledger.others for /vshop ledger <Player>


With LuckPerms you can set options like /lp user DosMike meta set KEY VALUE

  • vshop.option.playershop.limit Number of player-shops one is allowed to have
  • vshop.option.dailyincome.limit Maximum money a player may earn through admin shops per irl day, reset at 24:00 server time
  • vshop.option.chestlink.distance Maximum distance a player-shop may have to it’s stock-container. This affects /vshop link as well as /vshop tphere

Player Shops

In order to create a player shop you’ll have to first place a container below the block you want the shop to be. This can either be directly below or with a one block spacing.

The chest should be protected from punching, explosions and is only accessible for the owner. Double chest wont work - The plugin does not care for the other half, neither stock nor protection wise.

On forge this means that a chest has to have at least 27 slots, since I do not want shops to be able to sell / buy into machines.

More Inforamtion

The plugin will create two configs and a h2 database.
None of these files are meant to be edited by you

The vshop.conf will store all shops including their listings. The income per player for the day are stored in incomeLimits.conf to persist over server restarts. All shop transactions are saved in the - you can inspect them with a h2 database editor. The database is never cleared at the moment so you may want to delete or trim it every now and then.

Chat messages will notify playershop owners about purchases in all their shops every 15 seconds to prevent mass spam.

Shops save with the world now, this means that editing shops via config got extremely unreliable and made the old behaviour of /vshop reload useless. Instead this command will now try to reload skins for sponge:human shops.
Even though I set the skin correctly they sometimes seem to not load/be sent to the player, so /vshop reload will reapply the skin.


For more Information see the Setup Guide, or the pinned messages in the Discord channel

  • Pixelmon will replace various vanilla mobs with Pixelmon versions resulting in VillagerShops spamming mobs
  • Minecraft Comes Alive similar to Pixelmon this mod replaced villagers with custom mobs
  • InventoryTweaks has to be installed client side only - otherwise item dupes may happen
  • RLCraft (Mod: PotionCore) if your modpack contains PotionCore you’ll have to modify configs for server and client to get things to work

External Connections

Version Checker
This plugin uses a version checker to notify you about available updates.
This updater is disabled by default and can be enabled in config/vshop/settings.conf by setting the value VersionChecker to true.
If enabled it will asynchronously check (once per server start) if the Ore repository has any updates.
This will only print update notes into the server log, no files are being downlaoded!

Translation Downloads
If you don’t want to download translations from GtiHub or can’t find them you can turn on AutoDownloading in the config/vshop/settings.conf. If you start the server or /vshop reload with this setting enabled and no tranlations can be found on your server it will automatically pull the latest translation files from GitHub and place them into config/vshop/Lang for you. Once the downloads finish you’ll have to restart the server.

Need Help?

Join my Discord

Category: Economy

Published on Aug 14, 2017


14 stars


3,914 total downloads

Licensed under MIT

Promoted Versions