CashChangerSimulator.Core 0.0.6-pre

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of CashChangerSimulator.Core. 
dotnet add package CashChangerSimulator.Core --version 0.0.6-pre
                    


                    

                
NuGet\Install-Package CashChangerSimulator.Core -Version 0.0.6-pre
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="CashChangerSimulator.Core" Version="0.0.6-pre" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="CashChangerSimulator.Core" Version="0.0.6-pre" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="CashChangerSimulator.Core" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add CashChangerSimulator.Core --version 0.0.6-pre
                    


                    

                
#r "nuget: CashChangerSimulator.Core, 0.0.6-pre"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package CashChangerSimulator.Core@0.0.6-pre
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=CashChangerSimulator.Core&version=0.0.6-pre&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=CashChangerSimulator.Core&version=0.0.6-pre&prerelease
                    


                            Install as a Cake Tool

CashChanger Simulator - Core

NuGet Version License: MIT

This repository contains the core logic and hardware device emulation for the CashChanger Simulator. It is designed as a modular foundational component that powers various user interfaces.

📦 NuGet Packages in this Repository

The following packages are maintained in this repository:

  • CashChangerSimulator.Core: Platform-independent core logic, currency calculation, and hardware event abstraction.
  • CashChangerSimulator.Device.Virtual: Pure C# virtual hardware simulation (works on Web/Linux/Windows, .NET 10).
  • CashChangerSimulator.Device.PosForDotNet: Windows-specific UPOS (POS for .NET) adapter for legacy integration.

User interface components are maintained in their own dedicated repositories: Cli (Command Line Interface) and Wpf (Windows Desktop UI).

Key Features (Platform-Independent Core)

  • Reactive Messaging (R3): Uses R3 for consistent state management (IsBusy, State) and asynchronous hardware event notifications.
  • Zero-Dependency Event Abstraction: High-layer components (Core/Cli) depend on abstracted event definitions, completely decoupled from Windows-specific libraries.
  • UPOS Compliant Behavior: Emulates DispenseChange, DispenseCash, and the full deposit cycle through a virtual device layer.
  • Multi-Platform Ready: The Core and Virtual Device projects have zero dependency on Windows-specific libraries, enabling use in Web APIs, CLIs, or Linux environments.
  • Reliable Lifecycle Management: Implements CompositeDisposable patterns for robust resource cleanup and memory leak prevention.

Setup

You can install the official packages via NuGet.org or GitHub Packages:

dotnet add package CashChangerSimulator.Core
dotnet add package CashChangerSimulator.Device.Virtual

Local Build

If you need to build from source:

# Build the core library and device simulator
dotnet build

🚀 Live Demo / Simulator API

The Virtual Cash Changer API is available on Google Cloud Run for testing without local setup:

Documentation

For more detailed information, please refer to the documents in the docs/ directory:

For the Japanese version, see README_JP.md.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on CashChangerSimulator.Core:

Package Downloads
CashChangerSimulator.Device.Virtual

Core logic and hardware emulation for the CashChanger Simulator. Provides platform-independent managers and virtual device controllers. / 自動釣銭機シミュレータのコアロジックとハードウェア・エミュレーション層。プラットフォームに依存しないマネージャと仮想デバイスコントローラを提供します。
CashChangerSimulator.Device.PosForDotNet

Core logic and hardware emulation for the CashChanger Simulator. Provides platform-independent managers and virtual device controllers. / 自動釣銭機シミュレータのコアロジックとハードウェア・エミュレーション層。プラットフォームに依存しないマネージャと仮想デバイスコントローラを提供します。

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.0.6-pre 93 4/8/2026
0.0.5-pre 71 4/8/2026
0.0.4-pre 86 4/7/2026
0.0.3-pre 71 4/6/2026
0.0.2-pre 78 4/6/2026
0.0.1-pre 86 4/3/2026