Description
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-nameanddescriptionare fallbacks only. If theitem-idresolves 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