Экономика

Команды 15#

/eco give Steve 1000
/pay Alex 200
/balance Alex
/baltop

/setworth minecraft:diamond 25
/setworth hand 4
/worth diamond 64
/sell hand
/sell inventory

/chestshop convert
/chestshop hologram enable
/chestshop info
/chestshop limit

/chestshop list
/chestshop setprice buy 8
/chestshop stats

/npcshop create Оружейник спавна
/npcshop list
/npcshop additem ab12cd34 diamond 50 -1 1
/npcshop additem ab12cd34 emerald -1 20 16
/npcshop info ab12cd34
/npcshop entitytype ab12cd34 minecraft:villager true

Конфигурация#

economy.json#

Права 30#

Подробное руководство#

Version: 1.0.5+build.54 · Config files: economy.json, config.json → economy section

Overview#

NeoEssentials provides a full server economy with player balances, payments, admin tools, an async leaderboard, a sign-based ChestShop, entity-based NPC shops, and Vault API integration.

Config (economy.json)#

Note: modules.economyEnabled (in config.json) is the master on/off switch — economy.json itself has no enabled key.

/sell's multiplier and named-item rule are read from config.json → economy (not economy.json):

/baltop's page size (10) and cache lifetime (60s) are currently hardcoded and not configurable.

Commands#

Player Commands#

/pt name collision: /pt is also registered separately as the Powertool system's shorthand (/pt list, /pt remove, …, permission neoessentials.item.powertool — see the Items/Powertool docs). Because Brigadier merges same-named literal nodes registered on the same dispatcher, bare /pt still runs paytoggle (its .executes() was registered first and is kept), but /pt list / /pt remove run the Powertool subcommands, not anything paytoggle-related. Don't assume /pt <subcommand> is part of the paytoggle command.

Admin Commands#

Note: /eco give\|take\|set take a plain numeric <amount> — percentage syntax (10%) is not supported.

ChestShop#

Sign-based shops that connect a chest to a sign for automated buy/sell.

Setup#

1. Place a chest (double chests are supported — both sign-facing halves share the combined inventory, so two signs on the same double chest correctly draw from and restock into the full 54-slot inventory rather than each only seeing its own half)
2. Place a sign on the chest (or adjacent block)
3. Write the sign in this format:

Line 1: [leave blank or your name]   ← auto-assigns your name if blank
Line 2: 5                            ← quantity per trade
Line 3: B 10:S 5                     ← buy price : sell price  (B only, S only, or both)
Line 4: diamond                      ← item name, or ? to assign by right-clicking with item

Typing a name directly on line 4 only resolves a bare item ID — it can't carry enchantments, custom names, or modded NBT-backed data. Use ? (or shift+right-click afterward — see Item Data / NBT below) to assign the item by holding the exact stack instead, if it has data that needs to be preserved.

Price shortcuts: B FREE = free to buy · S FREE = free to sell · 1K = 1000 · 1.5M = 1500000

Admin Shops#

Use Admin Shop on line 1 — requires neoessentials.shop.create.admin. Admin shops have unlimited stock.

Item Data / NBT (Modded Items)#

Sign text alone can only encode a bare item ID (diamond, thermal:copper_ingot) — it cannot carry custom data (enchantments, custom names/lore, or a modded item's NBT-backed capability data). To make a shop trade an item with its data intact, assign it by holding the exact item and interacting with the sign/hologram rather than typing its name:

Only the owner (or, for admin shops, a player with neoessentials.shop.create.admin) can do either. If a shop was created by typing an item name directly on the sign and buying/selling against a data-bearing item in the chest reports "out of stock" even though the chest visibly has stock, this is almost always the fix — the shop never captured the item's data, so it wasn't matching what's actually in the chest. Shift+right-click it with the correct item to fix.

Removing a Shop#

Left-click (attack) a shop sign to sell, same as always — but a single left-click swing on a shop sign is also the tool used to actually break it, so it's intercepted for the sell/info action by default. Sneak (shift) + left-click bypasses that interception and lets the swing through as a normal break attempt, removing the shop (if you're the owner or an admin).

Commands#

/chestshop (alias /cshop) with no arguments prints an in-game help listing.

Dynamic Pricing & Holograms#

Shops support optional per-shop holograms (floating buy/sell display, clickable) and a configurable dynamic pricing engine (shop.pricing in config.json) with rules such as bulk-quantity discounts, time-based discounts, and supply/demand adjustment. These are off by default — /chestshop pricing reports current status.

Permissions#

NPC Shops#

Entity-based shops — an invulnerable ArmorStand NPC that opens a virtual chest-style GUI listing configurable buy/sell offers, instead of a sign+chest pair. Unlike ChestShop, NPC shops have no linked chest: items are minted/sunk directly (like an admin ChestShop with unlimited stock), so there's no stock to run out of on the shop's side.

Setup#

1. Stand where you want the NPC and run /npcshop create <name> — spawns the NPC at your current position.
2. Add item listings with /npcshop additem <shopId> <item> <buyPrice> <sellPrice> <qty> (pass -1 for either price to disable that side of the trade — e.g. buy-only or sell-only listings).
3. Right-click the NPC to open the shop GUI.

Buying and Selling#

Inside the shop GUI, each listing is shown as an item stack with buy/sell prices and a click hint in its lore:

• Right-click a listing → buy (pay money, receive the item).
• Left-click a listing → sell (give up the item, receive money) — only works if the listing has a sell price configured and you're carrying enough of the item.

Requires neoessentials.shop.use, same permission as ChestShop.

Commands#

/npcshop with no arguments prints an in-game help listing. All sub-commands require neoessentials.shop.npc.manage (or OP level 3).

shopId accepts either the full UUID or an unambiguous prefix (as shown by /npcshop list/create).

Permissions#

Vault API#

NeoEssentials registers itself as a Vault Economy, Chat, and Permission provider. Any mod/plugin using Vault will automatically use NeoEssentials.

Use /vault to check provider status in-game.

Data Files#

Back to Wiki Home