Configuration

All config files are located in config/TaleShop/.

config.json

Main configuration file. Generated on first run with defaults.

General

Option	Default	Description
Enabled	true	Global plugin toggle. When false, all commands show "TaleShop is currently disabled."
ShopCommandEnabled	true	Enable/disable the /shop command
SellCommandEnabled	true	Enable/disable the /sell command
AuctionCommandEnabled	true	Enable/disable the /auction command

Pricing

Option	Default	Description
PricingMode	BOTH	Active pricing types: BOTH, MONEY, or ITEM
CurrencyFormatting	true	Format currency values in the UI
CurrencyFormat	$ {amount}	Currency display template. {amount} is replaced with the value
MaxOrderAmount	6400	Maximum quantity per purchase
ShowPricesOnGrid	true	Display prices on item icons in the shop grid

Auction House

Option	Default	Description
AuctionHouseEnabled	true	Enable/disable the auction house
AuctionListingDurationHours	48	How long listings stay active
AuctionListingTaxPercent	5.0	Tax percentage (0 to disable)
AuctionListingMaxPrice	1000000000	Maximum listing price
AuctionTaxOnSale	false	Collect tax when sold instead of at creation
DefaultAuctionLimit	3	Default max active listings per player
AuctionRequestItemLimit	5	Max different items requestable per listing
AllowPlayersAskForItem	true	Allow sellers to request items from buyers

Miscellaneous

Option	Default	Description
PartialIdMatching	true	Match items with runtime ID suffixes (e.g. modded items)
HideBackButtonOnOpenFor	true	Hide the back button when opening shop for another player via /shop openfor
Hooks.SimpleEnchantments.UseRomanNumerals	true	Display enchantment levels as Roman numerals

Example

{
  "Enabled": true,
  "AuctionHouseEnabled": true,
  "ShopCommandEnabled": true,
  "SellCommandEnabled": true,
  "AuctionCommandEnabled": true,
  "PricingMode": "BOTH",
  "CurrencyFormatting": true,
  "CurrencyFormat": "$ {amount}",
  "MaxOrderAmount": 6400,
  "AuctionListingDurationHours": 48,
  "AuctionListingTaxPercent": 5.0,
  "AuctionListingMaxPrice": 1000000000.0,
  "AuctionTaxOnSale": false,
  "DefaultAuctionLimit": 3,
  "AuctionRequestItemLimit": 5,
  "AllowPlayersAskForItem": true,
  "HideBackButtonOnOpenFor": true,
  "ShowPricesOnGrid": true,
  "PartialIdMatching": true,
  "Hooks": {
    "SimpleEnchantments": {
      "UseRomanNumerals": true
    }
  }
}

lang.json

All user-facing text is customizable. The file contains 100+ message keys.

Color Tags

Messages support color tags:

Tag	Color
<red>	Red
<green>	Green
<gold>	Gold
<yellow>	Yellow
<aqua>	Aqua
<gray>	Gray
<white>	White
<bold>	Bold text
<italic>	Italic text

Close tags with </tag> (e.g. <red>Error!</red>).

Common Customizations

{
  "prefix": "<gold>[TaleShop]</gold> <gray>",
  "shopTitle": "Market",
  "itemBought": "<green>Bought: {amount}x {item} for {price}",
  "itemSold": "<green>Sold: {amount}x {item} for {price}",
  "searchPlaceholder": "Search items..."
}

Auto-Repair

On load, TaleShop checks for missing keys and adds them with default values. You never need to manually add new keys after updates.

Category Files

Located in config/TaleShop/categories/. Each category is a separate JSON file.

Structure

{
  "id": "weapons",
  "displayName": "Weapons",
  "iconMaterial": "Weapon_Sword_Iron",
  "permission": "taleshop.category.weapons",
  "items": [
    {
      "material": "Weapon_Sword_Iron",
      "displayName": "Iron Sword",
      "description": "A reliable weapon",
      "buyPrice": 100,
      "sellPrice": 50,
      "buyCosts": [
        { "material": "Ore_Iron_Ingot", "amount": 3 }
      ],
      "enchantments": {
        "sharpness": 2
      },
      "stockLimit": {
        "buyMode": "PER_PLAYER",
        "buyLimit": 3,
        "buyRenewalHours": 24
      }
    },
    {
      "type": "COMMAND",
      "material": "Gem_Diamond",
      "displayName": "VIP Rank",
      "buyPrice": 5000,
      "commands": ["say {player} purchased VIP!"]
    }
  ]
}

Item Fields Reference

Field	Type	Default	Description
material	string	required	Item ID
displayName	string	item default	Custom display name
description	string	none	Description shown in shop
buyPrice	number	0	Buy price (0 = can't buy)
sellPrice	number	0	Sell price (0 = can't sell)
type	string	NORMAL	NORMAL or COMMAND
commands	string[]	none	Commands to execute (COMMAND type)
permission	string	none	Permission to buy
giveItem	boolean	true	Whether to give the physical item
buyCosts	object[]	none	Required items to buy
sellCosts	object[]	none	Bonus items given on sell
enchantments	object	none	Enchantment name to level mapping
stockLimit	object	none	Stock limit configuration

Stock Limit Fields

Field	Type	Default	Description
buyMode	string	NONE	NONE, PER_PLAYER, or SERVER
buyLimit	number	0	Max buy count
buyRenewalHours	number	0	Hours until buy stock resets (0 = no reset)
sellMode	string	NONE	NONE, PER_PLAYER, or SERVER
sellLimit	number	0	Max sell count
sellRenewalHours	number	0	Hours until sell stock resets (0 = no reset)

Validation

Invalid item IDs are skipped on load (logged to console). The rest of the shop loads normally.