FAQ

Common questions and answers about EasySell.

General

What is EasySell?

EasySell is a Minecraft plugin that allows players to easily sell items through a GUI-based interface. Players simply open a menu, place items in it, and close it to sell everything at once.

What versions are supported?

EasySell supports Minecraft 1.16 and above. It's developed and tested primarily on 1.21.4.

Is EasySell free?

EasySell requires a license key. Visit discord.gg/pikzstudios to obtain your license.


Installation

What plugins are required?

Plugin
Purpose

Vault

Economy API integration

ProtocolLib

Real-time worth display

Economy Plugin

Actual money storage (EssentialsX, CMI, etc.)

Why isn't the plugin enabling?

Check the following:

  1. Vault is installed and enabled

  2. ProtocolLib is installed and enabled

  3. You're running Java 21 or higher

  4. License key is valid

How do I get a license key?

Join discord.gg/pikzstudios to request a license key.


Economy

What economy plugins work with EasySell?

Any Vault-compatible economy plugin works:

  • EssentialsX

  • CMI

  • iConomy

  • TheNewEconomy

  • And many more

Why isn't money being deposited?

  1. Verify an economy plugin is installed

  2. Check Vault recognizes your economy: look for Vault messages on startup

  3. Ensure the player has a valid economy account

Can I use multiple currencies?

EasySell uses Vault's default economy. For multiple currencies, use an economy plugin that supports that feature.


Prices

How do I change item prices?

Edit plugins/EasySell/prices.yml:

Then run /easypayreload.

What happens if an item isn't in the price list?

It uses the default-price value:

Set to 0 to prevent selling unconfigured items.

How do I add new items?

Add them to the items: section in prices.yml:

Use the Minecraft material name in lowercase with underscores.

Why is my item selling for the wrong price?

  1. Check the exact material name in prices.yml

  2. Material names are case-sensitive (use lowercase)

  3. Reload with /easypayreload after changes


Worth Display

The worth lore isn't showing on items

  1. Ensure item-worth: true in config.yml

  2. Verify ProtocolLib is installed

  3. Make sure you're not in Creative mode

  4. Reload the plugin

Can I disable the worth display?

Yes, set item-worth: false in config.yml.

Why does the worth show in my inventory but not chests?

Worth display should work in all inventories. If it doesn't:

  1. Check ProtocolLib version is up to date

  2. Look for errors in console

  3. Try restarting the server


Sell GUI

How big is the sell GUI?

The sell GUI has 36 slots (4 rows of 9 slots).

Can I change the GUI size?

Currently, the GUI size is fixed at 36 slots.

Can I add decoration items to the GUI?

The current version doesn't support decoration items. All slots are available for selling.

What happens to unsellable items?

Items with a price of 0 or not in the price list (when default-price is 0) cannot be sold. The "item-not-sellable" message will display if enabled.


Commands

What's the difference between /sell and /worth?

Command
Function

/sell

Opens GUI to sell multiple items

/worth

Shows value of item in hand

Can I create aliases for commands?

Use a plugin like CommandAliases or add aliases in your server's commands.yml.

How do I reload the config?

Use /easypayreload (requires easysell.reload permission).


Permissions

Can players sell by default?

Yes, easysell.sell and easysell.worth are granted to all players by default.

How do I restrict selling to certain ranks?


Troubleshooting

Plugin loads but commands don't work

  1. Check for error messages in console

  2. Verify license key is valid

  3. Ensure dependencies are loading before EasySell

"No permission" message even though I'm OP

  1. Check if another plugin is interfering

  2. Verify permission nodes with your permission plugin

  3. Try giving explicit permission: /op <your name>

Items disappear but no money received

  1. Check console for economy errors

  2. Verify Vault is working: /vault-info

  3. Ensure your economy plugin is functioning

Console shows errors about packets

  1. Update ProtocolLib to the latest version

  2. Ensure server version matches ProtocolLib version

  3. Check for plugin conflicts


Performance

Does EasySell cause lag?

EasySell is optimized for performance:

  • Efficient packet handling

  • Optimized price lookups

  • Minimal database usage

Will it affect TPS?

Under normal usage, EasySell has negligible impact on server TPS.


Support

Where can I get help?

Join our Discord server: discord.gg/pikzstudios

How do I report a bug?

Report bugs on our Discord server with:

  1. Server version

  2. EasySell version

  3. Error messages from console

  4. Steps to reproduce

Can I request features?

Yes! Feature requests are welcome on our Discord server.


Last updated