Frequently Asked Questions
General
The shop shows "TaleShop is currently disabled."
Run /shop enable as an admin, or set Enabled to true in config.json and run /shop reload.
Players can't see a category
Check if the category has a permission field set. Players need that permission to see and access it.
Item prices show as "$0" or don't appear
Make sure you have an economy plugin installed and detected. Check the server console on startup for "Economy provider found: ..." message.
If you want item-only pricing without money, set PricingMode to ITEM in config.
Items
My modded items aren't recognized in the shop
Enable PartialIdMatching in config (default: true). This matches items with runtime ID suffixes to their shop entry using prefix matching.
Use /shop debugitems while holding the item to see its exact item ID in the console, then add that base ID to the shop.
/sell hand says "This item cannot be found in the shop!"
The item's ID doesn't match any shop entry. Use /shop debugitems to check the exact item ID, then add it to the shop with the correct material ID.
Stock limits aren't resetting
Check that buyRenewalHours or sellRenewalHours is set in the item's stock limit config. A value of 0 means no automatic reset.
Admins can manually reset stock with /shop resetstock.
Auction House
Players can't create listings
Check these common causes:
Player has reached their listing limit (default: 3). Grant
taleshop.auction.<amount>for more.Price exceeds
AuctionListingMaxPrice(default: 1 billion).Player can't afford the listing tax.
AuctionHouseEnabledisfalsein config.
Where do expired items go?
Expired items are automatically sent to the seller's mailbox. Players can claim them from the MAILBOX button in the auction house.
How do I change the listing duration?
Set AuctionListingDurationHours in config.json (default: 48 hours). Run /shop reload to apply.
Economy
TaleShop doesn't detect my economy plugin
Make sure your economy plugin loads before TaleShop. TaleShop retries economy detection up to 6 times with 10-second delays, so it usually connects even if the economy loads late.
Currently supported: EcoAPI, EcoTale, VaultUnlocked, HyCurrency, TheEconomy, XqediiCore, ArefyEconomy.
Can I use the shop without an economy plugin?
Yes. Set PricingMode to ITEM in config. Players trade items for items instead of using money.
Configuration
I added new items but they don't show up
Run /shop reload to reload category files. Check the console for any validation errors (invalid item IDs are skipped with a warning).