Shopkeepers Fabric

Shopkeepers Fabric

Players run their own shops. Place a chest, pick a mob, set your prices, and everyone else buys through the normal villager trading screen.

Works on Minecraft 1.21 to 1.21.11 and 26.1 to 26.3. There are two jars: pick the one for your version (see Requirements).

⚠️ This is not the official Shopkeepers. Shopkeepers Fabric is an independent, unofficial mod inspired by the classic Shopkeepers Bukkit plugin. It is not an official port, it shares no code with the plugin, and it is not made, endorsed or supported by the plugin's authors. Please don't report issues with this mod to them.

🎮 No client mod. Your players join vanilla.

Shopkeepers Fabric is 100% server-side. It goes in your server's mods/ folder and that's it: no modpack, no launcher setup, nothing for players to install. The trading screen is the vanilla villager screen, the shop editor is a vanilla chest screen, and the shopkeepers are ordinary mobs, so any vanilla client already knows how to show all of it.

🏪 Player Shops

Every shop is linked to a stock chest (or barrel) placed next to it.

• When someone buys, the item comes out of the chest and their payment goes into it.
• One shop can mix selling (diamonds for emeralds), buying (emeralds for wheat) and swapping (any item for any item), with up to 45 trades by default.
• Trades the chest can't fill right now (sold out, or no room for the payment) show the vanilla red cross, and the list updates after every purchase.
• Shift-click the result to buy as many as you can afford in one go.
• Owners get a chat message whenever someone buys from them.

👑 Admin Shops

Unlimited stock, keeps nothing it's paid. Made for spawn markets, item sinks and quest rewards.

• Create one with /shopkeeper admin [mob], or switch the Shopkeeper item into admin mode.
• Works from the console and command blocks: /execute positioned 0 64 0 run shopkeeper admin.
• Only staff can edit or delete them.

📚 Book Shops

Sell copies of your written books: guides, rules, stories, maps of the server. Flip any shop to a book shop with the Shop type button in its editor (its trades are kept for when you switch back).

• Put the written books you want to sell in the shop's chest, with empty Book and Quills as stock.
• The editor lists every book it finds (by title and author). Set a price under each, with one or two price items.
• Every sale writes a copy into one Book and Quill and puts the payment into the chest. Your originals never leave the chest.
• Copies follow the vanilla rules: an original sells as Copy of original, a copy of an original as Copy of a copy. Copies of copies and tattered books can't be copied.
• Out of Book and Quills, or no room for the payment? The trade shows the red cross until you restock.
• Admin book shops: click books straight into the editor. Unlimited copies, no chest needed.

🐑 Mob Looks

The Mob looks button in the editor shows only what fits the shop's mob:

• Baby versions of villagers, animals, zombies and piglins.
• Sheep in any wool colour, cat, wolf, fox, panda, llama, rabbit and parrot variants, and the warm and cold pigs, cows and chickens on 1.21.5+.
• A charged creeper, a snow golem with or without its pumpkin.
• An item in the hand of pillagers, vindicators, witches, piglins, skeletons and zombies: click it in like a trade item (a copy, yours stays with you).
• Villager profession and biome.

Looks are saved with the shop and survive restarts. Change the mob and back, and its looks come back too.

🧾 Sales History and Logs

• /shopkeeper history shows the latest sales of a shop, 10 per page, newest first.
• Every sale (player, admin and book shops) is written to a daily CSV file in config/shopkeepers/logs/, ready for a spreadsheet: who bought what, for what, when, and where.
• Old logs are cleaned up automatically after 30 days (configurable). Logging runs in the background, so it never slows a trade down.
• Safe to open in a spreadsheet: a shop name or book title that would run as a formula (like =HYPERLINK(...)) is written as text.

🛠️ Setting Up a Shop

1. Craft a Shopkeeper: 8 emeralds around a chest. It looks like a villager spawn egg (a glowing book on 1.21–1.21.1).
2. Right-click your chest with it to select it as stock.
3. Right-click the air to choose the mob (optional).
4. Right-click a block to place the shop. The editor opens straight away.

The Editor

A chest screen where each column is one trade: what the customer gets on top, the price below, an optional second price under that.

• Holding an item: left-click puts in the whole stack, right-click adds 1. Dragging works too.
• Empty hand: left-click takes the item out, right-click takes 1 out.
• The editor only uses copies. Your real items never leave your inventory, so nothing can be lost or duplicated in it.
• Buttons for pages, the shop type (trading or books), renaming (type the name in chat, & colour codes work), changing the mob, its looks, and deleting the shop (you get the Shopkeeper back).

25 mobs to choose from: villagers, wandering traders, pillagers, witches, golems, foxes, cats, pandas, llamas and more. The list is configurable.

🔒 Built for Servers (Anti-Grief & Anti-Exploit)

Shopkeepers is designed with server admins in mind. Shops can't be killed, robbed or hijacked.

• Unkillable shops: shop mobs ignore all damage, /kill @e, lightning (no villagers turning into witches), the void and despawning. If anything moves one, it snaps back within a second.
• Locked stock chests: only the owner can open or break a shop's chest. Explosions leave it standing, and nobody can open it by placing a chest next to it to make a double chest.
• Book shop chests too: everything here protects a book shop's chest the same way.
• No draining the stock: hoppers can't pull items out of a shop's chest or barrel, and neither can a hopper minecart rolled in on rails underneath. On 1.21.9 and newer, copper golems leave shops in copper chests alone too. Hoppers can still put items in, so you can keep a shop stocked automatically.
• No chest hijacking: you can only use a container you placed in the last 10 minutes as stock, so nobody can turn your chest into their shop and lock you out of it.
• No free items: stock is checked again at the exact moment an item is taken, so emptying the chest mid-trade can't hand out free items. Removing a shop closes every open editor and trade screen for it, so a shop can't be deleted twice for a second Shopkeeper item.
• Shop limits: 10 shops per player by default, and players can't pass shops to each other to get around it.
• Crash-proof storage: shop mobs aren't saved with the world. They're rebuilt from the shop data every time their chunk loads, so a crash or a stray /kill can never lose a shop.
• Clean uninstall: remove the mod and the shop mobs simply disappear. No stray villagers, no broken entities left behind.

🔑 LuckPerms Support

Every command and action has its own permission node, and a per-group shop limit can be set as LuckPerms meta. Works with LuckPerms and any other Fabric permissions mod, with nothing extra to install. Without one, it falls back to vanilla op levels.

• Shops for VIPs only: /lp group default permission set shopkeepers.create false
• Bigger limits for donors: /lp group vip meta set shopkeepers.max-shops 25
• Moderators who can manage any shop: /lp group mod permission set shopkeepers.bypass true

A node you set always wins over the default, both ways: you can give a normal player an admin power, or take one away from an op.

Everyone by default

• shopkeepers.trade — Trade with shops.
• shopkeepers.create — Create player shops with the Shopkeeper item.
• shopkeepers.command.list — /shopkeeper list (your own shops).
• shopkeepers.command.edit — /shopkeeper edit.
• shopkeepers.command.remove — /shopkeeper remove.
• shopkeepers.command.transfer — /shopkeeper transfer.
• shopkeepers.command.history — /shopkeeper history for your own shops.

OP by default

• shopkeepers.command.list.others — /shopkeeper list <player|admin|all>.
• shopkeepers.command.history.others — /shopkeeper history for anyone's shop and admin shops.
• shopkeepers.command.give — /shopkeeper give. Without OP, use player names instead of selectors like @a.
• shopkeepers.command.remote — /shopkeeper remote.
• shopkeepers.command.tp — /shopkeeper tp.
• shopkeepers.command.reload — /shopkeeper reload.
• shopkeepers.admin — Create, edit and delete admin shops.
• shopkeepers.bypass — Edit, remove and transfer anyone's shops, and open or break their stock chests. (OPs only get it by default while opsBypassProtection is on in the config, which it is unless you change it.)
• shopkeepers.bypass.limit — Own more shops than the limit.
• shopkeepers.bypass.container — Use any chest as stock, not just one you placed in the last 10 minutes.

Meta

• shopkeepers.max-shops — How many shops a player or group may own (-1 = unlimited). Replaces the config's default of 10.

Sneak + right-clicking your own shop and the editor's delete button work without the command nodes.

📊 Player Commands (everyone)

Leave out the [id] to use the shop you're looking at.

• /shopkeeper list — Your shops, with their ids and locations.
• /shopkeeper edit [id] — Open a shop's editor from anywhere.
• /shopkeeper remove [id] — Delete one of your shops and get the Shopkeeper back.
• /shopkeeper transfer [id] <player> — Give a shop to another player.
• /shopkeeper history [id] [page] — The latest sales of one of your shops.
• /shopkeeper help — Shows only the commands you're allowed to use.

🛠️ Admin Commands (OP, or the matching permission)

• /shopkeeper list <player|admin|all> — Anyone's shops, admin shops, or every shop on the server.
• /shopkeeper give [players] [amount] — Hand out Shopkeeper items.
• /shopkeeper admin [mob] — Create an admin shop where you stand.
• /shopkeeper remote <id> — Open any shop's trading screen from anywhere.
• /shopkeeper tp <id> — Teleport to a shop.
• /shopkeeper history <id> [page] — Any shop's sales.
• /shopkeeper reload — Re-read the config file without restarting the server.

Admins can also edit, remove and transfer any player's shop, and open any stock chest.

⚙️ Configuration

config/shopkeepers.json is written with defaults on first run: the shop limit, how far a shop may stand from its chest, whether the chest must be one you just placed, trade pages, the longest shop name, the allowed mobs, whether shop mobs look at players, owner trade notifications, the purchase log (logPurchases, purchaseLogDays), and toggles for chest protection, explosion protection and admin bypass. Edit it and run /shopkeeper reload, no restart needed. Missing keys fall back to defaults, so your config survives updates.

Requirements

Two jars, the same mod: pick the one for your Minecraft version.

Minecraft	Download	Java	Fabric Loader	Also needs
1.21 to 1.21.11	shopkeepers-fabric-<version>.jar	21	0.16.0+	Fabric API
26.1 to 26.3	shopkeepers-fabric-<version>-26.x.jar	25	0.18.4+ (0.19.3+ on 26.3)	Fabric API

Drop the jar into mods/ next to Fabric API and it picks the right build for your Minecraft version by itself. Both jars have the same features, commands, permissions and config.

Your shops carry over. Shops are stored per world in world/shopkeepers.dat, and the items in their trades are upgraded along with the rest of your world. Updating within 1.21? Keep the same jar. Moving your server from 1.21.x to 26.x? Swap the jar: every shop comes back where it was, with its owner, trades, book prices, looks and stock chest, and your config and purchase logs keep working as they are.

Minecraft 26.2 only: on a Peaceful server, players on 26.2 don't see shops whose mob is a monster (pillager, witch, vindicator…), because the 26.2 game drops every monster on Peaceful. 26.1, 26.3, 26.2 on Easy or higher, and every non-monster mob are fine.

On 1.21 and 1.21.1 the Shopkeeper item is a glowing knowledge book, because those versions can't give an item the spawn-egg look.

---

Contact me in my discord server if you need any help