[HR][/HR]

[HEADING=2] Overview[/HEADING]

ShopkeepersReworked is a fully reworked version of the famous Shopkeepers plugin designed for modern Paper/Spigot servers.

The plugin provides a stable, scalable, and highly customizable merchant system for:

• Survival Economy Servers
• Semi-RP Servers
• RPG Servers
• Trading Hubs
• Community Marketplaces

Designed with performance and production stability in mind, ShopkeepersReworked supports advanced trading mechanics, modern Paper/Folia compatibility, extensive integrations, and complete administrative control.

[HR][/HR]

[HEADING=2] Main Features[/HEADING]

• Player Shops & Admin Shops
• 78 Supported Merchant Entity Types
• Villager & Wandering Trader Support
• Regular Signs & Hanging Signs
• Remote Shop Opening & Editing
• Merchant Teleportation
• Shop Ownership Transfer
• Trade Notifications
• Merchant Rental & Hiring System
• Shopkeeper Snapshots
• Trade Command Support
• Automatic Cleanup of Inactive Shops
• Advanced Container Protection
• Advanced Placement Restrictions
• Statistics & Top Systems
• Multilingual Support (FR / EN / DE)

[HR][/HR]

[HEADING=2] Technical Highlights[/HEADING]

• Paper / Spigot 1.21.x
• Full Folia Support
• Java 21
• 78 Merchant Entity Types
• 10 Optional Plugin Integrations
• Advanced Logging Modes:
  • DISABLED
  • CSV
  • SQLITE
  • MYSQL
• Configurable Statistics & Leaderboards
• Automatic Refresh System

[HR][/HR]

[HEADING=2] Optional Integrations[/HEADING]

• WorldGuard
• Towny
• Citizens
• Vault
• Gringotts
• ChestShop
• PlaceholderAPI
• Multiverse-Core
• My Worlds
• Transporter

[HR][/HR]

[HEADING=2] Why Choose ShopkeepersReworked?[/HEADING]

Unlike traditional merchant plugins, ShopkeepersReworked focuses on production-ready stability, flexibility, and modern server compatibility.

• Highly detailed configuration system
• Advanced administration tools
• Secure data management
• Modern Paper & Folia architecture
• Optimized for large-scale economy servers
• Integrated protection systems
• Flexible restriction management
• Reliable backup & restoration features

Whether you run a small survival server or a large RPG network, ShopkeepersReworked provides a clean and scalable merchant ecosystem.

[HR][/HR]

[HEADING=2] Reworked Version Highlights[/HEADING]

• Modern 1.21.x support
• Recent Minecraft entity support
• Folia compatibility
• Hanging sign support
• Advanced PlaceholderAPI support
• Integrated statistics & rankings
• MySQL / SQLite / CSV trade logging
• Snapshot restoration system
• Improved multilingual ecosystem

[HR][/HR]

[HEADING=2] Perfect For[/HEADING]

• Economy Survival Servers
• Semi-RP Servers
• RPG Servers
• NPC Trading Systems
• Merchant Cities & Marketplaces
• Progression-Based Servers

[HR][/HR]



[HR][/HR]

[HEADING=2] Permissions[/HEADING]

Permission	Description	Default
shopkeeper.help	Display command help	true
shopkeeper.reload	Reload the plugin	op
shopkeeper.debug	Enable debug mode	op
shopkeeper.cleanup-citizen-shopkeepers	Remove invalid Citizens shopkeepers	op
shopkeeper.list.own	List your own shops	true
shopkeeper.list.others	List other players' shops	op
shopkeeper.list.admin	List admin shops	op
shopkeeper.remove.own	Remove your own shops	op
shopkeeper.remove.others	Remove other players' shops	op
shopkeeper.remove.admin	Remove admin shops	op
shopkeeper.remove-all.own	Remove all your shops	op
shopkeeper.remove-all.others	Remove all shops from another player	op
shopkeeper.remove-all.player	Remove all player shops	op
shopkeeper.remove-all.admin	Remove all admin shops	op
shopkeeper.notify.trades	Enable or disable trade notifications	true
shopkeeper.give	Give shop creation item	op
shopkeeper.give.plus	Give Shop+ item	op
shopkeeper.player.plus	Create Shop+ shops	false
shopkeeper.givecurrency	Give currency items	op
shopkeeper.setcurrency	Define currency items	op
shopkeeper.convertitems.own	Convert your own items	op
shopkeeper.convertitems.others	Convert other players' items	op
shopkeeper.updateitems	Update third-party items	op
shopkeeper.remote	Open a shop remotely	op
shopkeeper.remote.otherplayers	Open other players' shops remotely	op
shopkeeper.remoteedit	Edit a shop remotely	op
shopkeeper.transfer	Transfer shop ownership	op
shopkeeper.teleport	Teleport to a merchant	op
shopkeeper.teleport.others	Teleport other players to a merchant	op
shopkeeper.settradeperm	Configure trade permissions	op
shopkeeper.settradedcommand	Configure traded commands	op
shopkeeper.setforhire	Set a merchant for hire	op
shopkeeper.snapshot	Access shopkeeper snapshots	op
shopkeeper.edit-villagers	Edit regular villagers	op
shopkeeper.edit-wandering-traders	Edit wandering traders	op
shopkeeper.trade	Allow trading with merchants	true
shopkeeper.hire	Allow hiring merchants	true
shopkeeper.bypass	Bypass restrictions	op
shopkeeper.autoop	Temporary OP for vanilla actions	false
shopkeeper.maxshops.unlimited	Remove shop limit	op
shopkeeper.admin	Create and manage admin shops	op
shopkeeper.player.trade	Create player trade shops	false
shopkeeper.player	Create player shops	true
shopkeeper.sign	Create sign shops	true
shopkeeper.hanging-sign	Create hanging sign shops	true
shopkeeper.citizen	Create Citizens shops	op
shopkeeper.entity.*	Use all supported entities	true
shopkeeper.trade-notifications.admin	Receive admin notifications	false
shopkeeper.trade-notifications.player	Receive player notifications	false
shopkeeper.maxtrades.unlimited	Remove trade limit	op
shopkeeper.*	Full plugin access	op

[HR][/HR]

[HEADING=2] Dynamic Permissions[/HEADING]

Permission	Description	Default
shopkeeper.maxshops.<count>	Set maximum shops per player	false
shopkeeper.maxtrades.<count>	Set maximum trades per shop	false
shopkeeper.entity.<mob-type>	Allow a specific merchant entity type	false

[HR][/HR]

[HEADING=2] PlaceholderAPI Support[/HEADING]

Placeholder	Return Value
%shopkeepers_top_vendeurs_<rank>%	#1 Player (500 sales)
%shopkeepers_top_vendeurs_nom_<rank>%	Player Name
%shopkeepers_top_vendeurs_ventes_<rank>%	500
%shopkeepers_top_items_<rank>%	#1 Diamond Sword (300 sold)
%shopkeepers_top_items_nom_<rank>%	Diamond Sword
%shopkeepers_top_items_quantite_<rank>%	300

[HR][/HR]

[HEADING=2] Placeholder Examples[/HEADING]

Example	Meaning
%shopkeepers_top_vendeurs_1%	Top seller #1
%shopkeepers_top_vendeurs_nom_1%	Name of top seller #1
%shopkeepers_top_vendeurs_ventes_1%	Sales count of top seller #1
%shopkeepers_top_items_1%	Most sold item
%shopkeepers_top_items_nom_1%	Name of most sold item
%shopkeepers_top_items_quantite_1%	Sold quantity of item #1