In Game Editor

The in-game shop editor lets admins create and manage categories, items, and commands without editing files.

Opening the Editor

Run /shop editor (requires taleshop.admin permission).

The editor has three panels:

• Left: Category list

• Middle: Item list for the selected category

• Right: Edit form for the selected category or item

Managing Categories

Creating a Category

1

Click + NEW in the category panel.

2

Fill in:

• Category ID: Unique identifier (lowercase, no spaces)

• Display Name: Name shown to players

• Icon Material: Search and select an item to use as the icon

• Slot Order: Position in the category list (lower = first)

• Permission (optional): Permission node required to access

3

Click SAVE.

Editing a Category

1

Select the category from the list.

2

Modify any field in the right panel.

3

Click SAVE.

Renaming a category ID moves all its items to the new category file automatically.

Deleting a Category

1

Select the category.

2

Click DELETE, then click CONFIRM? to confirm.

This deletes the category and all its items.

Managing Items

Creating an Item

1

Select a category.

2

Click + NEW in the item panel.

3

Choose Item Type: Normal Item or Command Item.

4

Fill in the item details.

5

Click SAVE.

Normal Item Fields

Field	Description
Material	The item ID (use the search bar to find items)
Display Name	Custom name (leave empty for default)
Description	Short text shown in the shop
Buy Price	Money price to buy (0 = can't buy)
Sell Price	Money price when selling (0 = can't sell)
Slot Order	Position in the item grid
Permission	Permission required to buy

Command Item Fields

Field	Description
Icon	Display material for the command listing
Display Name	Name shown in the shop
Buy Price	Money price
Command	Command to execute. Use {player} and {uuid} as placeholders
Slot Order	Position in the item grid

Buy Item Costs

Add items that the player must provide alongside money to buy:

1

Click SHOW next to "Buy Item Costs".

2

Search for an item and click it to add.

3

Set the required amount.

4

Add more items if needed.

Sell Item Bonuses

Add bonus items given alongside money when a player sells:

1

Click SHOW next to "Sell Item Bonus".

2

Search and add items.

3

Set amounts.

Enchantments

If SimpleEnchantments is installed:

1

Click SHOW next to "Enchantments".

2

Select an enchantment from the dropdown.

3

Set the level.

4

Add more enchantments if needed.

Stock Limits

Configure buy/sell limits:

1

Click SHOW next to "Stock Limits".

2

Set the mode (None, Per Player, Server-Wide).

3

Set the limit amount.

4

(Optional) Set renewal hours for automatic reset.

Saving

All changes are saved directly to the category JSON files in config/TaleShop/categories/. Changes take effect immediately after saving.