Play Coin Library

1. Introduction

This library provides functions for accessing the Play Coins that users accumulate by walking around with their CTR systems.

2. Supplement About This Version

To embed this in your application, add LIBS += libnn_plCoin to your Omakefile.
Also add #include <nn/pl/CTR/pl_GameCoin.h> to your source code.
Before you can use this library's functions, you must first call the nn::fs::Initialize and nn::ptm::CTR::Initialize functions, and then call the nn::pl::CTR::InitializeGameCoin function.
The nn::pl::CTR::InitializeGameCoin and nn::pl::CTR::FinalizeGameCoin functions do not support being called multiple times.
Note that no matter how many times you call nn::pl::CTR::InitializeGameCoin, the library will close after nn::pl::CTR::FinalizeGameCoin is called once.
Because this library's functions only return a single error, nn::pl::ResultLackOfGameCoin, functions other than nn::pl::CTR::UseGameCoin only return actual success. For other results, nn::pl::ResultGameCoinDataReset is sometimes returned. This is handled as a success, even though it indicates that the Play Coin has been initialized because the data was corrupted or for some other reason. Check this if you want to notify the user that Play Coin has been initialized.
The nn::pl::CTR::SetGameCoinCountForDebug function and the nn::pl::CTR::AddGameCoinCountForDebug function have been deprecated.
During development, use the tool described below to set the number of Play Coins that a system has.

This package has a tool for setting the number of Play Coins that a system has (CTR_SDK\tools\TargetTools\CTR-TS\Release\GameCoinSetter.[cia|csu]).
Set a number of coins using Left and Right on the +Control Pad and then apply it by pressing the A Button.
By pressing the L Button, R Button, and X Button simultaneously you can prevent the number of Play Coins from increasing any more today (although you can still use this tool to increase and decrease the number). There is no way to cancel this feature apart from changing the date in System Settings.

CONFIDENTIAL