NexusShop

Overview

NexusShop is a server shop that reacts to your economy instead of using flat prices. Each item has a base buy and sell price plus configurable minimum and maximum bounds; every transaction nudges the price by dynamic-shift-rate per unit, so heavily farmed items lose value and rare items hold it. Prices always stay inside the per-item floor/ceiling you define.

Players browse through a category GUI and buy from item menus, or sell fast from anywhere with /sell hand and /sell all. Economy is handled through Vault, so it works with any Vault-compatible economy plugin. It fits survival, skyblock and prison servers that want an economy that self-balances over time.

Features

• Dynamic pricing engine — buy/sell prices shift with transaction volume (settings.dynamic-shift-rate).
• Per-item price bounds — min-buy-price / max-buy-price / min-sell-price / max-sell-price keep prices sane.
• Category GUI browser — items grouped into configurable categories with icons and slots.
• Quick-sell commands — /sell hand, /sell all, plus dedicated /sellhand and /sellall.
• Vault economy integration — works with any Vault-compatible economy provider.
• In-game item creation — /shop create <material> <buy> <sell> adds items without editing files.
• MiniMessage display names for categories and items.
• Pre-built catalogue — Farming, Mining, Mob Drops and Building Blocks categories with starter items.
• Live reload — /shop reload re-reads the configuration with no restart.

Commands

Command	Description	Permission
/shop (aliases: /store, /buy)	Open the shop category GUI	shop.use
/shop help	Show the command help list	shop.use
/shop create <material> <buyPrice> <sellPrice>	Add an item to the shop	shop.admin
/shop reload	Reload configuration files	shop.admin
/sell [hand|all]	Sell the held item or all matching items	shop.use
/sellhand	Sell the item in your main hand	shop.use
/sellall	Sell all sellable items in your inventory	shop.use

Permissions

Node	Default	Description
shop.use	true	Use the shop GUI and selling commands
shop.admin	op	Full administrative access to shop configuration and item creation

Configuration

config.yml (excerpt):

settings:
  # Price shift per transaction unit (0.0005 = 0.05% per unit)
  dynamic-shift-rate: 0.0005
  menu-title: "<dark_gray>ToprakSMP Server Shop</dark_gray>"

categories:
  mining:
    display-name: "<aqua><bold>Mining & Minerals</bold></aqua>"
    icon: "DIAMOND_PICKAXE"
    description: "Precious ores, ingots, and gemstones."
    slot: 12

items:
  diamond:
    material: "DIAMOND"
    category: "mining"
    display-name: "<aqua><bold>Diamond</bold></aqua>"
    buy-price: 200.00
    sell-price: 100.00
    min-buy-price: 100.00
    max-buy-price: 500.00
    min-sell-price: 50.00
    max-sell-price: 300.00

Pre-built categories: farming, mining, mob_drops, blocks. Each item supports material, category, display-name, buy-price, sell-price and the four price-bound fields.

Compatibility

• Server software: Paper 1.21.11 (api-version 1.21)
• Java: 21
• Soft dependencies: Vault (required for economy transactions in practice; declared as softdepend)

Support

• GitHub: https://github.com/toprakeker/NexusShop
• Discord: provided with your purchase for setup help and bug reports
• Issues and feature requests are handled through the GitHub issue tracker.