Shop

A configurable shop mod for Hytale servers, built by LucaStudios. Players can browse categorized item tabs and purchase items using in-game currency.

Features

Multi-tab shop UI with paginated item listings
Pluggable economy system (EconomyPlus or VaultUnlocked)
Fully configurable shops via shops.yml
Hot-reload config without restarting the server

Requirements

One of the following economy plugins must be installed:

EconomyPlus (com.lucastudios.EconomyPlus)
VaultUnlocked (net.cfh.vault.VaultUnlocked)

The mod will auto-detect whichever is present. If neither is found, the server will fail to start with an error.

Commands

Command	Description
`/shop`	Opens the shop UI
`/shopreload`	Reloads `shops.yml` without a server restart

Configuration

On first run, a default shops.yml is copied to plugins/Shop/shops.yml. Edit it to define your shops and items.

Structure

shops:
  ShopName:
    shop-name: 'Display Name'
    shop-description: 'Short description shown in the UI.'
    items:
      ItemKey:
        display-name: 'Item Display Name'
        description: 'Item description.'
        buy-price: 10.0
        currency: 'coins'
        currencySymbol: '$'
        quantity: 16
        item-id: 'Hytale_Item_ID'

Fields

Field	Description
`shop-name`	Name displayed on the shop tab
`shop-description`	Short description of the shop category
`display-name`	Fallback name shown in the UI if Hytale item data is unavailable
`description`	Fallback description shown in the UI if Hytale item data is unavailable
`buy-price`	Price to purchase the item
`currency`	Currency identifier (e.g. `coins`)
`currencySymbol`	Symbol displayed next to the price (e.g. `$`)
`quantity`	How many of the item the player receives
`item-id`	Hytale asset ID for the item

Note: display-name and description are fallbacks only. If the item-id resolves to a known Hytale item, the mod will automatically use the item's localized name and description from the Hytale item data instead.

Authors

Itamar Behar
Omer Behar

ShopPlus