Minecraft plugin VillagerMarket

🔌 About VillagerMarket

VillagerMarket — is a Minecraft plugin that lets server owners provide player shops, admin shops and rentable villager shops using villager NPCs or shop items. The plugin focuses on configurable, semi‑vanilla shop mechanics so players can sell, buy and trade through villager-based shops. VillagerMarket supports integration with common plugins and provides a developer API.

🎯 Purpose

VillagerMarket solves the need for an in-game, villager-backed shop system without heavy modding. It gives server owners a configurable marketplace for player-run shops, admin shops, and rentable shops, and adds tools for limits, taxes and shop management. Key confirmed capabilities are listed below. ()

⚙ Main features

• Create player shops via commands or shop items (spawn eggs). ()
• Admin shops with unlimited storage and sell-commands. ()
• Rentable shops and per-player or server-wide trade limits with cooldowns. ()
• Infinite storage and selling slots, customizable villager appearance (profession/name). ()
• Discounts system, automatic random discounts, and taxes. ()
• PlaceholderAPI support (PAPI) and integration with Citizens, Towny, Lands, PlotSquared. ()
• Developer API and GitHub source available. ()

🧩 Who it's for

• Server owners running survival or semi‑vanilla servers who want player economy shops.
• Admins who need admin shops and automated shop management.
• Communities that want rentable shop mechanics and shop search/teleport features.

🏗 Usage examples

• Players create and manage their own villager shops in a town district.
• Admins create server-run admin shops that sell commands or items.
• Rentable shops that expire and refund owners a configurable percentage on sale. ()

⌨️ Commands

Note: Commands and permission nodes are taken from the official plugin listing and repository. For exact usage and arguments consult the plugin docs. ()

🔐 Permissions

Default values for permission nodes (true/op/false) are not specified on the official resource page; please verify defaults in your permission manager. ()

⚙ Installation

📥 Installation

• Download the VillagerMarket .jar from the official source and place it in your server's plugins/ folder.
• Restart the server (full restart; avoid /reload).
• On first run the plugin generates its configuration files. ()

📦 Dependencies

• Vault — required (for economy integration). ()
• An economy provider plugin (e.g., EssentialsX, iConomy, etc.) — required for money transactions. ()
• NBTAPI — required for legacy Minecraft versions (1.8–1.13). ()
• Optional integrations: PlaceholderAPI, Citizens, Towny, Lands, PlotSquared. ()

🧾 Configuration

• VillagerMarket generates a default configuration file on first run (config.yml). A default config snippet is shown on the official resource. ()
• The plugin includes an automatic config updater (not all options may require manual editing). ()
• No official statement about MySQL/SQLite support was found in the cited sources.

🧠 Additional information

Known requirements & notes

• Requires Vault + an economy plugin for monetary features. ()
• Legacy (1.8–1.13) builds require NBTAPI. ()
• Plugin source and developer API are available on GitHub. ()

Conflicts & limitations

• No explicit official list of conflicts; administrators should test interactions with other economy or shop plugins before deploying on production. (Not explicitly listed on official pages.)

FAQ

Q: Which Minecraft versions are supported? A: The official Spigot resource lists tested support from 1.8 up to 1.21 (see resource listing). Confirm version compatibility with the release notes when installing. ()

Q: Does VillagerMarket require Vault? A: Yes — Vault plus an economy provider plugin are required for economy features. ()

Q: Where can I find documentation or support? A: Official documentation (wiki), GitHub repository and a Discord link are provided on the plugin's resource page. ()

Q: Does the plugin collect analytics (bStats)? A: No explicit statement about bStats or telemetry was found in the cited sources.

Q: Is there an API for developers? A: Yes — the project exposes a developer API and is published on GitHub. ()

🤝 When VillagerMarket is useful

VillagerMarket is useful when you want a configurable, villager-backed shop economy without heavy server mods. It gives server owners shop types (player/admin/rentable), trade limits, PAPI integration and a developer API to extend functionality. Use it on Paper or Spigot servers and integrate with Vault for economy features. ()