Troubleshooting
The problems server owners actually hit, matched to the console line or symptom you will see.
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 anddefault-priceis 0, orshop_onlyis 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_onlyif 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-priceis 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.ymlis 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-listeneris 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
sqlblock 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 containsotherside. - 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). Settingfeatures.sell-eventdoes 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>.
