Currencies

Overview

Currencies are configurable balances a player can earn and spend. The mod uses them to power mastery (mastery points, material currencies) and class switching, but they are a general-purpose system — define your own and grant or charge them from rewards, quests, achievements, or commands.

Two flavors

Every currency is one of two kinds:

• Counter-backed — a number stored on the player, with no inventory item. Set an iconItemId for the display icon and leave hytaleItemId unset. Mastery Points are counter-backed.
• Item-backed — wraps a real Hytale item. Set hytaleItemId to the item id, and the balance is the count of that item the player holds. Life Essence is item-backed.

// Counter-backed
{
  "displayName": "Mastery Points",
  "iconItemId": "Ingredient_Crystal_Purple",
  "color": "#c08aff",
  "cap": 0,
  "showOnSidebar": true,
  "showOnMasteryPage": true
}

// Item-backed
{
  "displayName": "Life Essence",
  "hytaleItemId": "Ingredient_Life_Essence",
  "color": "#a7e0a7",
  "cap": 0
}

A cap of 0 means uncapped. Currencies can optionally show on the sidebar and the mastery page.

Earning & spending

• Earn from command rewards at level milestones, from quest and achievement CURRENCY rewards, or from an admin grant.
• Spend on mastery nodes and on switching classes (the class switch cost defaults to mastery points).

Commands

For server owners & pack authors

Currencies are enabled in config and defined as content. Author your own (or retune the Mastery Pack's Mastery Points and Life Essence) through the pack system — see Currency content types for the full definition schema.