https://github.com/ivanmurzak/unity-iap-store
Powerful Store manager for Unity project. Can handle everything related to: ingame currencies, ingame shop items, IAP purchases, subscriptions, data save with encryption.
https://github.com/ivanmurzak/unity-iap-store
iap store unity unity-iap unity-plugin
Last synced: 4 months ago
JSON representation
Powerful Store manager for Unity project. Can handle everything related to: ingame currencies, ingame shop items, IAP purchases, subscriptions, data save with encryption.
- Host: GitHub
- URL: https://github.com/ivanmurzak/unity-iap-store
- Owner: IvanMurzak
- License: mit
- Created: 2021-12-30T15:37:56.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-10T10:13:16.000Z (7 months ago)
- Last Synced: 2025-01-31T03:38:29.377Z (4 months ago)
- Topics: iap, store, unity, unity-iap, unity-plugin
- Language: ShaderLab
- Homepage:
- Size: 1.45 MB
- Stars: 14
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Unity IAP Store
 [](https://openupm.com/packages/extensions.unity.iap.store/)  [](https://stand-with-ukraine.pp.ua)
Powerful Store manager for Unity project. You have codeless products management system, where you can create in-game products. Create all currencies with custom names and icons. Each product has price in single or multiple in-game currencies. Ability to create bundle of different products and sell them in single purchase. Any product can be easily swapped to IAP or back to in-game product. Fully supported IAP for iOS and Android out of the box, other platforms supported also, just need to extend fram base class and add needed to you code.
## Features
- ✔️ add custom currencies
- ✔️ item price in multiple currencies
- ✔️ item categorization
- ✔️ in-app purchases supported for iOS and Android
- ✔️ currencies management
- ✔️ pack of multiple products by single purchase
- ✔️ pack of multiple currencies by single purchase
- ✔️ drawer for showing items in Unity UI with ability to override for any other UI system
- ✔️ drawer adapter for showing all items from specific category in Unity UI with ability to override for any other UI system
# How to install - Option 1 (RECOMMENDED)
- Install [ODIN Inspector](https://odininspector.com/)
- Install [OpenUPM-CLI](https://github.com/openupm/openupm-cli#installation)
- Open command line in Unity project folder
- `openupm add extensions.unity.iap.store`
# How to install - Option 2
- Install [ODIN Inspector](https://odininspector.com/)
- Add this code to /Packages/manifest.json
```json
{
"dependencies": {
"extensions.unity.iap.store": "4.12.2",
},
"scopedRegistries": [
{
"name": "package.openupm.com",
"url": "https://package.openupm.com",
"scopes": [
"extensions.unity",
"com.cysharp.unitask",
"com.neuecc.unirx"
]
}
]
}
```
# How to setup
### 1. Extends from `StoreSO`
Override at least abstract method. You should take of saving your data in persistent memory. There are basic methods required to implement in the example below.
```C#
using System;
using System.Collections.Generic;
using Sirenix.Serialization;
using UnityEngine;
using UniRx;
using Project.Store;
using BigInt = System.Numerics.BigInteger;
[CreateAssetMenu(fileName = "MyStore", menuName = "Store/MyStore")]
public class MyStore : StoreSO
{
[OdinSerialize, NonSerialized]
public ReactiveProperty balance = new ReactiveProperty();
public override IObservable OnBalanceChanged(string currency)
{
return balance.Select(x => new Price(currency, x));
}
public override BigInt GetBalance(string currency)
{
return balance.Value;
}
protected override void SpendBalance(string currency, BigInt amount)
{
balance.Value -= amount;
}
protected override void ApplyPurchase(List sellables)
{
// Apply purchase here
}
}
```
### 2. Create instance of the new ScriptableObject `MyStore`
Create instance and do setup. You can add as many currencies as needed. Also you can use it without currencies at all, if you just need to handle in-app purchases.
### 3. Add StoreInstaller to any gameObject
# How to show sellable item(s) in UI
This system is quite independent, but you need to show sellable items for a user, to make ability for a user to buy them. There are multiple ways to do that.
- create prefab for drawing UI element which represent single item for selling. If you need you can use multiple prefabs for different reasons in different places
- add `StoreSellableDrawer_UGUI` component to the prefab
- bind all required elements to the component
It can be used for showing single sellable item.
## Adapters
Adapter generates multiples items, very easy to setup all of them from single place with small amount of setup steps.
- `StoreCategoryAdapter` - shows list of sellable items from specific category
- `StoreCustomAdapter` - shows custom list of sellable items
- Or create your own StoreAdapter, for that need to extand from `StoreAdapter`. Also you may create custom StoreSellableDrawer for any UI system in case if you don't use Unity UI.
# How to show player's current currencies balance in UI
`CurrencyBalanceDrawer_UGUI_TMP` show currency balance and refreshes it when it changed.
# How to show separate price of specific sellable item
That is easy. Just create any gameObject with Text component and add `PriceDrawer` on it.
# Other
- to execute `Purchase` action without sellable item drawer and/or adapter use `SimplePurchaser`
- to restore non-consumable in-app purchases use `SimpleInAppPurchaseRestorer`
