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
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 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.adminedit any shop, create admin shops,
vshop.edit.playeris 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 ledger <Player>
With LuckPerms you can set options like
/lp user DosMike meta set KEY VALUE
vshop.option.playershop.limitNumber of player-shops one is allowed to have
vshop.option.dailyincome.limitMaximum money a player may earn through admin shops per irl day, reset at 24:00 server time
vshop.option.chestlink.distanceMaximum distance a player-shop may have to it’s stock-container. This affects
/vshop linkas well as
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.
The plugin will create two configs and a h2 database.
None of these files are meant to be edited by you
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
ledger.db.mv.db - 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
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
This plugin uses a version checker to notify you about available updates.
This updater is disabled by default and can be enabled in
by setting the value
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!
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
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.