Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
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-pricekeep prices sane. - Category GUI browser — items grouped into configurable categories with icons and slots.
- Quick-sell commands —
/sell hand,/sell all, plus dedicated/sellhandand/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 reloadre-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.

