# First Install

## Installation

{% stepper %}
{% step %}
Download `TaleShop.jar` from the resource page.
{% endstep %}

{% step %}
Place it in your server's `mods/` directory.
{% endstep %}

{% step %}
Start (or restart) the server.
{% endstep %}

{% step %}
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
  {% endstep %}
  {% endstepper %}

## First Setup

### Using the In-Game Editor

The fastest way to set up your shop:

{% stepper %}
{% step %}
Join the server with an admin account (needs `taleshop.admin` permission).
{% endstep %}

{% step %}
Run `/shop editor` to open the editor GUI.
{% endstep %}

{% step %}
Click **+ NEW** under categories to create your first category.
{% endstep %}

{% step %}
Set the category **name** and **icon material** (use the search bar to find items).
{% endstep %}

{% step %}
Click **SAVE**.
{% endstep %}

{% step %}
Select your new category, then click **+ NEW** under items.
{% endstep %}

{% step %}
Set the item **material**, **buy price**, and **sell price**.
{% endstep %}

{% step %}
Click **SAVE**.
{% endstep %}
{% endstepper %}

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

### Using Config Files

You can also edit category files directly:

{% stepper %}
{% step %}
Navigate to `config/TaleShop/categories/`.
{% endstep %}

{% step %}
Create a new JSON file (e.g. `tools.json`).
{% endstep %}

{% step %}
Define your category and items:

```json
{
  "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
    }
  ]
}
```

{% endstep %}

{% step %}
Run `/shop reload` to apply changes.
{% endstep %}
{% endstepper %}

## 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](https://heliostudios.gitbook.io/asel/hytale/taleshop/broken-reference) 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.aselstudios.com/taleshop/first-install.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.