Loerx-CommunityShop v1.0.3

loerx-CommunityShop​

A supply-driven community shop where players sell to stock the shop, and others buy from what's been supplied. Dual economy support (Vault + loerx-currency), per-item currencies, three languages, and full in-game configuration — no manual config editing required.

---

What is loerx-CommunityShop?​

loerx-CommunityShop is a Minecraft shop plugin (Paper/Spigot 1.20+) built around a player-driven economy. Unlike a traditional admin shop where items appear from nowhere, this plugin creates a closed, community-fed marketplace: when a player sells an item, that item goes into the shop's stock, and other players can then buy it. The supply comes from the players themselves.


This makes the shop's inventory a living reflection of your server's economy. If nobody is farming diamonds, diamonds run out. If a player floods the market with cobblestone, there's plenty for everyone to buy. It rewards production, encourages trade between players, and keeps prices meaningful.


If you prefer a classic unlimited shop, you can switch to Normal mode with a single command and the plugin behaves like a standard admin shop with infinite stock.

---

Core Feature: Supply-Driven Stock​

The heart of the plugin is its stock system, which sets it apart from ordinary shops.

• Community mode (default): An item can only be bought if it is in stock — meaning another player has sold it first. Selling 64 stone adds 64 stone to the shop's stock; buyers can purchase from that pool until it runs out. When stock hits zero, the item shows as out of stock.
• Normal mode: The shop has unlimited stock. Every item can be bought without any player supplying it first, exactly like a conventional admin shop.
• Switch between the two modes at any time with /shopmode community or /shopmode normal. Your choice is saved and persists across restarts.

Selling removes the item from the player, increases the shop's stock, and pays the player. Buying checks stock (in community mode), charges the player, decreases the stock, and delivers the item — preserving all custom NBT data, so complex items keep their names, lore, enchantments, and custom model data.

---

Dual Economy Support (Vault + loerx-currency)​

loerx-CommunityShop works with two economy engines and lets you choose how they behave:

• Runs with Vault (any Vault-compatible economy such as EssentialsX Economy, CMI, and others).
• Runs with loerx-currency, allowing custom currencies.
• If only one economy is present, the plugin uses it automatically.
• If both are present, loerx-currency is used by default, and you can switch engines at any time with /shopcurrencymotor vault or /shopcurrencymotor loerx-currency. The selection is saved across restarts.
• If neither economy is available, the shop safely disables its buying/selling rather than causing errors.

Per-Item Currencies​

With loerx-currency, you can assign a different currency to individual items or whole categories. One category could be paid for with a "gold" currency, another with "gems," while the rest use your server's default currency. Items without a specific currency simply use the shop's base currency. This is configured entirely in-game through the /shopcurrency menu.

---

Fully In-Game Configuration​

Almost everything can be managed from within the game through clean GUIs and chat prompts — you do not need to edit configuration files by hand.

• Add items with a GUI: /shopedit opens a menu to add new items to the shop, including complex items with custom NBT.
• Set prices with a GUI: /shopprice lets you set buy and sell prices per item through a menu.
• Create categories: /shopcategory <display name> adds a new category to organize your shop.
• Rearrange items and categories: /shopmove <category|item> moves and reorders entries.
• Delete entries: /shopdelete <category|item> removes a category or item.
• Manage stock manually: /shopstock <itemId> <amount> lets admins adjust stock directly.
• Set currencies: /shopcurrency assigns a loerx-currency currency to a category's items.

The shop is organized into paginated categories, so large shops stay tidy and easy to navigate.

---

Multi-Language Support​

The plugin ships with three built-in languages: English, Hungarian (Magyar), and German (Deutsch). Switch the active language with /shoplang <hu|en|de>. All player-facing messages and menus adapt to the selected language.

---

PlaceholderAPI Support​

loerx-CommunityShop integrates with PlaceholderAPI, exposing shop data as placeholders for use in scoreboards, chat, holograms, and other plugins.

---

Command Reference​

Permissions​

• communityshop.use — use the shop (default: everyone)
• communityshop.admin — access admin commands (default: operators)

---

Requirements​

• Server: Paper or Spigot 1.20+
• Java: 17 or newer
• Economy (at least one): Vault (with a Vault-compatible economy plugin) or loerx-currency
• Optional: PlaceholderAPI for placeholder support

---

Why choose loerx-CommunityShop?​

• A genuine player-driven economy that most admin shops don't offer — supply comes from your community, not from thin air.
• Flexibility: run it as a community shop or a classic unlimited shop, your choice.
• Two economy engines and per-item currencies for advanced setups.
• No config-file editing needed — everything is handled in-game.
• Three languages out of the box.
• Preserves custom NBT on items, so it works cleanly with custom-item setups.

---