hammerFirst 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 Configurationarrow-up-right 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.