wallet-module

What problem does it solve?

Provides a production-ready system to manage in-game currencies reliably, solving issues around precision, caps, persistence, and reactive UI updates so values remain consistent across gameplay, saves, and edge-case flows like prestige or bulk transactions.

Core Features & Use Cases

• Reactive Currency Containers: ReadOnlyReactiveProperty bindings for live UI updates and direct subscription to amount and cap changes.
• BigNumber Precision: BigDouble storage and arithmetic to support very large values without precision loss.
• Persistence & Versioning: Batched and immediate saves, lazy load into pending buffers, and versioned WalletData serialization for robust save/load behavior.
• Atomic Transactions & Caps: Atomic multi-currency consumption, cap enforcement with events on clamps, and lifetime earned/spent statistics persisted for analytics.
• Event-Driven Integration: MessagePipe events for CurrencyChangedEvent, CurrencyCapChangedEvent, and CurrencyInsufficientFundsEvent to decouple systems like shops, production, and prestige.
• Use Cases: Implementing in-game shops, idle/production reward systems, prestige/reset mechanics, and multi-currency economies that require accurate accounting and UI binding.

Quick Start

Register your CurrencyDefinition assets, call InitializeAsync on IWalletService to apply pending save data, bind CurrencyContainer.Amount to your UI, and use IWalletService.Add or Consume to modify balances.