NexusShop
Vault-backed GUI shop for Paper with a real supply-and-demand pricing engine: prices drift as players buy and sell, bounded by per-item floors and…
⬇ Download on ModrinthNexusShop
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.
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21.11
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as NexusShop-1.0.0.jar — drop this file into the mods folder
- Download size: 35 KB
- Download link checked 27 Sept 2026 — working
These come from our own check of the pack file, not from the source page.