First Install

Installation

1

Download TaleShop.jar from the resource page.

2

Place it in your server's mods/ directory.

3

Start (or restart) the server.

4

TaleShop generates its config files on first run:

• config/TaleShop/config.json - Main configuration

• config/TaleShop/lang.json - All user-facing messages

• config/TaleShop/categories/ - Per-category shop files

First Setup

Using the In-Game Editor

The fastest way to set up your shop:

1

Join the server with an admin account (needs taleshop.admin permission).

2

Run /shop editor to open the editor GUI.

3

Click + NEW under categories to create your first category.

4

Set the category name and icon material (use the search bar to find items).

5

Click SAVE.

6

Select your new category, then click + NEW under items.

7

Set the item material, buy price, and sell price.

8

Click SAVE.

Your shop is ready. Players can now use /shop to browse and buy.

Using Config Files

You can also edit category files directly:

1

Navigate to config/TaleShop/categories/.

2

Create a new JSON file (e.g. tools.json).

3

Define your category and items:

{
  "id": "tools",
  "displayName": "Tools",
  "iconMaterial": "Tool_Pickaxe_Iron",
  "items": [
    {
      "material": "Tool_Pickaxe_Copper",
      "buyPrice": 50,
      "sellPrice": 25
    },
    {
      "material": "Tool_Axe_Copper",
      "buyPrice": 50,
      "sellPrice": 25
    }
  ]
}

4

Run /shop reload to apply changes.

Setting Up the Auction House

The auction house works out of the box. Players use /auction to open it. Data is stored in SQLite automatically.

To customize auction settings, see the Configuration page.

Economy Setup

If you have an economy plugin installed, TaleShop detects it automatically. No extra configuration needed.

If no economy plugin is found, money-based pricing is skipped. You can still use item-based pricing by setting PricingMode to ITEM in config.