YAS Currency

Changelog V1.1.1

New Features

• Added a configurable Balance HUD for player currency information.
• Added a dedicated HUD tab inside the player wallet.
• Added per-player HUD settings for:
  • HUD position
  • X/Y offset
  • digital balance visibility
  • physical cash balance visibility
  • currency icon visibility
  • HUD background style
• Added selectable Balance HUD backgrounds:
  • Standard
  • RPG
  • RPG light
• Added optional global currency symbol visibility. Server owners can now hide the currency symbol completely.
• Added dynamic cash item names and descriptions using Hytale item stack display metadata.
• Added support for physical cash display names and values in cash item tooltips.
• Added new QuestLines requirement for physical cash checks:

  yascurrency:cancashafford:<amount>

• Added new QuestLines action for removing physical cash from a player inventory:

  yascurrency:takecash:<amount>:<label>

• Added new QuestLines text variable for physical cash balance:

  {ycurcashbalance}

• Updated public API to API v3.
• Added new API helpers for physical cash balance checks, formatted cash balance output, Balance HUD refreshes, HUD settings, and feature detection.

Improvements

• Improved player wallet structure with clearer HUD configuration.
• Improved Balance HUD startup behavior so the HUD can load automatically without requiring the wallet to be opened first.
• Improved Balance HUD padding and spacing for better readability.
• Improved Balance HUD display options so players can choose between digital balance, physical cash balance, or both.
• Reduced Balance HUD positions to stable corner placements:
  • top left
  • top right
  • bottom left
  • bottom right
• Improved physical cash naming across wallet, HUD, and cash handling.
• Improved cash formatting so physical cash can use its own configured value label.
• Improved QuestLines integration with support for both digital balance and physical cash economy flows.
• Improved API feature flags for easier compatibility checks by other plugins.
• Improved handling of existing cash stacks by normalizing them when they are processed by wallet or cash actions.

Fixes

• Fixed inconsistent currency/cash labels where old names such as Syndi or SyndiCash could still appear after configuration changes.
• Fixed optional symbol handling so the currency symbol can be fully hidden when disabled.
• Fixed Balance HUD background selection where the standard background could incorrectly keep an RPG background style.
• Fixed Balance HUD visibility behavior when the global HUD option is enabled or disabled.
• Fixed several HUD placement issues by limiting the available positions to stable corner anchors.
• Fixed physical cash item tooltips no longer relying on static item translation keys for dynamic cash names and values.
• Fixed raw translation keys appearing in cash item tooltips by using resolved per-stack display metadata.
• Fixed legacy/old HUD position values being normalized to a safe default.

Compatibility Notes

• Existing cash items may need to be processed once through wallet, cash handling, or related inventory actions before receiving updated dynamic tooltip metadata.
• Balance HUD settings are stored per player.
• Global admin HUD settings now only control whether the Balance HUD feature is available; players configure their own HUD placement in the wallet.
• Plugins integrating with YASCurrency should check API_VERSION = 3 and use feature flags where possible.