AlphaSellDocs v2.1.0
AlphaSellHelpTroubleshooting

Troubleshooting

The problems server owners actually hit, matched to the console line or symptom you will see.

On this page

Check the server console first. Each card gives the symptom, the likely cause and the fix.

Startup

Console: AlphaSell is disabled — this server is waiting for approval.
Cause
A new server starts as pending, and the plugin stays off until AlphaStudio approves it.
Fix
Send the server id from the next console line to AlphaStudio, then restart once it is approved. See Server approval.
Console: Vault economy provider not found yet. Sell payouts are temporarily disabled.
Cause
No Vault economy was registered when AlphaSell started. A second line appears if the provider is unregistered later.
Fix
Install Vault and an economy plugin. The plugin keeps retrying, so payouts resume once a provider appears. Until then selling does not pay.
Console: Updated … to lang-version N
Cause
A lang file shipped a newer version, so it replaced yours.
Fix
Your old file is kept as *.old. Copy your wording across.

Prices

Items sell for the wrong price, or not at all
Cause
The price may come from your shop plugin rather than config.yml, an item may have no price and default-price is 0, or shop_only is set and the shop does not list it.
Fix
Hold the item and run /alphasell diag. It shows the method, the hooks and the final quote. See Pricing.
The category multiplier does not seem to apply
Cause
When a price comes from ShopGUIPlus or EconomyShopGUI, the category multiplier is not stacked on top. Only the sell event boost is.
Fix
Use config_only if you want category multipliers to drive all prices.
An item stays in the menu and is never sold
Cause
Items with a custom model value are never sold, and an item with no price is unsellable when default-price is 0.
Fix
Give it a price in a category, or raise default-price. Custom items from other plugins are skipped on purpose.
Enchanted items sell for the plain price
Cause
enchantments-value.yml is not read by this version.
Fix
Price enchanted gear through your shop plugin instead.

Commands

/sell opens another plugin's menu
Cause
override-command-with-listener is false, or the other plugin runs its command first.
Fix
Turn the option on. AlphaSell already loads before Essentials and CMI.
Players are told their profile is loading
Cause
They ran a sell command immediately after joining, before their profile was loaded. If it never finishes, the console logs Failed loading profile for <uuid>.
Fix
Try again in a moment. For a persistent failure check the storage settings: with MySQL, the sql block and the database host.
Players are told they cannot sell here
Cause
The player is in a world listed under blacklisted-worlds. The shipped list contains otherside.
Fix
Edit the list and run /alphasell reload.

Sell events and the Sell Axe

No sell events ever start
Cause
Scheduled events are off by default (sell-event.enabled: false). Setting features.sell-event does nothing.
Fix
Set sell-event.enabled: true, or start one with /sellevent start.
The Sell Axe stopped working
Cause
It expired. The player is told, and breaking blocks with it is cancelled.
Fix
Give a new one with /alphasell give sellaxe <player> <days>.