Bank Vendor & Coins

# Zero0o Bank, Money & Vendor System

A complete economy foundation for Hytale focused on persistent banking, money management, NPC vendors, item storage, and coin handling.

This project started as a bank system and has now evolved into a full bank, money, and vendor economy module. The core base is now complete and considered the definitive foundation of the system. Future updates will mainly focus on maintenance, bug fixes, polish, and targeted improvements.

## Main Features

- Persistent money storage
- Persistent coin bank
- Persistent item storage
- NPC bankers
- NPC vendors
- Vendor categories
- Vendor item entries
- Buy and sell support
- In-game admin pages
- Model selection for NPCs
- Animation selection for NPCs
- Automatic item icon binding from item id
- English system texts and cleaner UI flow

## Money and Banking

Players can interact with bankers to:

- Open their item storage
- Open their money bank
- Open their coin bank
- Deposit currency
- Withdraw currency
- Manage persistent stored resources

## Vendors

Players can interact with vendors to:

- Browse categories
- View configured items
- Buy items
- Sell items when enabled
- Use a cleaner dedicated vendor flow

## Admin Tools

Admins can configure the system directly in-game:

- Create and edit vendors
- Create and edit categories
- Create and edit items
- Select NPC models
- Search compatible animations
- Assign item entries through existing asset ids
- Configure buy and sell prices
- Update already existing NPCs without rebuilding the full setup

## UI and Visual Improvements

Compared to the older version, this system now includes:

- Dedicated admin pages instead of one overloaded menu
- Cleaner bank pages
- Better vendor editing flow
- Improved NPC handling
- Updated money, coin, and pouch icons in a more fantasy / Hytale-friendly style
- Better item naming display
- Reduced UI errors and safer interaction flow

## Project Status

This is now the definitive base version of the system.

The core structure is finished.
Upcoming updates will mainly cover:

- bug fixes
- maintenance
- compatibility updates
- visual polish
- quality-of-life improvements

## Commands

### Player Commands

- `/pouch`
  Open your coin pouch UI.

- `/coins`
  Show your current pouch balance.

- `/bank`
  Open your bank UI.

- `/bankstorage`
  Open your item storage bank UI.

- `/bankcoins`
  Open your coin bank UI.

- `/bankcoins balance`
  Show your pouch and bank coin balance.

- `/bankcoins deposit <amount>`
  Deposit coins from your pouch into the bank.

- `/bankcoins deposit all`
  Deposit all pouch coins into the bank.

- `/bankcoins withdraw <amount>`
  Withdraw coins from the bank into your pouch.

- `/bankcoins withdraw all`
  Withdraw all bank coins into your pouch.

- `/vendor`
  Open the first available configured vendor.

- `/vendor <vendorId>`
  Open a specific vendor.

- `/vendor <vendorId> <categoryId>`
  Open a specific vendor on a specific category.

### Navigation Commands

- `/banknext`
  Go to the next bank storage page.

- `/bankprev`
  Go to the previous bank storage page.

### Admin Commands

- `/bankadmin`
  Open the banker admin UI.

- `/vendoradmin`
  Open the vendor admin UI.

- `/bankpages <amount>`
  Change the maximum number of bank pages.

- `/bankslots <amount>`
  Change the number of slots per bank page.

- `/bankreload`
  Reload bank storage and bank-related data from disk.

- `/economyreload`
  Reload the full economy system from disk:
  bank, vendors, bankers, and NPC refresh.

## Notes

- Interaction is designed around NPC banker and vendor workflows
- The mod is now structured to be more maintainable than the older NPC market approach
- This project is intended as a long-term supported foundation for economy gameplay

**Discord:**  
[https://discord.gg/pUXTEZpnmA](https://discord.gg/pUXTEZpnmA)